API obsoletas de Kubernetes 1.32

En esta página se explica cómo preparar los clústeres para actualizar a la versión 1.32 de GKE. Puedes buscar clientes de API que hagan llamadas a APIs obsoletas eliminadas en la versión 1.32 y actualizar esos clientes para que usen las APIs de GA. Para obtener información más detallada, consulta la guía de migración de APIs obsoletas de Kubernetes.

APIs retiradas en la versión 1.32

Las APIs obsoletas de la versión 1.32 de Kubernetes son APIs beta que han pasado a estar disponibles de forma general (por ejemplo, v2) o de una versión beta a otra (por ejemplo, de v1beta1 a v1beta2). Las APIs disponibles de forma general ofrecen garantías de compatibilidad a largo plazo y deben usarse en lugar de las APIs beta obsoletas.

Todos los objetos de las APIs que se hayan actualizado a nuevas versiones se pueden usar con las APIs actualizadas.

Recursos de control de flujo

La versión flowcontrol.apiserver.k8s.io/v1beta3 de la API de FlowSchema y PriorityLevelConfiguration ya no se ofrece desde la versión 1.32.

Migra los manifiestos y los clientes de la API para que usen la flowcontrol.apiserver.k8s.io/v1versión de la API, disponible desde la versión 1.29.

Se puede acceder a todos los objetos persistentes con la nueva API.

La versión flowcontrol.apiserver.k8s.io/v1 de la API incluye los siguientes cambios importantes:

  • El campo PriorityLevelConfiguration spec.limited.assuredConcurrencyShares se ha cambiado a spec.limited.nominalConcurrencyShares y solo tiene el valor predeterminado 30 cuando no se especifica ningún valor. Además, el valor explícito 0 no se cambia a 30.

Preparación para actualizar a la versión 1.32

No es necesario que elimines ni vuelvas a crear ninguno de tus objetos de API. Todos los objetos de API persistentes de las APIs que han pasado a estar disponibles de forma general se pueden leer y actualizar con las nuevas versiones de la API.

Sin embargo, te recomendamos que migres tus clientes y manifiestos antes de actualizar a Kubernetes 1.32. Para obtener más información, consulta la guía de migración de APIs obsoletas de Kubernetes.

Puedes consultar estadísticas y recomendaciones sobre las APIs obsoletas para determinar si tu clúster está usando APIs obsoletas de Kubernetes 1.32. GKE genera estadísticas de obsolescencia cuando los agentes de usuario llaman a APIs obsoletas, no a partir de la configuración de tus objetos de Kubernetes.

Buscar clústeres que usen APIs obsoletas

Puedes consultar qué clústeres usan APIs obsoletas en Estadísticas de obsolescencia. Las estadísticas de las APIs obsoletas también proporcionan información, como qué clientes de API llaman a las APIs obsoletas de tu clúster.

También puedes usar los registros de auditoría para saber qué clientes están haciendo llamadas a APIs obsoletas.

Localizar clientes de API que hacen llamadas de escritura a APIs obsoletas

En los clústeres en los que Google Cloud Observability esté habilitado, puedes usar la siguiente consulta del registro de auditoría de actividad de administrador para mostrar el uso de APIs obsoletas por parte de agentes de usuario que no estén gestionados por Google:

resource.type="k8s_cluster"
labels."k8s.io/removed-release"="DEPRECATED_API_MINOR_VERSION"
protoPayload.authenticationInfo.principalEmail:("system:serviceaccount" OR "@")
protoPayload.authenticationInfo.principalEmail!~("system:serviceaccount:kube-system:")

Sustituye DEPRECATED_API_MINOR_VERSION por la versión secundaria en la que se ha retirado la API obsoleta (por ejemplo, 1.22).

Los registros de auditoría de actividad de administración se habilitan automáticamente en los clústeres de GKE. Con esta consulta, los registros muestran agentes de usuario que hacen llamadas de escritura a las APIs obsoletas.

Localizar clientes de API que hagan llamadas de lectura a APIs obsoletas

De forma predeterminada, los registros de auditoría solo muestran las llamadas de escritura a las APIs obsoletas. Para mostrar también las llamadas de lectura a APIs obsoletas, configura los registros de auditoría de acceso a datos.

Sigue las instrucciones para configurar registros de auditoría de acceso a datos con la Google Cloud consola. En la Google Cloud consola, selecciona la API de Kubernetes Engine. En la pestaña Tipos de registro del panel de información, selecciona Admin Read y Data Read.

Con estos registros habilitados, ahora puede usar la consulta original para ver tanto las llamadas de lectura como las de escritura a las APIs obsoletas.

Actualizar componentes de terceros

Estadísticas de obsolescencia: puede que se muestren resultados de agentes de terceros que hagan llamadas a APIs obsoletas en tu clúster.

Para resolver el problema de los agentes de terceros que llaman a APIs obsoletas, te recomendamos que sigas estas prácticas recomendadas:

  1. Ponte en contacto con el proveedor del software de terceros para obtener una versión actualizada.
  2. Actualiza el software de terceros a la versión más reciente. Si no puedes actualizar el software, debes probar si la actualización de GKE a la versión con las APIs obsoletas eliminadas afectaría a tu servicio.

Te recomendamos que realices esta actualización y la de la versión de GKE en un clúster de staging para monitorizar las interrupciones antes de actualizar tus clústeres de producción.

Actualizar clústeres afectados por las obsolescencias

GKE pausa las actualizaciones automáticas de los clústeres afectados por las obsolescencias. Para obtener más información, consulta Cómo funcionan las obsolescencias de Kubernetes en GKE.

Para actualizar los clústeres afectados por las obsolescencias, sigue estos pasos:

  1. Consulta qué user-agents usan las APIs obsoletas en los registros.
  2. Actualiza los user-agents que usan las APIs obsoletas para que usen versiones de la API compatibles.
  3. Actualiza a las versiones más recientes el software de terceros que llame a APIs obsoletas.
  4. Actualiza un clúster de prueba y prueba tu aplicación en un entorno de pruebas antes de actualizar tu clúster de producción para reducir el riesgo de interrupciones cuando las APIs obsoletas ya no estén disponibles.

  5. Si no puedes actualizar un user-agent afectado, actualiza un clúster de prueba independiente para comprobar si la actualización provoca interrupciones. Si la actualización no provoca interrupciones, puedes actualizar el clúster manualmente.

  6. Una vez que hayas actualizado todos los user-agents, GKE esperará hasta que no se haya observado el uso de APIs obsoletas durante 30 días y, a continuación, desbloqueará las actualizaciones automáticas. Las actualizaciones automáticas se realizan según la programación de lanzamientos.

Recursos

Puede consultar más información en la documentación de Kubernetes de software libre: