安裝訪客環境

本頁說明如何為在 Compute Engine 上執行自訂映像檔的虛擬機器 (VM) 執行個體，手動安裝訪客環境。

在大多數情況下，如果您使用的是透過 Google 提供的公開映像檔建立的 VM，則無須安裝訪客環境。如要瞭解何時使用訪客環境，請參閱「何時手動安裝或更新訪客環境」。

手動安裝訪客環境之前，請先進行驗證訪客環境程序，檢查您的 VM 上是否正在執行訪客環境。如果 VM 上有可用的訪客環境，但該訪客環境已過時，請更新訪客環境。

事前準備

  • 如果尚未設定，請先設定驗證機制。驗證是指驗證身分，以便存取 Google Cloud 服務和 API 的程序。如要在本機開發環境中執行程式碼或範例，您可以選取下列任一選項，向 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

安裝方法

您可以透過多種方式安裝訪客環境，請選擇下列其中一個選項：

  • 匯入工具。這是我們建議的選項。不過，請注意，匯入工具不僅會安裝來賓環境，還會在映像檔上執行其他設定更新，例如設定網路、設定 Bootloader 和安裝 Google Cloud CLI。如要瞭解如何使用匯入工具，請參閱「將映像檔設定為可開機」一節。

    匯入工具支援多種作業系統和版本。詳情請參閱「作業系統詳細資訊」。

  • 手動安裝：選擇下列其中一個選項：

支援的作業系統

您可以在使用一般可用 (GA) 生命週期或延長支援生命週期階段的 OS 映像檔版本的 VM 上，手動安裝訪客環境。如要查看 Compute Engine 上的 OS 映像檔版本清單及其生命週期階段，請參閱「作業系統詳細資料」。

限制

您無法為 Fedora CoreOS 和 Container-Optimized 作業系統手動安裝或使用匯入工具安裝訪客環境。如果您需要上述其中一個作業系統，建議您使用公開映像檔，因為所有公開映像檔的核心部分均已包含訪客環境。

安裝訪客環境

就地安裝訪客環境

如果能以 SSH 連線至目標執行個體，請採用此方法安裝訪客環境。如果無法連線至執行個體安裝訪客環境，請複製開機磁碟並使用開機指令碼安裝訪客環境。

如果您可以使用安全殼層密碼式驗證來連線，則這項程序對匯入的映像檔來說很實用。如果您至少有一個使用者帳戶具備可運作的金鑰式安全殼層，這項程序也可以用於重新安裝訪客環境。

CentOS/RHEL/Rocky

  1. 確認您的作業系統版本受支援。

  2. 判斷 CentOS/RHEL/Rocky Linux 版本，並建立原始碼存放區檔案 /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 主控台或 Cloud Shell 中完成的步驟。

這個方法所提供的程序僅適用於 Linux 發行版。如果是 Windows，請使用其他兩種安裝方法。

請使用 Cloud Shell 執行此程序。如果您並未使用 Cloud Shell，請安裝 jq 指令列 JSON 處理器。您可以使用這個處理器篩選 gcloud CLI 輸出內容。Cloud Shell 已預先安裝 jq。

CentOS/RHEL/Rocky

  1. 確認您的作業系統版本受支援。

  2. 建立新執行個體以做為救援執行個體。將此執行個體命名為 rescue。此救援執行個體執行的 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. 將新磁碟連接至救援執行個體，並掛接救援執行個體的根磁碟區。由於這個程序只連接一個額外磁碟，因此新磁碟的裝置 ID 為 /dev/sdb。CentOS/RHEL/Rocky Linux 預設使用磁碟的第一個磁碟區做為根磁碟區，因此磁碟區 ID 應為 /dev/sdb1。如為自訂情況，請使用 lsblk 判定磁碟區 ID。

    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 控制台建立替代執行個體：

    1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

      前往 VM 執行個體

    2. 按一下有問題的執行個體，然後點選「建立類似的執行個體」。

    3. 指定替代執行個體的名稱。在「Boot disk」(開機磁碟) 區段，點選 [Change] (變更)，然後按一下 [Existing Disks](現有磁碟) 。選取新磁碟。

    4. 按一下 [Create] (建立)。替代執行個體在建立完成後會自動啟動。

    當替代執行個體啟動時，暫時 rc.local 指令碼會執行並安裝訪客環境。如要查看這個指令碼的進度，請檢查主控台記錄中暫時 rc.local 指令碼產生的記錄行。如要查看記錄，請執行下列指令：

    gcloud compute instances get-serial-port-output REPLACEMENT_VM_NAME

    將 REPLACEMENT_VM_NAME 替換為您指派給替代執行個體的名稱。

    當暫時 rc.local 指令碼完成時，替代執行個體也會自動重新啟動。在第二次重新啟動期間，您可以檢查主控台記錄，確保訪客環境可順利載入。

  9. 確認您可以使用 SSH 連線至執行個體。

    如果您對替代執行個體的運作情況感到滿意，就可以停止或刪除有問題的執行個體。

Debian

  1. 確認您的作業系統版本受支援

  2. 建立新執行個體以做為救援執行個體。將此執行個體命名為 rescue。此救援執行個體執行的 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. 將新磁碟連接至救援執行個體，並掛接救援執行個體的根磁碟區。由於這個程序只連接一個額外磁碟，因此新磁碟的裝置 ID 為 /dev/sdb。根據預設，Debian 會使用磁碟的第一個磁碟區做為根磁碟區，因此磁碟區 ID 應為 /dev/sdb1。如為自訂情況，請使用 lsblk 判定磁碟區 ID。

    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 控制台建立替代執行個體：

    1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

      前往 VM 執行個體

    2. 按一下有問題的執行個體，然後點選「建立類似的執行個體」。

    3. 指定替代執行個體的名稱。在「Boot disk」(開機磁碟) 區段，點選 [Change] (變更)，然後按一下 [Existing Disks](現有磁碟) 。選取新磁碟。

    4. 按一下 [Create] (建立)。替代執行個體在建立完成後會自動啟動。

    當替代執行個體啟動時，暫時 rc.local 指令碼會執行並安裝訪客環境。如要查看這個指令碼的進度，請檢查主控台記錄中暫時 rc.local 指令碼產生的記錄行。如要查看記錄，請執行下列指令：

    gcloud compute instances get-serial-port-output REPLACEMENT_VM_NAME

    將 REPLACEMENT_VM_NAME 替換為您為替代執行個體指派的名稱。

    當暫時 rc.local 指令碼完成時，替代執行個體也會自動重新啟動。在第二次重新啟動期間，您可以檢查主控台記錄，確保訪客環境可順利載入。

  9. 確認您可以使用 SSH 連線至執行個體。

    如果您對替代執行個體的運作情況感到滿意，就可以停止或刪除有問題的執行個體。

Ubuntu

  1. 確認您的作業系統版本受支援

  2. 建立新執行個體以做為救援執行個體。將此執行個體命名為 rescue。此救援執行個體執行的 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. 將新磁碟連接至救援執行個體，並掛接救援執行個體的根磁碟區。由於這個程序只連接一個額外磁碟，因此新磁碟的裝置 ID 為 /dev/sdb。根據預設，Ubuntu 會將自己的根磁碟區標示為 1，因此磁碟區 ID 應為 /dev/sdb1。如為自訂情況，請使用 lsblk 判定磁碟區 ID。

    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 控制台建立替代執行個體：

    1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

      前往 VM 執行個體

    2. 按一下有問題的執行個體，然後點選「建立類似的執行個體」。

    3. 指定替代執行個體的名稱。在「Boot disk」(開機磁碟) 區段，點選 [Change] (變更)，然後按一下 [Existing Disks](現有磁碟) 。選取新磁碟。

    4. 按一下 [Create] (建立)。替代執行個體在建立完成後會自動啟動。

    當替代執行個體啟動時，暫時 rc.local 指令碼會執行並安裝訪客環境。如要查看這個指令碼的進度，請檢查主控台記錄中暫時 rc.local 指令碼產生的記錄行。如要查看記錄，請執行下列指令：

    gcloud compute instances get-serial-port-output REPLACEMENT_VM_NAME

    將 REPLACEMENT_VM_NAME 替換為您指派給替代執行個體的名稱。

    當暫時 rc.local 指令碼完成時，替代執行個體也會自動重新啟動。在第二次重新啟動期間，您可以檢查主控台記錄，確保訪客環境可順利載入。

  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)

如要查看執行個體的主控台記錄，請執行下列步驟。

主控台

  1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

    前往 VM 執行個體

    1. 點選要您要檢查的執行個體。
    2. 重新啟動或重設執行個體。
    3. 在「記錄」下按一下 [序列埠 1 (主控台)]。
    4. 參考上表搜尋預期的輸出。

gcloud

  1. 重新啟動或重設執行個體。

  2. 使用 gcloud compute instances get-serial-port-output 子指令，透過 Google Cloud CLI 進行連線。例如：

    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

後續步驟