Excepto donde se indique, estas notas de la versión se aplican a todas las versiones de revisión v2.4.x de Tanzu Kubernetes Grid (TKG).
TKG v2.4 se distribuye como un paquete de CLI de Tanzu descargable que implementa un clúster de administración independiente de TKG con versión. TKG v2.4 admite la creación y la administración de clústeres de carga de trabajo basados en clases con un clúster de administración independiente que se puede ejecutar en varias infraestructuras, incluidas vSphere, AWS y Azure.
ImportanteEl supervisor de vSphere with Tanzu en vSphere 8.0.1c y versiones posteriores ejecuta TKG v2.2. Las versiones anteriores de vSphere 8 ejecutan TKG v2.0, que no se publicó independientemente del supervisor. Los clústeres de administración independientes que ejecutan TKG 2.x están disponibles a partir de TKG 2.1. Debido a la versión anterior de TKG que está integrada en supervisor, algunas de las funciones que están disponibles si se utiliza un clúster de administración TKG 2.4 independiente no están disponibles si se utiliza un supervisor vSphere with Tanzu para crear clústeres de carga de trabajo. Las versiones posteriores de TKG se integrarán en Supervisor en futuras versiones de actualización de vSphere. En consecuencia, es posible que la versión de TKG integrada en la versión de vSphere with Tanzu más reciente en un momento determinado no sea tan reciente como la versión independiente más reciente de TKG. Sin embargo, las versiones de la CLI de Tanzu que son compatibles con todas las versiones de TKG v2.x son totalmente compatibles con Supervisor en todas las versiones de vSphere 8. Por ejemplo, Tanzu CLI v1.0.x es totalmente compatible con versiones anteriores de los complementos de TKG 2.2 que proporciona Supervisor.
Tanzu Kubernetes Grid v2.4.x incluye las siguientes funciones nuevas.
Nuevas funciones de Tanzu Kubernetes Grid v2.4.0:
A partir de TKG v2.2, la directiva de compatibilidad de VMware cambió para las versiones de revisión anteriores de TKG y las versiones de Tanzu Kubernetes (TKr), que empaquetan versiones de Kubernetes para TKG. Las directivas de compatibilidad para TKG v2.1 y versiones secundarias anteriores de TKG no cambian.
En las primeras dos secciones siguientes, se resume la compatibilidad con todas las versiones compatibles actualmente de TKG y TKr en las directivas de compatibilidad que se aplican a cada una.
En la tercera sección a continuación, se enumeran las versiones de los paquetes del repositorio Tanzu Standard compatibles con Kubernetes v1.27, v1.26 y 1.25 TKr.
Cada versión de Tanzu Kubernetes Grid agrega compatibilidad con la versión de Kubernetes de su clúster de administración, además de versiones adicionales de Kubernetes, distribuidas como versiones Tanzu Kubernetes (TKr), excepto donde se indique como un Problema conocido.
Versiones secundarias: VMware admite TKG v2.4 con Kubernetes v1.27, v1.26 y v1.25 en el momento de la publicación y durante el tiempo que también se admite TKG v2.4. Una vez que TKG v2.4 alcance su hito de fin de soporte general, VMware dejará de admitir Kubernetes v1.26 y v1.25 con TKG.
Versiones de revisión: Después de que VMware publique una nueva versión de revisión de TKr para una línea secundaria, conserva la compatibilidad con versiones de revisión anteriores durante dos meses. Esto proporciona a los clientes un plazo de 2 meses para actualizar a nuevas versiones de revisión de TKr. A partir de TKG v2.2, VMware no admite todas las versiones de revisión de TKr de líneas secundarias anteriores de Kubernetes.
Las versiones de revisiones de Tanzu Kubernetes Grid son compatibles o eran compatibles con las versiones de revisiones TKr, como se indica a continuación.
Versión de Tanzu Kubernetes Grid | Versión de Kubernetes del clúster de administración | Versiones de Kubernetes (TKr) proporcionadas |
---|---|---|
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 |
VMware admite las versiones de TKG de la siguiente manera:
Versiones secundarias: VMware admite TKG siguiendo la directiva del ciclo de vida de N-2, que se aplica a las dos versiones secundarias más recientes y anteriores de TKG. Con la publicación de TKG v2.4.0, TKG v2.1 ya no se admite después de que haya transcurrido un período de un año desde la versión 2.1. Consulte la Matriz del ciclo de vida del producto de VMware para obtener más información.
Versiones de revisión: VMware no admite todas las versiones anteriores de revisiones de TKG. Después de que VMware publique una nueva versión de revisión de TKG, conserva la compatibilidad con la versión de revisión anterior durante dos meses. Esto proporciona a los clientes un período de 2 meses para actualizar a nuevas versiones de revisión de TKG.
Las versiones del paquete en el repositorio Tanzu Standard para TKG v2.4 son compatibles a través de TKr con las versiones secundarias de Kubernetes v1.27, v1.26 y 1.25, y se enumeran en las Notas de la versión del repositorio Tanzu Standard.
Tanzu Kubernetes Grid v2.4 admite las siguientes plataformas de infraestructura y sistemas operativos (SO), así como con los componentes de creación y administración de clústeres, redes, almacenamiento, autenticación, copia de seguridad y migración y observación.
Consulte Versiones de componentes para obtener una lista completa de versiones de componentes incluidas en TKG v2.4.0.
Consulte Notas de la versión del repositorio Tanzu Standard para obtener versiones de paquetes adicionales compatibles con TKG v2.4.0.
vSphere | AWS | Azure | |
Plataforma de la infraestructura |
|
AWS nativo | Azure nativo |
CLI de Tanzu | Tanzu CLI Core v1.0.x** | ||
Infraestructura de TKG API y de paquetes | Tanzu Framework v0.31.0 | ||
Creación y administración de clústeres | API de clúster principal (v1.4.5), proveedor de API del clúster vSphere (v1.7.1) | API de clúster principal (v1.4.5), PROVEEDOR de API del clúster AWS (v2.1.3) | API de clúster principal (v1.4.5), Proveedor de API del clúster Azure (v1.9.2) |
Sistema operativo del nodo de Kubernetes distribuido con TKG | Photon OS 3, Ubuntu 20.04 | Amazon Linux 2, Ubuntu 20.04 | Ubuntu 18.04, Ubuntu 20.04 |
Cree su propia imagen | Photon OS 3, Red Hat Enterprise Linux 7*** y 8, Ubuntu 18.04, Ubuntu 20.04, Windows 2019 | Amazon Linux 2, Ubuntu 18.04 y Ubuntu 20.04 | Ubuntu 18.04, Ubuntu 20.04 |
Tiempo de ejecución del contenedor | Containerd (v1.6.18) | ||
Redes de contenedores | Antrea (v1.11.2), Calico (v3.26.1), Multus CNI (v4.0.1, v3.8.0) | ||
Registro de contenedores | Harbor (v2.8.4) | ||
Entrada | controlador NSX Advanced Load Balancer Essentials y 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) |
Almacenamiento | Interfaz de almacenamiento de contenedores de vSphere (v3.0.2*****) y almacenamiento nativo en la nube vSphere | Controlador CSI de Amazon EBS (v1.18.0) y proveedores de nube en el árbol | Controlador CSI de disco de Azure (v1.28.1), controlador CSI de archivos de Azure (v1.28.0) y proveedores de nube en el árbol |
Autenticación | OIDC y LDAP a través de Pinniped (v0.24.0) | ||
Observabilidad | Fluent Bit (v2.1.2, v1.9.5), Prometheus (v2.43.0, v2.37.0)**, Grafana (v9.5.1) | ||
Detección de servicios | DNS externo (v0.13.4, v0.12.2) | ||
Copia de seguridad y migración | Velero (v1.11.1) |
* Para obtener una lista de las versiones de SDDC de VMware Cloud on AWS compatibles con esta versión, consulte la matriz de interoperabilidad de productos de VMware.
** Para obtener una lista completa de las versiones de la CLI de Tanzu compatibles con esta versión, consulte la matriz de interoperabilidad de productos.
Tanzu Kubernetes Grid v1.6 es la última versión que admite la creación de imágenes de Red Hat Enterprise Linux 7.
En vSphere 8, para utilizar NSX Advanced Load Balancer con un clúster de administración independiente de TKG y sus clústeres de carga de trabajo, necesita NSX ALB v22.1.2 o una versión posterior y TKG v2.1.1 o una versión posterior.
***** Versión de vsphere_csi_driver. Para obtener una lista completa de los componentes de la interfaz de almacenamiento del contenedor de vSphere incluidos en esta versión, consulte Versiones de los componentes.
****** Si actualiza un clúster a Kubernetes v1.25, debe actualizar Prometheus a la versión 2.37.0+vmware.3-tkg.1
como mínimo. Las versiones anteriores del paquete de Prometheus, por ejemplo, la versión 2.37.0+vmware.1-tkg.1
, no son compatibles con Kubernetes 1.25.
Para obtener una lista completa de las versiones de Kubernetes que se incluyen en Tanzu Kubernetes Grid v2.4, consulte la sección anterior Versiones de Kubernetes compatibles.
La versión de TKG v2.4.x incluye las siguientes versiones de componentes de software:
NotaLas versiones anteriores de TKG incluían componentes que ahora se distribuyen a través del repositorio Tanzu Standard. Para obtener una lista de estos componentes, consulte las Notas de la versión del repositorio Tanzu Standard.
Componente | 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* |
clúster-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* |
* Indica un nuevo componente o un nuevo bump de versiones desde la versión anterior. TKG v2.3.0 es anterior a v2.4.0, y v2.2.0 es anterior a v2.3.0.
Para obtener una lista de versiones de componentes de software que se incluyen en TKG v2.4 utilice imgpkg
para extraer los paquetes de repositorios y, a continuación, enumerar su contenido. Por ejemplo, para enumerar las versiones de componentes que se incluyen en el repositorio Tanzu Standard para TKG v2.4.0, ejecute el siguiente comando:
imgpkg pull -b projects.registry.vmware.com/tkg/packages/standard/repo:v2023.9.19 -o standard-2023.9.19
En la ruta de acceso de actualización de TKG, v2.4 sigue inmediatamente a v2.3.0.
Solo puede actualizar a Tanzu Kubernetes Grid v2.4.x desde v2.3.x. Si desea actualizar a Tanzu Kubernetes Grid v2.4.x desde una versión anterior a v2.3.x, primero debe actualizar a v2.3.x.
Al actualizar versiones de Kubernetes en clústeres de carga de trabajo, no se pueden omitir versiones secundarias. Por ejemplo, no puede actualizar un clúster de Tanzu Kubernetes directamente de v1.25.x a v1.27.x. Debe actualizar un clúster de la v1.25.x a la v1.26.x antes de actualizar el clúster a la v1.27.x.
Las fechas de versión de Tanzu Kubernetes Grid v2.4 son:
Tanzu Kubernetes Grid v2.4 introduce el siguiente cambio en la documentación en comparación con la v2.3.0, que es la última versión anterior.
En esta sección se proporciona un aviso previo de los cambios de comportamiento y desuso de funciones que se aplicarán en futuras versiones, después de la versión 2.4.x de TKG.
ImportanteTanzu Kubernetes Grid v2.4 (incluidas las versiones de revisión) es la última versión secundaria de TKG que admite la creación de clústeres de administración de TKG independientes y clústeres de carga de trabajo de TKG en AWS y Azure. La capacidad para crear clústeres de administración de TKG independientes y clústeres de carga de trabajo de TKG en AWS y Azure se eliminará en la versión 2.5 de Tanzu Kubernetes Grid.
A partir de ahora, VMware recomienda utilizar Tanzu Mission Control para crear clústeres nativos de AWS EKS y Azure AKS en lugar de crear nuevos clústeres de administración de TKG independientes o nuevos clústeres de carga de trabajo de TKG en AWS y Azure. Para obtener información sobre cómo crear clústeres nativos de AWS EKS y Azure AKS con Tanzu Mission Control, consulte Gestión del ciclo de vida de los clústeres de AWS EKS y Gestión del ciclo de vida de los clústeres de Azure AKS en la documentación de Tanzu Mission Control.
Aunque la tarea es utilizar Tanzu Mission Control para crear clústeres nativos de AWS EKS y Azure AKS, la creación y el uso de clústeres de administración de TKG independientes y clústeres de carga de trabajo de TKG en AWS y Azure sigue siendo totalmente compatible con todas las versiones de TKG hasta TKG v2.4.x, incluso.
Para obtener información sobre por qué los clústeres de TKG en AWS y Azure están en desuso en VMware, consulte VMware Tanzu se alinea con las tendencias de la industria de varias nubes en el blog de VMware Tanzu.
Implementar y administrar clústeres de administración independientes de TKG 2.4 incluye temas específicos de los clústeres de administración independientes que no son pertinentes para usar TKG con un supervisor de vSphere with Tanzu.
Para obtener más información, consulte Buscar los documentos de TKG adecuados para la implementación en la página Documentación de VMware Tanzu Kubernetes Grid.
Los siguientes problemas documentados como Problemas conocidos en versiones de Tanzu Kubernetes Grid anteriores se han resuelto en Tanzu Kubernetes Grid v2.4.
Los componentes no se programan cuando se utilizan clústeres con capacidad limitada
Para los clústeres de administración y los clústeres de carga de trabajo, si implementa clústeres con un solo nodo de plano de control, un solo nodo de trabajo o clústeres pequeños o medianos, es posible que se produzca una contención de programación de recursos.
A continuación se muestran los problemas conocidos de Tanzu Kubernetes Grid v2.4.x. Todos los problemas conocidos presentes en la versión 2.4.0 que se hayan resuelto en una versión de revisión posterior a v2.4.x se enumeran en Problemas resueltos para la versión de revisión en la que se resolvieron.
Puede encontrar soluciones adicionales para problemas frecuentes en Solución de problemas del clúster de administración y Solución de problemas del clúster de carga de trabajo, o en los artículos de la base de conocimientos de VMware.
No se pueden crear nuevos clústeres de carga de trabajo basados en versiones de TKr no actuales con CNI de Antrea
No se puede crear un nuevo clúster de carga de trabajo que utilice CNI de Antrea y ejecute versiones de Kubernetes enviadas con versiones anteriores de TKG, como Kubernetes v1.23.10, que fue la versión predeterminada de Kubernetes en TKG v1.6.1, como se indica en Versiones de Kubernetes compatibles en Tanzu Kubernetes Grid v2.4.
Solución alternativa: Cree un clúster de carga de trabajo que ejecute Kubernetes 1.27.x, 1.26.x o 1.25.x. El proyecto de Kubernetes recomienda que se ejecuten componentes en la versión de revisión más reciente de cualquier versión secundaria actual.
NotaPara v4.0+, se cambia el nombre de VMware NSX-T Data Center a "VMware NSX".
El modo de entrada NodePortLocal
de NSX ALB no es compatible con el clúster de administración
En TKG v2.3, no se puede ejecutar NSX Advanced Load Balancer (ALB) como un tipo de servicio con modo de entrada NodePortLocal
para el tráfico hacia el clúster de administración.
Este problema no afecta a la compatibilidad con la entrada NodePortLocal
a los clústeres de carga de trabajo, como se describe en Entrada L7 en el modo NodePortLocal.
Solución alternativa: Configure los clústeres de administración con AVI_INGRESS_SERVICE_TYPE
establecido en NodePort
o ClusterIP
. El valor predeterminado es NodePort
.
El clúster de carga de trabajo no puede distribuir el almacenamiento entre varios almacenes de datos
No puede habilitar un clúster de carga de trabajo para distribuir el almacenamiento entre varios almacenes de datos como se describe en Implementar un clúster que usa un clúster de almacén de datos. Si etiqueta varios almacenes de datos en un clúster de almacenes de datos como base para la directiva de almacenamiento de un clúster de carga de trabajo el clúster de carga de trabajo utiliza solo uno de los almacenes de datos.
Solución alternativa: Ninguna
La CLI de Tanzu enumera tanzu management-cluster osimage
El grupo de comandos management-cluster
enumera tanzu management-cluster osimage
. Esta función está actualmente en desarrollo y está reservada para su uso en el futuro.
Solución alternativa: No use tanzu management-cluster osimage
Se produce un error al implementar el clúster de administración en vSphere 7 mientras se espera a que el plano de control del clúster esté disponible
Si especifica la red de máquina virtual al implementar un clúster de administración para vSphere 7, se produce el error unable to set up management cluster: unable to wait for cluster control plane available: control plane is not available yet
.
Solución alternativa: A continuación, la red "Red de máquina virtual" tiene varias subredes configuradas con direcciones IP estáticas para VsVip
y ServiceEngine
. Establezca exclude_discovered_subnets
en True en la red de máquina virtual para omitir las subredes detectadas y permitir que los servicios virtuales se coloquen en los motores de servicio.
Las zonas de disponibilidad se pueden eliminar mientras se asignan máquinas virtuales
Si elimina una zona de disponibilidad que contiene máquinas virtuales, las máquinas virtuales no se pueden eliminar posteriormente.
Solución alternativa: Elimine todas las máquinas virtuales de una zona de disponibilidad antes de eliminarla.
Se produce un error al crear clústeres de carga de trabajo debido a que se agota la sesión de VPXD
Al crear clústeres de carga de trabajo en vSphere, se produce el siguiente error en la creación:
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
Esto ocurre debido a que la sesión de vCenter Server se agota.
Solución alternativa: Consulte el artículo de la base de conocimientos de VMware 50114010.
Los grupos de nodos creados con nodos small
pueden detenerse en Provisioning
Los grupos de nodos creados con el nodo SIZE
configurado como small
pueden bloquearse en el estado Provisioning
y nunca continuar con Running
.
Solución alternativa: Configure el grupo de nodos con al menos nodos de tamaño medium
.
La prueba goss
que se puede ignorar falla durante el proceso de creación de imagen
Cuando se ejecuta Kubernetes Image Builder para crear una imagen de máquina personalizada de Linux, las pruebas goss
python-netifaces
, python-requests
y ebtables
producen errores. Los resultados del comando informan de los errores. Los errores se pueden ignorar; no impiden que se cree correctamente la imagen.
Con TKG v2.4, el repositorio de paquetes Tanzu Standard se versiona y se distribuye de forma independiente desde TKG, y su control de versiones se basa en una marca de fecha. Para TKG v2.4, la versión del repositorio Tanzu Standard compatible más reciente es la 2023.9.19 y ambas se publicaron en la misma fecha.
Es posible que las futuras versiones del repositorio Tanzu Standard se publiquen con más frecuencia que las versiones de TKG, pero todas las versiones de revisión mantendrán compatibilidades existentes entre las versiones secundarias de TKG y Tanzu Standard.
Para obtener más información, consulte las Notas de la versión de Tanzu Standard v2023.9.19.