ゲスト環境をインストールする

このページでは、Compute Engine でカスタム イメージを実行している仮想マシン（VM）インスタンスにゲスト環境を手動でインストールする方法について説明します。

ほとんどの場合、Google 提供の公開イメージを使用して作成された VM を使用すると、ゲスト環境をインストールする必要がありません。ゲスト環境を使用する状況については、ゲスト環境を手動でインストールまたは更新する状況をご覧ください。

ゲスト環境を手動でインストールする前に、ゲスト環境を検証するの手順に沿って、VM でゲスト環境が実行されているかどうかを確認します。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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

インストール方法

ゲスト環境のインストール方法は複数あります。次のいずれかを選択します。

サポートされているオペレーティング システム

一般提供（GA）ライフサイクルまたは拡張サポート ライフサイクル ステージにある OS イメージ バージョンを使用する VM に、ゲスト環境を手動でインストールできます。Compute Engine の OS イメージ バージョンとそのライフサイクル ステージの一覧を確認するには、オペレーティング システムの詳細をご覧ください。

制限事項

Fedora CoreOS、Container-Optimized の各オペレーティング システム用のゲスト環境を手動またはインポート ツールによってインストールすることはできません。これらのオペレーティング システムのいずれかが必要な場合は公開イメージを使用することをおすすめします。すべての公開イメージには、中核としてゲスト環境が含まれています。

ゲスト環境のインストール

ゲスト環境をインプレースでインストールする

SSH を使用してターゲット インスタンスに接続できる場合、この方法を使用してゲスト環境をインストールします。インスタンスに接続してゲスト環境をインストールできない場合は、ブートディスクのクローンを作成して起動スクリプトでゲスト環境をインストールします。

SSH パスワード ベースの認証を使用して接続できる場合は、この手順がイメージのインポートに便利です。機能キーベースの SSH を使用したユーザー アカウントが 1 つ以上ある場合は、ゲスト環境の再インストールにも使用できます。

CentOS/RHEL/Rocky

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. CentOS/RHEL/Rocky Linux のバージョンを特定して、ソース repo ファイル /etc/yum.repos.d/google-cloud.repo を作成します。

    eval $(grep VERSION_ID /etc/os-release)
sudo tee /etc/yum.repos.d/google-cloud.repo << EOM
[google-compute-engine]
name=Google Compute Engine
baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-el${VERSION_ID/.*}-x86_64-stable
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
      https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

  3. パッケージ リストを更新します。

    sudo yum makecache
sudo yum updateinfo

  4. ゲスト環境パッケージをインストールします。

    sudo yum install -y google-compute-engine google-osconfig-agent

  5. インスタンスを再起動して、コンソールログを調査することで、バックアップの開始時にゲスト環境が読み込まれることを確認します。

  6. SSH を使用してインスタンスに接続できることを確認します。

Debian

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. 公開リポジトリの GPG 鍵をインストールします。

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

  3. Debian ディストリビューションの名前を決めて、ソースリスト ファイル /etc/apt/sources.list.d/google-cloud.list を作成します。

    eval $(grep VERSION_CODENAME /etc/os-release)
sudo tee /etc/apt/sources.list.d/google-cloud.list << EOM
deb http://packages.cloud.google.com/apt google-compute-engine-${VERSION_CODENAME}-stable main
deb http://packages.cloud.google.com/apt google-cloud-packages-archive-keyring-${VERSION_CODENAME} main
EOM

  4. パッケージ リストを更新します。

    sudo apt update

  5. ゲスト環境パッケージをインストールします。

    sudo apt install -y google-cloud-packages-archive-keyring
sudo apt install -y google-compute-engine google-osconfig-agent

  6. インスタンスを再起動して、コンソールログを調査することで、バックアップの開始時にゲスト環境が読み込まれることを確認します。

  7. SSH を使用してインスタンスに接続できることを確認します。

Ubuntu

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. Universe リポジトリを有効にします。Canonical は、そのゲスト環境用のパッケージを Universe リポジトリに公開します。

    sudo apt-add-repository universe

  3. パッケージ リストを更新します。

    sudo apt update

  4. ゲスト環境パッケージをインストールします。

    sudo apt install -y google-compute-engine google-osconfig-agent

  5. インスタンスを再起動して、コンソールログを調査することで、バックアップの開始時にゲスト環境が読み込まれることを確認します。

  6. SSH を使用してインスタンスに接続できることを確認します。

SLES

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. Public Cloud モジュールを有効にします。

    product=$(sudo SUSEConnect --list-extensions | grep -o "sle-module-public-cloud.*")
[[ -n "$product" ]] && sudo SUSEConnect -p "$product"

  3. パッケージ リストを更新します。

    sudo zypper refresh

  4. ゲスト環境パッケージをインストールします。

    sudo zypper install -y google-guest-{agent,configs,oslogin} \
google-osconfig-agent
sudo systemctl enable /usr/lib/systemd/system/google-*

  5. インスタンスを再起動して、コンソールログを調査することで、バックアップの開始時にゲスト環境が読み込まれることを確認します。

  6. SSH を使用してインスタンスに接続できることを確認します。

Windows

開始する前に、お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

Windows ゲスト環境をインストールするには、昇格した PowerShell バージョン 3.0 以降のプロンプトで次のコマンドを実行します。以下の手順の Invoke-WebRequest コマンドには、3.0 より上のバージョンの PowerShell が必要です。

  1. GooGet をダウンロードして、インストールします。

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12;
Invoke-WebRequest https://github.com/google/googet/releases/download/v2.18.3/googet.exe -OutFile $env:temp\googet.exe;
& "$env:temp\googet.exe" -root C:\ProgramData\GooGet -noconfirm install -sources `
https://packages.cloud.google.com/yuck/repos/google-compute-engine-stable googet;
Remove-Item "$env:temp\googet.exe"

    GooGet のインストール中に、コンテンツをシステム環境に追加します。インストールが完了したら、新しい PowerShell コンソールを起動するか、googet.exe ファイルへのフルパス（C:\ProgramData\GooGet\googet.exe）を入力します。

  2. 新しいコンソールを開き、google-compute-engine-stable リポジトリを追加します。

    googet addrepo google-compute-engine-stable https://packages.cloud.google.com/yuck/repos/google-compute-engine-stable

  3. コア Windows ゲスト環境パッケージをインストールします。

    googet -noconfirm install google-compute-engine-windows `
google-compute-engine-sysprep google-compute-engine-metadata-scripts `
google-compute-engine-vss google-osconfig-agent

  4. オプションの Windows ゲスト環境パッケージをインスールします。

    googet -noconfirm install google-compute-engine-auto-updater

    googet コマンドの使用

    使用可能なパッケージを表示するには、googet available コマンドを実行します。

    インストール済みのパッケージを表示するには、googet installed コマンドを実行します。

    最新のパッケージ バージョンに更新するには、googet update コマンドを実行します。

    他のコマンドを表示するには、googet help を実行します。

ブートディスクのクローン作成と起動スクリプトの使用

インスタンスに接続してゲスト環境を手動でインストールできない場合は、この方法でゲスト環境をインストールします。この方法には、Google Cloud Console または Cloud Shell で行える次のような手順が含まれます。

この方法は、Linux ディストリビューションにのみ適用できます。Windows の場合は、他の 2 つのインストール方法のいずれかを使用してください。

この手順は Cloud Shell で行います。Cloud Shell を使用していない場合は、jq コマンドライン JSON プロセッサをインストールします。このプロセッサを使用して、gcloud CLI の出力をフィルタリングできます。Cloud Shell には jq がプリインストールされています。

CentOS/RHEL/Rocky

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. レスキュー インスタンスとして機能する新しいインスタンスを作成します。このインスタンスにレスキューという名前を付けます。このレスキュー インスタンスは、問題インスタンスと同じ Linux OS を実行する必要はありません。この例では、レスキュー インスタンスで Debian 9 を使用します。

  3. 問題インスタンスを停止し、そのルートディスクのコピーを作成します。

    1. 問題インスタンスの変数名を設定します。これにより、後の手順でインスタンスを簡単に参照できるようになります。

      export PROB_INSTANCE_NAME=VM_NAME

      VM_NAME は、問題インスタンスの名前に置き換えます。

    2. 問題インスタンスを停止します。

      gcloud compute instances stop "$PROB_INSTANCE_NAME"

    3. 問題インスタンスのブートディスクの名前を取得します。

      export PROB_INSTANCE_DISK="$(gcloud compute instances describe \
"$PROB_INSTANCE_NAME" --format='json' |  jq -r \
'.disks[] | select(.boot == true) | .source')"

    4. ブートディスクのスナップショットを作成します。

      export DISK_SNAPSHOT="${PROB_INSTANCE_NAME}-snapshot"

gcloud compute disks snapshot "$PROB_INSTANCE_DISK" \
   --snapshot-names "$DISK_SNAPSHOT"

    5. スナップショットから新しいディスクを作成します。

      export NEW_DISK="${PROB_INSTANCE_NAME}-new-disk"

gcloud compute disks create "$NEW_DISK" \
   --source-snapshot="$DISK_SNAPSHOT"

    6. スナップショットを削除します。

      gcloud compute snapshots delete "$DISK_SNAPSHOT"

  4. 新しいディスクをレスキュー インスタンスに接続し、そのルート ボリュームをマウントします。この手順では追加のディスクを 1 つだけ接続するため、新しいディスクのデバイス識別子は /dev/sdb になります。CentOS/RHEL/Rocky Linux では、デフォルトでディスク上の最初のボリュームをルート ボリュームとして使用するため、ボリューム識別子は /dev/sdb1 にする必要があります。カスタムケースでは、lsblk を使用してボリューム識別子を特定します。

    gcloud compute instances attach-disk rescue --disk "$NEW_DISK"

  5. SSH を使用してレスキュー インスタンスに接続します。

    gcloud compute ssh rescue

  6. レスキュー インスタンスで次の手順を行います。

    1. 新しいディスクのルート ボリュームをマウントします。

      export NEW_DISK_MOUNT_POINT="/tmp/sdb-root-vol"
DEV="/dev/sdb1"
sudo mkdir "$NEW_DISK_MOUNT_POINT"
sudo mount -o nouuid "$DEV" "$NEW_DISK_MOUNT_POINT"

    2. rc.local スクリプトを作成します。

      cat <<'EOF' >/tmp/rc.local
#!/bin/bash
echo "== Installing Google guest environment for CentOS/RHEL/Rocky Linux =="
sleep 30 # Wait for network.
echo "Determining CentOS/RHEL/Rocky Linux version..."
eval $(grep VERSION_ID /etc/os-release)
if [[ -z $VERSION_ID ]]; then
  echo "ERROR: Could not determine version of CentOS/RHEL/Rocky Linux."
  exit 1
fi
echo "Updating repo file..."
tee "/etc/yum.repos.d/google-cloud.repo" << EOM
[google-compute-engine]
name=Google Compute Engine
baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-el${VERSION_ID/.*}-x86_64-stable
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
echo "Running yum makecache..."
yum makecache
echo "Running yum updateinfo..."
yum updateinfo
echo "Running yum install google-compute-engine..."
yum install -y google-compute-engine
rpm -q google-compute-engine
if [[ $? -ne 0 ]]; then
  echo "ERROR: Failed to install ${pkg}."
fi
echo "Removing this rc.local script."
rm /etc/rc.d/rc.local
# Move back any previous rc.local:
if [[ -f "/etc/moved-rc.local" ]]; then
  echo "Restoring a previous rc.local script."
  mv "/etc/moved-rc.local" "/etc/rc.d/rc.local"
fi
echo "Restarting the instance..."
reboot
EOF

    3. rc.local スクリプトを新しいディスクのルート ボリュームに移動し、権限を設定します既存の rc.local スクリプトはそのままにします。これは、終了時に一時的なスクリプトによって置き換えられます。

      if [ -f "$NEW_DISK_MOUNT_POINT/etc/rc.d/rc.local" ]; then
  sudo mv "$NEW_DISK_MOUNT_POINT/etc/rc.d/rc.local" \
  "$NEW_DISK_MOUNT_POINT/etc/moved-rc.local"
fi
sudo mv /tmp/rc.local "$NEW_DISK_MOUNT_POINT/etc/rc.d/rc.local"
sudo chmod 0755 "$NEW_DISK_MOUNT_POINT/etc/rc.d/rc.local"
sudo chown root:root "$NEW_DISK_MOUNT_POINT/etc/rc.d/rc.local"

    4. 新しいディスクのルート ボリュームをアンマウントします。

      sudo umount "$NEW_DISK_MOUNT_POINT" && sudo rmdir \
"$NEW_DISK_MOUNT_POINT"

    5. レスキュー インスタンスへの SSH セッションを終了します。

  7. レスキュー インスタンスから新しいディスクを切断します。

    gcloud compute instances detach-disk rescue --disk "$NEW_DISK"

  8. 置換インスタンスとして機能するインスタンスを作成します。置換インスタンスを作成するときに、新しいディスクをブートディスクとして指定します。置換インスタンスは Google Cloud Console で作成できます。

    1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。

      [VM インスタンス] に移動

    2. 問題インスタンスをクリックして、[同様のものを作成] をクリックします。

    3. 置換インスタンスの名前を指定します。[ブートディスク] セクションで、[変更] をクリックしてから、[既存のディスク] をクリックします。新しいディスクを選択します。

    4. [作成] をクリックします。置換インスタンスは、作成されると自動的に開始されます。

    置換インスタンスが開始されると、一時的な rc.local スクリプトが実行され、ゲスト環境がインストールされます。このスクリプトの進行状況を監視するには、一時的な rc.local スクリプトによって生成されたコンソールログの行を調べます。ログを表示するには、次のコマンドを実行します。

    gcloud compute instances get-serial-port-output REPLACEMENT_VM_NAME

    REPLACEMENT_VM_NAME は、置換インスタンスに割り当てた名前に置き換えます。

    また、一時的な rc.local スクリプトが終了すると、置換インスタンスが自動的に再起動されます。2 回目の再起動中にコンソールログを調査することで、ゲスト環境が読み込まれていることを確認できます。

  9. SSH を使用してインスタンスに接続できることを確認します。

    置換インスタンスが機能していることを確認したら、問題インスタンスを停止または削除できます。

Debian

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. レスキュー インスタンスとして機能する新しいインスタンスを作成します。このインスタンスにレスキューという名前を付けます。このレスキュー インスタンスは、問題インスタンスと同じ Linux OS を実行する必要はありません。この例では、レスキュー インスタンスで Debian 9 を使用します。

  3. 問題インスタンスを停止し、そのルートディスクのコピーを作成します。

    1. 問題インスタンスの変数名を設定します。これにより、後の手順でインスタンスを簡単に参照できるようになります。

      export PROB_INSTANCE_NAME=VM_NAME

      VM_NAME は、問題インスタンスの名前に置き換えます。

    2. 問題インスタンスを停止します。

      gcloud compute instances stop "$PROB_INSTANCE_NAME"

    3. 問題インスタンスのブートディスクの名前を取得します。

      export PROB_INSTANCE_DISK="$(gcloud compute instances describe \
"$PROB_INSTANCE_NAME" --format='json' |  jq -r \
'.disks[] | select(.boot == true) | .source')"

    4. ブートディスクのスナップショットを作成します。

      export DISK_SNAPSHOT="${PROB_INSTANCE_NAME}-snapshot"

gcloud compute disks snapshot "$PROB_INSTANCE_DISK" \
   --snapshot-names "$DISK_SNAPSHOT"

    5. スナップショットから新しいディスクを作成します。

      export NEW_DISK="${PROB_INSTANCE_NAME}-new-disk"

gcloud compute disks create "$NEW_DISK" \
   --source-snapshot="$DISK_SNAPSHOT"

    6. スナップショットを削除します。

      gcloud compute snapshots delete "$DISK_SNAPSHOT"

  4. 新しいディスクをレスキュー インスタンスに接続し、そのルート ボリュームをマウントします。この手順では追加のディスクを 1 つだけ接続するため、新しいディスクのデバイス識別子は /dev/sdb になります。Debian では、デフォルトでディスク上の最初のボリュームをルート ボリュームとして使用するため、ボリューム識別子は /dev/sdb1 にする必要がありますカスタムケースでは、lsblk を使用してボリューム識別子を特定します。

    gcloud compute instances attach-disk rescue --disk "$NEW_DISK"

  5. SSH を使用してレスキュー インスタンスに接続します。

    gcloud compute ssh rescue

  6. レスキュー インスタンスで次の手順を行います。

    1. 新しいディスクのルート ボリュームをマウントします。

      export NEW_DISK_MOUNT_POINT="/tmp/sdb-root-vol"
DEV="/dev/sdb1"
sudo mkdir "$NEW_DISK_MOUNT_POINT"
sudo mount "$DEV" "$NEW_DISK_MOUNT_POINT"

    2. rc.local スクリプトを作成します。

      cat <<'EOF' >/tmp/rc.local
#!/bin/bash
echo "== Installing Google guest environment for Debian =="
export DEBIAN_FRONTEND=noninteractive
sleep 30 # Wait for network.
echo "Determining Debian version..."
eval $(grep VERSION_CODENAME /etc/os-release)
if [[ -z $VERSION_CODENAME ]]; then
 echo "ERROR: Could not determine Debian version."
 exit 1
fi
echo "Adding GPG key for Google cloud repo."
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add -
echo "Updating repo file..."
tee "/etc/apt/sources.list.d/google-cloud.list" << EOM
deb http://packages.cloud.google.com/apt google-compute-engine-${VERSION_CODENAME}-stable main
deb http://packages.cloud.google.com/apt google-cloud-packages-archive-keyring-${VERSION_CODENAME} main
EOM
echo "Running apt update..."
apt update
echo "Installing packages..."
for pkg in google-cloud-packages-archive-keyring google-compute-engine; do
 echo "Running apt install ${pkg}..."
 apt install -y ${pkg}
 if [[ $? -ne 0 ]]; then
    echo "ERROR: Failed to install ${pkg}."
 fi
done
echo "Removing this rc.local script."
rm /etc/rc.local
# Move back any previous rc.local:
if [[ -f "/etc/moved-rc.local" ]]; then
 echo "Restoring a previous rc.local script."
 mv "/etc/moved-rc.local" "/etc/rc.local"
fi
echo "Restarting the instance..."
reboot
EOF

    3. rc.local スクリプトを新しいディスクのルート ボリュームに移動し、権限を設定します既存の rc.local スクリプトはそのままにします。これは、終了時に一時的なスクリプトによって置き換えられます。

      if [[ -f "$NEW_DISK_MOUNT_POINT/etc/rc.local" ]]; then
   sudo mv "$NEW_DISK_MOUNT_POINT/etc/rc.local" \
   "$NEW_DISK_MOUNT_POINT/etc/moved-rc.local"
fi
sudo mv /tmp/rc.local "$NEW_DISK_MOUNT_POINT/etc/rc.local"
sudo chmod 0755 "$NEW_DISK_MOUNT_POINT/etc/rc.local"
sudo chown root:root "$NEW_DISK_MOUNT_POINT/etc/rc.local"

    4. 新しいディスクのルート ボリュームをアンマウントします。

      sudo umount "$NEW_DISK_MOUNT_POINT" && sudo rmdir "$NEW_DISK_MOUNT_POINT"

    5. レスキュー インスタンスへの SSH セッションを終了します。

  7. レスキュー インスタンスから新しいディスクを切断します。

    gcloud compute instances detach-disk rescue --disk "$NEW_DISK"

  8. 置換インスタンスとして機能する新しいインスタンスを作成します。置換インスタンスを作成するときに、新しいディスクをブートディスクとして指定します。置換インスタンスは Google Cloud Console で作成できます。

    1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。

      [VM インスタンス] に移動

    2. 問題インスタンスをクリックして、[同様のものを作成] をクリックします。

    3. 置換インスタンスの名前を指定します。[ブートディスク] セクションで、[変更] をクリックしてから、[既存のディスク] をクリックします。新しいディスクを選択します。

    4. [作成] をクリックします。置換インスタンスは、作成されると自動的に開始されます。

    置換インスタンスが開始されると、一時的な rc.local スクリプトが実行され、ゲスト環境がインストールされます。このスクリプトの進行状況を監視するには、一時的な rc.local スクリプトによって生成されたコンソールログの行を調べます。ログを表示するには、次のコマンドを実行します。

    gcloud compute instances get-serial-port-output REPLACEMENT_VM_NAME

    REPLACEMENT_VM_NAME は、置換インスタンスに割り当てた名前に置き換えます。

    また、一時的な rc.local スクリプトが終了すると、置換インスタンスが自動的に再起動されます。2 回目の再起動中にコンソールログを調査することで、ゲスト環境が読み込まれていることを確認できます。

  9. SSH を使用してインスタンスに接続できることを確認します。

    置換インスタンスが機能していることを確認したら、問題インスタンスを停止または削除できます。

Ubuntu

  1. お使いのオペレーティング システムのバージョンがサポートされていることを確認します。

  2. レスキュー インスタンスとして機能する新しいインスタンスを作成します。このインスタンスにレスキューという名前を付けます。このレスキュー インスタンスは、問題インスタンスと同じ Linux OS を実行する必要はありません。この例では、レスキュー インスタンスで Debian 9 を使用します。

  3. 問題インスタンスを停止し、そのルートディスクのコピーを作成します。

    1. 問題インスタンスの変数名を設定します。これにより、後の手順でインスタンスを簡単に参照できるようになります。

      export PROB_INSTANCE_NAME=VM_NAME

      VM_NAME は、問題インスタンスの名前に置き換えます。

    2. 問題インスタンスを停止します。

      gcloud compute instances stop "$PROB_INSTANCE_NAME"

    3. 問題インスタンスのブートディスクの名前を取得します。

      export PROB_INSTANCE_DISK="$(gcloud compute instances describe \
"$PROB_INSTANCE_NAME" --format='json' |  jq -r \
'.disks[] | select(.boot == true) | .source')"

    4. ブートディスクのスナップショットを作成します。

      export DISK_SNAPSHOT="${PROB_INSTANCE_NAME}-snapshot"

gcloud compute disks snapshot "$PROB_INSTANCE_DISK" \
   --snapshot-names "$DISK_SNAPSHOT"

    5. スナップショットから新しいディスクを作成します。

      export NEW_DISK="${PROB_INSTANCE_NAME}-new-disk"

gcloud compute disks create "$NEW_DISK" \
   --source-snapshot="$DISK_SNAPSHOT"

    6. スナップショットを削除します。

      gcloud compute snapshots delete "$DISK_SNAPSHOT"

  4. 新しいディスクをレスキュー インスタンスに接続し、そのルート ボリュームをマウントします。この手順では追加のディスクを 1 つだけ接続するため、新しいディスクのデバイス識別子は /dev/sdb になります。Ubuntu では、デフォルトでルート ボリュームに 1 というラベルを付けるため、ボリューム識別子は /dev/sdb1 にする必要がありますカスタムケースでは、lsblk を使用してボリューム識別子を特定します。

    gcloud compute instances attach-disk rescue --disk "$NEW_DISK"

  5. SSH を使用してレスキュー インスタンスに接続します。

    gcloud compute ssh rescue

  6. レスキュー インスタンスで次の手順を行います。

    1. 新しいディスクのルート ボリュームをマウントします。

      export NEW_DISK_MOUNT_POINT="/tmp/sdb-root-vol"
DEV="/dev/sdb1"
sudo mkdir "$NEW_DISK_MOUNT_POINT"
sudo mount "$DEV" "$NEW_DISK_MOUNT_POINT"

    2. rc.local スクリプトを作成します。

      cat <<'EOF' >/tmp/rc.local
#!/bin/bash
echo "== Installing a Linux guest environment for Ubuntu =="
sleep 30 # Wait for network.
echo "Running apt update..."
apt update
echo "Installing packages..."
echo "Running apt install google-compute-engine..."
apt install -y google-compute-engine
if [[ $? -ne 0 ]]; then
 echo "ERROR: Failed to install ${pkg}."
fi
echo "Removing this rc.local script."
rm /etc/rc.local
# Move back any previous rc.local:
if [[ -f "/etc/moved-rc.local" ]]; then
 echo "Restoring a previous rc.local script."
 mv "/etc/moved-rc.local" "/etc/rc.local"
fi
echo "Restarting the instance..."
reboot
EOF

    3. rc.local スクリプトを新しいディスクのルート ボリュームに移動し、権限を設定します既存の rc.local スクリプトはそのままにします。これは、終了時に一時的なスクリプトによって置き換えられます。

      if [[ -f "$NEW_DISK_MOUNT_POINT/etc/rc.local" ]]; then
   sudo mv "$NEW_DISK_MOUNT_POINT/etc/rc.local" \
   "$NEW_DISK_MOUNT_POINT/etc/moved-rc.local"
fi
sudo mv /tmp/rc.local "$NEW_DISK_MOUNT_POINT/etc/rc.local"
sudo chmod 0755 "$NEW_DISK_MOUNT_POINT/etc/rc.local"
sudo chown root:root "$NEW_DISK_MOUNT_POINT/etc/rc.local"

    4. 新しいディスクのルート ボリュームをアンマウントします。

      sudo umount "$NEW_DISK_MOUNT_POINT" && sudo rmdir "$NEW_DISK_MOUNT_POINT"

    5. レスキュー インスタンスへの SSH セッションを終了します。

  7. レスキュー インスタンスから新しいディスクを切断します。

    gcloud compute instances detach-disk rescue --disk "$NEW_DISK"

  8. 置換インスタンスとして機能する新しいインスタンスを作成します。置換インスタンスを作成するときに、新しいディスクをブートディスクとして指定します。置換インスタンスは Google Cloud Console で作成できます。

    1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。

      [VM インスタンス] に移動

    2. 問題インスタンスをクリックして、[同様のものを作成] をクリックします。

    3. 置換インスタンスの名前を指定します。[ブートディスク] セクションで、[変更] をクリックしてから、[既存のディスク] をクリックします。新しいディスクを選択します。

    4. [作成] をクリックします。置換インスタンスは、作成されると自動的に開始されます。

    置換インスタンスが開始されると、一時的な rc.local スクリプトが実行され、ゲスト環境がインストールされます。このスクリプトの進行状況を監視するには、一時的な rc.local スクリプトによって生成されたコンソールログの行を調べます。ログを表示するには、次のコマンドを実行します。

    gcloud compute instances get-serial-port-output REPLACEMENT_VM_NAME

    REPLACEMENT_VM_NAME は、置換インスタンスに割り当てた名前に置き換えます。

    また、一時的な rc.local スクリプトが終了すると、置換インスタンスが自動的に再起動されます。2 回目の再起動中にコンソールログを調査することで、ゲスト環境が読み込まれていることを確認できます。

  9. SSH を使用してインスタンスに接続できることを確認します。

    置換インスタンスが機能していることを確認したら、問題インスタンスを停止または削除できます。

ゲスト環境の更新

ゲスト環境が古いというメッセージが表示された場合は、オペレーティング システムのパッケージを更新します。

CentOS/RHEL/Rocky

CentOS、RHEL、Rocky Linux オペレーティング システムを更新するには、次のコマンドを実行します。

sudo yum makecache
sudo yum install google-compute-engine google-compute-engine-oslogin \
google-guest-agent google-osconfig-agent

Debian

Debian オペレーティング システムを更新するには、次のコマンドを実行します。

sudo apt update
sudo apt install google-compute-engine google-compute-engine-oslogin \
google-guest-agent google-osconfig-agent

Ubuntu

Ubuntu オペレーティング システムを更新するには、次のコマンドを実行します。

sudo apt update
sudo apt install google-compute-engine google-compute-engine-oslogin \
google-guest-agent google-osconfig-agent

SLES

SLES オペレーティング システムを更新するには、次のコマンドを実行します。

sudo zypper refresh
sudo zypper install google-guest-{agent,configs,oslogin} \
google-osconfig-agent

Windows

Windows オペレーティング システムを更新するには、次のコマンドを実行します。

googet update

ゲスト環境を検証する

ゲスト環境の存在は、インスタンスの起動中にコンソールに出力されるシステムログを調査するか、インスタンスへの接続中にインストールされたパッケージをリストすることによって判断できます。

ゲスト環境の想定されるコンソールログ

この表は、稼働中のゲスト環境が起動するときにインスタンスから発行されるコンソールログの想定される出力をまとめたものです。

オペレーティング システム サービス管理 予想される出力
CentOS/RHEL/Rocky Linux
Debian
Ubuntu
SLES
Container-Optimized OS 89 以降		 systemd 
google_guest_agent: GCE Agent Started (version YYYYMMDD.NN)
google_metadata_script_runner: Starting startup scripts (version YYYYMMDD.NN)
OSConfigAgent Info: OSConfig Agent (version YYYYMMDD.NN)
Container-Optimized OS 85 以前 systemd 
Started Google Compute Engine Accounts Daemon
Started Google Compute Engine Network Daemon
Started Google Compute Engine Clock Skew Daemon
Started Google Compute Engine Instance Setup
Started Google Compute Engine Startup Scripts
Started Google Compute Engine Shutdown Scripts
Windows 
GCEGuestAgent: GCE Agent Started (version YYYYMMDD.NN)
GCEMetadataScripts: Starting startup scripts (version YYYYMMDD.NN)
OSConfigAgent Info: OSConfig Agent (version YYYYMMDD.NN)

インスタンスのコンソールログを表示するには、次の手順を実行します。

Console

  1. Google Cloud コンソールの [VM インスタンス] ページに移動します。

    [VM インスタンス] に移動

    1. 調査する必要があるインスタンスをクリックします。
    2. インスタンスを再起動するかリセットします。
    3. [ログ] で、[シリアルポート 1（コンソール）] をクリックします。
    4. 上の表を参照して想定される出力を探します。

gcloud

  1. インスタンスを再起動するかリセットします。

  2. Google Cloud CLI の gcloud compute instances get-serial-port-output サブコマンドを使用して接続します。次に例を示します。

    gcloud compute instances get-serial-port-output VM_NAME

    VM_NAME は、調査が必要なインスタンスの名前に置き換えます。

  3. 上の表を参照して想定される出力を探します。

ゲスト環境で読み込まれるサービス

この表は、稼働中のゲスト環境でインスタンスに読み込む必要があるサービスをまとめたものです。サービスをリストするコマンドは、インスタンスに接続した後に実行する必要があります。そのため、このチェックはインスタンスへのアクセス権がある場合にのみ実行できます。

オペレーティング システム サービスの一覧を取得するコマンド 予想される出力
CentOS/RHEL/Rocky Linux
Debian		 
sudo systemctl list-unit-files \
| grep google | grep enabled
 
google-disk-expand.service             enabled
google-guest-agent.service             enabled
google-osconfig-agent.service          enabled
google-shutdown-scripts.service        enabled
google-startup-scripts.service         enabled
google-oslogin-cache.timer             enabled
Ubuntu 
sudo systemctl list-unit-files \
| grep google | grep enabled
 
google-guest-agent.service             enabled
google-osconfig-agent.service          enabled
google-shutdown-scripts.service        enabled
google-startup-scripts.service         enabled
google-oslogin-cache.timer             enabled
Container-Optimized OS 
sudo systemctl list-unit-files \
| grep google
 
var-lib-google.mount                   disabled
google-guest-agent.service             disabled
google-osconfig-agent.service          disabled
google-osconfig-init.service           disabled
google-oslogin-cache.service           static
google-shutdown-scripts.service        disabled
google-startup-scripts.service         disabled
var-lib-google-remount.service         static
google-oslogin-cache.timer             disabled
SLES 12 以降 
sudo systemctl list-unit-files \
| grep google | grep enabled
 
google-guest-agent.service              enabled
google-osconfig-agent.service           enabled
google-shutdown-scripts.service         enabled
google-startup-scripts.service          enabled
google-oslogin-cache.timer              enabled
Windows 
Get-Service GCEAgent
Get-ScheduledTask GCEStartup
 
Running    GCEAgent   GCEAgent
\          GCEStartup Ready

ゲスト環境でインストールされるパッケージ

この表は、稼働中のゲスト環境でインスタンスにインストールする必要があるパッケージをまとめたものです。インストールされるパッケージをリストするコマンドは、インスタンスに接続した後に実行する必要があります。そのため、このチェックはインスタンスへのアクセス権がある場合にのみ実行できます。

オペレーティング システム パッケージの一覧を取得するコマンド 予想される出力
CentOS/RHEL/Rocky Linux 
rpm -qa --queryformat '%{NAME}\n' \
| grep -iE 'google|gce'
 
google-osconfig-agent
google-compute-engine-oslogin
google-guest-agent
gce-disk-expand
google-cloud-sdk
google-compute-engine
Debian 
apt list --installed \
| grep -i google
 
gce-disk-expand
google-cloud-packages-archive-keyring
google-cloud-sdk
google-compute-engine-oslogin
google-compute-engine
google-guest-agent
google-osconfig-agent
Ubuntu 
apt list --installed \
| grep -i google
 
google-compute-engine-oslogin
google-compute-engine
google-guest-agent
google-osconfig-agent
SUSE（SLES） 
rpm -qa --queryformat '%{NAME}\n' \
| grep -i google
 
google-guest-configs
google-osconfig-agent
google-guest-oslogin
google-guest-agent
Windows 
googet installed
 
certgen
googet
google-compute-engine-auto-updater
google-compute-engine-driver-gga
google-compute-engine-driver-netkvm
google-compute-engine-driver-pvpanic
google-compute-engine-driver-vioscsi
google-compute-engine-metadata-scripts
google-compute-engine-powershell
google-compute-engine-sysprep
google-compute-engine-vss
google-compute-engine-windows
google-osconfig-agent

次のステップ