2. CodeDeployデプロイメントグループの作成 (handson-cli-deploy-dg)¶
作業の目的 [why]¶
CodeDeployアプリケーション名"handson-cli-deploy-app"にデプロイメントグループ"handson-cli-deploy-dg"を作成します。
完了条件/事前条件 [設計者用情報]
完了条件 [after]
主処理は、以下を満たしたときに成功したものとします。
- 完了条件1
- CodeDeployアプリケーション>名"handson-cli-deploy-app"にCodeDeployデプロイメントグループ名"handson-cli-deploy-dg"が存在する。
事前条件 [before]
主処理の実施は、以下の状態であることを前提とします。
- 事前条件1
- CodeDeployアプリケーション名"handson-cli-deploy-app"が存在する。
- 事前条件2
- CodeDeployアプリケーション>名"handson-cli-deploy-app"にCodeDeployデプロイメントグループ名"handson-cli-deploy-dg"が存在しない。
作業対象 [what]¶
- CodeDeployサービス
標準時間(合計)¶
8分
パラメータ設定¶
パラメータ設定の標準時間: | 2分 |
---|
作業に必要なモノ・情報 [resource]¶
作業開始には、以下が全て揃っていることが必要です。
リソース1: CodeDeployアプリケーション名
- デプロイメントグループを作成するCodeDeployアプリケーションの名称です。
- 今回は"handson-cli-deploy-app"とします。
リソース2: CodeDeployデプロイメントグループ名
- 作成するCodeDeployデプロイメントグループの名称です。
- 今回は"handson-cli-deploy-dg"とします。
リソース3: IAMロール名
- 作成するCodeDeployデプロイメントグループが利用するIAMロールの名称です。
- 今回は"AWSCodeDeployRole-role"とします。
リソース4: AutoScalingグループ名
- 作成するCodeDeployデプロイメントグループが利用するAutoScalingグループの名称です。
- 今回は"handson-cli-deploy-ag"とします。
パラメータの指定¶
作業に必要なパラメータを変数に格納をします。
0.1. CodeDeployアプリケーション名の指定¶
CodeDeployアプリケーション名を指定します。
変数の設定:
CODED_APP_NAME='handson-cli-deploy-app'
0.2. CodeDeployデプロイメントグループ名の指定¶
CodeDeployデプロイメントグループ名を指定します。
変数の設定:
CODED_DEPLOY_GROUP_NAME='handson-cli-deploy-dg'
パラメータの保存¶
設定されている変数の保存先となるファイル名を指定します。
変数の設定:
DIR_PARAMETER="${HOME}/tmp/parameter-handson-cli" FILE_PARAMETER="${DIR_PARAMETER}/$(date +%Y-%m-%d)-deploy-deployment_group-create-expand-autoscaling.env" \ && echo ${FILE_PARAMETER}
結果(例):
${HOME}/tmp/parameter-handson-cli/2019-04-30-deploy-deployment_group-create-expand-autoscaling.env
各変数に正しいパラメータ値が格納されていることを確認しながら保存します。
変数の確認:
cat << EOF > ${FILE_PARAMETER} # 0.0. AWS_DEFAULT_REGION:"ap-northeast-1" AWS_DEFAULT_REGION="${AWS_DEFAULT_REGION}" # 0.1. CODED_APP_NAME:"handson-cli-deploy-app" CODED_APP_NAME="${CODED_APP_NAME}" # 0.2. CODED_DEPLOY_GROUP_NAME:"handson-cli-deploy-dg" CODED_DEPLOY_GROUP_NAME="${CODED_DEPLOY_GROUP_NAME}" # 0.3. IAM_ROLE_NAME:"AWSCodeDeployRole-role" IAM_ROLE_NAME="${IAM_ROLE_NAME}" # 0.4. AS_GROUP_NAME:"handson-cli-deploy-ag" AS_GROUP_NAME="${AS_GROUP_NAME}" EOF cat ${FILE_PARAMETER}
下段の変数が入っていない、もしくは上段と同等の値が入っていない場合は、それぞれの手順番号に戻って変数の設定を行います。
タスクの実施¶
タスク標準時間: | 6分 |
---|
1. 前処理¶
1.1. 処理対象の状態確認¶
主処理の実施は、以下の状態であることを前提とします。
前提と異なることが判明した場合、直ちに処理を中止します。
事前条件1: CodeDeployアプリケーション名"handson-cli-deploy-app"が存在する。
「CodeDeployアプリケーション名"handson-cli-deploy-app"が存在する。」ことを確認します。
コマンド:
aws deploy get-application \ --application-name ${CODED_APP_NAME} \ --query 'application.applicationName' \ --output text
結果(例):
handson-cli-deploy-app
事前条件2: CodeDeployアプリケーション>名"handson-cli-deploy-app"にCodeDeployデプロイメントグループ名"handson-cli-deploy-dg"が存在しない。
「CodeDeployアプリケーション>名"handson-cli-deploy-app"にCodeDeployデプロイメントグループ名"handson-cli-deploy-dg"が存在しない。」ことを確認します。
コマンド:
! aws deploy get-deployment-group \ --application-name ${CODED_APP_NAME} \ --deployment-group-name ${CODED_DEPLOY_GROUP_NAME} \ --query 'deploymentGroupInfo.deploymentGroupName' \ --output text
結果(例):
An error occurred (DeploymentGroupDoesNotExistException) when calling the GetDeploymentGroup operation: No Deployment Group found for name: handson-cli-deploy-dg
1.2. 主処理に必要な情報の取得¶
IAMロールのARN取得
コマンド:
IAM_ROLE_ARN=$( \ aws iam get-role \ --role-name ${IAM_ROLE_NAME} \ --query 'Role.Arn' \ --output text \ ) \ && echo ${IAM_ROLE_ARN}
結果(例):
arn:aws:iam::XXXXXXXXXXXX:role/AWSCodeDeployRole-role
ASグループの配列作成
変数の設定:
ARRAY_AS_GROUPS="${AS_GROUP_NAME}" \ && echo ${ARRAY_AS_GROUPS}
結果(例):
handson-cli-deploy-ag
2. 主処理¶
CodeDeployデプロイメントグループの作成¶
変数の確認:
cat << ETX # CODED_APP_NAME:"handson-cli-deploy-app" CODED_APP_NAME:"${CODED_APP_NAME}" # CODED_DEPLOY_GROUP_NAME:"handson-cli-deploy-dg" CODED_DEPLOY_GROUP_NAME:"${CODED_DEPLOY_GROUP_NAME}" # IAM_ROLE_ARN:"arn:aws:iam::XXXXXXXXXXXX:role/AWSCodeDeployRole-role" IAM_ROLE_ARN:"${IAM_ROLE_ARN}" # ARRAY_AS_GROUPS:"handson-cli-deploy-ag" ARRAY_AS_GROUPS:"${ARRAY_AS_GROUPS}" ETX
コマンド:
aws deploy create-deployment-group \ --application-name ${CODED_APP_NAME} \ --deployment-group-name ${CODED_DEPLOY_GROUP_NAME} \ --service-role-arn ${IAM_ROLE_ARN} \ --auto-scaling-groups ${ARRAY_AS_GROUPS}
結果(例):
{ "deploymentGroupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" }
3. 後処理¶
完了条件の確認¶
主処理は、以下を満たしたときに成功したものとします。
完了条件1: CodeDeployアプリケーション>名"handson-cli-deploy-app"にCodeDeployデプロイメントグループ名"handson-cli-deploy-dg"が存在する。
「CodeDeployアプリケーション>名"handson-cli-deploy-app"にCodeDeployデプロイメントグループ名"handson-cli-deploy-dg"が存在する。」ことを確認します。
コマンド:
aws deploy get-deployment-group \ --application-name ${CODED_APP_NAME} \ --deployment-group-name ${CODED_DEPLOY_GROUP_NAME} \ --query 'deploymentGroupInfo.deploymentGroupName' \ --output text
結果(例):
handson-cli-deploy-dg