登入

控制台

在新的瀏覽器分頁開啟下列網址，存取 Distributed Cloud 使用者介面 (UI)：

https://GDC_URL

將 GDC_URL 替換為您用來存取 Distributed Cloud 的網域名稱，該網域由基礎架構運作人員 (IO) 提供。首次開啟任何網址時，如果基礎架構運作人員 (IO) 已設定頁面，Distributed Cloud 會將您重新導向至識別資訊提供者登入頁面。

舉例來說，下圖顯示登入名為 org-1 的組織控制台 UI：

gdcloud

登入 gdcloud CLI 時，請使用 gdcloud auth login 指令，向 gdcloud CLI 驗證主體。gdcloud CLI 會使用該主體進行驗證和授權，以管理 Google Cloud 資源和服務。

登入前，請務必先執行下列工作：

• 下載 gdcloud CLI 二進位檔，並安裝到系統中。詳情請參閱「下載 gdcloud CLI」。
• 設定並初始化 gdcloud CLI 預設設定。請務必設定正確的組織網址，用於擷取登入設定端點。詳情請參閱「安裝 gdcloud CLI」。
• 安裝 kubectl CLI。
• 安裝驗證外掛程式 gdcloud-k8s-auth-plugin。詳情請參閱「gdcloud CLI 驗證」。

如要登入 Management API 伺服器或 Kubernetes 叢集，請完成下列步驟：

• Management API 伺服器：

1. 匯出要儲存 Management API 伺服器 kubeconfig 檔案的路徑：

   export KUBECONFIG=MANAGEMENT_API_SERVER
   

   將 MANAGEMENT_API_SERVER 替換為 kubeconfig 檔案儲存位置的目錄路徑。

2. 驗證 gdcloud CLI 執行個體，以便登入。驗證方式有兩種：

   • 標準瀏覽器登入：從瀏覽器登入時，請使用這個驗證流程。

     gdcloud auth login
     

   • 次要裝置登入：如果主要裝置沒有可用的瀏覽器，請使用這個驗證流程。這個流程會先在沒有瀏覽器存取權的主要裝置上啟動登入程序，然後在具有瀏覽器存取權的次要裝置上繼續登入。

     在沒有瀏覽器的主要裝置上登入：

     gdcloud auth login --no-browser
     

     KUBECONFIG 環境變數會更新，納入組織中所有 API 伺服器和叢集的 kubeconfig 檔案。如果未設定 KUBECONFIG 變數，kubectl CLI 會使用儲存在 $HOME/.kube/config 的預設 kubeconfig 檔案。

     如要略過編輯 kubeconfig 檔案，請在指令中加入 --skip-kubeconfig-update 旗標。例如：

     gdcloud auth login --no-browser --skip-kubeconfig-update
     

     複製輸出的 gdcloud CLI 指令，並在可存取瀏覽器的機器上執行。

3. 按照網頁上的指示完成登入程序。

   成功登入後，瀏覽器會顯示「Authentication successful. 請關閉這個視窗。

4. 按照終端機上的指示操作。成功登入後，終端機會顯示「You are now logged in」(您已登入) 訊息。

• Kubernetes 叢集：

1. 驗證 gdcloud CLI 執行個體，以便登入。驗證方式有兩種：

   • 標準瀏覽器登入：從瀏覽器登入時，請使用這個驗證流程。

     gdcloud auth login
     

   • 次要裝置登入：如果主要裝置沒有可用的瀏覽器，請使用這個驗證流程。這個流程會先在沒有瀏覽器存取權的主要裝置上啟動登入程序，然後在具有瀏覽器存取權的次要裝置上繼續登入。

     1. 在沒有瀏覽器的主要裝置上登入：

        gdcloud auth login --no-browser
        

        主要裝置中的指令會輸出另一個 gdcloud 指令，您必須在步驟 c 中，於次要裝置上執行該指令。

     2. 重複步驟 1，在次要裝置下載憑證。

     3. 輸入步驟 a 中主要裝置顯示的指令，在次要裝置上完成登入。

   這項操作會開啟瀏覽器，登入已設定的識別資訊提供者 (IdP)。提供您在初始 gdcloud CLI 設定期間設定的使用者和密碼，即可登入。

2. 將使用者身分 kubeconfig 檔案匯出為變數：

   export KUBECONFIG=/tmp/CLUSTER_NAME-ZONE-kubeconfig-with-user-identity.yaml
   

3. 使用使用者身分，為可用區叢集產生 kubeconfig 檔案：

   gdcloud clusters get-credentials CLUSTER_NAME --zone ZONE
   

   將 ZONE 替換為區域名稱。

   系統會使用您的使用者身分產生 kubeconfig 檔案。以下 YAML 檔案為範例：

   apiVersion: v1
   clusters:
   - cluster:
     certificate-authority-data: <REDACTED>
     server: https://10.200.0.32:443
   name: cluster-name
   contexts:
   - context:
     cluster: cluster-name
     user: cluster-name-anthos-default-user
   name: cluster-name-cluster-name-anthos-default-user
   current-context: cluster-name-cluster-name-anthos-default-user
   kind: Config
   preferences: {}
   users:
   - name: cluster-name-anthos-default-user
   user:
     exec:
       apiVersion: client.authentication.k8s.io/v1
       args:
       - --audience=root-admin
       command: gdcloud-k8s-auth-plugin
       env: null
       installHint: Run 'gdcloud components install gdcloud-k8s-auth-plugin' to use plugin
       interactiveMode: Never
       provideClusterInfo: false
   

4. 如要確認您是否能存取叢集，請使用產生的 kubeconfig 檔案，以使用者身分登入：

   kubectl --kubeconfig /tmp/admin-kubeconfig-with-user-identity.yaml version
   

控制台

按一下選單列中的「logout 登出」。

gdcloud

從 CLI 登出：

gdcloud auth revoke

控制台

如果工作階段閒置，GDC 控制台會將您登出。在 GDC 控制台因閒置而將您登出前兩分鐘，系統會顯示對話方塊，提醒您即將登出：

因閒置而登出後，您會看到以下畫面：

如要重新登入 GDC 控制台，請選取識別資訊提供者，並新增登入憑證。如果您使用監控資訊主頁等服務，而 GDC 控制台因閒置而將您登出，請重新登入以取得存取權。

gdcloud

如果工作階段閒置，gdcloud CLI 會將您登出。gdcloud CLI 將您登出後，如果您嘗試執行指令，會收到授權錯誤：

Error: error when creating kube client: unable to create k8sclient: Unauthorized

如要重新登入 GDC，請按照「登入」中的 CLI 步驟操作。

如果您透過 Management API 伺服器重新登入 GDC，kubeconfig 檔案會自動更新。如要避免 kubeconfig 檔案更新，請在 gdcloud auth login 指令中使用 --skip-kubeconfig-update 旗標。

kubectl

如果工作階段閒置，gdcloud CLI 會將 kubeconfig 檔案設為過期。如果在閒置後嘗試執行 kubectl 指令，會收到授權錯誤訊息：

error: You must be logged in to the server (Unauthorized)

如要重新登入並使用 kubeconfig 檔案，請按照「登入」中的 CLI 步驟操作。每次工作階段逾時，都必須重新產生 kubeconfig 檔案。