Auto Scaling:Automatically add ECS instances to or remove them from the whitelist of a MongoDB instance

ポリシーの作成

1. RAM コンソールにログインします。

2. 左側のナビゲーションウィンドウで、[権限] > [ポリシー] を選択します。

3. [ポリシーの作成] をクリックします。

4. [ポリシーの作成] ページで、[JSON] タブをクリックし、次のポリシードキュメントを入力して、[OK] をクリックします。

   パラメーター	値
   名前	ESSHookPolicyForMongoDBWhitelist
   ポリシードキュメント	以下の JSON を参照

   {
       "Version": "1",
       "Statement": [
           {
               "Action": [
                   "ecs:DescribeInstances"
               ],
               "Resource": "*",
               "Effect": "Allow"
           },
           {
               "Action": [
                   "dds:ModifySecurityIps"
               ],
               "Resource": "*",
               "Effect": "Allow"
           },
           {
               "Action": [
                   "ess:CompleteLifecycleAction"
               ],
               "Resource": "*",
               "Effect": "Allow"
           }
       ]
   }

OOSServiceRole にポリシーをアタッチする

1. 左側のナビゲーションウィンドウで、ID > ロール を選択します。

2. 「OOSServiceRole」を見つけ、[権限の付与] を [操作] 列でクリックします。

3. [権限の付与] パネルで、次の設定を構成し、[権限を付与] をクリックします。

   パラメーター	値
   リソーススコープ	アカウント
   ポリシー	ESSHookPolicyForMongoDBWhitelist

ライフサイクルフックの作成

1. Auto Scaling コンソールにログインします。

2. 左側のナビゲーションウィンドウで、[スケーリンググループ] をクリックします。

3. 上部のナビゲーションバーで、Auto Scaling がアクティブ化されているリージョンを選択します。

4. スケーリンググループを見つけ、[スケーリンググループ名/ID] 列のその ID をクリックするか、[操作] 列の [詳細] をクリックします。

5. スケーリンググループの詳細ページで、[ライフサイクルフック] タブをクリックします。

6. [ライフサイクルフックの作成] をクリックします。

7. 以下のパラメーターを設定し、[OK] をクリックします。

   パラメーター	値
   名前	ESSHookForAddMongoDBWhitelist
   スケーリングアクティビティ	スケールアウトイベント
   タイムアウト期間	OOS によるホワイトリスト更新の完了に十分な時間を設定します。本例では 300 秒を指定しています。タイムアウトが発生した時点で OOS の処理が完了していない場合、ライフサイクルアクションはデフォルトで 続行 となり、IP アドレスが追加されない状態でインスタンスが起動します。
   デフォルト実行ポリシー	続行
   ライフサイクルフックの有効化時に通知を送信	OOS テンプレート > パブリックテンプレート > LifeCycleModifyMongoDBIPWhitelist
   dbInstanceId	ご利用の MongoDB インスタンスの ID（本例ではレプリカセットインスタンスを使用）
   modifyMode	Append
   OOSAssumeRole	OOSServiceRole

スケーリンググループにすでに ECS インスタンスが含まれている場合は、この自動化を有効にする前に、それらのプライベート IP アドレスを MongoDB ホワイトリストに手動で追加します。スケールインイベントが実行されたときにそれらの IP がホワイトリストにない場合、削除ステップは失敗します。

スケールアウトイベントをトリガーする

この例では、スケーリングルールを手動で実行してスケールアウトをトリガーします。本番環境では通常、スケジュールされたタスクまたは監視タスクを使用します。

1. スケーリンググループの詳細ページで、[スケーリングルールとイベントトリガータスク] タブをクリックします。

2. [スケーリングルール] タブで、[スケーリングルールの作成] をクリックします。

3. 以下のパラメーターを設定して、[OK] をクリックしてください。

   パラメーター	値
   ルール名	Add1
   ルールタイプ	シンプルスケーリングルール
   操作	インスタンスを1台追加

4. 「Add1」ルールを見つけ、[実行] を [操作] 列でクリックします。

5. 「[スケーリングルールの実行]」メッセージで、[OK] をクリックします。

Auto Scaling はスケーリンググループに ECS インスタンスを1台追加します。ESSHookForAddMongoDBWhitelist ライフサイクルフックが有効になっているため、インスタンスは Pending Add 状態になります。タイムアウト期間中に、OOS は ACS-ESS-LifeCycleModifyMongoDBIPWhitelist テンプレートを実行して MongoDB ホワイトリストを更新します。

IP アドレスがホワイトリストに追加されない

現象：スケールアウトイベントは完了しますが、ECS インスタンスのプライベート IP アドレスが MongoDB ホワイトリストに表示されません。

手順：

1. OOS 実行ログ (ステップ 4 を参照) を開き、実行ステータスが [失敗] であるかどうかを確認します。

2. 実行が失敗した場合は、次のいずれかのエラーメッセージを探し、対応する解決策を適用します。

   エラーメッセージ	原因	修正
   Forbidden.Unauthorized: A required authorization for the specified action is not supplied	OOSServiceRole に必要な権限がありません	ステップ 1 で説明されているように、ESSHookPolicyForMongoDBWhitelist ポリシーを OOSServiceRole にアタッチします。
   Forbidden.RAM: User not authorized to operate on the specified resource, or this API doesn't support RAM	OOSServiceRole に必要な権限がありません	ステップ 1 で説明されているように、ESSHookPolicyForMongoDBWhitelist ポリシーを OOSServiceRole にアタッチします。

3. 実行ログに OOS タスクがトリガーされたレコードが表示されない場合、ライフサイクルフックが正しく設定されていない可能性があります。フックが [スケールアウトイベント] を対象とし、OOS テンプレートが [ACS-ESS-LifeCycleModifyMongoDBIPWhitelist] に設定されていることを確認してください。

OOS が完了する前にライフサイクルアクションがタイムアウトする

現象：IP がホワイトリストに追加される前にインスタンスが Pending Add 状態から移行するか、OOS 実行ログに中断されたタスクが表示されます。

手順：

1. OOS 実行ログを開き、実行が LifecycleHookIdAndLifecycleActionToken.Invalid エラーで終了したかどうかを確認します。

   LifecycleHookIdAndLifecycleActionToken.Invalid: The specified lifecycleActionToken
   and lifecycleActionId you provided does not match any in process lifecycle action.

2. このエラーが表示された場合、ライフサイクルフックの[タイムアウト期間]が短すぎます。ライフサイクルフックで[タイムアウト期間]を延長し、OOS がホワイトリストの更新を完了できるだけの時間を確保した後、スケーリングルールを再実行して再度テストしてください。