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.

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 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 se encuentra 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 de Skaffold admitida. En las notas de la versión, anunciamos la compatibilidad con versiones nuevas, incluidos parches específicos de la versión de Skaffold.

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 lanzamiento regular. Te recomendamos que no uses la versión de vista previa para las 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 en versión preliminar, el comando fallará.

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

Aquí, "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 seguirán siendo compatibles durante 60 días después de que venza la compatibilidad con esa versión. Aún puedes crear lanzamientos a producción 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 progresivos a partir de un lanzamiento 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 Skaffold funciona 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.