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

1. CFnリソースファイルの作成 (SQS::QueuePolicy SqsQueuePolicy0)

手順の目的

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

設定値の指定

設定値の指定

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

0. リージョンの指定

リージョンを指定します。

環境変数の設定:

export AWS_DEFAULT_REGION='ap-northeast-1'

1. CloudFormationリソース名

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

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME='SqsQueuePolicy0'

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

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

変数の設定:

DIR_TEMPLATE_CFN_RESOURCE="${HOME}/environment/conf-handson-cli-cfn-sqs-QueuePolicy/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-sqs-QueuePolicy/resources/SqsQueuePolicy0.txt

4. SQSキュー名

SQSキュー名を指定します。

変数の設定:

SQS_QUEUE_NAME="handson-cli-cfn-sqs-QueuePolicy-stack"

5. プリンシパルAWS ID

プリンシパルとなるAWS IDを指定します。

変数の設定:

AWS_ID_PRINCIPAL='953640472020'

6. 依存するCloudFormationリソース名

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

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE='SqsQueue0StackName'

設定値の確認

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

変数の確認:

cat << END

  # 0. AWS_DEFAULT_REGION:"ap-northeast-1"
       AWS_DEFAULT_REGION="${AWS_DEFAULT_REGION}"

  # 1. TEMPLATE_CFN_RESOURCE_NAME:"SqsQueuePolicy0"
       TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # 2. DIR_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-sqs-QueuePolicy/resources"
       DIR_TEMPLATE_CFN_RESOURCE="${DIR_TEMPLATE_CFN_RESOURCE}"
  # 3. FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-sqs-QueuePolicy/resources/SqsQueuePolicy0.txt"
       FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # 4. SQS_QUEUE_NAME:"handson-cli-cfn-sqs-QueuePolicy-stack"
       SQS_QUEUE_NAME="${SQS_QUEUE_NAME}"
  # 5. AWS_ID_PRINCIPAL:"953640472020"
       AWS_ID_PRINCIPAL="${AWS_ID_PRINCIPAL}"
  # 6. TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE:"SqsQueue0StackName"
       TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE="${TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE}"

END

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

処理の実行

課題

(未検証)

AWS IDを取得します。

コマンド:

aws_id=$( \
  aws sts get-caller-identity \
    --query 'Account' \
    --output text \
) \
  && echo ${aws_id}

結果(例):

XXXXXXXXXXXX

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

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-sqs-QueuePolicy/resources/SqsQueuePolicy0.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # TEMPLATE_CFN_RESOURCE_NAME:"SqsQueuePolicy0"
    TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # AWS_DEFAULT_REGION:"ap-northeast-1"
    AWS_DEFAULT_REGION="${AWS_DEFAULT_REGION}"
  # aws_id:"XXXXXXXXXXXX"
    aws_id="${aws_id}"
  # AWS_ID_PRINCIPAL:"953640472020"
    AWS_ID_PRINCIPAL="${AWS_ID_PRINCIPAL}"
  # SQS_QUEUE_NAME:"handson-cli-cfn-sqs-QueuePolicy-stack"
    SQS_QUEUE_NAME="${SQS_QUEUE_NAME}"
  # TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE:"SqsQueue0StackName"
    TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE="${TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE}"

END

コマンド:

cat << EOF > ${FILE_TEMPLATE_CFN_RESOURCE}
  ${TEMPLATE_CFN_RESOURCE_NAME}:
    Type: "AWS::SQS::QueuePolicy"
    Properties:
      PolicyDocument:
        Statement:
          -
            Principal:
              AWS:
                - "${AWS_ID_PRINCIPAL}"
            Action:
              - "SQS:SendMessage"
              - "SQS:ReceiveMessage"
            Effect: "Allow"
            Resource: "arn:aws:sqs:${AWS_DEFAULT_REGION}:${aws_id}:${SQS_QUEUE_NAME}"
      Queues:
        - "https://sqs:${AWS_DEFAULT_REGION}.amazonaws.com/${aws_id}/${SQS_QUEUE_NAME}"
    DependsOn: "${TEMPLATE_CFN_RESOURCE_NAME_DEPENDS_ON_QUEUE}"
EOF

cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

SqsQueuePolicy0:
  Type: "AWS::SQS::QueuePolicy"
  Properties:
    PolicyDocument:
      Statement:
        -
          Principal:
            AWS:
              - "953640472020"
          Action:
            - "SQS:SendMessage"
            - "SQS:ReceiveMessage"
          Effect: "Allow"
          Resource: "arn:aws:sqs:ap-northeast-1:XXXXXXXXXXXX:handson-cli-cfn-sqs-QueuePolicy-stack"
    Queues:
      - "https://sqs:ap-northeast-1.amazonaws.com/XXXXXXXXXXXX/handson-cli-cfn-sqs-QueuePolicy-stack"
  DependsOn: "SqsQueue0StackName"

完了確認

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

コマンド:

ls ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-sqs-QueuePolicy/resources/SqsQueuePolicy0.txt

手順の完了