GSP087

概要

このラボでは、Cloud Monitoring のカスタム指標の値に基づいて自動スケーリングする、Compute Engine マネージド インスタンス グループを作成します。

アプリケーション アーキテクチャ

自動スケーリング アプリケーションでは、Compute Engine インスタンスにインストールされた Node.js スクリプトが使用されます。このスクリプトを実行すると、Cloud Monitoring 指標に数値を報告できます。このラボでは、Node.js や JavaScript に関する知識は必要ありません。アプリケーションでは、指標の値に基づき必要に応じて、Compute Engine インスタンス グループの自動スケールアップや自動スケールダウンが行われます。

Node.js スクリプトを使用してカスタム指標に値が提供され、その値に応じてインスタンス グループが動作します。本番環境では、実際のユースケースに関連する指標に基づいて自動スケーリングを行うことになります。

このアプリケーションは、次のコンポーネントで構成されています。

1. Compute Engine インスタンス テンプレート - インスタンス グループ内の各インスタンスの作成に使用されるテンプレート。
2. Cloud Storage - 起動スクリプトなどのスクリプト ファイルをホストするために使用されるバケット。
3. Compute Engine 起動スクリプト - 各インスタンスに必要なコード コンポーネントをインストールする起動スクリプト。起動スクリプトは、インスタンスの起動時に自動的にインストールされ開始されます。起動スクリプトが実行されると、Cloud Monitoring カスタム指標に値を書き込むコードがインスタンスにインストールされ開始されます。
4. Compute Engine インスタンス グループ - Cloud Monitoring の指標の値に基づいて自動スケーリングを行うインスタンス グループ。
5. Compute Engine インスタンス - 状況に応じて数が変わる Compute Engine インスタンス。
6. Cloud Monitoring カスタム指標 - Compute Engine インスタンス グループの自動スケーリングの入力値として使用されるカスタム モニタリング指標。

目標

このラボでは、次のタスクを行う方法を学びます。

• 自動スケーリングの Compute Engine インスタンス グループをデプロイします。
• インスタンス グループのスケーリングに使用するカスタム指標を作成します。
• Cloud コンソールを使用して、カスタム指標とインスタンス グループのサイズを可視化します。

設定と要件

[ラボを開始] ボタンをクリックする前に

こちらの説明をお読みください。ラボには時間制限があり、一時停止することはできません。タイマーは、Google Cloud のリソースを利用できる時間を示しており、[ラボを開始] をクリックするとスタートします。

このハンズオンラボでは、シミュレーションやデモ環境ではなく実際のクラウド環境を使って、ラボのアクティビティを行います。そのため、ラボの受講中に Google Cloud にログインおよびアクセスするための、新しい一時的な認証情報が提供されます。

このラボを完了するためには、下記が必要です。

• 標準的なインターネット ブラウザ（Chrome を推奨）

注: このラボの実行には、シークレット モード（推奨）またはシークレット ブラウジング ウィンドウを使用してください。これにより、個人アカウントと受講者アカウント間の競合を防ぎ、個人アカウントに追加料金が発生しないようにすることができます。

• ラボを完了するための時間（開始後は一時停止できません）

注: このラボでは、受講者アカウントのみを使用してください。別の Google Cloud アカウントを使用すると、そのアカウントに料金が発生する可能性があります。

ラボを開始して Google Cloud コンソールにログインする方法

1. [ラボを開始] ボタンをクリックします。ラボの料金をお支払いいただく必要がある場合は、表示されるダイアログでお支払い方法を選択してください。 左側の [ラボの詳細] ペインには、以下が表示されます。

   • [Google Cloud コンソールを開く] ボタン
   • 残り時間
   • このラボで使用する必要がある一時的な認証情報
   • このラボを行うために必要なその他の情報（ある場合）

2. [Google Cloud コンソールを開く] をクリックします（Chrome ブラウザを使用している場合は、右クリックして [シークレット ウィンドウで開く] を選択します）。

   ラボでリソースがスピンアップし、別のタブで [ログイン] ページが表示されます。

   ヒント: タブをそれぞれ別のウィンドウで開き、並べて表示しておきましょう。

   注: [アカウントの選択] ダイアログが表示されたら、[別のアカウントを使用] をクリックします。

3. 必要に応じて、下のユーザー名をコピーして、[ログイン] ダイアログに貼り付けます。

   {{{user_0.username | "Username"}}}

   [ラボの詳細] ペインでもユーザー名を確認できます。

4. [次へ] をクリックします。

5. 以下のパスワードをコピーして、[ようこそ] ダイアログに貼り付けます。

   {{{user_0.password | "Password"}}}

   [ラボの詳細] ペインでもパスワードを確認できます。

6. [次へ] をクリックします。

   重要: ラボで提供された認証情報を使用する必要があります。Google Cloud アカウントの認証情報は使用しないでください。 注: このラボでご自身の Google Cloud アカウントを使用すると、追加料金が発生する場合があります。

7. その後次のように進みます。

   • 利用規約に同意してください。
   • 一時的なアカウントなので、復元オプションや 2 要素認証プロセスは設定しないでください。
   • 無料トライアルには登録しないでください。

その後、このタブで Google Cloud コンソールが開きます。

注: Google Cloud のプロダクトやサービスにアクセスするには、ナビゲーション メニューをクリックするか、[検索] フィールドにサービス名またはプロダクト名を入力します。

Cloud Shell をアクティブにする

Cloud Shell は、開発ツールと一緒に読み込まれる仮想マシンです。5 GB の永続ホーム ディレクトリが用意されており、Google Cloud で稼働します。Cloud Shell を使用すると、コマンドラインで Google Cloud リソースにアクセスできます。

1. Google Cloud コンソールの上部にある「Cloud Shell をアクティブにする」アイコン をクリックします。

2. ウィンドウで次の操作を行います。

   • Cloud Shell 情報ウィンドウで操作を進めます。
   • Cloud Shell が認証情報を使用して Google Cloud API を呼び出すことを承認します。

接続した時点で認証が完了しており、プロジェクトに各自の Project_ID、 が設定されます。出力には、このセッションの PROJECT_ID を宣言する次の行が含まれています。

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud は Google Cloud のコマンドライン ツールです。このツールは、Cloud Shell にプリインストールされており、タブ補完がサポートされています。

3. （省略可）次のコマンドを使用すると、有効なアカウント名を一覧表示できます。

gcloud auth list

4. [承認] をクリックします。

出力:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. （省略可）次のコマンドを使用すると、プロジェクト ID を一覧表示できます。

gcloud config list project

出力:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注: Google Cloud における gcloud ドキュメントの全文については、gcloud CLI の概要ガイドをご覧ください。

タスク 1. アプリケーションの作成

自動スケーリング アプリケーションを作成するには、必要なコード コンポーネントをダウンロードし、マネージド インスタンス グループを作成して、マネージド インスタンス グループの自動スケーリングを設定する必要があります。

Cloud Storage にスクリプト ファイルをアップロードする

自動スケーリング（スケールアップ）時、インスタンス グループでは、新しい Compute Engine インスタンスを作成する必要があります。その際、インスタンスはインスタンス テンプレートに基づいて作成されます。各インスタンスには起動スクリプトが必要です。そのため、テンプレートには起動スクリプトを参照する方法が必要です。Compute Engine では、起動スクリプトのソースとして Cloud Storage バケットを使用できます。このセクションでは、このラボで使用するサンプル アプリケーションの起動スクリプトとアプリケーション ファイルのコピーを作成します。サンプル アプリケーションは、自動スケーリング グループの自動スケーリング動作を制御する指標として設定するために使用できる Cloud Logging のカスタム指標に一定パターンのデータをプッシュします。

注: 既存のインスタンス テンプレートや、ラボで自動的に作成されてすでに実行中のグループがあります。自動スケーリングでは、スケールアップとスケールダウンの両方の動作を実施するために少なくとも 30 分は必要になります。後でこのグループを利用して、カスタム指標スクリプトによって生成されたカスタム指標値の変化に応じてどのようにスケーリングが制御されるかを確認します。

タスク 2. バケットの作成

1. Cloud コンソールで、ナビゲーション メニューの [Cloud Storage] > [バケット] を選択し、[作成] をクリックします。

2. 一意の名前をバケットに指定します。別のプロジェクトで使用する可能性がある名前は指定しないでください。バケットの命名方法の詳細については、バケットとオブジェクトの命名ガイドラインをご覧ください。バケットにはプロジェクト ID を使用できます。このバケットは、ラボ全体で YOUR_BUCKET と表記されます。

3. デフォルト値をそのまま使用して、[作成] をクリックします。

プロンプトが表示されたら、Public access will be prevented と表示されるポップアップで [確認] をクリックします。

バケットが作成されると、[バケットの詳細] ページが開きます。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。Cloud Storage バケットが正常に作成されている場合は、評価スコアが表示されます。

Cloud Storage バケットを作成する

4. 次に、Cloud Shell で以下のコマンドを実行して、ラボのデフォルトの Cloud Storage バケットから自分の Cloud Storage バケットに起動スクリプト ファイルをコピーします。<YOUR BUCKET> は、先ほど作成したバケットの名前に置き換えます。

gsutil cp -r gs://spls/gsp087/* gs://<YOUR BUCKET>

5. スクリプトをアップロードしたら、[バケットの詳細] ページで [更新] をクリックします。追加したファイルがバケットに表示されます。

コード コンポーネントについて

• Startup.sh - Compute Engine インスタンスをマネージド インスタンス グループに追加する際に、必要なコンポーネントを各インスタンスにインストールするシェル スクリプト。
• writeToCustomMetric.js - スケーリングのトリガーとなる値を持つカスタム モニタリング指標を生成する Node.js スニペット。現実の指標値をエミュレートするために、このスクリプトは時間とともに変化する値を生成します。本番環境にデプロイするときは、このスクリプトをカスタムコードに置き換えて、必要なモニタリング指標（処理キューの値など）が報告されるようにします。
• Config.json - カスタム モニタリング指標の値を指定する Node.js 構成ファイル。writeToCustomMetric.js で使用されます。
• Package.json - writeToCustomMetric.js の標準インストールや依存関係を指定する Node.js パッケージ ファイル。
• writeToCustomMetric.sh - writeToCustomMetric.js プログラムを各 Compute Engine インスタンス上で継続的に実行するシェル スクリプト。

タスク 3. インスタンス テンプレートを作成する

次に、自動スケーリングを使用するインスタンス グループで作成されるインスタンスのテンプレートを作成します。テンプレートの一部として、インスタンスの起動時に実行する起動スクリプトの場所（Cloud Storage 内）を指定します。

1. Cloud コンソールで、ナビゲーション メニュー > [Compute Engine] > [インスタンス テンプレート] をクリックします。

2. ページの上部にある [インスタンス テンプレートを作成] をクリックします。

3. インスタンス テンプレートに autoscaling-instance01 という名前を付けます。

4. 下にスクロールし、[詳細オプション] をクリックします。

5. [管理] タブの [メタデータ] セクションで、メタデータのキーと値を入力し、[+ 項目を追加] ボタンをクリックして各項目を追加します。必ず、[YOUR_BUCKET_NAME] プレースホルダを目的のバケット名に置き換えてください。

キー	値
startup-script-url	gs://[YOUR_BUCKET_NAME]/startup.sh
gcs-bucket	gs://[YOUR_BUCKET_NAME]

6. [作成] をクリックします。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。インスタンス テンプレートが正常に作成された場合は、評価スコアが表示されます。

インスタンス テンプレートの作成

タスク 4. インスタンス グループを作成する

1. 左側のペインで [インスタンス グループ] をクリックします。

2. ページ上部にある [インスタンス グループの作成] をクリックします。

3. 名前は autoscaling-instance-group-1 にします。

4. [インスタンス テンプレート] には、作成したインスタンス テンプレートを選択します。

5. [ロケーション] には [シングルゾーン] を選択し、リージョンとゾーンにはそれぞれ と を使用します。

6. [自動スケーリング モード] を [オフ: 自動スケーリングを行いません] に設定します。

自動スケーリングの設定は、インスタンス グループが作成された後に編集します。他の設定はデフォルト値のままにします。

7. [作成] をクリックします。

注: インスタンス グループの横に表示される「自動スケーリングはオフになっています。グループ内のインスタンスの数は自動的に変更されません。自動スケーリングの構成が維持されます。」という警告は無視してかまいません。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。インスタンス グループが正常に作成された場合は、評価スコアが表示されます。

インスタンス グループを作成する

タスク 5. インスタンス グループが作成されたことを確認する

作成した新しいインスタンス グループの横に緑色のチェックマークが表示されるまで待ちます。起動スクリプトのインストールが完了して値の報告が開始されるまで、数分かかる場合があります。時間がかかりすぎていると思われる場合は、[更新] をクリックしてください。

注: ラボで事前に作成された他のインスタンス グループの横に赤色のアイコンが表示される場合がありますが、この警告は無視してください。インスタンス グループは初期化中に最大 10～15 分間警告を報告するため、これは想定された挙動です。

タスク 6. Node.js スクリプトが実行されていることを確認する

グループ内の最初のインスタンスが作成され、そのインスタンスがカスタム指標値の報告を開始するまで、カスタム指標 custom.googleapis.com/appdemo_queue_depth_01 は作成されません。

インスタンス グループの最初のインスタンスで writeToCustomMetric.js スクリプトが実行されていることを確認するには、そのインスタンスがカスタム指標値を記録しているかどうかをチェックします。

1. 引き続き Compute Engine の [インスタンス グループ] ウィンドウで、autoscaling-instance-group-1 の名前をクリックして、グループで実行されているインスタンスを表示します。

2. 下にスクロールし、インスタンス名をクリックします。自動スケーリングによるインスタンスの追加は開始されていないため、実行されているインスタンスは 1 つだけです。

3. [詳細] タブの [ログ] セクションで、[ロギング] のリンクをクリックして、VM インスタンスのログを表示します。

4. 一定のデータが収集されるまで数分待ちます。[クエリを表示] を有効に切り替えると、[クエリ] プレビュー ボックスに resource.type と resource.labels.instance_id が表示されます。

5. 3 行目に "nodeapp" を追加します。次のようなコードになります。

6. [クエリを実行] をクリックします。

Node.js スクリプトが Compute Engine インスタンスで実行されている場合は、API にリクエストが送信され、nodeapp: available というログエントリが表示されます。

注: このログエントリが表示されない場合、Node.js スクリプトはカスタム指標値を報告していません。メタデータが正しく入力されていることを確認してください。メタデータが正しくない場合は、ラボを再起動した方が簡単なことがあります。アプリが起動するまでに 10 分ほどかかることがあります。

タスク 7. インスタンス グループの自動スケーリングを構成する

カスタム指標が最初のインスタンスからデータを正常に報告していることを確認した後、カスタム指標の値に基づいて自動スケーリングを行うようにインスタンス グループを構成できます。

1. Cloud コンソールで、[Compute Engine] > [インスタンス グループ] に移動します。

2. autoscaling-instance-group-1 グループをクリックします。

3. [編集] をクリックします。

4. [自動スケーリング] の [自動スケーリング モード] を、[オン: グループに対してインスタンスを追加および削除します] に設定します。

5. [インスタンスの最小数] を 1 に、[インスタンスの最大数] を 3 に設定します。

6. [自動スケーリング シグナル] で [シグナルを追加] をクリックし、指標を編集します。以下のフィールドを設定します。その他のフィールドはデフォルト値のままにします。

   • [シグナルタイプ] は Cloud Monitoring metric new にします。[構成] をクリックします。
   • [リソースと指標] で [指標を選択] をクリックし、[VM インスタンス] > [カスタム指標] > [Custom/appdemo_queue_depth_01] に移動します。
   • [適用] をクリックします。
   • [使用率のターゲット] は 150 にします。

   カスタム モニタリング指標値が [ターゲット] の値と異なる場合は、オートスケーラーによってマネージド インスタンス グループがスケーリングされ、インスタンス数が増減されます。ターゲット値には任意の double 値を指定できますが、このラボでは、カスタム モニタリング指標によって報告される値と一致する値である 150 を使用しています。

   • [使用率のターゲットのタイプ] はゲージにします。[選択] をクリックします。

   [ゲージ] を設定することで、過去数分間に収集されたデータの平均値を計算してターゲット値と比較することを指定します（これに対し、[ターゲット モード] を [DELTA_PER_MINUTE] または [DELTA_PER_SECOND] に設定すると、平均値ではなく、観測された変化率に基づいて自動スケーリングが行われます）。

7. [保存] をクリックします。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。インスタンス グループの自動スケーリングが正常に設定された場合は、評価スコアが表示されます。

インスタンス グループの自動スケーリングを構成する

タスク 8. インスタンス グループが自動スケーリングを行っていることを監視する

Node.js スクリプトは、各インスタンスから報告するカスタム指標値を時間の経過とともに変更します。指標の値が上がると、インスタンス グループは Compute Engine インスタンスを追加することによってスケールアップします。値が下がると、インスタンス グループはこれを検出し、インスタンスを削除してスケールダウンします（前述のように、スクリプトは値が同様に上下に変動する実際の指標をエミュレートします）。

次に、[モニタリング] タブをクリックして [自動スケーリングされたサイズ] グラフを表示して、指標に応じてどのようにインスタンス グループがスケーリングしているかを確認します。

1. 左側のペインで [インスタンス グループ] をクリックします。
2. リストで builtin-igm インスタンス グループをクリックします。
3. [モニタリング] タブをクリックします。
4. [自動更新] を有効にします。

このグループは先行して開始されているため、自動スケーリング グラフでインスタンス グループに関する自動スケーリングの詳細を確認できます。オートスケーラーがカスタム指標を正しく認識するまで約 5 分かかり、自動スケーリングの動作をトリガーするのに十分なデータをスクリプトが生成するまで最大 10～15 分かかることがあります。

グラフにカーソルを合わせると、詳細が表示されます。

作成したインスタンス グループに戻ると、その動作を確認できます（インスタンス グループの自動スケーリングを確認するには、ラボの時間が十分に残っていない場合があります）。

ラボの時間が残っていれば、インスタンスの追加および削除に合わせて自動スケーリングのグラフが上下していることを確認してください。

タスク 9. 自動スケーリングの例

この自動スケーリングの例を読み、自動スケーリングされたインスタンスの容量と数が大規模な環境ではどのように動作するかを確認します。

上のグラフに示されるインスタンス数は、下のグラフに報告されるカスタム指標プロパティ値の集計レベルの変動に応じて変化します。各インスタンスが起動してからそのカスタム指標値の報告を開始するまで、最大 5 分という若干の遅れがあります。作成したインスタンス グループで自動スケーリングが開始されるまでの間、このグラフで、何が起こるのかを確認しておきましょう。

このスクリプトは、スケールアップ動作をトリガーするために、最初は約 15 分間高い値を生成します。

• 11:27 自動スケーリング グループが 1 つのインスタンスで始まります。カスタム指標の集計ターゲットは 150 です。
• 11:31 最初の指標データが取得されます。指標がターゲットの 150 よりも大きいため、自動スケーリング グループは 2 番目のインスタンスを起動します。
• 11:33 2 番目のインスタンスからのカスタム指標データの取得が開始されます。現在の集計ターゲットは 300 です。指標値は 300 を上回っているため、自動スケーリング グループは 3 番目のインスタンスを起動します。
• 11:37 3 番目のインスタンスからのカスタム指標データの取得が開始されます。現在の集計ターゲットは 450 です。累積の指標値は 450 を上回っているため、自動スケーリング グループは 4 番目のインスタンスを起動します。
• 11:42 4 番目のインスタンスからのカスタム指標データの取得が開始されます。現在の集計ターゲットは 600 です。現在、累積の指標値は新しいターゲット レベルの 600 を超えていますが、自動スケーリング グループのサイズ制限に達しているため、スケールアップ操作はこれ以上行われません。
• 11:44 アプリケーション スクリプトは低い指標値の生成期間（15 分間）に移ります。累積の指標値がターゲットの 600 を下回っていても、組み込みのスケールダウン遅延（10 分間）が経過するまで、スケールダウンによる変更は行われません。
• 11:54 この時点で、カスタム指標データは、4 ノードクラスタの集計ターゲット レベルである 600 を 10 分以上下回っています。スケールダウンにより、2 つのインスタンスがすぐに削除されます。
• 11:56 削除されたノードのカスタム指標データが自動スケーリングの計算から除外され、集計ターゲットが 300 に低下します。
• 12:00 アプリケーション スクリプトは高い指標値の生成期間（15 分）に戻ります。累積のカスタム指標値は集計ターゲット レベルの 300 を再び超えているため、自動スケーリング グループは 3 番目のインスタンスを起動します。
• 12:03 新しいインスタンスからカスタム指標データが取得されます。ただし、報告された累積値はターゲットの 450 を下回っているため、自動スケーリングによる変更は行われません。
• 12:04 累積のカスタム指標値がターゲットの 450 を超えているため、自動スケーリングによって 4 番目のインスタンスが起動します。

お疲れさまでした

これで完了です。このラボでは、Cloud Monitoring のカスタム指標の値に基づいて自動スケーリングする、Compute Engine マネージド インスタンス グループを作成しました。また、Cloud コンソールを使用してカスタム指標とインスタンス グループのサイズを可視化する方法も学びました。

次のステップと詳細情報

• Cloud Monitoring の詳細
• Cloud Monitoring のカスタム指標の詳細
• Compute Engine の自動スケーリングの詳細

Google Cloud トレーニングと認定資格

Google Cloud トレーニングと認定資格を通して、Google Cloud 技術を最大限に活用できるようになります。必要な技術スキルとベスト プラクティスについて取り扱うクラスでは、学習を継続的に進めることができます。トレーニングは基礎レベルから上級レベルまであり、オンデマンド、ライブ、バーチャル参加など、多忙なスケジュールにも対応できるオプションが用意されています。認定資格を取得することで、Google Cloud テクノロジーに関するスキルと知識を証明できます。

マニュアルの最終更新日: 2024 年 2 月 7 日

ラボの最終テスト日: 2024 年 2 月 7 日

Copyright 2025 Google LLC. All rights reserved. Google および Google のロゴは Google LLC の商標です。その他すべての企業名および商品名はそれぞれ各社の商標または登録商標です。