本主題說明如何在啟動機器上安裝和初始化 Tanzu 命令列介面 (CLI)。啟動機器是一部您從中部署管理和工作負載叢集的筆記型電腦、主機或伺服器,且用來保留您部署的 Tanzu 和 Kubernetes 組態檔。啟動機器通常是本機機器,但也可以是您遠端存取的實體機器或虛擬機器。
如果要以 vSphere 8 上的 vSphere with Tanzu 主管作為管理叢集,在您安裝 Tanzu CLI 後,可以將其連線到主管。
附註本主題中的指示專門用來安裝 Tanzu CLI 以與 vSphere 8 上的 vSphere with Tanzu 主管搭配使用。如果您要安裝 Tanzu CLI,以在不含主管的 vSphere 上部署獨立管理叢集,或在 AWS 或 Azure 上部署獨立管理叢集,請參閱《部署和管理 Tanzu Kubernetes Grid 2.2 獨立管理叢集》中的對應主題:安裝 Tanzu CLI 和其他工具以用於獨立管理叢集。
Tanzu CLI 會與主管通訊,以在 vSphere with Tanzu 中建立和管理工作負載叢集。
重要vSphere 8.0.1c 和更新版本中的 vSphere with Tanzu 主管執行 TKG v2.2。舊版的 vSphere 8 執行 TKG v2.0,該版本並非獨立於主管發佈。從 TKG 2.1 開始,可以使用執行 TKG 2.x 的獨立管理叢集。更新的 TKG 版本將嵌入到未來 vSphere 更新版本的主管中。因此,在指定時間內嵌于最新vSphere with Tanzu版本的 TKG 版本可能與所使用的 TKG 獨立版本不同。但是,完全支援與所有 TKG v2.x 版本相容的 Tanzu CLI 版本與 vSphere 8 所有版本中的主管一起使用。
注意與 vSphere 8 中的 TKG 2.x 和 vSphere with Tanzu 主管相容的 Tanzu CLI 版本與 vSphere 7 中的主管叢集不相容。如要在 vSphere 7 上對 vSphere with Tanzu 主管叢集使用 Tanzu CLI,請使用 TKG v1.6 中的 Tanzu CLI 版本。如要使用與具有主管的 TKG 2.x 相容的 Tanzu CLI 版本,請升級到 vSphere 8。如果 vSphere with Tanzu 主管叢集不存在,您可以將獨立 TKG 2.x 管理叢集部署到 vSphere 7。有關 Tanzu CLI 與 VMware 產品之間相容性的資訊,請參閱 Tanzu CLI 文件。
如需 Tanzu CLI 的詳細資訊 (包括命令參考),請參閱 VMware Tanzu CLI 說明文件。
用來安裝及執行 Tanzu CLI 的啟動機器必須符合特定需求。另有進一步的需求,具體取決於您是打算將 Tanzu CLI 與作為管理叢集的 vSphere with Tanzu 主管搭配使用,還是要部署獨立管理叢集,還是兩者都要。
若要透過 Tanzu Kubernetes Grid v2.2 來執行 Tanzu CLI,您需要一部用來安裝及執行 Tanzu CLI 的啟動機器,且其具備:
若要以主管叢集作為管理叢集,還需要:
具有 vSphere 8 帳戶,並且:
下列其中一項:
kubectl vsphere
CLI 外掛程式已安裝在您的啟動機器上,如下載並安裝適用於 vSphere 的 Kubernetes CLI 工具中所述。從 Tanzu Kubernetes Grid 下載頁面,下載 Tanzu CLI 相容版本的檔案。
移至 VMware Customer Connect,然後使用 VMware Customer Connect 認證登入。
在 VMware Tanzu Kubernetes Grid 資料列中,按一下移至下載 (Go to Downloads)。
在選取版本 (Select Version) 下拉式功能表中,選取 2.2.0。
在產品下載 (Product Downloads) 下,捲動到標有 VMware Tanzu CLI 2.2.0 的區段。
(選用) 驗證所下載的檔案與原始檔案相同。對於每一次的下載,VMware 都會提供 SHA-1、SHA-256 和 MD5 總和檢查。若想取得這些總和檢查,請按一下您要下載的項目下的閱讀更多 (Read More)。如需詳細資訊,請參閱使用密碼編譯雜湊。
在系統上,建立名為 tanzu
的新目錄。如果您先前已將舊版本的構件解壓縮至此資料夾,請刪除該資料夾的現有內容。
在 tanzu
資料夾中,將作業系統的 Tanzu CLI 服務包檔案解壓縮。若要解壓縮服務包檔案,請使用您選擇的解壓縮工具。例如,在 Linux 或 macOS 上,您可以使用 tar
命令。
tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
tanzu-cli-bundle-windows-amd64.zip
。
解壓縮服務包檔案後,在 tanzu
資料夾中,您將看到一個 cli
資料夾,其中包含多個子資料夾和檔案。
在啟動機器中下載並解壓縮 Tanzu CLI 後,必須讓它可供系統使用。
導覽至您在上一節中解壓縮的 tanzu
資料夾下的 cli
子資料夾。
cd cli
使 CLI 可供系統使用:
/usr/local/bin
:
sudo install core/v0.29.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
/usr/local/bin
:
sudo install core/v0.29.0/tanzu-core-linux_amd64 /usr/local/bin/tanzu
Program Files\tanzu
資料夾。cli
資料夾中,找出 core\v0.29.0\tanzu-core-windows_amd64.exe
檔案,並將其複製到新的 Program Files\tanzu
資料夾中。tanzu-core-windows_amd64.exe
重新命名為 tanzu.exe
。tanzu
資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。env
。Path
資料列,然後按一下編輯 (Edit)。tanzu
CLI 的路徑。在新終端機的命令列中,初始化 Tanzu CLI:
tanzu init
檢查是否適當安裝了正確版本的 CLI。CLI 版本與目前版本的 Tanzu Framework (在 Tanzu CLI 中) 相同。Tanzu Kubernetes Grid 2.2 使用 Tanzu CLI v0.29.0 (在 Tanzu Framework v0.29.0 中):
tanzu version
如果您是在 macOS 上執行,可能會遇到以下錯誤:
"tanzu" cannot be opened because the developer cannot be verified.
如果發生這種情況,您需要為 tanzu
可執行檔建立安全性例外狀況。在 Finder 中找出 tanzu
應用程式,按住 Ctrl 並按一下該應用程式,然後選取開啟 (Open)。
如果您的機器上已安裝先前安裝的現有 Tanzu CLI 外掛程式,請將外掛程式更新為目前的 CLI 版本:
卸載現有外掛程式:
tanzu plugin clean
安裝此版本的所有外掛程式:
tanzu plugin sync
檢查外掛程式安裝狀態和版本:
tanzu plugin list
附註在安裝 Tanzu CLI 之後,但在使用其登入到管理叢集之前,該內容特定的所有 CLI 命令群組 (例如
tanzu cluster
和tanzu kubernetes-release
) 均無法使用,並且不會包含在 Tanzu CLI--help
輸出中。
在啟動機器中下載並解壓縮 Kubernetes CLI kubectl
,然後讓它可供您的系統使用。
移至 VMware Customer Connect,然後使用 VMware Customer Connect 認證登入。
在 VMware Tanzu Kubernetes Grid 資料列中,按一下移至下載 (Go to Downloads)。
在選取版本 (Select Version) 下拉式功能表中,選取 2.2.0。
在產品下載 (Product Downloads) 下,捲動到標有 Kubectl 1.25.7 for VMware Tanzu Kubernetes Grid 2.2.0 的區段。
(選用) 驗證所下載的檔案與原始檔案相同。對於每一次的下載,VMware 都會提供 SHA-1、SHA-256 和 MD5 總和檢查。若想取得這些總和檢查,請按一下您要下載的項目下的閱讀更多 (Read More)。如需詳細資訊,請參閱使用密碼編譯雜湊。
導覽至您在上述下載並解壓縮 Tanzu CLI 中所建立的 tanzu
目錄,然後解壓縮作業系統的 kubectl
二進位檔。若要解壓縮服務包檔案,請使用您選擇的解壓縮工具。例如,gunzip
命令。
gunzip kubectl-mac-v1.25.7+vmware.2.gz
gunzip kubectl-linux-v1.25.7+vmware.2.gz
kubectl-windows-v1.25.7+vmware.2.exe.gz
。
使 CLI 可供系統使用:
將下載的檔案指定為可執行檔:
chmod ugo+x kubectl-mac-v1.25.7+vmware.2
將二進位檔安裝到 /usr/local/bin
:
sudo install kubectl-mac-v1.25.7+vmware.2 /usr/local/bin/kubectl
執行 kubectl version
,檢查 kubectl
的正確版本是否已安裝且可執行。
kubectl version
將下載的檔案指定為可執行檔:
chmod ugo+x kubectl-linux-v1.25.7+vmware.2
將二進位檔安裝到 /usr/local/bin
:
sudo install kubectl-linux-v1.25.7+vmware.2 /usr/local/bin/kubectl
執行 kubectl version
,檢查 kubectl
的正確版本是否已安裝且可執行。
kubectl version
Program Files\kubectl
資料夾。kubectl-windows-v1.25.7+vmware.2.exe
檔案,並將其複製到新的 Program Files\kubectl
資料夾中。kubectl-windows-v1.25.7+vmware.1.exe
重新命名為 kubectl.exe
。kubectl
資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。env
。Path
資料列,然後按一下編輯 (Edit)。kubectl
CLI 的路徑。執行 kubectl version
,檢查是否適當安裝了正確版本的 CLI。
執行 tanzu --help
,以查看 Tanzu CLI 提供的命令清單。
您可以使用 --help
選項來查看任何命令群組的説明文字,以查看該特定命令或命令群組的相關資訊。例如,tanzu login --help
、tanzu management-cluster --help
或 tanzu management-cluster create --help
。
如需 Tanzu CLI 的詳細資訊,請參閱《Tanzu CLI 命令參考。
Carvel 開放原始碼專案提供一組可靠且為單一用途的可組合工具,有助於您在 Kubernetes 中建置、設定和部署應用程式。
Tanzu Kubernetes Grid 提供 ytt
、kapp
、kbld
和 imgpkg
的簽署二進位檔,並隨附於 Tanzu CLI。該服務包還包含一個 Kubernetes 目錄結構工具 vendir
,使用者目前不需要使用該工具,之所以提供,是為了方便使用。
導覽至啟動環境機器中,針對您的作業系統解壓縮 Tanzu CLI 服務包 tar 檔案的位置。
例如,您在先前程序中建立的 tanzu
資料夾。
開啟 cli
資料夾。
cd cli
ytt
ytt
是用來範本化及修補 YAML 檔案的命令列工具。您還可以使用 ytt
,將 YAML 的片段和堆疊收集到模組化區塊中,以方便重新使用。Tanzu Kubernetes Grid 使用 ytt
,以支援對叢集和叢集計劃,進行以覆疊為基礎的自訂。您可能需要 ytt
,才能使用自訂覆疊。
解壓縮 ytt
二進位檔,並使其可執行。
gunzip ytt-darwin-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-darwin-amd64-v0.43.1+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 ytt
:
sudo mv ./ytt-darwin-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
執行 ytt --version
,檢查 ytt
的正確版本是否已安裝且可執行。
ytt --version
解壓縮 ytt
二進位檔,並使其可執行。
gunzip ytt-linux-amd64-v0.43.1+vmware.1.gz
chmod ugo+x ytt-linux-amd64-v0.43.1+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 ytt
:
sudo mv ./ytt-linux-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt
執行 ytt --version
,檢查 ytt
的正確版本是否已安裝且可執行。
ytt --version
解壓縮 ytt
二進位檔。
gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz
將 ytt-windows-amd64-v0.43.1+vmware.1
重新命名為 ytt.exe
Program Files\ytt
資料夾,並將 ytt.exe
檔案複製到其中。ytt
資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。env
。Path
資料列,然後按一下編輯 (Edit)。ytt
工具的路徑。ytt version
,以檢查是否適當安裝正確版本的 ytt
。kapp
kapp
是適用於 Kubernetes 的應用程式部署 CLI。它可讓您將多個 Kubernetes 資源當成一個應用程式,來安裝、升級和刪除。
解壓縮 kapp
二進位檔,並使其可執行。
gunzip kapp-darwin-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-darwin-amd64-v0.53.2+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 kapp
:
sudo mv ./kapp-darwin-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
執行 kapp --version
,檢查 kapp
的正確版本是否已安裝且可執行。
kapp --version
解壓縮 kapp
二進位檔,並使其可執行。
gunzip kapp-linux-amd64-v0.53.2+vmware.1.gz
chmod ugo+x kapp-linux-amd64-v0.53.2+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 kapp
:
sudo mv ./kapp-linux-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp
執行 kapp --version
,檢查 kapp
的正確版本是否已安裝且可執行。
kapp --version
解壓縮 kapp
二進位檔。
gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz
將 kapp-windows-amd64-v0.53.2+vmware.1
重新命名為 kapp.exe
Program Files\kapp
資料夾,並將 kapp.exe
檔案複製到其中。kapp
資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。env
。Path
資料列,然後按一下編輯 (Edit)。kapp
工具的路徑。kapp version
,以檢查是否適當安裝正確版本的 kapp
。kbld
kbld
是一個映像建置和解析工具。
解壓縮 kbld
二進位檔,並使其可執行。
gunzip kbld-darwin-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-darwin-amd64-v0.35.1+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 kbld
:
sudo mv ./kbld-darwin-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
執行 kbld --version
,檢查 kbld
的正確版本是否已安裝且可執行。
解壓縮 kbld
二進位檔,並使其可執行。
gunzip kbld-linux-amd64-v0.35.1+vmware.1.gz
chmod ugo+x kbld-linux-amd64-v0.35.1+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 kbld
:
sudo mv ./kbld-linux-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld
執行 kbld --version
,檢查 kbld
的正確版本是否已安裝且可執行。
kbld --version
解壓縮 kbld
二進位檔。
gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz
將 kbld-windows-amd64-v0.35.1+vmware.1
重新命名為 kbld.exe
Program Files\kbld
資料夾,並將 kbld.exe
檔案複製到其中。kbld
資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。env
。Path
資料列,然後按一下編輯 (Edit)。kbld
工具的路徑。kbld version
,以檢查是否適當安裝正確版本的 kbld
。imgpkg
imgpkg
是一個可讓 Kubernetes 將組態和相關聯的容器映像儲存成 OCI 映像並傳輸這些映像的工具。若要在網際網路受限的環境中部署 Tanzu Kubernetes Grid 以及建置您自己的機器映像,則需要 imgpkg
。在設定 Harbor 套件時,也需要使用該套件。
解壓縮 imgpkg
二進位檔,並使其可執行。
gunzip imgpkg-darwin-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-darwin-amd64-v0.31.1+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 imgpkg
:
sudo mv ./imgpkg-darwin-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
執行 imgpkg --version
,檢查 imgpkg
的正確版本是否已安裝且可執行。
imgpkg --version
解壓縮 imgpkg
二進位檔,並使其可執行。
gunzip imgpkg-linux-amd64-v0.31.1+vmware.1.gz
chmod ugo+x imgpkg-linux-amd64-v0.31.1+vmware.1
將二進位檔移至 /usr/local/bin
,並重新命名為 imgpkg
:
sudo mv ./imgpkg-linux-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg
執行 imgpkg --version
,檢查 imgpkg
的正確版本是否已安裝且可執行。
imgpkg --version
解壓縮 imgpkg
二進位檔。
gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz
將 imgpkg-windows-amd64-v0.31.1+vmware.1
重新命名為 imgpkg.exe
Program Files\imgpkg
資料夾,並將 imgpkg.exe
檔案複製到其中。imgpkg
資料夾上按一下滑鼠右鍵,選取內容 (Properties) > 安全性 (Security),並確定您的使用者帳戶具有完全控制 (Full Control) 權限。env
。Path
資料列,然後按一下編輯 (Edit)。imgpkg
工具的路徑。imgpkg version
,以檢查是否適當安裝正確版本的 imgpkg
。在您使用 Tanzu CLI、kubectl
和 Carvel 工具,將工作負載叢集和服務套件部署到 Tanzu Kubernetes Grid 之前,請依如下所述,將 Tanzu CLI 連線到主管。
若要向 Tanzu CLI 登錄主管,然後登入「主管」,請執行下列動作。您只需要向 Tanzu CLI 登錄主管一次。登錄主管後,您可以跳至 tanzu login
步驟。
從 vCenter 取得「主管」的 IP 位址:
https://192.168.123.3
。無 IDP:如果您沒有使用外部身分識別提供者,請執行下列動作:
(選用) 使用受信任的憑證來安裝及設定 kubectl vsphere
外掛程式,如設定 vSphere with Tanzu 叢集的安全登入中所述。
執行 kubectl vsphere login
,以登入 vSphere。如需此步驟的詳細資訊,請參閱使用 Kubectl 以 vCenter Single Sign-On 使用者身分連線至主管。
kubectl vsphere login --vsphere-username VSPHERE-USERNAME --server=SUPERVISOR-IP
其中,VSPHERE-USERNAME
是 vCenter Single Sign-On (SSO) 帳戶的使用者名稱 (例如 [email protected]
),而 SUPERVISOR-IP
是您在上述中取得的主管 IP 位址。
如果您未使用受信任的憑證來設定 kubectl vsphere
外掛程式,您可以將 --insecure-skip-tls-verify=true
附加到上述命令,以不安全的方式登入。
注意請僅在開發環境中使用不安全的登入。
輸入您用來登入 vCenter 的密碼。
成功登入後,kubectl vsphere login
命令會:
kubeconfig
檔案,以新增用來透過 Kubernetes API 進行驗證的 Token將 kubectl
的內容設定為「主管」。
kubectl config use-context SUPERVISOR-IP
其中,SUPERVISOR-IP
是主管的內容;請參閱 vSphere with Tanzu 服務和工作負載中的取得和使用主管內容。
收集資訊來執行 tanzu login
命令,以連線至「主管」:
tanzu
CLI 所要使用的主管名稱。kubeconfig
檔案的路徑,預設值為 ~/.kube/config
,這是由 KUBECONFIG
環境變數所設定。執行 tanzu login
命令,傳遞上述值,例如:
無 IDP:
tanzu login --name my-supervisor --kubeconfig ~/.kube/config --context 192.168.123.3
登入後,CLI 會下載特定於主管的外掛程式。
??? successfully logged in to management cluster using the kubeconfig my-supervisor
Checking for required plugins...
Installing plugin 'cluster:v0.25' with target 'kubernetes'
Installing plugin 'feature:v0.25' with target 'kubernetes'
Installing plugin 'kubernetes-release:v0.25' with target 'kubernetes'
Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
Successfully installed all required plugins
使用 IDP:
tanzu login --endpoint https://10.73.27.32 --name oidc-user
Detected a vSphere Supervisor being used
Log in by visiting this link:
...
https://10.27.62.33/wcp/pinniped/oauth2/authorize?..
...
Optionally, paste your authorization code: G2TcS145Q4e6A1YKf743n3BJlfQAQ_UdjXy38TtEEIo.ju4QV3PTsUvOigVUtQllZ7AJFU0YnjuLHTRVoNxvdZc
...
??? successfully logged in to management cluster using the kubeconfig oidc-user
Checking for required plugins...
All required plugins are already installed and up-to-date
在上述範例中,https://10.73.27.32
是主管控制平面 IP 位址。如需此步驟的詳細資訊,請參閱使用 Tanzu CLI 和外部 IDP 連線至主管。
執行 tanzu config server list
,檢查是否已新增主管,例如:
tanzu config server list
NAME TYPE ENDPOINT PATH CONTEXT
my-supervisor managementcluster https://192.168.123.3:443 /home/vmware/.kube/config 192.168.123.3
tanzu login
現在應會列出您指名的主管:
tanzu login
? Select a server [Use arrows to move, type to filter]
> my-supervisor ()
+ new server
執行 tanzu plugin list
,以查看主管特定外掛程式以及核心 CLI 外掛程式的清單。
tanzu plugin list
Standalone Plugins
NAME DESCRIPTION TARGET DISCOVERY VERSION STATUS
isolated-cluster isolated-cluster operations default v0.29.0 installed
login Login to the platform default v0.29.0 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) default v0.29.0 installed
management-cluster Kubernetes management-cluster operations kubernetes default v0.29.0 installed
package Tanzu package management kubernetes default v0.29.0 installed
secret Tanzu secret management kubernetes default v0.29.0 installed
telemetry Configure cluster-wide telemetry settings kubernetes default v0.29.0 installed
Plugins from Context: my-supervisor
NAME DESCRIPTION TARGET VERSION STATUS
cluster Kubernetes cluster operations kubernetes v0.25.0 installed
feature Operate on features and featuregates kubernetes v0.25.0 installed
kubernetes-release Kubernetes release operations kubernetes v0.25.0 installed
namespaces Discover vSphere Supervisor namespaces you have access to kubernetes v1.0.0 installed
附註在上述範例中,您在安裝 Tanzu CLI 時所安裝的獨立外掛程式 (例如
login
和pinniped-auth
) 的版本為 v0.29.0。您將 Tanzu CLI 連線到主管時所安裝的主管內容中的外掛程式 (例如,cluster
或kubernetes-release
) 的版本為 v0.25.0。這是因為 vSphere with Tanzu 中的主管在執行 TKG 2.0 而不是 TKG 2.2。但是,v0.25.0 外掛程式與 v0.29.0 的 Tanzu CLI 和獨立外掛程式完全相容並受其支援。