使用次要開機磁碟預先載入資料或容器映像檔

gcloud

1. 建立啟用映像檔串流的 GKE Standard 叢集：

   gcloud container clusters create CLUSTER_NAME \
       --location=LOCATION \
       --cluster-version=VERSION \
       --enable-image-streaming
   

   更改下列內容：

   • CLUSTER_NAME：叢集名稱。
   • LOCATION：叢集位置。
   • VERSION：要使用的 GKE 版本。GKE 版本必須為 1.28.3-gke.1067000 以上。

2. 在同一個專案中，建立具有次要開機磁碟的節點集區：

   gcloud container node-pools create NODE_POOL_NAME \
   --cluster=CLUSTER_NAME \
   --location LOCATION \
   --enable-image-streaming \
   --secondary-boot-disk=disk-image=global/images/DISK_IMAGE_NAME,mode=CONTAINER_IMAGE_CACHE
   

   更改下列內容：

   • NODE_POOL_NAME：節點集區的名稱。
   • CLUSTER_NAME：現有叢集的名稱。
   • LOCATION：叢集的運算可用區，以半形逗號分隔。
   • DISK_IMAGE_NAME：磁碟映像檔名稱。

   如要使用其他專案中的磁碟映像檔建立具有次要開機磁碟的節點集區，請完成「使用其他專案中的次要開機磁碟」一節中的步驟。

3. 在 Pod 範本中新增 nodeSelector：

   nodeSelector:
       cloud.google.com/gke-nodepool: NODE_POOL_NAME
   

4. 確認次要開機磁碟快取正在使用中：

   kubectl get events --all-namespaces
   

   輸出結果會與下列內容相似：

   75s       Normal      SecondaryDiskCachin
   node/gke-pd-cache-demo-default-pool-75e78709-zjfm Image
   gcr.io/k8s-staging-jobsejt/pytorch-mnist:latest is backed by secondary disk cache
   

5. 如要更可靠地確認是否使用次要開機磁碟快取，請按照下列步驟操作：

   使用這個記錄名稱，從您感興趣的節點查詢記錄：

   logName="projects/PROJECT_ID/logs/gcfs-snapshotter"
   

   將 PROJECT_ID 替換為 Google Cloud 專案 ID。

   類似於 Image gcr.io/k8s-staging-jobsejt/pytorch-mnist:latest is backed by secondary boot disk caching by 100.0%... 的記錄表示已使用次要開機磁碟快取。

6. 執行下列指令，檢查映像檔提取延遲時間：

   kubectl describe pod POD_NAME
   

   將 POD_NAME 替換為 Pod 名稱。

   輸出結果會與下列內容相似：

   …
     Normal  Pulled     15m   kubelet            Successfully pulled image "docker.io/library/nginx:latest" in 0.879149587s
   …
   

無論映像檔大小為何，快取容器映像檔的預期映像檔提取延遲時間應不超過幾秒。

Terraform

1. 如要使用 Terraform 建立含有預設節點集區的叢集，請參閱下列範例：

   resource "google_container_cluster" "default" {
     name               = "default"
     location           = "us-central1-a"
     initial_node_count = 1
   
     # secondary_boot_disks require GKE 1.28.3-gke.106700 or later, which should
     # be true for all release channels apart from EXTENDED.
     # If required, Use `release_channel = "EXTENDED"` and set `min_master_version`.
   }

2. 在同一個專案中，建立具有次要開機磁碟的節點集區：

   resource "google_container_node_pool" "secondary-boot-disk-container" {
     name               = "secondary-boot-disk-container"
     location           = "us-central1-a"
     cluster            = google_container_cluster.default.name
     initial_node_count = 1
   
     node_config {
       machine_type = "e2-medium"
       image_type   = "COS_CONTAINERD"
       gcfs_config {
         enabled = true
       }
       secondary_boot_disks {
         disk_image = ""
         mode       = "CONTAINER_IMAGE_CACHE"
       }
     }
   }

   如要進一步瞭解如何使用 Terraform，請參閱「GKE 的 Terraform 支援」。

3. 在 Pod 範本中新增 nodeSelector：

   nodeSelector:
       cloud.google.com/gke-nodepool: NODE_POOL_NAME
   

4. 確認次要開機磁碟快取正在使用中：

   kubectl get events --all-namespaces
   

   輸出結果會與下列內容相似：

   75s       Normal      SecondaryDiskCachin
   node/gke-pd-cache-demo-default-pool-75e78709-zjfm Image
   gcr.io/k8s-staging-jobsejt/pytorch-mnist:latest is backed by secondary disk cache
   

5. 執行下列指令，檢查映像檔提取延遲時間：

   kubectl describe pod POD_NAME
   

   將 POD_NAME 替換為 Pod 名稱。

   輸出結果會與下列內容相似：

   …
     Normal  Pulled     15m   kubelet            Successfully pulled image "docker.io/library/nginx:latest" in 0.879149587s
   …
   

無論映像檔大小為何，快取容器映像檔的預期映像檔提取延遲時間應不超過幾秒。

如要進一步瞭解如何使用 Terraform，請參閱「GKE 的 Terraform 支援」。

gcloud

1. 建立啟用映像檔串流的 GKE Standard 叢集：

   gcloud container clusters create CLUSTER_NAME \
       --location=LOCATION \
       --cluster-version=VERSION \
       --enable-image-streaming
   

   更改下列內容：

   • CLUSTER_NAME：叢集名稱。
   • LOCATION：叢集位置。
   • VERSION：要使用的 GKE 版本。GKE 版本必須為 1.28.3-gke.1067000 以上。

2. 使用 --secondary-boot-disk 旗標建立具有次要開機磁碟的節點集區：

   gcloud container node-pools create NODE_POOL_NAME \
   --cluster=CLUSTER_NAME \
   --location LOCATION \
   --enable-image-streaming \
   --secondary-boot-disk=disk-image=global/images/DISK_IMAGE_NAME
   

   更改下列內容：

   • NODE_POOL_NAME：節點集區的名稱。
   • CLUSTER_NAME：現有叢集的名稱。
   • LOCATION：叢集的運算可用區，以半形逗號分隔。
   • DISK_IMAGE_NAME：磁碟映像檔名稱。

   如要使用其他專案中的磁碟映像檔建立具有次要開機磁碟的節點集區，請完成「使用其他專案中的次要開機磁碟」一節中的步驟。

   GKE 會建立節點集區，每個節點都有預先載入資料的次要磁碟。GKE 會在節點上連結並掛接次要開機磁碟。

3. 如要存取資料，請使用 hostPath 磁碟區掛接，在 Pod 容器中掛接次要開機磁碟映像檔。將 /usr/local/data_path_sbd 設為容器中要存放資料的路徑：

   apiVersion: v1
   kind: Pod
   metadata:
     name: pod-name
   spec:
     containers:
     ...
       volumeMounts:
       - mountPath: /usr/local/data_path_sbd
         name: data-path-sbd
     ...
     volumes:
     - name: data-path-sbd
       hostPath:
         path: /mnt/disks/gke-secondary-disks/gke-DISK_IMAGE_NAME-disk
   

   將 DISK_IMAGE_NAME 換成磁碟映像檔名稱。

Terraform

1. 如要使用 Terraform 建立含有預設節點集區的叢集，請參閱下列範例：

   resource "google_container_cluster" "default" {
     name               = "default"
     location           = "us-central1-a"
     initial_node_count = 1
   
     # secondary_boot_disks require GKE 1.28.3-gke.106700 or later, which should
     # be true for all release channels apart from EXTENDED.
     # If required, Use `release_channel = "EXTENDED"` and set `min_master_version`.
   }

2. 在同一個專案中，建立具有次要開機磁碟的節點集區：

   resource "google_container_node_pool" "secondary-boot-disk-data" {
     name               = "secondary-boot-disk-data"
     location           = "us-central1-a"
     cluster            = google_container_cluster.default.name
     initial_node_count = 1
   
     node_config {
       machine_type = "e2-medium"
       image_type   = "COS_CONTAINERD"
       gcfs_config {
         enabled = true
       }
       secondary_boot_disks {
         disk_image = ""
       }
     }
   }

   如要進一步瞭解如何使用 Terraform，請參閱「GKE 的 Terraform 支援」。

3. 如要存取資料，請使用 hostPath 磁碟區掛接，在 Pod 容器中掛接次要開機磁碟映像檔。將 /usr/local/data_path_sbd 設為容器中要存放資料的路徑：

   apiVersion: v1
   kind: Pod
   metadata:
     name: pod-name
   spec:
     containers:
     ...
       volumeMounts:
       - mountPath: /usr/local/data_path_sbd
         name: data-path-sbd
     ...
     volumes:
     - name: data-path-sbd
       hostPath:
         path: /mnt/disks/gke-secondary-disks/gke-DISK_IMAGE_NAME-disk
   

   將 DISK_IMAGE_NAME 替換為磁碟映像檔名稱。