本頁說明如何管理 Google Distributed Cloud connected 部署作業中的虛擬機器,這些虛擬機器執行 Google Distributed Cloud 的 VM 執行階段。完成本頁的步驟前,請務必先熟悉 GDC 上的 VM 執行階段。如需支援的客層作業系統清單,請參閱 GDC 上 VM 執行階段的已驗證客層作業系統。
如要瞭解虛擬機器如何做為 Distributed Cloud connected 平台的重要元件,請參閱「擴充 GKE Enterprise,管理內部部署邊緣 VM」。
Distributed Cloud 連線叢集支援虛擬機器 Webhook。這項功能可讓 Distributed Cloud 連線驗證向本機 Kubernetes API 伺服器發出的使用者要求。遭拒的要求會產生詳細資訊,說明遭拒原因。
設定 Symcloud Storage
Google Distributed Cloud connected 使用 Rakuten Symcloud Storage 做為儲存空間解決方案。Symcloud Storage 是第三方解決方案,可做為每個 Distributed Cloud connected 節點上的本機儲存空間抽象層,並讓其他 Distributed Cloud connected 節點上執行的工作負載使用本機儲存空間。
Symcloud Storage 是從 Google Cloud Marketplace 部署,並受其中所述條款約束。Google 僅提供有限的支援,協助您搭配使用 Symcloud Storage 與 Distributed Cloud Connected,並可能會聘僱第三方供應商提供協助。Distributed Cloud 連線軟體更新包含 Symcloud Storage 的軟體更新。
請按照下列步驟設定 Google Distributed Cloud connected 叢集,為虛擬機器啟用 Symcloud Storage。詳情請參閱「在 Distributed Cloud 連線節點上安裝 Symcloud Storage」。
使用下列指令建立
robin-admin命名空間:kubectl create ns robin-admin
取得 Symcloud Storage 授權檔案,並使用下列指令套用至叢集:
kubectl apply LICENSE_FILE
執行下列指令,確認 Symcloud Storage 正常運作:
kubectl describe robincluster
指令會傳回類似以下內容的輸出結果:
Name: robin Namespace: Labels: app.kubernetes.io/instance=robin app.kubernetes.io/managed-by=robin.io app.kubernetes.io/name=robin Annotations: <none> API Version: manage.robin.io/v1 Kind: RobinCluster Metadata: … Spec: … Status: … Phase: Ready …將下列設定套用至叢集,建立
robin-block-immediate儲存空間類別:apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: robin-block-immediate parameters: faultdomain: host replication: "3" blocksize: "512" provisioner: robin reclaimPolicy: Delete volumeBindingMode: Immediate allowVolumeExpansion: true
將下列設定套用至叢集,建立
robin-snapshotclass磁碟區快照類別:apiVersion: snapshot.storage.k8s.io/v1 kind: VolumeSnapshotClass metadata: name: robin-snapshotclass labels: app.kubernetes.io/instance: robin app.kubernetes.io/managed-by: robin.io app.kubernetes.io/name: robin annotations: snapshot.storage.kubernetes.io/is-default-class: "true" driver: robin deletionPolicy: Delete使用下列內容修改
robin-block-immediate儲存空間類別的storageprofile,然後套用至叢集:apiVersion: cdi.kubevirt.io/v1beta1 kind: StorageProfile metadata: name: robin-block-immediate spec: claimPropertySets: accessModes: ReadWriteMany volumeMode: Block
安裝 virtctl 管理工具
您需要 virtctl 用戶端工具,才能管理 Distributed Cloud connected 叢集中的虛擬機器。如要安裝這項工具,請完成下列步驟:
將
virtctl用戶端工具安裝為kubectl外掛程式:export VERSION=GDC_SO_VERSION gcloud storage cp gs://anthos-baremetal-release/virtctl/${VERSION}/linux-amd64/virtctl ./virtctl sudo mv ./virtctl /usr/local/bin/virtctl cd /usr/local/bin sudo ln -s virtctl kubectl-virt sudo chmod a+x virtctl cd -
將
GDC_SO_VERSION替換為 Distributed Cloud 軟體專屬的目標版本。確認已安裝
virt外掛程式:kubectl plugin list
如果外掛程式安裝成功,指令輸出內容會將
kubectl-virt列為外掛程式之一。
建立 VM 映像檔的 Cloud Storage bucket
完成本節中的步驟,為虛擬機器映像檔建立 Cloud Storage bucket。儲存空間會使用 Workload Identity Federation,將 Kubernetes 服務帳戶繫結至對應的 Google Cloud 服務帳戶,以存取儲存空間;換句話說,Kubernetes 服務帳戶會模擬 Google Cloud服務帳戶。如果您已有映像檔存放區,請略過本節。
如要降低多叢集機群中身分相同的風險,請按照本節步驟操作時,遵循「機群 Workload Identity 聯盟最佳做法」的指引。
完成「建立值區」一文中的步驟,建立值區。
建立服務帳戶來存取 bucket: Google Cloud
export GSA_PROJECT_ID=GSA_PROJECT_ID export GSA_NAME=GSA_NAME gcloud iam service-accounts create ${GSA_NAME}
更改下列內容:
GSA_NAME:這個 Google Cloud 服務帳戶的名稱。GSA_PROJECT_ID:託管目標 Google Cloud 服務帳戶的Google Cloud 專案 ID。
授予 Google Cloud 服務帳戶存取 bucket 的權限:
export BUCKET_PROJECT_ID=BUCKET_PROJECT_ID export GSA_NAME=GSA_NAME gcloud storage buckets add-iam-policy-binding gs://${BUCKET_PROJECT_ID}-vm-images \ --member="serviceAccount:${GSA_NAME}@${GSA_PROJECT_ID}.iam.gserviceaccount.com" \ --role="roles/storage.objectViewer" \ --project=${BUCKET_PROJECT_ID}
更改下列內容:
GSA_NAME:目標 Google Cloud 服務帳戶的名稱。BUCKET_PROJECT_ID:託管值區的 Google Cloud 專案 ID。GSA_PROJECT_ID:託管目標 Google Cloud 服務帳戶的Google Cloud 專案 ID。
在目標虛擬機器的命名空間中建立 Kubernetes 服務帳戶,以便繫結至您的 Google Cloud 服務帳戶:
export GSA_PROJECT_ID=GSA_PROJECT_ID export VM_NAMESPACE=NAMESPACE export KSA_NAME=KSA_NAME export GSA_EMAIL=${GSA_NAME}@${GSA_PROJECT_ID}.iam.gserviceaccount.com kubectl create serviceaccount ${KSA_NAME} -n ${VM_NAMESPACE} kubectl annotate serviceaccount ${KSA_NAME} gsaEmail=${GSA_EMAIL} -n ${VM_NAMESPACE}
更改下列內容:
GSA_PROJECT_ID:託管目標 Google Cloud 服務帳戶的Google Cloud 專案 ID。NAMESPACE:目標虛擬機器的命名空間。KSA_NAME:這個 Kubernetes 服務帳戶的有意義名稱。GSA_NAME:對應 Google Cloud 服務帳戶的名稱。
找出叢集的workload identity pool 和身分識別提供者名稱:
gcloud container fleet memberships describe MEMBERSHIP_ID \ --project=FLEET_PROJECT_ID \ --format="table(authority.identityProvider,authority.workloadIdentityPool,name)"
更改下列內容:
MEMBERSHIP_ID:叢集的艦隊成員名稱。這通常是叢集名稱。FLEET_PROJECT_ID:機群主機 Google Cloud 專案的 ID。
指令會傳回類似以下內容的輸出結果:
IDENTITY_PROVIDER: IDENTITY_PROVIDER WORKLOAD_IDENTITY_POOL: WORKLOAD_IDENTITY_POOL在輸出中,記下下列值:
IDENTITY_PROVIDER:這個叢集的 IDP。WORKLOAD_IDENTITY_POOL:與車隊相關聯的工作負載身分集區名稱。名稱格式為FLEET_PROJECT_ID.svc.id.goog。 如要進一步瞭解這個步驟中的指令,請參閱「在應用程式中使用 Fleet Workload Identity Federation」。
將 Kubernetes 服務帳戶繫結至 Google Cloud 服務帳戶,以設定模擬:
export GSA_PROJECT_ID=GSA_PROJECT_ID export GSA_NAME=GSA_NAME export KSA_NAME=KSA_NAME export VM_NAMESPACE=NAMESPACE export WI_POOL=WORKLOAD_IDENTITY_POOL gcloud iam service-accounts add-iam-policy-binding ${GSA_NAME}@${GSA_PROJECT_ID}.iam.gserviceaccount.com \ --project=${GSA_PROJECT_ID} \ --role=roles/iam.workloadIdentityUser \ --member="serviceAccount:${WI_POOL}[${VM_NAMESPACE}/${KSA_NAME}]" --condition="IAM_CONDITION" --condition-from-file="IAM_CONDITION_FILE"
更改下列內容:
GSA_PROJECT_ID:託管目標 Google Cloud 服務帳戶的Google Cloud 專案 ID。GSA_NAME:對應 Google Cloud 服務帳戶的名稱。KSA_NAME:目標 Kubernetes 服務帳戶的名稱。NAMESPACE:目標虛擬機器的命名空間。WORKLOAD_IDENTITY_POOL:叢集工作負載身分集區的名稱。IAM_CONDITION:選用;指定要使用的 IAM 條件,限制存取機群內的特定叢集。如果省略或設為None,系統不會套用任何 IAM 條件。IAM_CONDITION_FILE:選用;指定包含 IAM 條件的檔案,用於限制機群內特定叢集的存取權。如果省略,除非指定--condition旗標並設為None以外的值,否則不會套用任何 IAM 條件。
將圖片儲存在值區中。
您也可以使用舊版方法,也就是透過 Google 服務帳戶的有效金鑰產生的密碼。詳情請參閱「為虛擬機器映像檔建立 Cloud Storage bucket」。
使用 IAM 條件限制對 Bucket 的存取權
IAM 條件可讓您指定機群中哪些叢集可以存取值區。如果未指定 IAM 條件,機群中所有命名空間內具有相同 Kubernetes 服務帳戶的叢集,都能存取該儲存空間,造成身分相同性風險。如未指定 IAM 條件,您也可以改用舊版存取機制,該機制會使用 Google 服務帳戶有效金鑰產生的密碼。以下範例說明如何設定及套用 IAM 條件,限制對 Bucket 的存取權:
建立 IAM 條件檔案:
cat <<EOF > iam_condition.yaml > expression: request.auth.claims.google.providerId == '$IDENTITY_PROVIDER' title: allow_only_this_cluster > EOF
將 GSA 繫結至 KSA 時,請套用 IAM 條件檔案。在 GSA Google Cloud 專案中執行下列指令:
gcloud iam service-accounts add-iam-policy-binding "${GSA_NAME}@${GSA_PROJECT_ID}.iam.gserviceaccount.com" \ --project="${GSA_PROJECT_ID}" \ --role=roles/iam.workloadIdentityUser \ --member="serviceAccount:${WI_POOL}[${VM_NAMESPACE}/${KSA_NAME}]" \ --condition-from-file=iam_condition.yaml
從虛擬機器映像檔建立虛擬機器磁碟
完成本節中的步驟,從虛擬機器映像檔建立虛擬機器磁碟。
從儲存在 Cloud Storage 中的映像檔建立磁碟
將下列設定套用至叢集,從儲存在 Cloud Storage bucket 中的虛擬機器建立虛擬機器磁碟:
apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachineDisk metadata: name: DISK_NAME namespace: NAMESPACE spec: source: gcs: url: gs://${BUCKET_PROJECT_ID}-vm-images/IMAGE_FILE_PATH serviceAccount: KSA_NAME size: DISK_SIZE storageClassName: robin-block-immediate
更改下列內容:
DISK_NAME:這個虛擬機器磁碟的名稱。NAMESPACE:目標虛擬機器的命名空間。IMAGE_FILE_PATH:虛擬機器映像檔的完整路徑和名稱。 在控制台中對圖片按一下滑鼠右鍵,然後選取「複製 gsutil URI」即可取得這個路徑。 Google CloudKSA_NAME:用於下載您先前建立的虛擬機器映像檔的 Kubernetes 服務帳戶。DISK_SIZE:目標磁碟大小。這個值必須大於虛擬機器映像檔的virtual-size值。您可以使用qemu-img info DISK_SIZE指令找出這個值。
如未指定 storageClassName 值,系統會使用 VMRuntime 資源中指定的預設值。
從第三方服務儲存的映像檔建立磁碟
您也可以使用 http、https、S3 或映像檔登錄檔,儲存虛擬機器映像檔。如果儲存空間服務需要憑證才能存取,請將憑證轉換為密鑰,然後使用 secretRef 欄位指定該密鑰。例如:
source: http/s3/registry: url: secretRef: "SECRET_NAME" # optional
將 SECRET_NAME 替換為密鑰名稱。
詳情請參閱「HTTP/S3/GCS/Registry 來源」。
建立空白磁碟
將下列設定套用至叢集,建立空白虛擬機器磁碟:
apiVersion: vm.cluster.gke.io/v1 kind: VirtualMachineDisk metadata: name: DISK_NAME namespace: NAMESPACE spec: size: DISK_SIZE storageClassName: robin-block-immediate
更改下列內容:
DISK_NAME:這個虛擬機器磁碟的名稱。NAMESPACE:目標命名空間。DISK_SIZE:以 GiB 為單位的所需磁碟大小。這個值必須大於虛擬機器映像檔的virtual-size值。您可以使用qemu-img info DISK_SIZE指令找出這個值。
如未指定 storageClassName 值,系統會使用 VMRuntime 資源中指定的預設值。
設定虛擬網路
按照「網路」一節的步驟,為虛擬機器設定虛擬網路。
建立虛擬機器
完成本節中的步驟,在 Distributed Cloud 連線伺服器部署作業中建立虛擬機器。本節的指示僅為範例,旨在說明不同情境的設定。如要進一步瞭解如何設定虛擬機器,請參閱「使用 GDC 上的 VM 執行階段,建立具有特定 CPU 和記憶體資源的 VM」。
使用 Google Cloud 控制台建立虛擬機器
如要使用 Google Cloud 控制台建立虛擬機器,請按照下列步驟操作:
前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。
選取目標 Google Cloud 專案。
(選用) 如果尚未登入目標叢集,請登入:
按一下左側導覽窗格中的「叢集」。
在「Anthos Managed Clusters」(Anthos 代管叢集) 清單中,按一下目標叢集。
在右側的資訊窗格中,按一下「登入」。
在隨即顯示的彈出式對話方塊中,選取偏好的驗證方式,輸入憑證,然後按一下「登入」。
前往「Virtual Machines」(虛擬機器) 頁面。
點選「建立」。
在「Basics」(基本) 部分,執行下列操作:
在「Name」(名稱) 欄位中,輸入虛擬機器的有意義名稱。
在「選取叢集」欄位中,選取虛擬機器的目標叢集。
在「命名空間」欄位中,選取目標命名空間。
在「OS Type」(作業系統類型) 欄位中,選取目標作業系統。
(選用) 如要為這個虛擬機器的設定新增一或多個標籤,請按一下「新增標籤」。
在「機器設定」部分,執行下列任一操作:
如要為這部虛擬機器指定 vCPU 數量和記憶體容量,請選取「自訂設定」,然後輸入目標值,再按一下「下一步」。
如要為這部虛擬機器使用預先決定的 vCPU 數量和記憶體容量,請選取「標準設定」,然後從「機器類型」下拉式清單中選取機器設定,再按一下「下一步」。
在「儲存空間」專區中,執行下列任一操作:
如要為這部虛擬機器建立新的虛擬磁碟,請選取「新增磁碟」,然後在「名稱」欄位中輸入有意義的名稱、「GiB」欄位中輸入大小 (以 GB 為單位),以及「映像檔」欄位中輸入網址。
如要為這部虛擬機器使用現有的虛擬磁碟,請選取「選取現有磁碟」,然後從「選取磁碟」下拉式清單中選取目標磁碟映像檔。
使用「唯讀」和「自動刪除」核取方塊,指定磁碟是否為唯讀,以及是否要在刪除這個虛擬機器時自動刪除磁碟。
在「Driver」(驅動程式) 下拉式清單中指定虛擬磁碟驅動程式。
如要為這部虛擬機器新增其他磁碟,請在「Additional disks」(其他磁碟) 區段中,按一下「ADD A DISK」(新增磁碟)。
點按「下一步」。
在「網路」部分,執行下列操作:
在「Default network interface」(預設網路介面) 子區段的「Interface name」(介面名稱) 欄位中,指定這個虛擬機器的主要網路介面名稱。
從「網路類型」下拉式清單中選取對應的網路類型。
使用「允許外部存取」核取方塊,指定是否允許外部存取這個網路介面。如果啟用這個選項,您必須在「Exposed ports」(公開連接埠) 欄位中,輸入以半形逗號分隔的連接埠清單,以便對外公開。
如要為這個虛擬機器新增一或多個次要網路介面,請按一下「新增網路介面」。
點按「下一步」。
在「進階選項」部分,使用「更新後自動重新啟動」核取方塊,指定在目標叢集上的 Distributed Cloud 連線軟體更新後,是否要重新啟動這個虛擬機器。
在「韌體」部分,執行下列操作:
在「系統啟動載入程式類型」欄位中,選取目標韌體類型。如果選取 UEFI 韌體,可以勾選「安全啟動」核取方塊,啟用安全啟動功能。
在「序號」欄位中,為這部虛擬機器指定序號。
在「UUID」UUID欄位中,指定這部虛擬機器的通用唯一識別碼 (UUID)。
在「Cloud-init」部分,執行下列操作:
在「網路資料 Secret」欄位中指定網路資料 Secret 值。
在「使用者資料密鑰」欄位中指定使用者資料密鑰值。
按一下「CREATE VM」(建立 VM) 建立虛擬機器。
從 YAML 檔案建立虛擬機器
如要從 YAML 設定檔建立虛擬機器,請按照下列步驟操作:
前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。
選取目標 Google Cloud 專案。
(選用) 如果尚未登入目標叢集,請登入:
按一下左側導覽窗格中的「叢集」。
在「Anthos Managed Clusters」(Anthos 代管叢集) 清單中,按一下目標叢集。
在右側的資訊窗格中,按一下「登入」。
在隨即顯示的彈出式對話方塊中,選取偏好的驗證方式,輸入憑證,然後按一下「登入」。
前往「Virtual Machines」(虛擬機器) 頁面。
按一下「使用 YAML 建立」。
在「選取叢集」欄位中,選取虛擬機器的目標叢集。
將 YAML 格式的虛擬機器設定貼到 YAML 欄位。
點選「建立」。
從可開機的磁碟映像檔建立虛擬機器
如要從可開機的磁碟映像檔建立虛擬機器,請對叢集套用下列設定:
kind: VirtualMachine metadata: name: my-virtual-machine namespace: my-vm-namespace spec: osType: Linux/Windows guestEnvironment: {} // comment out this line to enable guest environment for access management compute: cpu: vcpus: 6 memory: capacity: 8Gi interfaces: - name: eth0 networkName: network-410 ipAddresses: - 10.223.237.10/25 disks: - virtualMachineDiskName: my-boot-disk boot: true - virtualMachineDiskName: my-data-disk
更改下列內容:
DISK_NAME:這個虛擬機器磁碟的名稱。NAMESPACE:目標命名空間。
從 ISO 光碟映像檔建立虛擬機器
如要從 ISO 光碟映像檔建立虛擬機器,請完成「在 Google Distributed Cloud 中使用 ISO 映像檔建立 Windows VM」一文中的步驟。
建立支援 GPU 的虛擬機器
完成本頁所述步驟,建立符合業務需求的虛擬機器,然後完成「設定虛擬機器以使用 GPU 資源」中的步驟。
存取虛擬機器
完成本節中的步驟,即可存取在 Distributed Cloud 連線伺服器部署作業中執行的虛擬機器。
取得存取憑證
如果您還沒有存取虛擬機器的憑證,請完成本節中的步驟,使用 Linux 訪客環境功能取得憑證。
將下列設定套用至叢集,為目標虛擬機器啟用 Linux 訪客環境:
kind: VirtualMachine metadata: name: my-virtual-machine namespace: my-vm-namespace spec: osType: Linux guestEnvironment: // enabled by default; disable with guestEnvironment: {} accessManagement: enable: true
使用下列指令產生包含 SSH 金鑰組的
id_rsa.pub檔案:ssh-keygen -t rsa將下列設定套用至叢集,建立
VirtualMachineAccessRequest資源:apiVersion: vm.cluster.gke.io/v1alpha1 kind: VirtualMachineAccessRequest metadata: name: RESOURCE_NAME namespace: NAMESPACE spec: vm: VM_NAME user: USER_NAME ssh: key: RSA_KEY ttl: 2h
更改下列內容:
RESOURCE_NAME:這個虛擬機器存取要求資源的說明名稱。NAMESPACE:目標命名空間。VM_NAME:目標虛擬機器的名稱。USER_NAME:要授予存取權的使用者名稱。RSA_KEY:您在上一個步驟中產生的id_rsa.pub檔案內容。
請使用下列指令檢查存取要求狀態:
kubectl get vmar
如果指令傳回
Configured狀態,請繼續下一個步驟。透過 SSH 或遠端桌面存取虛擬機器:
- 如果虛擬機器已連上區域網路,可以直接存取。
- 如果虛擬機器連線至 Pod 網路,您必須建立負載平衡器服務,才能存取所需連接埠。
啟動、重新啟動或停止虛擬機器
使用下列指令啟動、重新啟動或停止虛擬機器:
- 啟動虛擬機器:
kubectl virt start vmVM_NAME-nNAMESPACE - 重新啟動虛擬機器:
kubectl virt restart vmVM_NAME-nNAMESPACE - 停止虛擬機器:
kubectl virt stop vmVM_NAME-nNAMESPACE
更改下列內容:
VM_NAME:目標虛擬機器的名稱。NAMESPACE:目標命名空間。
使用 Google Cloud 控制台啟動或停止虛擬機器
前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。
選取目標 Google Cloud 專案。
(選用) 如果尚未登入目標叢集,請登入:
按一下左側導覽窗格中的「叢集」。
在「Anthos Managed Clusters」(Anthos 代管叢集) 清單中,按一下目標叢集。
在右側的資訊窗格中,按一下「登入」。
在隨即顯示的對話方塊中,選取偏好的驗證方式,輸入憑證,然後按一下「登入」。
前往「Virtual Machines」(虛擬機器) 頁面。
在虛擬機器清單中,勾選目標虛擬機器的核取方塊。
按一下頁面頂端的「開始」或「停止」。
使用 Google Cloud 控制台查看虛擬機器的狀態
前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。
選取目標 Google Cloud 專案。
(選用) 如果尚未登入目標叢集,請登入:
按一下左側導覽窗格中的「叢集」。
在「Anthos Managed Clusters」(Anthos 代管叢集) 清單中,按一下目標叢集。
在右側的資訊窗格中,按一下「登入」。
在隨即顯示的彈出式對話方塊中,選取偏好的驗證方式,輸入憑證,然後按一下「登入」。
前往「Virtual Machines」(虛擬機器) 頁面。
按一下目標虛擬機器。
在隨即顯示的頁面中,按一下「詳細資料」、「事件」和「YAML」分頁標籤,即可查看這部虛擬機器的相關資訊。
修改虛擬機器
如要修改虛擬機器,請先刪除再使用更新的設定重新建立。
使用 Google Cloud 控制台刪除虛擬機器
前往 Google Cloud 控制台的「Clusters」(叢集) 頁面。
選取目標 Google Cloud 專案。
(選用) 如果尚未登入目標叢集,請登入:
按一下左側導覽窗格中的「叢集」。
在「Anthos Managed Clusters」(Anthos 代管叢集) 清單中,按一下目標叢集。
在右側的資訊窗格中,按一下「登入」。
在隨即顯示的對話方塊中,選取偏好的驗證方式,輸入憑證,然後按一下「登入」。
前往「Virtual Machines」(虛擬機器) 頁面。
在虛擬機器清單中,勾選目標虛擬機器的核取方塊。
按一下頁面頂端的「刪除」。
在隨即顯示的確認對話方塊中,輸入虛擬機器的名稱,然後按一下「刪除」。