連線至 VM

控制台

1. 在導覽選單中，依序點選「Virtual Machines」>「Instances」(虛擬機器 > 執行個體)。

2. 在 VM 清單中，找出要連線的執行中 VM 所在列。在「連線」欄中，按一下「SSH」。

3. SSH 瀏覽器終端機隨即開啟。在 Shell 中輸入任何指令，或按一下「FTP」FTP瀏覽檔案結構並上傳檔案。

gdcloud

執行 gdcloud compute ssh 指令，透過 SSH 連線至 VM

gdcloud compute ssh VM_NAME \
  --project=PROJECT_ID

請替換下列變數：

• VM_NAME：VM 的名稱。
• PROJECT_ID：包含 VM 的專案 ID。

如果已為 CLI 設定預設屬性，則可省略此指令中的 --project 旗標。例如：

gdcloud compute ssh VM_NAME

API

VirtualMachine 資源會使用 GuestEnvironmentSynced 條件來指出啟動狀態。如果 GuestEnvironmentSynced 條件為 True，表示 VM 已完成啟動，可供 SSH 連線。

下列程式碼片段範例顯示 VirtualMachine 資源，且 GuestEnvironmentSynced 條件設為 True：

{
    "apiVersion": "virtualmachine.gdc.goog/v1",
    "kind": "VirtualMachine",
    ...
    "status": {
        "conditions": [
            {
                "lastTransitionTime": "2026-01-25T09:52:52Z",
                "message": "No message available",
                "observedGeneration": 3,
                "reason": "AccessManagementReady",
                "status": "True",
                "type": "GuestEnvironmentSynced"
            },
        ],
    },
}

確認 VM 的 GuestEnvironmentSynced 狀態為 True 後，請按照下列步驟連線至 VM：

• 開啟終端機。
• 建立 SSH 金鑰組。
• 上傳公開金鑰和使用者名稱，並設定存留時間 (TTL) 值。

GDC 會擷取 SSH 金鑰和使用者名稱，並以該使用者名稱建立使用者帳戶。在 VM 上，GDC 會將公開金鑰儲存在 VM 上使用者 ~/.ssh/authorized_keys 檔案中。

請按照下列步驟，透過指令列連線至 VM：

1. 建立 SSH 金鑰組和使用者名稱。

   在 OS 工作站上，使用 ssh-keygen 公用程式建立新的安全殼層金鑰組。下列程式碼範例會建立 RSA (Rivest-Shamir-Adleman) 金鑰組：

   ssh-keygen -t rsa \
     -f ~/.ssh/KEY_FILENAME \
     -C USERNAME \
     -b 2048
   

   請使用下列定義替換變數。

   變數	定義
   KEY_FILENAME	安全殼層金鑰檔案的名稱。例如，my-ssh-key 檔案名稱會產生名為 my-ssh-key 的私密金鑰檔案，以及名為 my-ssh-key.pub 的公開金鑰檔案。
   USERNAME	VM 上的使用者名稱，例如 testuser 或 testuser_gmail_com。

   ssh-keygen 公用程式會將私密金鑰檔案儲存在 ~/.ssh/KEY_FILENAME 路徑，並將公開金鑰檔案儲存在 ~/.ssh/KEY_FILENAME.pub 路徑。

   使用者 testuser 的公開金鑰類似於下列範例：

   ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF... testuser
   

2. 將金鑰上傳至 VM，並使用金鑰的公開金鑰、使用者名稱和存留時間 (TTL) 值建立 Kubernetes 資源。

   以下範例使用 access_request.yaml 檔案，透過 KEY_FILENAME 私密金鑰授與 VM 執行個體存取權，並將 TTL 值設為十分鐘：

   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineAccessRequest
   metadata:
     namespace: VM_NAMESPACE
     name: AR_NAME
   spec:
     ssh:
       key: |
         ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAu5kKQCPF... cloudysanfrancisco
       ttl: 10m
     user: USERNAME
     vm: VM_NAME
   

   請使用下列定義替換變數：

   變數	定義
   VM_NAMESPACE	VM 的命名空間。
   AR_NAME	存取要求名稱。
   USERNAME	VM 上的使用者名稱，例如 testuser 或 testuser_gmail_com。
   VM_NAME	VM 執行個體的名稱。

3. 建立金鑰：

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     create -f access_request.yaml
   

4. 查看存取權要求狀態：

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n VM_NAMESPACE \
     get virtualmachineaccessrequests.virtualmachine.gdc.goog
   

   將 VM_NAMESPACE 替換為 VM 的命名空間。

   configured 狀態表示您可以連線至 VM。

5. 連線至 VM：

   ssh -i PATH_TO_PRIVATE_KEY USERNAME@EXTERNAL_IP
   

   替換下列值：

   • PATH_TO_PRIVATE_KEY，並提供與您新增至 VM 的公開金鑰對應的私密安全殼層金鑰檔案路徑。
   • USERNAME，其中 USERNAME 是您在建立 SSH 金鑰時指定的使用者名稱。例如：cloudysanfrancisco_example_com 或 cloudysanfrancisco。
   • EXTERNAL_IP，並使用 VM 的外部連入 IP 位址。

疑難排解

本節說明如何排解建立存取要求後，連線至 VM 執行個體時可能發生的問題。

請按照下列步驟找出可能的問題：

1. 確認 VM 正在執行中。在下列指令中，將可編輯的變數替換為您的值：

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n VM_NAMESPACE \
     get virtualmachines.virtualmachine.gdc.goog VM_NAME
   

   如果 VM 未執行，您就無法連線或設定新要求。

2. 確認 VM 已執行幾分鐘。如果 VM 剛啟動，SSH 存取所需的服務可能尚未執行。通常會在開機後五分鐘內執行。

3. 確認存取要求未超過 TTL 值。時間達到存留時間值後，系統就會移除金鑰。

4. 如果 VirtualMachineAccessRequest 顯示 configured 狀態，請確認下列規定：

   1. 您已啟用資料轉入至通訊埠 22 上的 VM。
   2. 您的機器會將流量轉送至 VM。舉例來說，您可以使用
      curl -vso /dev/null --connect-timeout 5 EXTERNAL_IP:22 指令檢查路徑。

5. 如果 VirtualMachineAccessRequest 顯示 failed 狀態，請查看完整狀態並檢查錯誤訊息，瞭解導致請求失敗的原因：

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n VM_NAMESPACE \
     describe virtualmachineaccessrequest.virtualmachine.gdc.goog AR_NAME
   

   將上述指令中可編輯的變數替換為您自己的值。

6. 如果 VirtualMachineAccessRequest 的狀態空白，可能表示訪客環境未執行。