安裝 Tanzu CLI 和 Kubernetes CLI 以與獨立管理叢集配合使用

本主題說明如何在啟動機器上安裝 Tanzu 命令列介面 (CLI)。啟動機器是一部您從中部署管理和工作負載叢集的筆記型電腦、主機或伺服器,且用來保留您部署的 Tanzu 和 Kubernetes 組態檔。啟動機器通常是本機機器,但也可以是您遠端存取的實體機器或虛擬機器。如需 Tanzu CLI 的詳細資訊 (包括命令參考),請參閱 VMware Tanzu CLI v1.0.x 說明文件。

如要在不含主管的 vSphere 上、AWS 或 Azure 上使用 Tanzu Kubernetes Grid,則可以使用 Tanzu CLI,在您環境中的每個雲端提供者上建立獨立管理叢集。Tanzu CLI 會與這個管理叢集通訊,以在您的目標雲端基礎結構上建立及管理工作負載叢集。

附註

本主題中的指示專門用來安裝 Tanzu CLI 以便在不含主管的 vSphere 上、AWS 或 Azure 上,部署獨立管理叢集。如果您要安裝 Tanzu CLI,以便與 vSphere 8 上的 vSphere with Tanzu 主管搭配使用,請參閱《使用 Tanzu CLI 來建立和管理 TKG 2.4 工作負載叢集》中的對應主題:安裝 Tanzu CLI 和 Kubernetes CLI 以用於 vSphere with Tanzu 主管

必要條件

用來安裝及執行 Tanzu CLI 以與 Tanzu Kubernetes Grid 搭配使用的啟動機器必須符合特定需求。另有進一步的需求,具體取決於您是打算將 Tanzu CLI 與作為管理叢集的 vSphere with Tanzu 主管搭配使用,還是要部署獨立管理叢集,還是兩者都要。

若要執行具有 Tanzu Kubernetes Grid v2.4 的 Tanzu CLI,您需要啟動機器,以安裝和執行具有下列Tanzu CLI:

  • 在具有下列硬體的實體或虛擬機器上執行的 Linux、Windows 或 macOS 作業系統:
    • 最少 8 GB RAM。VMware 建議使用 16 GB RAM。
    • 具有 50 GB 可用儲存空間的磁碟。
    • 2 或 4 個 2 核心 CPU。
  • 如果您打算使用 Tanzu Kubernetes Grid 安裝程式介面來部署獨立管理叢集,則需要具有瀏覽器,或使用瀏覽器從機器進行遠端存取。無需瀏覽器即可使用 Tanzu CLI,但若是第一次部署,強烈建議使用安裝程式介面。
  • 系統時間會與網路時間通訊協定 (NTP) 伺服器同步。
  • 如果啟動機器執行 Windows,VMware 建議將 Windows Subsystem for Linux (WSL) 與 Ubuntu 20.04.4 LTS 一起安裝,以便在 Windows 上執行 Linux 命令。如需 WSL 的詳細資訊,請參閱 Microsoft 說明文件中的安裝 WSL

  • 在 VMware Cloud on AWS 和 Azure VMware 解決方案上,啟動機器必須是雲端虛擬機器,而不是本機實體機器。如需設定指示,請參閱準備將管理叢集部署到 VMware Cloud 環境

  • 若要部署獨立管理叢集,則另有其他需求,具體取決於啟動機器是在哪個作業系統上執行:

    macOS
    • 您的啟動機器上已安裝且正在執行 Docker 桌面
    • 在 Docker 桌面中至少配置 6 GB 記憶體,以容納 kind 容器。請參閱 kind 說明文件中的 Docker 桌面的設定
    Linux
    • 您的啟動機器上已安裝且正在執行 Docker。使用 apt 而非 snap 從套件管理員安裝 Docker。如需在網際網路受限環境中安裝 Docker 用戶端應用程式的相關指示,請參閱準備網際網路受限環境
    • 將非 root 使用者帳戶新增到 docker 使用者群組。建立群組 (如果尚未存在)。這樣一來,Tanzu CLI 就可以存取 root 使用者所擁有的 Docker 通訊端。如需詳細資訊,請參閱 Docker 說明文件中的以非 root 使用者身分來管理 Docker
    • 如果您的啟動機器執行 Ubuntu 22.04,請確保停用反向路徑篩選。若要停用反向路徑篩選,請新增下列覆寫專案:

      # New file /etc/sysctl.d/90-override.conf
      ipv4.conf.all.rp_filter = 0
      
    • 如果您的啟動載入機器具有在 2021 年 5 月 Linux 安全修補程式之後建置的 Linux 核心,則必須啟用 Tanzu CLI 用來建立本機啟動載入叢集的 kind,以寫入到最新 Linux 版本預設設為唯讀的控制檔。

      變更此檔案權限的方式取決於您的 Linux 發行版本。例如,針對 Linux 5.11 和 5.12 的 Fedora 發行版本,請執行:

      sudo sysctl net/netfilter/nf_conntrack_max=131072
      

      針對 Debian 發行版本,請將 nf_conntrack_max=131072 新增至 sysctl.conf 檔並執行:

      sudo modprobe nf_conntrack
      

      如果要按照使用現有啟動叢集來部署和刪除管理叢集中所述來進行疑難排解,您必須使用 kind v0.11 或更新版本來建立既存的持續性啟動叢集。

    Windows
    • 您的啟動機器上已安裝且正在執行 Docker 桌面
    • 在 Docker 桌面中至少配置 6 GB 記憶體,以容納 kind 容器。請參閱 kind 說明文件中的 Docker 桌面的設定
    • 如果您的啟動機器執行的是 Windows Subsystem for Linux,且其具有在 2021 年 5 月 Linux 安全性修補程式 (例如,具有 Fedora 的 Linux 5.11 和 5.12) 之後所建置的 Linux 核心,請執行以下命令:

      sudo sysctl net/netfilter/nf_conntrack_max=131072
      

      這樣一來,kind (供 tanzu CLI 用來建立本機啟動叢集) 會寫入到控制檔 (依預設,最新 Linux 版本會將控制檔設為唯讀)。
      如果要按照使用現有啟動叢集來部署和刪除管理叢集中所述來進行疑難排解,您必須使用 kind v0.11 或更新版本來建立既存的持續性啟動叢集。


安裝 Tanzu CLI

若要安裝 Tanzu CLI 以與 Tanzu Kubernetes Grid v2.4 搭配使用,請為 Tanzu Kubernetes Grid v2.4 安裝相容版本的 Tanzu Core CLI 和 Tanzu CLI 外掛程式。這些外掛程式提供的命令可啟用叢集和套件作業。有關相容 CLI 版本的清單,請參見產品互通性對照表

安裝 Tanzu Core CLI

如要安裝 Tanzu Core CLI,請執行以下步驟;如要查看這些步驟,請按兩下使用套件管理員安裝 (Install using a package manager) 從二進位版本安裝 (Install from a binary release) 索引標籤。

安裝 Tanzu Core CLI 後,繼續安裝適用於 TKG v2.4 的 Tanzu CLI 外掛程式

附註

如果要保留 Tanzu CLI 的現有安裝,請先將 CLI 二進位檔從 /usr/local/bin/tanzu 移到其他位置,然後再執行以下步驟。

使用套件管理員安裝
如要使用套件管理員安裝 Tanzu CLI,請執行以下操作:
  1. 選擇相容版本的 Tanzu CLI。有關與此版本 Tanzu Kubernetes Grid 相容的 CLI 版本清單,請參見產品互通性對照表

  2. 按照下面適用於您的套件管理員的說明進行操作。

    • APT (Debian 或 Ubuntu):

      • 如果要安裝的版本是 Tanzu CLI 的最新可用版本,例如 v1.0.0,請執行:

        sudo apt update
        sudo apt install -y ca-certificates curl gpg
        sudo mkdir -p /etc/apt/keyrings
        curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
        echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
        sudo apt update
        sudo apt install -y tanzu-cli
        
      • 如果要安裝早期版本的 Tanzu CLI,例如 v0.90.1,請執行:

        sudo apt update
        sudo apt install -y ca-certificates curl gpg
        sudo mkdir -p /etc/apt/keyrings
        curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
        echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
        sudo apt update
        sudo apt install tanzu-cli=0.90.1
        
    • Chocolatey (Windows):

      • 如果要安裝的版本是 Tanzu CLI 的最新可用版本,例如 v1.0.0,請執行:

        choco install tanzu-cli
        
      • 如果要安裝早期版本的 Tanzu CLI,例如 v0.90.1,請執行:

        choco install tanzu-cli --version 0.90.1
        
    • Homebrew (MacOS):

      • 如果要安裝的版本是 Tanzu CLI 的最新可用版本,例如 v1.0.0,請執行:

        brew update
        brew install vmware-tanzu/tanzu/tanzu-cli
        
      • 如果要安裝早期版本的 Tanzu CLI,例如 v0.90.1,請執行:

        brew update
        brew tap-new local/tap
        brew extract --version=0.90.1 vmware-tanzu/tanzu/tanzu-cli local/tap
        brew install tanzu-cli@0.90.1
        
    • YUM 或 DNF (RHEL):

      • 如果要安裝的版本是 Tanzu CLI 的最新可用版本,例如 v1.0.0,請執行:

        cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
        [tanzu-cli]
        name=Tanzu CLI
        baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
        enabled=1
        gpgcheck=1
        repo_gpgcheck=1
        gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
        EOF
        
        sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.
        
      • 如果要安裝早期版本的 Tanzu CLI,例如 v0.90.1,請執行:

        cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
        [tanzu-cli]
        name=Tanzu CLI
        baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
        enabled=1
        gpgcheck=1
        repo_gpgcheck=1
        gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
        EOF
        
        sudo yum install tanzu-cli-0.90.1 # If you are using DNF, run sudo dnf install tanzu-cli-0.90.1.
        
  3. 檢查是否適當安裝了正確版本的 CLI。例如:

    tanzu version
    version: v1.0.0
    ...
    
從二進位版本安裝
您可以從 VMware Customer Connect 或 GitHub 下載 Tanzu CLI 二進位檔。有關所有相容 CLI 版本的清單,請參見 產品互通性對照表

如要從 Customer Connect 下載 Tanzu CLI 的二進位版本,然後進行安裝,請執行以下操作:

  1. 下載並解壓縮 Tanzu CLI 二進位版本:

    1. 移至 VMware Customer Connect 上的 VMware Tanzu CLI 頁面,然後在 Tanzu CLI v1.0.0 的產品下載 (Product Downloads) 之下,找到並下載適用您作業系統的 Tanzu CLI 二進位檔。
    2. 解壓縮適用您作業系統的 Tanzu CLI 檔。若要解壓縮檔案,請使用您選擇的解壓縮工具。例如,在 Linux 或 macOS 上,您可以使用 tar 命令。

      • macOS:

        tar -xvf tanzu-cli-darwin-amd64.tar.gz
        
      • Linux:

        tar -xvf tanzu-cli-linux-amd64.tar.gz
        
      • Windows:

        使用 Windows 解壓縮工具來解壓縮 tanzu-cli-windows-amd64.zip

  2. 使 CLI 可供系統使用:

    • macOS:

      將二進位檔安裝到 /usr/local/bin

      install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
      
    • Linux:

      將二進位檔安裝到 /usr/local/bin

      sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
      
    • Windows:

      1. 建立新的 Program Files\tanzu 資料夾。
      2. tanzu-cli-windows_amd64.exeProgram Files\tanzu
      3. tanzu-cli-windows_amd64.exe 重新命名為 tanzu.exe
      4. tanzu 資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。
      5. 使用 Windows Search 搜尋 env
      6. 選取編輯系統環境變數 (Edit the system environment variables),然後按一下環境變數 (Environment Variables) 按鈕。
      7. 系統變數 (System variables) 下選取 Path 資料列,然後按一下編輯 (Edit)
      8. 按一下新增 (New),以新增資料列,然後輸入 tanzu CLI 的路徑。路徑值不得包含 .exe 延伸/副檔名。例如,C:\Program Files\tanzu
  3. 檢查是否適當安裝了正確版本的 CLI。例如:

    tanzu version
    version: v1.0.0
    ...
    

如要從 GitHub 上的二進位版本下載並安裝 Tanzu CLI,請按照《安裝 Tanzu CLI》的從 GitHub 專案中的二進位版本部分的說明進行。

安裝適用於 TKG v2.4 的 Tanzu CLI 外掛程式

若要安裝適用于 Tanzu Kubernetes Grid v2.4 的獨立 Tanzu CLI 外掛程式:

  1. 列出適用于 Tanzu Kubernetes Grid v2.4 的獨立 Tanzu CLI 外掛程式:

    tanzu plugin group get vmware-tkg/default:v2.4.0
    

    此輸出看起來類似如下:

    Plugins in Group:  vmware-tkg/default:v2.4.0
      NAME                TARGET      VERSION
      isolated-cluster    global      v0.31.0
      management-cluster  kubernetes  v0.31.0
      package             kubernetes  v0.31.0
      pinniped-auth       global      v0.31.0
      secret              kubernetes  v0.31.0
      telemetry           kubernetes  v0.31.0
    

    如要列出 vmware-tkg/default 外掛程式群組的所有可用版本,請執行:

    tanzu plugin group search -n vmware-tkg/default --show-details
    
  2. 安裝適用於 Tanzu Kubernetes Grid v2.4 的獨立外掛程式:

    tanzu plugin install --group vmware-tkg/default:v2.4.0
    
  3. 確認外掛程式是否成功安裝:

    tanzu plugin list
    

    tanzu plugin group get vmware-tkg/default:v2.4.0 傳回的每個外掛程式名稱和外掛程式版本必須包含在 tanzu plugin list 的輸出中。

    附註

    在安裝 Tanzu CLI 和 Tanzu Kubernetes Grid 的獨立外掛程式之後,但在使用其連接到管理叢集之前,該內容特定的所有 CLI 命令群組 (例如 tanzu clustertanzu kubernetes-release) 均無法使用,並且不會包含在 Tanzu CLI --help 輸出中。Tanzu CLI 會在您連接到管理叢集時自動安裝相關範圍的外掛程式。有關 Tanzu CLI 外掛程式以及如何安裝這些外掛程式的詳細資訊,請參閱安裝 Tanzu CLI 外掛程式

安裝 Kubernetes CLI

在執行啟動程序機器中下載並解壓縮 Kubernetes CLI kubectl,然後提供給系統使用:

  1. 移至 VMware Customer Connect,然後使用 VMware Customer Connect 認證登入。

  2. 造訪 Tanzu Kubernetes Grid 下載頁面

  3. VMware Tanzu Kubernetes Grid 資料列中,按一下移至下載 (Go to Downloads)

  4. 選取版本 (Select Version) 下拉式功能表中,選取 2.4.0

  5. 產品下載 (Product Downloads) 下,捲動到標有 Kubectl 1.27.5 for VMware Tanzu Kubernetes Grid 2.4.0 的區段。

    macOS
    找到 kubectl cli v1.27.5 for Mac,然後按一下 立即下載 (Download Now)
    Linux
    找到 kubectl cli v1.27.5 for Linux,然後按一下 立即下載 (Download Now)
    Windows
    找到 kubectl cli v1.27.5 for Windows,然後按一下 立即下載 (Download Now)
  6. (選用) 驗證所下載的檔案與原始檔案相同。對於每一次的下載,VMware 都會提供 SHA-1、SHA-256 和 MD5 總和檢查。若想取得這些總和檢查,請按一下您要下載的項目下的閱讀更多 (Read More)。如需詳細資訊,請參閱使用密碼編譯雜湊

  7. 如要解壓縮作業系統的 kubectl 二進位檔,請使用您選擇的解壓縮工具。例如,gunzip 命令。

    macOS
    gunzip kubectl-mac-v1.27.5+vmware.1.gz
    
    Linux
    gunzip kubectl-linux-v1.27.5+vmware.1.gz
    
    Windows
    使用 Windows 解壓縮工具來解壓縮 kubectl-windows-v1.27.5+vmware.2.exe.gz
  8. 使 CLI 可供系統使用:

    macOS
    1. 將下載的檔案指定為可執行檔:

      chmod ugo+x kubectl-mac-v1.27.5+vmware.1
      
    2. 將二進位檔安裝到 /usr/local/bin

      sudo install kubectl-mac-v1.27.5+vmware.1 /usr/local/bin/kubectl
      
    3. 執行 kubectl version,檢查 kubectl 的正確版本是否已安裝且可執行。

      kubectl version
      
    Linux
    1. 將下載的檔案指定為可執行檔:

      chmod ugo+x kubectl-linux-v1.27.5+vmware.1
      
    2. 將二進位檔安裝到 /usr/local/bin

      sudo install kubectl-linux-v1.27.5+vmware.1 /usr/local/bin/kubectl
      
    3. 執行 kubectl version,檢查 kubectl 的正確版本是否已安裝且可執行。

      kubectl version
      
    Windows
    1. 建立新的 Program Files\kubectl 資料夾。
    2. 找出 kubectl-windows-v1.27.5+vmware.1.exe 檔案,並將其複製到新的 Program Files\kubectl 資料夾中。
    3. kubectl-windows-v1.27.5+vmware.1.exe 重新命名為 kubectl.exe
    4. kubectl 資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。
    5. 使用 Windows Search 搜尋 env
    6. 選取編輯系統環境變數 (Edit the system environment variables),然後按一下環境變數 (Environment Variables) 按鈕。
    7. 系統變數 (System variables) 下選取 Path 資料列,然後按一下編輯 (Edit)
    8. 按一下新增 (New),以新增資料列,然後輸入 kubectl CLI 的路徑。
    9. 執行 kubectl version,檢查是否適當安裝了正確版本的 CLI。

      kubectl version
      

後續步驟

若要將獨立管理叢集部署到雲端提供者,請遵循部署獨立管理叢集中的指示。

check-circle-line exclamation-circle-line close-line
Scroll to top icon