マネージド インスタンスを操作する

マネージド インスタンス グループ（MIG）は、使用する構成コンポーネント（インスタント テンプレート、オプションのすべてのインスタンス構成、オプションのステートフル構成）に基づいて、それぞれのマネージド インスタンスを作成します。

各マネージド インスタンスは、MIG 内の実際の仮想マシン（VM）インスタンスの目的の状態を表すデータ エンティティです。

このドキュメントでは、MIG 内のマネージド インスタンスを確実に操作する方法について説明します。たとえば、特定のインスタンスに関する情報の追加、削除、更新、取得が必要になることがあります。

構成の変更が MIG によって元に戻されないように、このドキュメントで説明する方法を使用することが重要になります。グループのメソッド以外で MIG の VM を変更する場合、それらの VM がグループの目的の構成を使用しなくなったことを MIG が検出する場合もあれば、検出しない場合もあります。また、予期しない結果が発生する可能性があります。たとえば、必要なインスタンス グループ マネージャー API ではなくインスタンス API を使用して MIG 内の VM を削除または更新すると、MIG はインテントを認識せず、今後、MIG は、MIG の構成に従って VM の再作成や復元を自動的に試行することがあります。

始める前に

  • 制限事項を確認して、グループを作成します。
  • まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。 

      gcloud init

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

    2. Set a default region and zone.

    REST

    このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

      Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。 

      gcloud init

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

    詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

マネージド インスタンスとは

マネージド インスタンスとは、実際の VM インスタンスの現在のステータスと目的の状態が含まれる、MIG 内のデータ エンティティです。

マネージド インスタンスの現在のステータスには次のフィールドが含まれます。

  • インスタンスのライフサイクルのステータス（例: RUNNING、STOPPING）。
  • MIG がインスタンスに対して実行している現在のアクション（例: RESTARTING、VERIFYING、NONE）。
  • インスタンスの健全性（例: HEALTHY、UNHEALTHY）。

実際の VM インスタンスに対するマネージド インスタンスの目的の状態には次のものがあります。

  • 目的のバージョン。つまり、インスタンスに使用するバージョン名とインスタンス テンプレートです。
  • 保持するアイテム（ディスク、メタデータなど）について維持する状態。

図 1 のように、MIG 内の各マネージド インスタンスについて、MIG はそのマネージド インスタンスの仕様に従って実際の VM を稼働中の状態にします。

MIG は構成に基づいてマネージド インスタンスを自動的に生成します。マネージド インスタンスは、MIG が管理している実際の VM インスタンスに対応します。

図 1. マネージド インスタンスと対応する VM の関係

マネージド インスタンスの仕様を表示するには、MIG 内のマネージド インスタンスに関する情報を取得するをご覧ください。

インスタンスを MIG に追加する

インスタンスを MIG に追加するには、次の操作を行います。

新しく追加されたインスタンスが稼働していることを確認するには、グループのステータスを確認するか、マネージド インスタンスのステータスを確認します。

MIG のサイズを手動で設定する

マネージド インスタンス グループの自動スケールが設定済みでない場合、グループのサイズを手動で設定して、グループ内のインスタンスの数を変更できます。詳細については、MIG を手動でサイズ変更するをご覧ください。

サイズ変更リクエストを使用して VM を一度に作成する

サイズ変更リクエストを使用すると、GPU VM を MIG に一度に追加できます。この機能を使用すると、Compute Engine がすべてのリソースをプロビジョニングしている間、部分的な容量に対する料金が発生しないようにすることができます。MIG のサイズ変更リクエストでは、Flex Start または予約で制限されたプロビジョニング モデルが使用されます。これらのモデルでは、vCPU と GPU を割引価格で取得できます。詳細については、MIG のサイズ変更リクエストについてをご覧ください。

ステートレス アプリケーションに自動スケーリングを使用する

マネージド インスタンス グループは、インスタンスがその負荷に応じて自動的に追加や削除されるように構成できます。トラフィックの増加をアプリケーションで適切に処理できると同時に、コンピューティング リソースの必要性が低下した場合には費用を抑えることができます。MIG の自動スケーリングの詳細については、インスタンスのグループの自動スケーリングをご覧ください。

特定の名前を持つインスタンスを追加する

ワークロードまたはオーケストレーション システムで特定のインスタンス名が必要な場合は、それらの名前を持つインスタンスを既存の MIG に追加できます。これらのインスタンスに割り当てた名前は、MIG がインスタンスを再作成した場合も保持されます。

特定の名前のインスタンスを MIG に追加する方法に基づいて、次のいずれかの方法を使用します。

MIG からインスタンスを削除する

マネージド インスタンスを削除すると、MIG はグループの targetSize を縮小し、対応する VM インスタンスを削除します。

ステートフル MIG を設定した場合、MIG はインスタンスで維持する状態の構成を削除します。また、MIG は削除されたインスタンスが属するすべてのターゲット プールからインスタンスを削除します。

グループが属するバックエンド サービスでコネクション ドレインが有効になっている場合は、コネクション ドレインが有効のタイムアウトが経過してから VM インスタンスが削除されるまでに 60 秒ほどかかることがあります。

マネージド インスタンスを削除するには、次のようにします。

MIG 内の VM 構成を更新する

MIG で VM の構成を変更する必要がある場合（たとえば、ブートディスクやマシンタイプの変更、ディスクの追加、その他の VM プロパティの変更など）は、MIG での VM 構成の更新を参照してください。

MIG 内のインスタンスを再作成する

この方法を使用して、グループの最新の VM 構成コンポーネントを使用するように、選択した VM を更新します。マネージド インスタンス グループに属するすべての VM を再作成する必要がある場合は、代わりにローリング アップデートを開始します。

グループが属するバックエンド サービスでコネクション ドレインが有効になっている場合は、コネクション ドレインが有効のタイムアウトが経過してから VM インスタンスが削除されるまでに 60 秒ほどかかることがあります。

マネージド インスタンス グループ内の選択した VM インスタンスを再作成するには、gcloud CLI または REST を使用します。

gcloud

instance-groups managed recreate-instances コマンドを使用します。

gcloud compute instance-groups managed recreate-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

API で、regionInstanceGroupManagers.recreateInstances メソッドに対する POST リクエストを行います。ゾーン マネージド インスタンス グループの場合は、instanceGroupManagers.recreateInstances メソッドを使用します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/recreateInstances

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

マネージド インスタンス グループの VM インスタンスの再作成リクエストを行うと、システムで新しい VM のプロビジョニングが可能になり次第、再作成された新しい VM が起動します。このプロセスにかかる時間は、再作成するインスタンスの数によっては長くなる場合があります。グループのステータスを確認するか、マネージド インスタンスのステータスを確認します。

再作成オペレーションでは VM インスタンス名が保持されますが、インスタンスの作成タイムスタンプは変更されない場合があります。インスタンスの作成タイムスタンプが変更されていない状態で、再作成オペレーションによって新しいインスタンスが作成されたことを確認するには、そのインスタンスにアタッチされているブートディスクの作成タイムスタンプを確認します。

MIG 内のインスタンスに関する情報を表示する

MIG 内のマネージド インスタンスに関する情報を取得するをご覧ください。

MIG でステートフル インスタンスを構成する

ステートフル MIG の構成をご覧ください。

次のステップ