Auto Scaling:AnalyticDB for MySQL クラスターのホワイトリストへの ECS インスタンスの自動追加または削除

前提条件

開始する前に、以下が準備できていることを確認してください：

• 有効化 状態のスケーリンググループ

• AnalyticDB for MySQL クラスター

• CloudOps Orchestration Service (OOS) の RAM ロール — 信頼できるエンティティは Alibaba Cloud サービス である必要があります。信頼できるサービスは CloudOps Orchestration Service である必要があります。設定の詳細については、「RAM を使用して OOS に権限を付与する」をご参照ください。

このチュートリアルでは、RAM ロール名として OOSServiceRole を使用します。別のロール名を使用することもできます。

仕組み

スケールアウトイベントが発生すると、次のようになります：

1. Auto Scaling は新しい ECS インスタンスを起動し、ライフサイクルフックをトリガーします。

2. インスタンスは Pending Add 状態になり、まだトラフィックを処理できません。

3. Auto Scaling は OOS に通知し、ACS-ESS-LifeCycleModifyAnalyticDBIPWhitelist パブリックテンプレートを実行させます。

4. OOS はインスタンスのプライベート IP アドレスを取得し、AnalyticDB for MySQL クラスターの IP アドレスホワイトリストに追加します。

5. タスクが完了すると、OOS は Auto Scaling に続行するよう信号を送信し、インスタンスは InService 状態に移行します。

OOS が完了する前にライフサイクルフックがタイムアウトした場合、インスタンスは設定した デフォルトの実行ポリシー に基づいて処理を進めます：

• 続行：ホワイトリストの更新が完了しなくても、インスタンスはサービスを開始します。

• 破棄：インスタンスは終了されます。

ステップ 1：OOS に対する RAM ロールの権限付与

ACS-ESS-LifeCycleModifyAnalyticDBIPWhitelist テンプレートには、ECS インスタンスの記述、AnalyticDB for MySQL ホワイトリストの変更、および Auto Scaling のライフサイクルアクションへの信号送信を行うための権限が必要です。

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

2. ポリシーを作成します。

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

   2. ポリシーの作成 をクリックします。

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

      名前 を ESSHookPolicyForAnalyticDBWhitelist に設定します。

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

3. OOSServiceRole RAM ロールにポリシーをアタッチします。

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

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

   3. 権限を付与 パネルで、リソース範囲 を アカウント に設定し、ESSHookPolicyForAnalyticDBWhitelist カスタムポリシーを選択して、権限を付与 をクリックします。

ステップ 2：スケールアウト用のライフサイクルフックの作成

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

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

3. 上部のナビゲーションバーで、スケーリンググループが配置されているリージョンを選択します。

4. スケーリンググループの ID をクリックするか、操作 列の 詳細 をクリックします。

5. ライフサイクルフック タブで、ライフサイクルフックの作成 をクリックします。

6. 次のパラメーターを設定し、OK をクリックします。

   パラメーター	説明
   名前	ESSHookForAddAnalyticDBWhitelist と入力します。
   スケーリングアクティビティ	スケールアウトイベント を選択します。
   タイムアウト期間	予想される OOS の実行時間よりも長い値を設定します。フックが OOS の完了前にタイムアウトすると、ホワイトリストの更新は失敗します。この例では 300 秒を使用します。
   デフォルトの実行ポリシー	フックがタイムアウトした場合にインスタンスがサービスを開始できるようにするには 続行 を選択します。代わりにインスタンスを終了するには 破棄 を選択します。
   ライフサイクルフックが有効になったときに通知を送信	OOS テンプレート > パブリックテンプレート > ACS-ESS-LifeCycleModifyAnalyticDBIPWhitelist を選択します。次に、テンプレートパラメーターを設定します：dbClusterId (ご利用の AnalyticDB for MySQL クラスターの ID)、modifyMode (Append — スケールアウト時にプライベート IP アドレスをホワイトリストに追加)、および OOSAssumeRole (OOSServiceRole)。

ステップ 3：スケールアウトイベントのトリガーとホワイトリストの確認

(任意) ステップ 4：OOS の実行の表示

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

2. 左側のナビゲーションウィンドウで、自動化タスク > タスク実行管理 を選択します。

3. 時間で実行を見つけ、操作 列の 詳細 をクリックします。

4. 基本情報 セクションで、実行 ID とステータスを確認します。実行ステップと結果 セクションで、タスクノードをクリックしてステップレベルの詳細を表示します。

詳細については、「実行の詳細を表示する」をご参照ください。

実行が失敗した場合、実行詳細ページにエラーメッセージが表示されます。

よくある質問

トラブルシューティング

タスクが失敗した場合は、実行結果でエラーメッセージを特定し、以下を参照してください：

`Forbidden.Unauthorized`: A required authorization for the specified action is not supplied.

OOSServiceRole RAM ロールに必要な権限がありません。ステップ 1 で説明されている権限を付与してください。

`Forbidden.RAM`: User not authorized to operate on the specified resource, or this API doesn't support RAM.

ステップ 1 のサンプル権限など、必要な権限が OOSServiceRole RAM ロールに付与されているか確認してください。ESSHookPolicyForAnalyticDBWhitelist ポリシーが、アカウントレベルのリソース範囲で OOSServiceRole にアタッチされていることを確認してください。

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

ライフサイクルフックのタイムアウト期間が、OOS テンプレートで指定された O&M タスクを完了するのに十分であるか確認してください。