Administra las versiones de Skaffold

Cloud Deploy usa Skaffold mediante Cloud Build para implementar tu aplicación mediante la renderización y la implementación de manifiestos.

En esta página, se describe cómo Cloud Deploy selecciona qué versión de Skaffold usar. En esta página, también se incluye información sobre lo siguiente:

¿Qué versión de Skaffold usa Cloud Deploy?

Cloud Deploy realiza sus operaciones con una imagen personalizada, que incluye una versión de LTS de Skaffold. Cada versión compatible de Skaffold se incluye en la tabla de este documento, vinculada al repositorio de todas las imágenes de Cloud Deploy. El número de versión de cada imagen de Cloud Deploy corresponde al número de versión de Skaffold.

Antes del 30 de agosto de 2022, Cloud Deploy usaba la versión LTS de las imágenes de Skaffold disponibles públicamente más recientes.

Versiones compatibles

Versión de Skaffold Versión máxima del esquema A partir de la siguiente fecha ¿es predeterminada?
2.11.x (notas de la versión) v4beta10 6 de mayo de 2024 ✓
2.10.x (notas de la versión) v4beta9 2 de febrero de 2024
2.8.x (notas de la versión) v4beta7 27 de octubre de 2023
2.6.x (notas de la versión) v4beta6 6 de julio de 2023
2.3.x (notas de la versión) v4beta4 24 de abril de 2023
2.0.x (notas de la versión) v4beta1 9 de enero de 2023

Cada versión de esta tabla se vincula a un repositorio en Artifact Registry. En ese repositorio, busca la fecha más reciente de la versión más reciente o la que desees. El repositorio vinculado se encuentra en la región us-central1, pero estas imágenes están disponibles en cada región en la que Cloud Deploy está disponible. La imagen que se usa está en la región en la que se creó la canalización de entrega.

Cloud Deploy usa la versión de parche más reciente para cada versión compatible de Skaffold. Anunciamos la compatibilidad con versiones nuevas, incluidos los parches específicos de la versión de Skaffold, en las notas de la versión.

Versión de vista previa

Puedes usar la imagen de vista previa de Cloud Deploy, que incluye funciones de vista previa.

La versión de Skaffold en la imagen de vista previa se puede actualizar en cualquier momento y no sigue un programa de lanzamientos regular. Te recomendamos que no uses la versión de vista previa para las cargas de trabajo de producción.

La versión de vista previa se encuentra en el mismo repositorio que las versiones compatibles. Busca imágenes con una etiqueta que comience con skaffold_preview.

Algunas funciones de vista previa requieren la imagen de vista previa de Cloud Deploy. Para estas funciones, Cloud Deploy usa esa versión preliminar sin que tengas que realizar ninguna acción. Si intentas seleccionar una versión diferente de Skaffold cuando creas una versión con una función de vista previa, el comando falla.

Descubre la versión de Skaffold asociada a una versión

Para encontrar la versión que usa Cloud Deploy en un momento determinado, ejecuta el siguiente comando:

gcloud deploy releases describe RELEASE \
       --delivery-pipeline=DELIVERY_PIPELINE \
       --region=REGION

La versión se muestra en el atributo skaffoldVersion en el resultado.

Elige qué versión de Skaffold usar

Puedes usar cualquier versión compatible de Skaffold. Para seleccionar la versión que deseas usar, incluye la marca --skaffold-version en el comando gcloud deploy releases create:

gcloud deploy releases create RELEASE_NAME \
       --delivery-pipeline=PIPELINE_NAME \
       --skaffold-version=SKAFFOLD_VERSION \
       --region=REGION

"SKAFFOLD_VERSION" es la versión (compatible) de Skaffold que se usará para esta versión. La versión debe tener el formato n.nn para una versión numerada o skaffold_preview si quieres usar la versión de vista previa.

Por ejemplo, con el siguiente comando, se selecciona la versión 2.8 de Skaffold:

gcloud deploy releases create release-001 \
                              --delivery-pipeline=my-pipeline \
                              --skaffold-version=2.8 \
                              --region=us-central1

Este comando selecciona la versión de vista previa de Skaffold:

gcloud deploy releases create release-001 \
                       --delivery-pipeline=my-pipeline \
                       --skaffold-version=skaffold_preview \
                       --region=us-central1

Cómo Cloud Deploy selecciona versiones nuevas

Se selecciona una versión nueva de Skaffold cada 90 días. Al final de ese ciclo de 90 días, Google Cloud agrega compatibilidad con una nueva versión de Skaffold. Ahora puedes usar esa versión con Cloud Deploy. Se convierte en la versión predeterminada que se usa para crear y administrar todas las versiones del siguiente ciclo de 90 días.

Las notas de la versión de Cloud Deploy se actualizan para anunciar cada versión nueva compatible.

Política de baja y mantenimiento de versiones de Skaffold

Las versiones de Skaffold son compatibles durante 12 meses, con un período de mantenimiento de 60 días. Este período de mantenimiento significa que las versiones vinculadas a una versión siguen siendo compatibles durante 60 días después del vencimiento de la compatibilidad con esa versión. Aún puedes crear lanzamientos a partir de esas versiones, pero no puedes crear versiones con una versión de Skaffold que se encuentre en el período de mantenimiento.

Después del período de mantenimiento de 60 días, la versión de Skaffold ya no es compatible. Ya no puedes crear lanzamientos a partir de una versión que usa la versión no compatible. Sin embargo, se conservan todos los datos asociados con la versión.

Versión de Skaffold A partir de la siguiente fecha Inicio del mantenimiento Vencimiento
2.11.x (notas de la versión) 6 de mayo de 2024 6 de mayo de 2025 5 de julio de 2025
2.10.x (notas de la versión) 2 de febrero de 2024 2 de febrero de 2025 3 de abril de 2025
2.8.x (notas de la versión) 26 de octubre de 2023 26 de octubre de 2024 25 de diciembre de 2024
2.6.x (notas de la versión) 6 de julio de 2023 6 julio de 2024 4 de septiembre de 2024
2.3.x (notas de la versión) 24 de abril de 2023 1 de mayo de 2024 1 de julio de 2024

¿Qué sigue?