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

1. CFnリソースファイルの作成 (IAM::ServiceLinkedRole CustomSuffix指定: ServiceLinkedRole0)

手順の目的

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

設定値の指定

設定値の指定

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

1. CloudFormationリソース名

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

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME='ServiceLinkedRole0'

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

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

変数の設定:

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

4. サービスにリンクされたIAMロールを利用するサービスの名称

サービスにリンクされたIAMロールを利用するサービスの名称を指定します。

変数の設定:

IAM_SERVICE_LINKED_ROLE_SERVICE_NAME='autoscaling.amazonaws.com'

5. サービスにリンクされたIAMロールの説明

サービスにリンクされたIAMロールの説明を指定します。

変数の設定:

IAM_SERVICE_LINKED_ROLE_DESCRIPTION='Service Linked Role for autoscaling.'

6. サービスにリンクされたIAMロールのカスタムサフィックス

サービスにリンクされたIAMロールのカスタムサフィックスを指定します。

変数の設定:

IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX='handson-cli-cfn-iam-servicelinkrole'

設定値の確認

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

変数の確認:

cat << END

  # 1. TEMPLATE_CFN_RESOURCE_NAME:"ServiceLinkedRole0"
       TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # 2. DIR_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-iam-servicelinkrole/resources"
       DIR_TEMPLATE_CFN_RESOURCE="${DIR_TEMPLATE_CFN_RESOURCE}"
  # 3. FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-iam-servicelinkrole/resources/ServiceLinkedRole0.txt"
       FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # 4. IAM_SERVICE_LINKED_ROLE_SERVICE_NAME:"autoscaling.amazonaws.com"
       IAM_SERVICE_LINKED_ROLE_SERVICE_NAME="${IAM_SERVICE_LINKED_ROLE_SERVICE_NAME}"
  # 5. IAM_SERVICE_LINKED_ROLE_DESCRIPTION:"Service Linked Role for autoscaling."
       IAM_SERVICE_LINKED_ROLE_DESCRIPTION="${IAM_SERVICE_LINKED_ROLE_DESCRIPTION}"
  # 6. IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX:"handson-cli-cfn-iam-servicelinkrole"
       IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX="${IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX}"

END

各変数について、上の行と下の行の値の内容もしくは形式が同じであることを確認します。 もし異なる場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行

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

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-iam-servicelinkrole/resources/ServiceLinkedRole0.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # TEMPLATE_CFN_RESOURCE_NAME:"ServiceLinkedRole0"
    TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # IAM_SERVICE_LINKED_ROLE_SERVICE_NAME:"autoscaling.amazonaws.com"
    IAM_SERVICE_LINKED_ROLE_SERVICE_NAME="${IAM_SERVICE_LINKED_ROLE_SERVICE_NAME}"
  # IAM_SERVICE_LINKED_ROLE_DESCRIPTION:"Service Linked Role for autoscaling."
    IAM_SERVICE_LINKED_ROLE_DESCRIPTION="${IAM_SERVICE_LINKED_ROLE_DESCRIPTION}"
  # IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX:"handson-cli-cfn-iam-servicelinkrole"
    IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX="${IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX}"

END

コマンド:

cat << EOF > ${FILE_TEMPLATE_CFN_RESOURCE}
  ${TEMPLATE_CFN_RESOURCE_NAME}:
    Type: AWS::IAM::ServiceLinkedRole
    Properties: 
      AWSServiceName: ${IAM_SERVICE_LINKED_ROLE_SERVICE_NAME}
      Description: ${IAM_SERVICE_LINKED_ROLE_DESCRIPTION}
      CustomSuffix: ${IAM_SERVICE_LINKED_ROLE_CUSTOM_SUFFIX}

EOF
cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

ServiceLinkedRole0:
  Type: AWS::IAM::ServiceLinkedRole
  Properties:
    AWSServiceName: autoscaling.amazonaws.com
    Description: Service Linked Role for autoscaling.
    CustomSuffix: handson-cli-cfn-iam-servicelinkrole

完了確認

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

コマンド:

ls ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-iam-servicelinkrole/resources/ServiceLinkedRole0.txt

手順の完了