Gestionar versiones de Skaffold

Cloud Deploy usa Skaffold, a través de Cloud Build, para desplegar tu aplicación renderizando y desplegando manifiestos.

En esta página se describe cómo selecciona Cloud Deploy la versión de Skaffold que debe 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, que está 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

Versión de Skaffold Versión máxima del esquema Fecha de referencia ¿Predeterminado?
2.16.x (notas de la versión) v4beta13 16 de mayo del 2025 ✓
2.14.x (notas de la versión) v4beta12 17 de febrero del 2025
2.13.x (notas de la versión) v4beta11 1 de agosto del 2024

Cada versión de esta tabla enlaza a un repositorio de Artifact Registry. En ese repositorio, busca la fecha más reciente para encontrar la última versión o la versión que quieras. El repositorio vinculado está en la región us-central1, pero estas imágenes están disponibles en todas las regiones en las que se ofrece Cloud Deploy. 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 de cada versión de Skaffold compatible. Anunciamos la compatibilidad con nuevas versiones, incluidos parches de versiones específicas de Skaffold, en las notas de la versión.

Versión preliminar

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

La versión de Skaffold de la imagen de vista previa se puede actualizar en cualquier momento y no sigue una programación de lanzamientos periódica. Te recomendamos que no utilices la versión de vista previa para cargas de trabajo de producción.

La versión de vista previa está en el mismo repositorio que las versiones compatibles. Busca imágenes con una etiqueta que empiece por 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 de Skaffold diferente al crear una versión con una función de vista previa, el comando falla.

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

Para saber qué versión de Cloud Deploy se está usando en un momento dado, ejecuta el siguiente comando:

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

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

Elegir qué versión de Skaffold usar

Puedes usar cualquier versión compatible de Skaffold. Para seleccionar la versión que quieres 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

Donde "SKAFFOLD_VERSION" es la versión (compatible) de Skaffold que se va a usar en 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 de vista previa.

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 de vista previa de Skaffold:

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

Cómo selecciona Cloud Deploy las nuevas versiones

Se selecciona una nueva versión de Skaffold cada 90 días. Al final de ese ciclo de 90 días, Google Cloud añade 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 gestionar todas las versiones durante el siguiente ciclo de 90 días.

Las notas de la versión de Cloud Deploy se actualizan para anunciar cada versión recién admitida.

Política de desactivación y mantenimiento de versiones de Skaffold

Las versiones de Skaffold se admiten durante 12 meses, con un periodo de mantenimiento de 60 días. Durante este periodo de mantenimiento, las versiones vinculadas a una versión seguirán recibiendo asistencia durante 60 días después de que haya caducado la asistencia para 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 periodo de mantenimiento.

Una vez transcurrido el periodo de mantenimiento de 60 días, la versión de Skaffold dejará de estar disponible. Ya no puedes crear lanzamientos a partir de una versión que use la versión no compatible. Sin embargo, se conservarán todos los datos asociados al lanzamiento.

Versión de Skaffold Fecha de referencia Inicio del mantenimiento Caducidad
2.16.x (notas de la versión) 12 de mayo del 2025 14 de mayo del 2026 13 de julio del 2026
2.14.x (notas de la versión) 17 de febrero del 2025 25 de febrero del 2026 26 de abril del 2026
2.13.x (notas de la versión) 1 de agosto del 2024 14 de agosto del 2025 13 de octubre del 2025

Siguientes pasos