2.2. IAMポリシの作成 (handson-cli-website-https-S3BucketWritePolicy)¶
作業の目的 [why]¶
IAMポリシ"handson-cli-website-https-S3BucketWritePolicy"を作成します。
完了条件/事前条件 [設計者用情報]
完了条件 [after]
主処理は、以下を満たしたときに成功したものとします。
- 完了条件1
- IAMポリシー"handson-cli-website-https-S3BucketWritePolicy"が存在する。
事前条件 [before]
主処理の実施は、以下の状態であることを前提とします。
- 事前条件1
- ポリシドキュメントファイル"${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json"が存在する。
- 事前条件2
- IAMポリシー"handson-cli-website-https-S3BucketWritePolicy"が存在しない。
前提と異なることが判明した場合、直ちに処理を中止します。
作業対象 [what]¶
- IAMサービス
標準時間(合計)¶
8分
パラメータ設定¶
| パラメータ設定の標準時間: | 2分 |
|---|
作業に必要なモノ・情報 [resource]¶
作業開始には、以下が全て揃っていることが必要です。
リソース1: IAMポリシ名
- 作成するIAMポリシの名称です。
- 今回は"handson-cli-website-https-S3BucketWritePolicy"とします。
リソース2: ポリシドキュメントファイル名
- 作成するIAMポリシーのポリシドキュメントのファイル名です。
- 今回は"${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json"とします。
パラメータの指定¶
作業に必要なパラメータを変数に格納をします。
0.1. IAMポリシ名の指定¶
IAMポリシ名を指定します。
変数の設定:
IAM_POLICY_NAME='handson-cli-website-https-S3BucketWritePolicy'
0.2. ポリシドキュメントファイル名の指定¶
ポリシドキュメント用ディレクトリの指定
変数の設定:
DIR_IAM_POLICY_DOC="${HOME}/conf/handson-cli-website-https-conf"
IAMポリシドキュメント名の指定
IAMポリシドキュメント名を指定します。
変数の設定:
IAM_POLICY_DOC_NAME='handson-cli-website-https-S3BucketWritePolicy'
ポリシドキュメントファイル名の指定
ポリシドキュメントファイル名を指定します。
変数の設定:
FILE_IAM_POLICY_DOC="${DIR_IAM_POLICY_DOC}/${IAM_POLICY_DOC_NAME}.json" \ && echo ${FILE_IAM_POLICY_DOC}
結果(例):
${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json
パラメータの保存¶
設定されている変数の保存先となるファイル名を指定します。
変数の設定:
DIR_PARAMETER="${HOME}/tmp/parameter-handson-cli-website-https" FILE_PARAMETER="${DIR_PARAMETER}/$(date +%Y-%m-%d)-iam-policy-create.env" \ && echo ${FILE_PARAMETER}
結果(例):
${HOME}/tmp/parameter-handson-cli-website-https/2019-07-14-iam-policy-create.env
各変数に正しいパラメータ値が格納されていることを確認しながら保存します。
変数の確認:
cat << EOF > ${FILE_PARAMETER} # 0.1. IAM_POLICY_NAME:"handson-cli-website-https-S3BucketWritePolicy" IAM_POLICY_NAME="${IAM_POLICY_NAME}" # 0.2. FILE_IAM_POLICY_DOC:"${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json" FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}" EOF cat ${FILE_PARAMETER}
下段の変数が入っていない、もしくは上段と同等の値が入っていない場合は、それぞれの手順番号に戻って変数の設定を行います。
タスクの実施¶
| タスク標準時間: | 6分 |
|---|
1. 前処理¶
処理対象の状態確認¶
主処理の実施は、以下の状態であることを前提とします。
前提と異なることが判明した場合、直ちに処理を中止します。
事前条件1: ポリシドキュメントファイル"${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json"が存在する。
「ポリシドキュメントファイル"${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json"が存在する。」ことを確認します。
コマンド:
ls ${FILE_IAM_POLICY_DOC}
結果(例):
${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json
事前条件2: IAMポリシー"handson-cli-website-https-S3BucketWritePolicy"が存在しない。
「IAMポリシー"handson-cli-website-https-S3BucketWritePolicy"が存在しない。」ことを確認します。
コマンド:
aws iam list-policies \ --scope Local \ --max-items 1000 \ --query "Policies[?PolicyName == \`${IAM_POLICY_NAME}\`].PolicyName" \ --output text
結果(例):
(出力なし)
2. 主処理¶
IAMポリシーの作成¶
変数の確認:
cat << ETX # IAM_POLICY_NAME:"handson-cli-website-https-S3BucketWritePolicy" IAM_POLICY_NAME="${IAM_POLICY_NAME}" # FILE_IAM_POLICY_DOC:"${HOME}/conf/handson-cli-website-https-conf/handson-cli-website-https-S3BucketWritePolicy.json" FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}" ETX
コマンド:
aws iam create-policy \ --policy-name ${IAM_POLICY_NAME} \ --policy-document file://${FILE_IAM_POLICY_DOC}
結果(例):
{ "Policy": { "PolicyName": "handson-cli-website-https-S3BucketWritePolicy", "CreateDate": "2019-07-14T01:23:45.678Z", "AttachmentCount": 0, "IsAttachable": true, "PolicyId": "ANPAxxxxxxxxxxxxxxxxx", "DefaultVersionId": "v1", "Path": "/", "Arn": "arn:aws:iam:::XXXXXXXXXXXX:policy/handson-cli-website-https-S3BucketWritePolicy", "UpdateDate": "2019-07-14T01:23:45.678Z" } }
3. 後処理¶
完了条件の確認¶
主処理は、以下を満たしたときに成功したものとします。
完了条件1: IAMポリシー"handson-cli-website-https-S3BucketWritePolicy"が存在する。
「IAMポリシー"handson-cli-website-https-S3BucketWritePolicy"が存在する。」ことを確認します。
コマンド:
aws iam list-policies \ --scope Local \ --max-items 1000 \ --query "Policies[?PolicyName == \`${IAM_POLICY_NAME}\`].PolicyName" \ --output text
結果(例):
handson-cli-website-https-S3BucketWritePolicy