將容器映像檔從一個叢集推送到另一個叢集

系統構件位於管理員叢集的 Artifact Registry 中。如果系統出現錯誤或中斷，而您可透過修補新構件修正問題，請推送新的系統構件。

本文說明如何將個別構件從一個叢集推送至另一個叢集。

事前準備

如要取得權限，以管理員身分存取系統 Artifact Registry 專案中的資源，請要求安全管理員根據您要推送容器映像檔的叢集，授予下列角色：

• 機構組織管理員叢集：如要將容器映像檔推送至機構組織管理員叢集的系統 Artifact Registry，您需要「機構組織系統 Artifact 管理管理員」角色 (organization-system-artifact-management-admin)。
• 根管理員叢集：如要將容器映像檔推送至根管理員叢集的系統 Artifact Registry，您需要「系統 Artifact 管理員」(system-artifact-management-admin) 角色。

取得必要權限後，請完成下列步驟，再將映像檔推送至根管理員叢集或機構管理員叢集的系統 Artifact Registry：

1. 按照「gdcloud 指令列介面 (CLI)」的說明，下載並安裝 Distributed Cloud CLI。

2. 按照「安裝元件」的指示安裝 docker-credential-gdcloud 元件。

   gdcloud components install docker-credential-gdcloud
   

3. 使用已設定的識別資訊提供者登入。

   gdcloud auth login
   

4. 匯出 kubeconfig 檔案。

   gdcloud clusters get-credentials CLUSTER_NAME
   

   將 CLUSTER_NAME 替換為叢集名稱。

5. 設定 Docker。

   gdcloud auth configure-docker
   

從 S3 bucket 下載容器映像檔

注意： 如果上傳的容器映像檔儲存在 Simple Storage Service (S3) 值區中，請參閱本節。否則，如果容器映像檔位於工作站，您可以跳至「將映像檔推送至系統 Artifact Registry」一節。

如要取得從 S3 bucket 下載容器映像檔所需的權限，請要求安全管理員在專案的命名空間中，授予您專案 bucket 物件檢視者 (project-bucket-object-viewer) 角色。

安全管理員會建立角色繫結，授予您存取權：

kubectl create rolebinding IO_USER-bor-rb \
  --role=project-bucket-object-viewer \
  --user=USER \
  -n PROJECT_NAMESPACE

更改下列內容：

• USER：需要角色繫結的使用者帳戶名稱。
• PROJECT_NAMESPACE：S3 bucket 的專案命名空間。

您將取得專案內值區和該值區中物件的唯讀存取權。

取得必要權限後，請按照下列步驟，從專案命名空間的 S3 bucket 下載容器映像檔：

1. 取得 bucket 的密鑰名稱。密鑰名稱如下所示：

   object-storage-key-std-user-ID
   

   密鑰名稱包含存取 bucket 的專屬 ID 值。

2. 複製 bucket 的密鑰名稱。

3. 取得值區存取憑證，並設定 s3cmd CLI 工具。

   SECRET_NAME=SECRET_NAME
   ACCESS_KEY=$(kubectl get secret ${SECRET_NAME} -n object-storage-access-keys -o=jsonpath='{.data.access-key-id}' | base64 -d)
   SECRET_KEY=$(kubectl get secret ${SECRET_NAME} -n object-storage-access-keys -o=jsonpath='{.data.secret-access-key}' | base64 -d)
   S3_ENDPOINT=objectstorage.$(kubectl get configmap dnssuffix -n gpc-system -o jsonpath='{.data.dnsSuffix}')
   
   echo "Access Key: ${ACCESS_KEY}" \
   && echo "Secret Key: ${SECRET_KEY}" \
   && echo "S3 Endpoint: ${S3_ENDPOINT}"
   
   s3cmd --configure
   

   將 SECRET_NAME 換成您在上一步複製的值。

4. 將容器映像檔從 S3 bucket 下載到工作站。

   s3cmd get s3://BUCKET_NAME /g/CONTAINER_IMAGE_NAME
   

   更改下列內容：

   • BUCKET_NAME：含有容器映像檔的 S3 bucket 名稱。
   • CONTAINER_IMAGE_NAME：要從 S3 bucket 下載的容器映像檔名稱。

將映像檔推送至系統 Artifact Registry

請按照下列步驟，將工作站中的容器映像檔推送至管理員叢集中的系統 Artifact Registry：

1. 開啟控制台。

2. 取得要推送容器映像檔的叢集系統 Artifact Registry 端點路徑。

   export REGISTRY_ENDPOINT=harbor.$(kubectl get configmap dnssuffix -n gpc-system -o jsonpath='{.data.dnsSuffix}')
   

3. 將容器映像檔載入、加上標記，然後推送至叢集的系統 Artifact Registry 端點。

   docker load --input CONTAINER_IMAGE_PATH
   
   docker tag CONTAINER_IMAGE_PATH ${REGISTRY_ENDPOINT}/CONTAINER_IMAGE_PATH
   
   docker push ${REGISTRY_ENDPOINT}/CONTAINER_IMAGE_PATH
   

   將 CONTAINER_IMAGE_PATH 替換為本機檔案系統中的容器映像檔路徑。這個路徑的有效值範例為 oracle_db.tar。