Administra 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:

• Con qué frecuencia cambia la versión de Skaffold
• Cómo averiguar la versión actual
• Durante cuánto tiempo se admite cada versión

¿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 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

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 Cloud Deploy está disponible. 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 versión preliminar para cargas de trabajo de producción.

La versión preliminar 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 hacer nada. 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 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 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

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, el siguiente comando 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 preliminar 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. Aún puedes crear 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.

¿Qué sigue?

• Obtén más información para integrar Cloud Deploy en otros sistemas.

• Obtén más información sobre cómo funciona Skaffold con Cloud Deploy y cómo hacer que funcione bien para ti.

• En el documento Administra manifiestos en Cloud Deploy, se describe más sobre cómo puedes usar Skaffold, incluso con otras herramientas de administración de manifiestos de terceros.