VM を起動して停止する

このドキュメントでは、Google Distributed Cloud（GDC）エアギャップで仮想マシン（VM）インスタンスを起動、停止、再起動する方法について説明します。

アプリケーションのライフサイクルをサポートするために、VM を停止、起動、再起動できます。たとえば、割り当てられた仮想中央処理装置（vCPU）の数や、VM に割り当てられたメモリ容量を変更する場合などです。構成を編集する前に、VM を停止する必要があります。完了したら、変更を適用するために電源を入れ直す必要があります。

このドキュメントは、Distributed Cloud 環境で VM インスタンスの起動、停止、再起動を行う必要があるプラットフォーム管理者またはアプリケーション オペレーター グループのデベロッパーを対象としています。詳細については、GDC エアギャップ環境のユーザー向けドキュメントをご覧ください。

始める前に

gdcloud コマンドライン インターフェース（CLI）コマンドを使用するには、gdcloud CLI をダウンロード、インストール、構成していることを確認します。Distributed Cloud のすべてのコマンドは gdcloud または kubectl CLI を使用し、オペレーティング システム（OS）環境が必要です。

kubeconfig ファイルのパスを取得する

Management API サーバーに対してコマンドを実行するには、次のリソースがあることを確認します。

  1. まだ kubeconfig ファイルがない場合は、ログインして Management API サーバーの kubeconfig ファイルを生成します。

  2. これらの手順では、Management API サーバーの kubeconfig ファイルのパスを使用して MANAGEMENT_API_SERVER を置き換えます。

VM の起動時間を最小限に抑える場合は、VM を起動する前に、VM の起動時間を最小限に抑える の手順に沿って操作してください。

IAM ロールをリクエストする

プロジェクトに対する次のロールをリクエストするには、プロジェクト IAM 管理者にお問い合わせください。

  • 仮想マシン プロジェクト管理者（project-vm-admin）: プロジェクト Namespace で VM を作成、変更、一覧表示、削除します。

  • プロジェクト閲覧者（project-viewer）: プロジェクト名前空間内のすべてのリソースを表示します。

すべての VM ロールは、VM が存在するプロジェクトの Namespace にバインドする必要があります。手順に沿ってアクセス権を確認します。

VM を停止する

仮想マシン（VM）を停止すると、ハイパーバイザはインスタンスに関連付けられているすべてのリソースの割り当てを解除します。VM をシャットダウンします。

GDC コンソールまたは kubectl を使用して、実行状態の VM を停止します。

コンソール

  1. ナビゲーション メニューで、[仮想マシン] > [インスタンス] をクリックします。

  2. VM のリストで、停止する実行中の VM のチェックボックスをオンにします。

  3. [停止] をクリックします。

  4. 確認ダイアログで [停止] をクリックします。

gdcloud

VM を停止するには:

gdcloud compute instances stop VM_NAME \
  --project PROJECT
  • VM_NAME は VM の名前で置き換えます。
  • PROJECT は、VM が存在する GDC プロジェクトの名前に置き換えます。

kubectl

  1. 次のコマンドを実行します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   -n PROJECT \
   edit virtualmachines.virtualmachine.gdc.goog VM_NAME

  2. VM の spec で runningState フィールドを探し、フィールドの値を Stopped に変更します。runningState が spec に含まれていない場合は、runningState を spec に追加し、値を Stopped に設定します。

    spec:
   runningState: Stopped

  3. VM のステータスを確認します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   -n PROJECT \
   get virtualmachines.virtualmachine.gdc.goog VM_NAME

    上記の変数の定義を使用します。

    変数定義
    MANAGEMENT_API_SERVER_KUBECONFIGManagement API サーバーの kubeconfig ファイル。
    VM_NAMEVM の名前。
    PROJECTVM のプロジェクト名。

VM を起動する

コンソールまたは kubectl を使用して、停止状態の VM を起動します。

コンソール

  1. ナビゲーション メニューで、[仮想マシン] > [インスタンス] をクリックします。

  2. VM のリストで、起動する停止済み VM のチェックボックスをオンにします。

  3. [開始] をクリックします。

  4. 確認ダイアログで [開始] をクリックします。

gdcloud

VM を起動するには:

gdcloud compute instances start VM_NAME --project PROJECT
  • VM_NAME は VM の名前で置き換えます。
  • PROJECT は、VM が存在する GDC プロジェクトの名前に置き換えます。

kubectl

  1. 次のコマンドを実行します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
  -n PROJECT \
  edit virtualmachines.virtualmachine.gdc.goog VM_NAME

  2. VM の spec で runningState フィールドを探し、フィールドの値を Running に変更します。

    spec:
   runningState: Running

  3. VM のステータスを確認します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
  -n PROJECT \
  get virtualmachines.virtualmachine.gdc.goog VM_NAME

    サンプルコードでは、これらの変数の定義を使用します。

    変数定義
    MANAGEMENT_API_SERVER_KUBECONFIGManagement API サーバーの kubeconfig ファイル。
    MANAGEMENT_API_SERVER_NAMEManagement API サーバーの名前。
    VM_NAMEVM の名前。
    PROJECTVM のプロジェクト名。

VM を再起動する

VM を再起動すると、マシンは初期状態にリセットされ、マシンのメモリの内容はワイプされます。

コンソールまたは kubectl を使用して、実行状態の VM を再起動します。

コンソール

  1. ナビゲーション メニューで、[仮想マシン > インスタンス] をクリックします。

  2. VM のリストで、再起動する実行中の VM のチェックボックスをオンにします。

  3. [リセット] をクリックします。

  4. 確認ダイアログで [リセット] をクリックします。

gdcloud

VM をリセットするには:

gdcloud compute instances reset VM_NAME --project PROJECT
  • VM_NAME は VM の名前で置き換えます。
  • PROJECT は、VM が存在する GDC プロジェクトの名前に置き換えます。

kubectl

  1. Management API サーバーへのローカル プロキシを起動します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG proxy --port=8001 &
PROXY_PID=$!

    MANAGEMENT_API_SERVER_KUBECONFIG は、Management API サーバーの kubeconfig ファイルに置き換えます。

  2. プロキシ経由で VM を再起動する API リクエストを行います。

    curl -s -i -X PUT \
  http://127.0.0.1:8001/apis/virtualmachineoperations.gdc.goog/v1/namespaces/PROJECT/virtualmachines/VM_NAME/restart | head -n 1
    • VM_NAME は VM の名前で置き換えます。
    • PROJECT は、VM が存在する GDC プロジェクトの名前に置き換えます。

    リクエストが成功すると、HTTP/1.1 202 Accepted が返されます。

  3. プロキシを停止します。

    kill $PROXY_PID

  4. VM のステータスを確認します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
  -n PROJECT \
  get virtualmachines.virtualmachine.gdc.goog VM_NAME