Administra las versiones de Skaffold

Cloud Deploy usa Skaffold, a través de 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. Esta página también 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 LTS de Skaffold. Cada versión compatible de Skaffold se indica 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 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.13.x (notas de la versión) v4beta11 1 de agosto de 2024 ✓
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

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 de la versión que deseas. El repositorio vinculado está en la región us-central1, pero estas imágenes están disponibles en cada región en la que está disponible Cloud Deploy. La imagen que se usa está en la región donde se creó la canalización de publicación.

Cloud Deploy usa la versión de parche más reciente para cada versión de Skaffold compatible. Anunciamos la compatibilidad con versiones nuevas, incluidos parches específicos de versiones 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 vista previa para 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 de vista previa sin que tengas que hacer nada. Si intentas seleccionar un Skaffold diferente cuando creas una versión mediante 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 cualquier momento, 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 el ícono --skaffold-version marca en el comando gcloud deploy releases create:

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

En el ejemplo anterior, "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 para usar la versión preliminar.

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 próximo ciclo de 90 días.

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

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 aún se admiten durante 60 días después de que venza la compatibilidad con esa versión. Puedes seguir creando lanzamientos a partir de esas versiones, pero no puedes crear versiones con una versión de Skaffold que esté en el período de mantenimiento.

Después del período de mantenimiento de 60 días, ya no se admitirá la versión de Skaffold. Ya no puedes crear lanzamientos a partir de una versión que use 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.13.x (notas de la versión) 1 de agosto de 2024 14 de agosto de 2025 13 de octubre de 2025
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

¿Qué sigue?