安裝 Kubernetes CLI (kubectl)

若要使用指令行介面 (CLI) 來存取叢集,您必須安裝並配置 kubectl( Kubernetes 指令行工具)。

  1. 將用戶端電腦與叢集中節點之間的時鐘同步化。 若要同步化時鐘,您可以使用網路時間通訊協定 (NTP)。 如需設定 NTP 的相關資訊,請參閱作業系統的使用者說明文件。

  2. 從主控台中,選取使用者圖示 使用者圖示,然後按一下 配置用戶端

  3. 按一下 安裝 CLI 工具提示: 您也可以在此程序的命令提示字元或「終端機」視窗中輸入 curl 指令,在沒有主控台的情況下安裝 kubectl。

    附註: 若要使用 curl 指令下載安裝檔案,請參閱 使用 curl 指令下載安裝檔案。 下載檔案之後,您可以從步驟 3 繼續安裝 kubectl。

  4. 展開 安裝 Kubernetes CLI ,以使用 curl 指令下載安裝程式。 複製並執行適用於您作業系統的 curl 指令,然後繼續產品說明文件中的安裝程序:

    選擇適用作業系統的 curl 指令。 例如,您可以針對 macOS執行下列指令:

    curl -kLo <install_file> https://<Cluster Master Host>:<Cluster Master API Port>/api/cli/kubectl-darwin-amd64
    

    執行下列範例指令,以在 Linux 作業系統上下載必要檔案,並將變數取代為您環境的資訊:

    curl -kLo <install_file> https://<Cluster Master Host>:<Cluster Master API Port>/api/cli/kubectl-linux-amd64
    
  5. 將檔案變更為執行檔,然後將檔案移至 PATH 環境變數中包含的目錄。 請參閱下列指令,其中 <path_to_installer> 是您所下載檔案的位置,而 <install_file> 是檔案的名稱:

    • 若為 Linux® 和 macOS,請執行下列指令來變更檔案的許可權,並將檔案移至 PATH 環境變數中包含的目錄:

      chmod 755 <path_to_installer>/<install_file>
      
      sudo mv <path_to_installer>/<install_file> /usr/local/bin/kubectl
      

      在此範例中,它會移至 /usr/local/bin/kubectl 目錄。

    • 若為 Windows ,請將下載的檔案重新命名為 kubectl ,並將檔案放置在 PATH 環境變數中列出的目錄中。

    附註: 您也可以從 Kubernetes下載。 請參閱 安裝及設定 kubectl 在新標籤中開啟

  6. 取得叢集配置詳細資料。 您可以使用 cloudctl 或主控台來取得叢集配置詳細資料。

    • 如果要從主控台取得配置詳細資料,請執行下列動作:

      1. 登入叢集主控台。
      2. 選取使用者圖示 使用者圖示,然後按一下 配置用戶端。 叢集配置詳細資料會顯示並類似於下列程式碼:

        kubectl config set-cluster {cluster_name} --server=https://<Cluster Master Host>:8001 --insecure-skip-tls-verify=true
        kubectl config set-context {cluster_name}-context --cluster={cluster_name}
        kubectl config set-credentials {username} --token={token}
        kubectl config set-context {cluster_name}-context --user={username} --namespace=default
        kubectl config use-context {cluster_name}-context
        

        附註: 此配置將在 12 小時後到期。 若要繼續使用 CLI ,您必須每 12 小時登入並重新配置 kubectl 。 若要避免此限制,您可以使用服務帳戶來配置 CLI。 如需相關資訊,請參閱 使用服務帳戶記號來連接 API 伺服器

      3. 複製配置資訊並貼到指令行,然後按 Enter鍵。

    • 若要從 cloudctl 取得配置詳細資料,請執行下列動作:
      1. 安裝 cloudctl 並登入叢集。 請參閱 安裝 cloudctl

使用 curl 指令下載安裝檔案

您可以完成下列步驟來下載安裝檔案:

  1. 取得服務主機名稱。 在指令中使用 management-ingress 服務主機名稱,以下載安裝檔案。

    oc get route -n kube-system
    

    以下是範例輸出:

    NAME          HOST/PORT                             PATH      SERVICES             PORT    TERMINATION            WILDCARD
    icp-console   cp-console.apps.an.os.example.abc.com          management-ingress   <all>   passthrough/Redirect   None
    icp-proxy     cp-proxy.apps.an.os.example.abc.com            nginx-ingress        https   passthrough/Redirect   None
    
  2. 下載安裝檔案。

    • 若為 macOS,請執行下列指令:

      curl -kLo kubectl-darwin-amd64-v1.13.11 https://cp-console.apps.an.os.example.abc.com:443/api/cli/kubectl-linux-amd64
      
    • 若為 Linux® x86_64,請執行下列指令:

      curl -kLo kubectl-linux-amd64-v1.13.11 https://cp-console.apps.an.os.example.abc.com:443/api/cli/kubectl-linux-amd64
      
    • 若為 Linux on Power (ppc64le) ,請執行下列指令:

      curl -kLo kubectl-linux-ppc64le-v1.13.11 https://cp-console.apps.an.os.example.abc.com:443/api/cli/kubectl-linux-ppc64le
      
    • 若為 Windows (64 位元) ,請執行下列指令:

      curl -kLo kubectl-win-amd64-v1.13.11.exe https://cp-console.apps.an.os.example.abc.com:443/api/cli/kubectl-win-amd64.exe
      
    • 若為 IBM Z 和 LinuxONE上的 Linux ,請執行下列指令:

      curl -kLo kubectl-linux-s390x-v1.13.11 https://cp-console.apps.an.os.example.abc.com:443/api/cli/kubectl-linux-s390x