ハンズオン(簡易版): CFnテンプレート入門(IAM::ManagedPolicy)

1.2. CFnリソースファイルの作成 (IAM::ManagedPolicy 名前指定: Policy0Named)

手順の目的

リソース(Policy0Named)のCloudFormationリソースファイルを作成します。

設定値の指定

設定値の指定

手順に必要な設定値を変数に格納をします。

1. CloudFormationリソース名

CloudFormationリソース名を指定します。

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME='Policy0Named'

2. リソースファイル用ディレクトリ

リソースファイル用ディレクトリを指定します。

変数の設定:

DIR_TEMPLATE_CFN_RESOURCE="${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources"

ディレクトリが存在することを確認し、存在しない場合は作成します。

コマンド:

ls -d ${DIR_TEMPLATE_CFN_RESOURCE} > /dev/null 2>&1 \
  || mkdir -p ${DIR_TEMPLATE_CFN_RESOURCE}

結果(例):

(出力なし)

3. リソースファイル名

リソースファイル名を指定します。

変数の設定:

FILE_TEMPLATE_CFN_RESOURCE="${DIR_TEMPLATE_CFN_RESOURCE}/${TEMPLATE_CFN_RESOURCE_NAME}.txt" \
  && echo ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources/Policy0Named.txt

4. IAMポリシーパス

IAMポリシーパスを指定します。

変数の設定:

IAM_POLICY_PATH='/handson-cli/'

5. IAMポリシーの説明

IAMポリシーの説明を指定します。

変数の設定:

IAM_POLICY_DESCRIPTION='Policy for handson-cli-cfn-iam-ManagedPolicy.'

6. IAMポリシー名

IAMポリシー名を指定します。

変数の設定:

IAM_POLICY_NAME='handson-cli-cfn-iam-ManagedPolicy-policy'

7. ポリシードキュメントファイル名

ポリシードキュメント用ディレクトリを指定します。

変数の設定:

DIR_IAM_POLICY_DOC="${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy"

IAMポリシードキュメント名を指定します。

変数の設定:

IAM_POLICY_DOC_NAME='handson-cli-cfn-iam-ManagedPolicy-policy'

ポリシードキュメントファイル名を指定します。

変数の設定:

FILE_IAM_POLICY_DOC="${DIR_IAM_POLICY_DOC}/${IAM_POLICY_DOC_NAME}.json" \
  && echo ${FILE_IAM_POLICY_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/handson-cli-cfn-iam-ManagedPolicy-policy.json

設定値の確認

各変数に正しい設定値が格納されていることを確認しながら保存します。

変数の確認:

cat << END

  # 1. TEMPLATE_CFN_RESOURCE_NAME:"Policy0Named"
       TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # 2. DIR_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources"
       DIR_TEMPLATE_CFN_RESOURCE="${DIR_TEMPLATE_CFN_RESOURCE}"
  # 3. FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources/Policy0Named.txt"
       FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # 4. IAM_POLICY_DESCRIPTION:"Policy for handson-cli-cfn-iam-ManagedPolicy."
       IAM_POLICY_DESCRIPTION="${IAM_POLICY_DESCRIPTION}"
  # 5. IAM_POLICY_PATH:"/handson-cli/"
       IAM_POLICY_PATH="${IAM_POLICY_PATH}"
  # 6. IAM_POLICY_NAME:"handson-cli-cfn-iam-ManagedPolicy-policy"
       IAM_POLICY_NAME="${IAM_POLICY_NAME}"
  # 7. FILE_IAM_POLICY_DOC:"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/handson-cli-cfn-iam-ManagedPolicy-policy.json"
       FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}"

END

下段の変数が入っていない、もしくは上段と同等の値が入っていない場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行

CFnリソースファイルを作成します。

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources/Policy0Named.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # TEMPLATE_CFN_RESOURCE_NAME:"Policy0Named"
    TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # IAM_POLICY_DESCRIPTION:"Policy for handson-cli-cfn-iam-ManagedPolicy."
    IAM_POLICY_DESCRIPTION="${IAM_POLICY_DESCRIPTION}"
  # IAM_POLICY_PATH:"/handson-cli/"
    IAM_POLICY_PATH="${IAM_POLICY_PATH}"
  # IAM_POLICY_NAME:"handson-cli-cfn-iam-ManagedPolicy-policy"
    IAM_POLICY_NAME="${IAM_POLICY_NAME}"

END

コマンド:

cat << EOF > ${FILE_TEMPLATE_CFN_RESOURCE}
  ${TEMPLATE_CFN_RESOURCE_NAME}:
    Type: AWS::IAM::ManagedPolicy
    Properties:
      Description: ${IAM_POLICY_DESCRIPTION}
      ManagedPolicyName: ${IAM_POLICY_NAME}
      Path: ${IAM_POLICY_PATH}
      PolicyDocument:
EOF
cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

Policy0Named:
  Type: AWS::IAM::ManagedPolicy
  Properties:
    Description: Policy for handson-cli-cfn-iam-ManagedPolicy.
    ManagedPolicyName: handson-cli-cfn-iam-ManagedPolicy-policy
    Path: /handson-cli/
    PolicyDocument:

ポリシードキュメント部分を追記します。

変数の確認:

cat << END

  # FILE_IAM_POLICY_DOC:"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/handson-cli-cfn-iam-ManagedPolicy-policy.json"
    FILE_IAM_POLICY_DOC="${FILE_IAM_POLICY_DOC}"

END

コマンド:

cat ${FILE_IAM_POLICY_DOC} \
  | python -c \
    "import yaml; import json; import sys; \
     print(yaml.dump(json.load(sys.stdin)))\
    " \
  | sed '/^$/d' \
  | sed "s/^/        /" \
  >> ${FILE_TEMPLATE_CFN_RESOURCE}

cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

Policy0Named:
  Type: AWS::IAM::ManagedPolicy
  Properties:
    Description: Policy for handson-cli-cfn-iam-ManagedPolicy.
    ManagedPolicyName: handson-cli-cfn-iam-ManagedPolicy-policy
    Path: /handson-cli/
    PolicyDocument:
      Statement:
      - Action:
        - iam:ListUsers
        Effect: Allow
        Resource: '*'
        Sid: Stmt1627200627607
      Version: '2012-10-17'

完了確認

本手順の主処理は、以下の完了条件を満たしたときに成功したものとします。

完了条件1: リソースファイル"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources/Policy0Named.txt"が存在する。

「リソースファイル"${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources/Policy0Named.txt"が存在する。」ことを確認します。

コマンド:

ls ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-iam-ManagedPolicy/resources/Policy0Named.txt

手順の完了