2. EC2イメージの作成 (handson-cli-ec2-ami-image-0)

手順の目的 [why]

EC2インスタンス"handson-cli-ec2-ami-builder-instance"からEC2イメージ"handson-cli-ec2-ami-image-0"を作成します。

設定値の指定

設定値の指定

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

0. リージョンの指定

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

環境変数の設定:

export AWS_DEFAULT_REGION='ap-northeast-1'

1. EC2インスタンス名

EC2インスタンス名を指定します。

変数の設定:

EC2_INSTANCE_TAG_NAME='handson-cli-ec2-ami-builder-instance'

2. EC2イメージ名

EC2イメージのプレフィックス名を指定します。

変数の設定:

EC2_IMAGE_PREFIX='handson-cli-ec2-ami-image'

EC2イメージのリビジョンを指定します。

変数の設定:

EC2_IMAGE_REVISION='0'

プレフィクス名とリビジョンを組み合わせてEC2イメージ名を指定します。

変数の設定:

EC2_IMAGE_NAME="${EC2_IMAGE_PREFIX}-${EC2_IMAGE_REVISION}" \
  && echo ${EC2_IMAGE_NAME}

結果(例):

handson-cli-ec2-ami-image-0

3. EC2イメージの説明文

EC2イメージの説明文を指定します。

変数の設定:

EC2_IMAGE_DESCRIPTION='AMI for handson-cli-ec2-ami'

設定値の確認

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

変数の確認:

cat << END

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

  # 1. EC2_INSTANCE_TAG_NAME:"handson-cli-ec2-ami-builder-instance"
       EC2_INSTANCE_TAG_NAME="${EC2_INSTANCE_TAG_NAME}"
  # 2. EC2_IMAGE_NAME:"handson-cli-ec2-ami-image-0"
       EC2_IMAGE_NAME="${EC2_IMAGE_NAME}"
  # 3. EC2_IMAGE_DESCRIPTION:"AMI for handson-cli-ec2-ami"
       EC2_IMAGE_DESCRIPTION="${EC2_IMAGE_DESCRIPTION}"

END

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

処理の実行

EC2インスタンスIDを取得します。

コマンド:

ARRAY_EC2_INSTANCE_IDS=$( \
  aws ec2 describe-instances \
    --filters Name=tag-key,Values=Name \
              Name=tag-value,Values=${EC2_INSTANCE_TAG_NAME} \
    --query Reservations[].Instances[].InstanceId \
    --output text \
) \
  && echo ${ARRAY_EC2_INSTANCE_IDS}

結果(例):

i-xxxxxxxxxxxxxxxxx

注釈

本手順でインスタンスタグ名に対してインスタンスIDは1つしか出力されない前提ですが、念のため先頭のインスタンスIDのみを取得します。

変数の設定:

EC2_INSTANCE_ID=$( \
  echo ${ARRAY_EC2_INSTANCE_IDS} \
    | sed 's/ .*$//' \
) \
  && echo ${EC2_INSTANCE_ID}

結果(例):

i-xxxxxxxxxxxxxxxxx

AMIを作成します。

コマンド:

aws ec2 create-image \
  --instance-id ${EC2_INSTANCE_ID} \
  --name ${EC2_IMAGE_NAME} \
  --description "${EC2_IMAGE_DESCRIPTION}"

結果(例):

{
  "ImageId": "ami-xxxxxxxx"
}

完了確認

「EC2イメージ"handson-cli-ec2-ami-image-0"が存在する。」ことを確認します。

コマンド:

aws ec2 describe-images \
  --filter "Name=name, Values=${EC2_IMAGE_NAME}" \
  --query 'Images[].Name' \
  --output text

結果(例):

handson-cli-ec2-ami-image-0

注釈

イメージが表示されるまで数十秒以上かかります。

「EC2イメージ"handson-cli-ec2-ami-image-0"がavailableである。」ことを確認します。

コマンド:

EC2_IMAGE_STATE=$( \
  aws ec2 describe-images \
    --filters Name=name,Values="${EC2_IMAGE_NAME}" \
    --query "Images[?Name == \`${EC2_IMAGE_NAME}\`].State" \
    --output text \
) \
  && echo ${EC2_IMAGE_STATE}

結果(例):

available

注釈

availableになるまで数十秒以上かかります。

手順の完了