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

1.2. CFnリソースファイルの作成 (Lambda::Function スタック名指定/インライン LambdaFunction0)

手順の目的 [why]

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

設定値の指定

設定値の指定

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

1. CloudFormationリソース名

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

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME='LambdaFunction0'

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

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

変数の設定:

DIR_TEMPLATE_CFN_RESOURCE="${HOME}/environment/conf-handson-cli-cfn-lambda-Function/resources"

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

コマンド:

ls -d ${DIR_TEMPLATE_CFN_RESOURCE}

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

${HOME}/environment/conf-handson-cli-cfn-lambda-Function/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-lambda-Function/resources/LambdaFunction0.txt

4. Lambda関数の説明

Lambda関数の説明を指定します。

変数の設定:

LAMBDA_FUNCTION_DESCRIPTION='Stack for handson-cli iam novice role.'

5. Lambda関数のハンドラー名

Lambda関数のハンドラー名を指定します。

変数の設定:

LAMBDA_FUNCTION_HANDLER='index.lambda_handler'

6. Lambda関数のランタイム名

Lambda関数のランタイム名を指定します。

変数の設定:

LAMBDA_FUNCTION_RUNTIME='python3.8'

7. IAMロールリソース名

IAMロール名を指定します。

変数の設定:

TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE="Role0"

8. Lambda関数コードファイル名

Lambda関数コードファイル名を指定します。

変数の設定:

DIR_LAMBDA_FUNCTION_CODE="${HOME}/environment/conf-handson-cli-cfn-lambda-Function"

変数の設定:

LAMBDA_FUNCTION_CODE_NAME='handson-cli-cfn-lambda-Function.py'

変数の設定:

FILE_LAMBDA_FUNCTION_CODE="${DIR_LAMBDA_FUNCTION_CODE}/${LAMBDA_FUNCTION_CODE_NAME}" \
  && echo ${FILE_LAMBDA_FUNCTION_CODE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-lambda-Function/handson-cli-cfn-lambda-Function.py

設定値の確認

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

変数の確認:

cat << END

  # 1. TEMPLATE_CFN_RESOURCE_NAME:"LambdaFunction0"
       TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # 2. DIR_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-lambda-Function/resources"
       DIR_TEMPLATE_CFN_RESOURCE="${DIR_TEMPLATE_CFN_RESOURCE}"
  # 3. FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-lambda-Function/resources/LambdaFunction0.txt"
       FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # 4. LAMBDA_FUNCTION_DESCRIPTION:"Stack for handson-cli iam novice role."
       LAMBDA_FUNCTION_DESCRIPTION="${LAMBDA_FUNCTION_DESCRIPTION}"
  # 5. LAMBDA_FUNCTION_HANDLER:"index.lambda_handler"
       LAMBDA_FUNCTION_HANDLER="${LAMBDA_FUNCTION_HANDLER}"
  # 6. LAMBDA_FUNCTION_RUNTIME:"python3.8"
       LAMBDA_FUNCTION_RUNTIME="${LAMBDA_FUNCTION_RUNTIME}"
  # 7. TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE:"Role0"
       TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE="${TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE}"
  # 8. FILE_LAMBDA_FUNCTION_CODE:"${HOME}/environment/conf-handson-cli-cfn-lambda-Function/handson-cli-cfn-lambda-Function.py"
       FILE_LAMBDA_FUNCTION_CODE="${FILE_LAMBDA_FUNCTION_CODE}"

END

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

処理の実行

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

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-lambda-Function/resources/LambdaFunction0.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # TEMPLATE_CFN_RESOURCE_NAME:"LambdaFunction0"
    TEMPLATE_CFN_RESOURCE_NAME="${TEMPLATE_CFN_RESOURCE_NAME}"
  # LAMBDA_FUNCTION_DESCRIPTION:"Stack for handson-cli iam novice role."
    LAMBDA_FUNCTION_DESCRIPTION="${LAMBDA_FUNCTION_DESCRIPTION}"
  # LAMBDA_FUNCTION_HANDLER:"index.lambda_handler"
    LAMBDA_FUNCTION_HANDLER="${LAMBDA_FUNCTION_HANDLER}"
  # LAMBDA_FUNCTION_RUNTIME:"python3.8"
    LAMBDA_FUNCTION_RUNTIME="${LAMBDA_FUNCTION_RUNTIME}"
  # TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE:"Role0"
    TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE="${TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE}"

END

コマンド:

cat << EOF > ${FILE_TEMPLATE_CFN_RESOURCE}
  ${TEMPLATE_CFN_RESOURCE_NAME}:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: !Ref AWS::StackName
      Description: ${LAMBDA_FUNCTION_DESCRIPTION}
      Handler: ${LAMBDA_FUNCTION_HANDLER}
      Runtime: ${LAMBDA_FUNCTION_RUNTIME}
      Role: !GetAtt ${TEMPLATE_CFN_RESOURCE_NAME_IAM_ROLE}.Arn
      Code:
        ZipFile: |
EOF
cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

LambdaFunction0:
  Type: AWS::Lambda::Function
  Properties:
    FunctionName: !Ref AWS::StackName
    Description: Stack for handson-cli iam novice role.
    Handler: index.lambda_handler
    Runtime: python3.8
    Role: !Ref Role0
    Code:
      ZipFile: |

Lambda関数をインラインで記述します。

変数の確認:

cat << END

  # FILE_TEMPLATE_CFN_RESOURCE:"${HOME}/environment/conf-handson-cli-cfn-lambda-Function/resources/LambdaFunction0.txt"
    FILE_TEMPLATE_CFN_RESOURCE="${FILE_TEMPLATE_CFN_RESOURCE}"
  # FILE_LAMBDA_FUNCTION_CODE:"${HOME}/environment/conf-handson-cli-cfn-lambda-Function/handson-cli-cfn-lambda-Function.py"
    FILE_LAMBDA_FUNCTION_CODE="${FILE_LAMBDA_FUNCTION_CODE}"

END

コマンド:

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

cat ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

LambdaFunction0:
  Type: AWS::Lambda::Function
  Properties:
    FunctionName: !Ref AWS::StackName
    Description: Stack for handson-cli iam novice role.
    Handler: index.lambda_handler
    Runtime: python3.8
    Role: !Ref Role0
    Code:
      ZipFile: |
        import os
        def lambda_handler(event, context):
          print('## ENVIRONMENT VARIABLES')
          print(os.environ)
          print('## EVENT')
          print(event)
          message = 'Hello Lambda World!'
          print(message)
          return message

完了確認

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

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

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

コマンド:

ls ${FILE_TEMPLATE_CFN_RESOURCE}

結果(例):

${HOME}/environment/conf-handson-cli-cfn-lambda-Function/resources/LambdaFunction0.txt

手順の完了