VMware Tanzu Kubernetes Grid v2.4 版本說明
除非另有說明，否則這些版本資訊適用於 Tanzu Kubernetes Grid (TKG) 的所有 v2.4.x 修補程式版本。
TKG v2.4 是以可下載 Tanzu CLI 套件的形式散佈，用於部署已進行版本的 TKG 獨立管理叢集。TKG v2.4 支援使用可在多個基礎架構 (包括 vSphere、AWS 和 Azure) 上執行的獨立管理叢集建立和管理以類別為基礎的工作負載叢集。
vSphere 8 中 Tanzu Kubernetes Grid 2.4 版和 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 版本，某些獨立 TKG 2.4 管理叢集中可用的功能，在使用 vSphere with Tanzu 建立工作負載叢集時不可用。更新的 TKG 版本將嵌入到未來 vSphere 更新版本的主管中。因此，特定時間最新 vSphere with Tanzu 版本中嵌入的 TKG 版本可能不如最新獨立 TKG 版本新。但是，完全支援與所有 TKG v2.x 版本相容的 Tanzu CLI 版本與 vSphere 8 所有版本中的主管一起使用。例如，Tanzu CLI v1.0.x 與主管提供的 TKG 2.2 外掛程式完全向後相容。
新增功能
Tanzu Kubernetes Grid v2.4.x 包含以下新功能。
Tanzu Kubernetes Grid v2.4.0
Tanzu Kubernetes Grid 2.4.0 版中的新功能：
- 支援 Kubernetes v1.27.5、v1.26.8 和 v1.25.13。請參閱下面的 Tanzu Kubernetes Grid v2.4 中支援的 Kubernetes 版本
- 元件版本更新，如下面的 Tanzu Kubernetes Grid v2.4 的產品快照和元件版本中所述。
- 套件說明文件和 Tanzu Standard 套件存放庫版本資訊已移至單獨的出版物。請參見下面的 Tanzu Kubernetes Grid v2.4 中的行為和說明文件變更。
支援的 Kubernetes、TKG 和套件版本
從 TKG v2.2 開始，VMware 的支援原則已針對舊版 TKG 和封裝 TKG Kubernetes 版本的 Tanzu Kubernetes 版本 （TKrs） 變更。TKG v2.1 和較舊次要 TKG 版本的支援政策則無變化。
前兩節總結了在適用於每個 TKG 和 TKr 的支援政策下，對所有目前支援的 TKG 和 TKr 版本的支援。
以下第三節列出 Tanzu Standard 存放庫中 Kubernetes v1.27、v1.26 和 v1.25 TKr 支援的套件版本。
支援的 Kubernetes 版本：
Tanzu Kubernetes Grid 的每個版本都增加了對其管理叢集的 Kubernetes 版本以及其他 Kubernetes 版本的支援，且這些版本是以 Tanzu Kubernetes 版本 (Tkr) 形式發行，但標記為已知問題者除外。
次要版本：VMware 在發行時以及 TKG v2.4 也支援 TKG v2.4 with Kubernetes v1.27、v1.26 和 v1.25。一旦 TKG v2.4 達到其終止一般支援里程碑，VMware將不再支援具有 TKG 的 Kubernetes v1.26 和 v1.25。
修補程式版本：在 VMware 為次要分支版本發佈新的 TKr 修補程式版本後，會將對較舊修補程式版本的支援保留兩個月。這為客戶提供了 2 個月的時間升級到新的 TKr 修補程式版本。從 TKG v2.2 開始， VMware 不支援 Kubernetes 先前次要行中的所有 TKr 修補程式版本。
Tanzu Kubernetes Grid 修補程式版本支援和支援的 TKr 修補程式版本如下所列。
| Tanzu Kubernetes Grid 版本 | 管理叢集的 Kubernetes 版本 | 提供的 Kubernetes (TKr) 版本 |
|---|---|---|
| 2.4.0 | 1.27.5 | 1.27.5、1.26.8、1.25.13 |
| 2.3.0 | 1.26.5 | 1.26.5、1.25.10、1.24.14 |
| 2.2.0 | 1.25.7 | 1.25.7、1.24.11、1.23.17 |
| 2.1.1 | 1.24.10 | 1.24.10、1.23.16、1.22.17 |
| 2.1.0 | 1.24.9 | 1.24.9、1.23.15、1.22.17 |
支援的 Tanzu Kubernetes Grid 版本
VMware 支援如下所示的 TKG 版本：
次要版本：VMware 支援遵循 N-2 生命週期政策的 TKG，該政策適用於最新和之前的兩個次要 TKG 版本。隨著 TKG v2.4.0 的發行，自 v2.1 版本起經過一年的時間後，不再支援 TKG v2.1。有關詳細資訊，請參見 VMware產品生命週期矩陣。
修補程式版本：VMware 不支援以前的所有 TKG 修補程式版本。在 Vmware 發行新的 TKG 修補程式版本後，會將對較舊修補程式版本的支援保留兩個月。這為客戶提供了 2 個月的時間升級到新的 TKG 修補程式版本。
- 例如，對 TKG v2.4.0 的支援將在 TKG v2.4.1 正式發佈兩個月後結束。
支援的套件版本
適用於 TKG v2.4 的 Tanzu Standard 存放庫中的套件版本通過 TKrs 與 Kubernetes 次要版本 v1.27、v1.26 和 v1.25 相容，並在 Tanzu Standard 存放庫版本資訊中列出。
Tanzu Kubernetes Grid v2.4 的產品快照
Tanzu Kubernetes Grid v2.4 支援下列基礎結構平台和作業系統 (OS)，以及叢集的建立和管理、網路、儲存區、驗證、備份和移轉以及可觀察性元件。
有關 TKG v2.4.0 中包含的元件版本的完整清單，請參閱元件版本。
有關與 TKG v2.4.0 相容的其他套件版本，請參閱 Tanzu Standard 存放庫版本資訊。
| vSphere | AWS | Azure | |
| 基礎結構平台 |
|
原生 AWS | 原生 Azure |
| Tanzu CLI | Tanzu CLI Core v1.0.x** | ||
| TKG API 和套件基礎結構 | Tanzu Framework v0.31.0 | ||
| 叢集的建立和管理 | 核心叢集 API （v1.4.5）、叢集 API 提供者vSphere （v1.7.1） | 核心叢集 API （v1.4.5）、叢集 API 提供者 AWS （v2.1.3） | 核心叢集 API （v1.4.5）、叢集 API 提供者 Azure （v1.9.2） |
| 隨 TKG 發行的 Kubernetes 節點作業系統 | Photon OS 3、Ubuntu 20.04 | Amazon Linux 2、Ubuntu 20.04 | Ubuntu 18.04、Ubuntu 20.04 |
| 建置您自己的映像 | Photon OS 3、Red Hat Enterprise Linux 7*** 和 8、Ubuntu 18.04、Ubuntu 20.04、Windows 2019 | Amazon Linux 2、Ubuntu 18.04、Ubuntu 20.04 | Ubuntu 18.04、Ubuntu 20.04 |
| 容器執行階段 | Containerd (v1.6.18) | ||
| 容器網路 | Antrea (v1.11.2)、Calico (v3.26.1)、Multus CNI (v4.0.1、v3.8.0) | ||
| 容器登錄 | Harbor (v2.8.4) | ||
| 入口 | NSX Advanced Load Balancer Essentials 和 Avi 控制器 **** （v21.1.5-v21.1.6， v22.1.3-v22.1.4）、NSX v4.1.0 （vSphere 8.0.u1）、v3.2.2 （vSphere 7）、Contour （v1.25.2、v1.24.5） | Contour (v1.25.2、v1.24.5) | Contour (v1.25.2、v1.24.5) |
| 儲存區 | vSphere 容器儲存區介面 (v3.0.2*****) 和 vSphere 雲端原生儲存區 | Amazon EBS CSI 驅動程式 (v1.18.0) 和樹狀結構內雲端提供者 | Azure 磁片 CSI 驅動程式 (v1.28.1)、Azure 檔案 CSI 驅動程式 (v1.28.0) 和樹狀結構內雲端提供者 |
| 驗證 | 透過 Pinniped 的 OIDC 和 LDAP (v0.24.0) | ||
| 可觀察性 | Fluent Bit (v2.1.2、v1.9.5)、Prometheus (v2.43.0、v2.37.0)******、Grafana (v9.5.1) | ||
| 服務探索 | 外部 DNS (v0.13.4、v0.12.2) | ||
| 備份和移轉 | Velero (v1.11.1) | ||
* 如需與此版本相容的 VMware Cloud on AWS SDDC 版本清單，請參閱 VMware 產品互通性對照表。
** 有關與此版本相容的 Tanzu CLI 版本的完整清單，請參見產品互通性對照表。
*** Tanzu Kubernetes Grid v1.6 是支援建置 Red Hat Enterprise Linux 7 映像的最新版本。
**** 在 vSphere 8 上，若要將 NSX Advanced Load Balancer 與 TKG 獨立管理叢集及其工作負載叢集結合使用，您需要 NSX ALB v22.1.2 或更新版本以及 TKG v2.1.1 或更新版本。
***** vsphere_csi_driver 版本。如需此版本中包含的 vSphere 容器儲存區介面元件的完整清單，請參見元件版本。
****** 如果將叢集升級到 Kubernetes v1.25，則必須至少將 Prometheus 升級到版本 2.37.0+vmware.3-tkg.1。Prometheus 軟體套件的早期版本 (例如版本 2.37.0+vmware.1-tkg.1) 與 Kubernetes 1.25 不相容。
有關 Tanzu Kubernetes Grid v2.4 隨附的 Kubernetes 版本的完整清單，請參見上述支援的 Kubernetes 版本。
元件版本
TKG v2.4.x 版本包含下列軟體元件版本：
附註以前的 TKG 版本包括現在透過 Tanzu Standard 存放庫散發的元件。有關這些元件的清單，請參見 Tanzu Standard 存放庫版本資訊。
| 元件 | TKG v2.4 |
|---|---|
| aad-pod-identity | v1.8.15+vmware.2 |
| addons-manager | v2.2+vmware.1 |
| ako-operator | v1.10.0_vmware.2* |
| antrea | v1.11.2_vmware.1-advanced* |
| antrea-internetworking | v1.11.1* |
| aws-cloud-controller-manager | v1.27.1+vmware.1* |
| aws-ebs-csi-driver | v1.18.0+vmware.3* |
| azuredisk-csi-driver | v1.28.1+vmware.2* |
| azurefile-csi-driver | v1.28.0+vmware.2* |
| calico_all | v3.26.1+vmware.1* |
| capabilities-package | v0.31.0-capabilities* |
| carvel-secretgen-controller | v0.14.2+vmware.2 |
| cloud-provider-azure | v1.1.26+vmware.1、 v1.23.23+vmware.1、 v1.24.10+vmware.1 |
| cloud_provider_vsphere | v1.27.0+vmware.1* |
| cluster-api-provider-azure | v1.9.2+vmware.1 |
| cluster_api | v1.4.5+vmware.1* |
| cluster_api_aws | v2.1.3+vmware.0 |
| cluster_api_vsphere | v1.7.1+vmware.0* |
| cni_plugins | v1.2.0+vmware.7* |
| containerd | v1.6.18+vmware.1 |
| coredns | v1.10.1_vmware.7* |
| crash-diagnostics | v0.3.7+vmware.7 |
| cri_tools | v1.26.0+vmware.7* |
| csi_attacher | v4.3.0+vmware.2*, v4.2.0+vmware.3* |
| csi_livenessprobe | v2.10.0+vmware.2*, v2.9.0+vmware.3* |
| csi_node_driver_registrar | v2.8.0+vmware.2*, v2.7.0+vmware.3* |
| csi_provisioner | v3.5.0+vmware.2*, v3.4.1+vmware.3*, v3.4.0+vmware.3* |
| etcd | v3.5.7_vmware.6* |
| external-snapshotter | v6.2.2+vmware.2*, v6.2.1+vmware.3* |
| guest-cluster-auth-service | v1.3.0_tkg.2 |
| image-builder | v0.1.14+vmware.1 |
| image-builder-resource-bundle | v1.27.5+vmware.1-tkg.1* |
| imgpkg | v0.36.0+vmware.2 |
| jetstack_cert-manager | v1.12.2+vmware.1* |
| k14s_kapp | v0.55.0+vmware.2 |
| k14s_ytt | v0.45.0+vmware.2 |
| kapp-controller | v0.45.2+vmware.1 |
| kbld | v0.37.0+vmware.2 |
| kube-vip | v0.5.12+vmware.1 |
| kube-vip-cloud-provider | v0.0.5+vmware.1、 v0.0.4+vmware.4 |
| kubernetes | v1.27.5+vmware.1*、 v1.26.8+vmware.1*、 v1.25.13+vmware.1* |
| kubernetes-csi_external-resizer | v1.8.0+vmware.2*、 v1.7.0+vmware.3* |
| kubernetes-sigs_kind | v1.27.5+vmware.1-tkg.1_v0.17.0* |
| kubernetes_autoscaler | v1.27.5+vmware.1* |
| load-balancer-and-ingress-service (AKO) | 1.10.2+vmware.1-tkg.1 |
| metrics-server | v0.6.2+vmware.1 |
| pinniped | v0.24.0+vmware.1-tkg.1 |
| pinniped-post-deploy | v0.24.0+vmware.1 |
| sonobuoy | v0.56.16+vmware.2 |
| tanzu-framework | v0.31.0* |
| tanzu-framework-addons | v0.31.0* |
| tanzu-framework-management-packages | v0.31.0* |
| tkg-bom | v2.4.0* |
| tkg-core-packages | v1.27.5+vmware.1-tkg.1* |
| tkg-standard-packages | v2023.9.19* |
| tkg-storageclass-package | v0.31.0* |
| tkg_telemetry | v2.3.0+vmware.3* |
| velero | v1.11.1+vmware.1* |
| velero-mgmt-cluster-plugin | v0.2.1+vmware.1* |
| velero-plugin-for-aws | v1.7.1+vmware.1* |
| velero-plugin-for-csi | v0.5.1+vmware.1* |
| velero-plugin-for-microsoft-azure | v1.7.1+vmware.1* |
| velero-plugin-for-vsphere | v1.5.1+vmware.1 |
| vendir | v0.33.1+vmware.2 |
| vsphere_csi_driver | v3.0.2+vmware.2* |
* 表示自先前版本以來新增的元件或版本更新。TKG v2.3.0 之前為 v2.4.0，而 v2.2.0 之前為 v2.3.0。
如需 TKG v2.4 隨附的軟體元件版本的完整清單，請使用 imgpkg 提取存放庫服務包，然後列出其內容。例如，要列出 TKG v2.4.0 Tanzu Standard 存放庫隨附的元件版本，請執行以下命令：
imgpkg pull -b projects.registry.vmware.com/tkg/packages/standard/repo:v2023.9.19 -o standard-2023.9.19
支援的升級路徑
在 TKG 升級路徑中，v2.4 緊接在 v2.3.0 之後。
您只能從 v2.3.x 升級至 Tanzu Kubernetes Grid v2.4.x。如果要從早於 v2.4.x 的版本升級到 Tanzu Kubernetes Grid v2.3.x，必須先升級到 v2.3.x。
在工作負載叢集上升級 Kubernetes 版本時，無法跳過次要版本。例如，您無法將 Tanzu Kubernetes 叢集從 v1.25.x 直接升級至 v1.27.x。您必須先將 v1.25.x 叢集升級至 v1.26.x，然後再將叢集升級至 v1.27.x。
發行日期
Tanzu Kubernetes Grid v2.4 版發行日期如下：
- v2.4.0：2023 年 9 月 28 日
Tanzu Kubernetes Grid v2.4 中的行為和說明文件變更
相較於 v2.3.0 (上一個版本)，Tanzu Kubernetes Grid v2.4 中引入了下列的說明文件變更。
- Tanzu 套件的說明文件和 Tanzu 標準套件存放庫的版本資訊已移至一個單獨的出版物，其中介紹了使用主管和獨立管理叢集部署的 TKG。
- 請參見新出版物《VMware Tanzu 套件說明文件》。
- 從 TKG v2.3 開始，Tanzu Standard 套件存放庫已與 TKG 分開發佈，如 TKG v2.3 版本資訊中所述。
未來行為變更和棄用通知
本節提供了將在未來版本 (TKG v2.4.x 版本之後的版本) 中生效的行為變更和未來棄用的預先通知。
取代 AWS 和 Azure 上的 TKG 管理和工作負載叢集
重要Tanzu Kubernetes Grid v2.4 (包括修補程式版本) 是支援在 AWS 和 Azure 上建立獨立 TKG 管理叢集和 TKG 工作負載叢集的上一個次要版本。Tanzu Kubernetes Grid 2.5 版將移除在 AWS 和 Azure 上建立獨立 TKG 管理叢集和 TKG 工作負載叢集的功能。
從現在開始，VMware 建議您使用 Tanzu Mission Control 建立原生 AWS EKS 和 Azure AKS 叢集，而不是在 AWS 和 Azure 上建立新的 TKG 工作負載叢集。有關如何使用 Tanzu Mission Control 原生 AWS EKS Azure AKS 叢集的資訊，請參見《Tanzu Mission Control》說明文件中的管理 AWS EKS 叢集的生命週期和管理 Azure AKS 叢集的生命週期。
雖然重新批註是使用 Tanzu Mission Control 來建立原生 AWS EKS 和 Azure AKS 叢集，但建立和使用獨立 TKG 管理叢集和 AWS 和 Azure 上的 TKG 工作負載叢集仍完全支援 TKG v2.4.x （包括 TKG v2.4.x） 的所有 TKG 版本。
有關 VMware 為何在 AWS 和 Azure 上棄用 TKG 叢集的資訊，請參見 VMware Tanzu 部落格上的 VMware Tanzu 與多雲行業趨勢一致。
使用者說明文件
部署和管理 TKG 2.4 獨立管理叢集中含有獨立管理叢集的特定主題，這些主題與「將 TKG 與 vSphere with Tanzu 主管搭配使用」無關。
如需詳細資訊，請參閱《VMware Tanzu Kubernetes Grid 說明文件》頁面上的尋找適合您部署的 TKG 文件。
已解決的問題
已在 v2.4.0 中解決
在舊版Tanzu Kubernetes Grid中記錄為 已知問題 的下列問題已在 Tanzu Kubernetes Grid v2.4 中解決。
已知問題
以下是 Tanzu Kubernetes Grid v2.4.x 中的已知問題。在後續 v2.4.x 修補程式發行版本中解決的存在於 v2.4.0 中的任何已知問題，都列在修正這些問題的修補程式發行版本的已解決的問題之下。
您可以在疑難排解管理叢集問題和疑難排解工作負載叢集問題或 VMware 知識庫文章中找到常見問題的其他解決方案。
叢集作業
-
無法根據具有 Antrea CNI 的非目前 TKr 版本建立新的工作負載叢集
您無法建立使用 Antrea CNI 並執行先前版本 TKG 隨附的 Kubernetes 版本 (如 Kubernetes v1.23.10) 的新工作負載叢集，這是 TKG v1.6.1 中預設的 Kubernetes 版本，如 Tanzu Kubernetes Grid v2.4 中支援的 Kubernetes 版本所列。
因應措施：建立執行 Kubernetes 1.27.x、1.26.x 或 1.25.x 的工作負載叢集。Kubernetes 專案建議您在目前任何次要版本的最新修補程式版本上執行元件。
網路
附註若為 v4.0 以上，VMware NSX-T Data Center 已重新命名為「VMware NSX」。
-
管理叢集不支援 NSX ALB
NodePortLocal輸入模式在 TKG v2.3 中，當使用輸入模式
NodePortLocal來將流量傳輸至管理叢集時，您無法將 NSX Advanced Load Balancer (ALB) 當成服務類型來執行。此問題不會影響支援使用
NodePortLocal輸入來傳輸到工作負載叢集，如 NodePortLocal 模式下的 L7 輸入中所述。因應措施：將
AVI_INGRESS_SERVICE_TYPE設定為NodePort或ClusterIP，來設定管理叢集。預設值為NodePort。
儲存區
-
無法啟用工作負載叢集以在多個資料存放區分配儲存，如部署使用資料存放區的叢集中所述。如果將資料存放區叢集中的多個資料存放區標記為工作負載叢集儲存原則的基礎，則工作負載叢集僅使用其中一個資料存放區。
因應措施：無
Tanzu CLI
-
Tanzu CLI 列出 tanzu management-cluster osimage
management-cluster命令群組列出了tanzu management-cluster osimage。此功能目前正在開發中，並保留供未來使用。因應措施：請勿使用
tanzu management-cluster osimage。
vSphere
-
在等待叢集控制平面變為可用時，將管理叢集部署到 vSphere 7 失敗
如果在將管理叢集部署到 vSphere 7 時指定虛擬機器網路，部署將失敗並顯示以下錯誤：
unable to set up management cluster: unable to wait for cluster control plane available: control plane is not available yet。因應措施：網路「虛擬機器網路」具有
VsVip和ServiceEngine的多個已設定子網路靜態 IP。在虛擬機器網路上將exclude_discovered_subnets設為 True，以忽略發現的子網路並允許將虛擬服務放置在服務引擎上。 -
如果刪除包含虛擬機器的可用區域，則後續無法刪除這些虛擬機器。
因應措施：從可用區域中移除所有虛擬機器，然後再將其刪除。
-
在 vSphere 上建立工作負載叢集時，建立失敗並顯示以下錯誤：
vSphere config validation failed: failed to get VC client: failed to create vc client: Post "https://address/sdk": EOF ". VCenter vpxd.log report error: Out of HTTP sessions: Limited to 2000發生這種情況的原因是 vCenter Server 工作階段耗盡。
因應措施：請參閱 VMware 知識庫文章 50114010。
-
使用
small節點來建立的節點集區可能會停滯在Provisioning狀態。建立節點集區時，如果將節點
SIZE設定為small，則集區可能停滯在Provisioning狀態，且永遠不會進入Running狀態。因應措施：將節點集區設定成至少具有
medium大小的節點。
Image-Builder
-
在您執行 Kubernetes Image Builder 以建立 Linux 自訂機器映像時，
goss測試python-netifaces、python-requests和ebtables失敗。命令輸出會報告失敗情況。這些錯誤可以忽略；它們不會妨礙映像建置成功。
Tanzu Standard Repository v2023.9.19
在 TKG v2.4 中，Tanzu Standard 套件存放庫會進行版本設定，並與 TKG 分開散佈，並且其版本設定以日期標記為基礎。對於 TKG v2.4，最新相容的 Tanzu Standard 存放庫版本為 v2023.9.19，兩者均在同一日期發行。
未來的 Tanzu Standard 存放庫版本可能會比 TKG 版本更頻繁發佈，但所有修補程式版本都將保持 TKG 的次要版本與 Tanzu Standard 之間的現有相容性。
如需詳細資訊，請參閱 Tanzu Standard v2023.9.19 版本資訊。
