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

1.2. CFnリソースファイルの作成 (S3::BucketPolicy S3BucketPolicy0)

手順の目的 [why]

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

設定値の指定

設定値の指定

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

1. CloudFormationリソース名

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

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME='S3BucketPolicy0'

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

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

変数の設定:

DIR_TEMPLATE_CFN_RESOURCE="${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources"

ディレクトリが存在することを確認します。

コマンド:

ls -d ${DIR_TEMPLATE_CFN_RESOURCE}

結果(例:存在する場合):

${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources

存在しない場合は作成します。

コマンド:

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-s3-bucket-policy/resources/S3BucketPolicy0.txt

4. S3バケットのリソース名

S3バケットのリソース名の指定します。

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET='S3Bucket0'

5. S3バケットポリシードキュメントファイル名

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

変数の設定:

DIR_S3_BUCKET_POLICY_DOC="${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy"

変数の設定:

FILE_S3_BUCKET_POLICY_DOC="${DIR_S3_BUCKET_POLICY_DOC}/${TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET}-s3-bucket-policy.yaml" \
  && echo ${FILE_S3_BUCKET_POLICY_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/S3Bucket0-s3-bucket-policy.yaml

設定値の確認

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

変数の確認:

cat << END

  # 1. TEMPLATE_CFN_RESOURCE_NAME:"S3BucketPolicy0"
       TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # 2. DIR_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources"
       DIR_TEMPLATE_CFN_RESOURCE="${DIR_TEMPLATE_CFN_RESOURCE}"
  # 3. FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources/S3BucketPolicy0.txt"
       FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # 4. TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET:"S3Bucket0"
       TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET="${TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET}"
  # 5. FILE_S3_BUCKET_POLICY_DOC:"${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/S3Bucket0-s3-bucket-policy.yaml"
       FILE_S3_BUCKET_POLICY_DOC="${FILE_S3_BUCKET_POLICY_DOC}"

END

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

処理の実行

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

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources/S3BucketPolicy0.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # TEMPLATE_CFN_RESOURCE_NAME:"S3BucketPolicy0"
    TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET:"S3Bucket0"
    TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET="${TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET}"

END

コマンド:

cat << EOF > ${FILE_TEMPLATE_CFN_RESOURCE}
  ${TEMPLATE_CFN_RESOURCE_NAME}:
    Type: AWS::S3::BucketPolicy
    Properties:
      Bucket: !Ref ${TEMPLATE_CFN_RESOURCE_NAME_S3_BUCKET}
EOF

cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

S3BucketPolicy0:
  Type: AWS::S3::BucketPolicy
  Properties:
    Bucket: !Ref S3Bucket0

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

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources/S3BucketPolicy0.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # FILE_S3_BUCKET_POLICY_DOC:"${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/S3Bucket0-s3-bucket-policy.yaml"
    FILE_S3_BUCKET_POLICY_DOC="${FILE_S3_BUCKET_POLICY_DOC}"

END

コマンド:

if [ ! $( grep 'PolicyDocument:' ${FILE_TEMPLATE_CFN_RESOURCE}) ];then
cat << EOF >> ${FILE_TEMPLATE_CFN_RESOURCE}
      PolicyDocument:
EOF
fi

cat ${FILE_S3_BUCKET_POLICY_DOC} \
  | sed '/^$/d' \
  | sed "s/^/        /" \
  >> ${FILE_TEMPLATE_CFN_RESOURCE}

cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

S3BucketPolicy0:
  Type: AWS::S3::BucketPolicy
  Properties:
    Bucket: !Ref S3Bucket0
    PolicyDocument:
      Version: 2012-10-17
      Statement:
        - Effect: Allow
          Principal: '*'
          Action:
            - 's3:GetObject'
          Resource: !Join
            - ''
            - - 'arn:aws:s3:::'
              - !Ref S3Bucket0
              - /*

完了確認

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

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

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

コマンド:

ls ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-s3-bucket-policy/resources/S3BucketPolicy0.txt

手順の完了