本頁面將逐步引導您安裝及設定 gdcloud CLI，以便在處理 Google Distributed Cloud (GDC) 實體隔離專案時管理物件儲存庫。內容涵蓋如何下載、安裝及設定必要元件和設定，以便在這個隔離環境中有效使用 Storage bucket 和物件。
本頁面適用於基礎架構營運商群組中的 IT 管理員，或應用程式營運商群組中的開發人員，他們希望在 GDC 實體隔離方案環境中，為專案佈建及管理物件儲存庫 bucket。詳情請參閱「GDC 實體隔離方案說明文件的目標對象」。
事前準備
如要安裝及設定儲存空間 CLI，請與 IAM 機構組織管理員聯絡，要求取得機構網路政策管理員 (org-network-policy-admin) 角色，以便建立、編輯及刪除機構網路政策。
下載 gdcloud CLI
按照操作說明下載 gdcloud CLI。
安裝 gdcloud CLI
如要使用儲存空間指令樹狀結構，必須安裝儲存空間依附元件。
按照「安裝 gdcloud CLI」一文的說明操作。
執行下列指令，安裝儲存空間依附元件：
gdcloud components install storage-cli-dependencies如要進一步瞭解
components install指令，請參閱「安裝 gdcloud CLI」。
設定 gdcloud CLI 以使用物件儲存庫
必須完成下列設定，才能使用 gdcloud CLI 執行物件儲存庫作業。
將
ACCESS_KEY_ID替換為從取得存取憑證中的密鑰取得的存取金鑰 ID：gdcloud config set storage/s3_access_key_id ACCESS_KEY_ID將
SECRET_ACCESS_KEY替換為從取得存取憑證中的密鑰取得的密鑰：gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEY將
CA_BUNDLE_FILE替換為 CA 憑證的路徑。這是屬於憑證授權單位 (CA) 的數位憑證，CA 是負責擔保身分的信任機構。您可以向基礎架構運作人員 (IO) 群組成員索取 GDC CA 信任套件。如要進一步瞭解如何取得 GDC CA 憑證，請參閱「擷取 GDC 信任套件」。gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILE將
ENDPOINT替換為基礎架構運算子 (IO) 提供的端點：gdcloud config set storage/s3_endpoint ENDPOINT雙可用區 bucket 的步驟略有不同。每個雙區域 bucket 都提供三個端點，您可以選擇透過這些端點存取 bucket。在大多數情況下，全域端點是適當的選擇，可充分利用自動容錯移轉功能：
- Zone1 端點：這個端點一律由 zone1 接收。如果使用這個端點，寫入 zone1 的任何物件都會有一致的寫後讀。不過，如果 zone1 故障，用戶端必須改用 zone2 或全域端點，才能繼續讀取/寫入這個 bucket。如果用戶端來自使用者叢集，則只能從 zone1 存取這個端點。
- Zone2 端點：這個端點一律由 zone2 接收。如果使用這個端點，寫入 zone2 的任何物件都會具備寫後讀一致性。不過，如果 zone2 故障，用戶端必須改用 zone1 或全域端點，才能繼續讀取/寫入這個 bucket。如果用戶端來自使用者叢集，則只能從 zone2 內存取這個端點。
- 全域端點：這個端點會將要求轉送至 zone1 或 zone2。這個選項不提供工作階段相依性，也就是說，使用相同工作階段提出的要求可能會抵達 zone1 或 zone2。也就是說，向全域端點提出的要求不保證能讀取最新寫入的資料。如果可用區故障，全域端點會自動容錯移轉，因此使用者不必像使用可用區端點時那樣，變更工作負載中的端點。此外，所有可用區的使用者叢集都能存取這個端點。
對管理 API 伺服器執行下列指令，查看 bucket 的全域和可用區端點，並選擇要使用的端點：
kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.globalEndpoint}" --kubeconfig MANAGEMENT_API_SERVER kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.zonalEndpoints}" --kubeconfig MANAGEMENT_API_SERVER