チュートリアル: データスクリプトとインスタンスメタデータを使用してライフサイクル状態を取得する

IAM コンソールの [ポリシーページ] を開き、[ポリシーの作成] を選択します。

[JSON] タブを選択します。

[Policy Document] (ポリシードキュメント) ボックスで、以下のポリシードキュメントをコピーし、ボックスに貼り付けます。sample text を、お使いのアカウント番号と、作成する Auto Scaling グループの名前 (TestAutoScalingEvent-group) に置き換えます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "autoscaling:CompleteLifecycleAction"
      ],
      "Resource": "arn:aws:autoscaling:*:123456789012:autoScalingGroup:*:autoScalingGroupName/TestAutoScalingEvent-group"
    }
  ]
}

[Next] を選択します。

[ポリシー名] に「TestAutoScalingEvent-policy」と入力します。[Create policy] を選択します。

左側のナビゲーションペインで、[Roles] を選択します。

[ロールの作成] を選択します。

[Select trusted entity] (信頼されたエンティティの選択) で、[AWS のサービス] を選択します。

ユースケースに [EC2] を選択してから、[Next] (次へ) を選択します。

[Add permissions] (許可を追加) で、作成したポリシー ([TestAutoScalingEvent-policy]) を選択します。[次へ] を選択します。

[Name, review, and create] (名前、確認、および作成) ページで、[Role name] (ロール名) に TestAutoScalingEvent-role を入力し、[Create role] (ロールを作成) を選択します。

Amazon EC2 コンソールの起動テンプレートページを開きます。

[起動テンプレートの作成] を選択します。

[起動テンプレート名] を使用する場合、TestAutoScalingEvent-template を入力します。

[Auto Scaling ガイダンス] で、チェックボックスを選択します。

[アプリケーションおよび OS イメージ (Amazon マシンイメージ)] で、[クイックスタート] から Amazon Linux 2 (HVM)、SSD Volume Type、64 ビット (x86) を選択します。

[Instance type] (インスタンスタイプ) には、Amazon EC2 インスタンスのタイプ (「t2.micro」など) を選択します。

[詳細設定] を使用する場合、セクションを展開してフィールドを表示します。

[IAM instance profile] (IAM インスタンスプロファイル) で、IAM ロールの IAM インスタンスプロファイル名を選択します (TestAutoScalingEvent-role)。インスタンスプロファイルは IAM ロールのコンテナであり、インスタンスの起動時に Amazon EC2 インスタンスに IAM ロール情報を渡すために使用できます。

IAM コンソールを使用して IAM ロールを作成すると、コンソールが対応するロールと同じ名前を使用したインスタンスプロファイルを自動的に作成します。

[User data] (ユーザーデータ) では、以下のサンプルユーザーデータスクリプトをコピーして、フィールドに貼り付けます。group_name のサンプルテキストは、作成する Auto Scaling グループの名前に置き換え、region は、Auto Scaling グループが使用する AWS リージョンに置き換えます。

#!/bin/bash

function get_target_state {
    echo $(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
}

function get_instance_id {
    echo $(curl -s http://169.254.169.254/latest/meta-data/instance-id)
}

function complete_lifecycle_action {
    instance_id=$(get_instance_id)
    group_name='TestAutoScalingEvent-group'
    region='us-west-2'
 
    echo $instance_id
    echo $region
    echo $(aws autoscaling complete-lifecycle-action \
      --lifecycle-hook-name TestAutoScalingEvent-hook \
      --auto-scaling-group-name $group_name \
      --lifecycle-action-result CONTINUE \
      --instance-id $instance_id \
      --region $region)
}

function main {
    while true
    do
        target_state=$(get_target_state)
        if [ \"$target_state\" = \"InService\" ]; then
            # Change hostname
            export new_hostname="${group_name}-$instance_id"
            hostname $new_hostname
            # Send callback
            complete_lifecycle_action
            break
        fi
        echo $target_state
        sleep 5
    done
}

main

このシンプルなユーザーデータスクリプトは、以下を実行します。

[起動テンプレートの作成] を選択します。

確認ページで、[Auto Scaling グループの作成] を選択します。

[Choose launch template or configuration] (起動テンプレートまたは起動設定を選択する) ページで、[Auto Scaling group name] (Auto Scaling グループ名) に Auto Scaling グループの名前 (TestAutoScalingEvent-group) を入力します。

[Next] (次へ) を選択して、[Choose instance launch options] (インスタンス起動オプションを選択) ページに進みます。

[Network] (ネットワーク) で VPC を選択します。

[Availability Zones and subnets] (アベイラビリティーゾーンとサブネット) で、1 つ、または複数のアベイラビリティーゾーンから 1 つ、または複数のサブネットを選択します。

[Instance type requirements] (インスタンスタイプの要件) セクションでは、このステップを簡略化するためにデフォルト設定を使用します。(起動テンプレートを上書きしないでください。) このチュートリアルでは、起動テンプレートで指定されたインスタンスタイプを使用して、オンデマンドインスタンスを 1 つだけ起動します。

画面の最下部にある [Skip to review] (スキップして確認) を選択します。

[Review] (確認) ページで Auto Scaling グループの詳細を確認してから、[Create Auto Scaling group] (Auto Scaling グループを作成) を選択します。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

Auto Scaling グループの横にあるチェックボックスを選択します。ページの下部にスプリットペインが開きます。

下部のペインで、[Instance management (インスタンス管理)] タブの [Lifecycle hooks (ライフサイクルフック)] で、[Create lifecycle hook (ライフサイクルフックを作成)] を選択します。

スケールアウト (インスタンスが起動) のライフサイクルフックを定義するには、以下を実行してください。

1. [ライフサイクルフック名] で、TestAutoScalingEvent-hookを入力します。

2. [Lifecycle transition (ライフサイクルの移行)] で、[Instance launch (インスタンスの起動)] を選択します。

3. [Heartbeat timeout] (ハートビートタイムアウト) に、ユーザーデータスクリプトからのコールバックを待つ秒数として 300 を入力します。

4. [デフォルトの結果] で、[中止] を選択します。フックがユーザーデータスクリプトからのコールバックを受け取ることなくタイムアウトすると、Auto Scaling グループは新しいインスタンスを終了します。

5. (オプション) [Notification metadata] (通知メタデータ) を空のままにしておきます。

[Create] (作成) を選択します。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

Auto Scaling グループの横にあるチェックボックスを選択します。上部ペインの最上部の行が見えている状態で、下部ペインの詳細を確認します。

下部のペインの [詳細] タブで、[グループの詳細] 、[編集] を順に選択します。

[Desired capacity (希望するキャパシティ)] の場合は、現在の値を 1 ずつ増やします。

[Update] (更新) を選択します。インスタンスの起動中は、上部ペインの [Status (ステータス)] 列に [Updating capacity (キャパシティの更新)] というステータスが表示されます。

[Auto Scaling グループ] ページに戻り、グループを選択します。

[アクティビティ] タブの [アクティビティ履歴] では、[ステータス] 列に、Auto Scaling グループがインスタンスを正常に起動したかどうかが表示されます。

ユーザーデータスクリプトが失敗した場合は、タイムアウト期間が過ぎたときに、ステータスが Canceled のスケーリングアクティビティと、Instance failed to complete user's Lifecycle Action: Lifecycle Action with token e85eb647-4fe0-4909-b341-a6c42EXAMPLE was abandoned: Lifecycle Action Completed with ABANDON Result のステータスメッセージが表示されます。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

Auto Scaling グループの横にあるチェックボックスを選択します。

[Instance management (インスタンス管理)] タブの [Lifecycle hooks (ライフサイクルフック)] で、[lifecycle hook (ライフサイクルフック)] を選択します。(TestAutoScalingEvent-hook)

[アクション]、[削除] の順に選択します。

確認のために、もう一度 [削除] を選択します。

Amazon EC2 コンソールの起動テンプレートページを開きます。

起動テンプレート (TestAutoScalingEvent-template) を選択してから、[Actions] (アクション)、[Delete template] (テンプレートを削除) の順に選択します。

確認を求められたら、Delete を入力して指定した起動テンプレートの削除を確認し、[Delete] (削除) を選択します。

Amazon EC2 コンソールで Auto Scaling グループのページを開きます。

Auto Scaling グループ (TestAutoScalingEvent-group) の横にあるチェックボックスをオンにして、[Delete] (削除) を選択します。

確認を求められたら、delete を入力して指定された Auto Scaling グループの削除を確認し、[Delete] (削除) を選択します。

[Name (名前)] 列のロードアイコンに、Auto Scaling グループが削除されたことが示されます。インスタンスを終了してグループを削除するには数分かかります。

IAM コンソールの [Roles (ロール)] ページを開きます。

関数のロール (TestAutoScalingEvent-role) を選択します。

[削除] を選択します。

確認を求められたら、ロールの名前を入力し、[Delete] (削除) を選択します。

IAM コンソールのポリシーページを開きます。

作成したポリシーを選択します。(TestAutoScalingEvent-policy)

[アクション]、[削除] の順に選択します。

確認を求められたら、ポリシーの名前を入力し、[Delete] (削除) を選択します。