Cloud Deploy realiza sus operaciones con una imagen personalizada, que incluye versiones de herramientas predeterminadas. Cloud Deploy te ofrece flexibilidad y control sobre el proceso de despliegue, ya que te permite especificar las versiones de las herramientas que se van a usar en las operaciones para renderizar, desplegar y verificar tus manifiestos.
En esta página se describe cómo se seleccionan las versiones de la herramienta Cloud Deploy y el tiempo de mantenimiento y asistencia de cada versión de la herramienta.
Versiones compatibles de la herramienta Cloud Deploy
Cloud Deploy te permite seleccionar las versiones de las siguientes herramientas:
Cloud Deploy proporciona un repositorio de versiones de herramientas disponibles que puedes usar en tus operaciones. Todas estas versiones están sujetas a la política de mantenimiento y de discontinuación.
Versiones de herramientas fijas
Todas las versiones de la herramienta se guardan en el recurso de lanzamiento de forma predeterminada. Las versiones de la herramienta se asocian a una versión en el momento de la creación y se usan durante todo el ciclo de vida de esa versión. No se pueden cambiar durante ese periodo. El ciclo de vida de la versión incluye todos los trabajos de renderización, implementación y otros trabajos de esa versión. Esto incluye la implementación en el destino final de la progresión y más allá (restauraciones o nuevas implementaciones). Para consultar las versiones de las herramientas asociadas a una versión, ejecuta el siguiente comando:
gcloud deploy releases describe RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--project=PROJECT \
--region=REGION \
--format='yaml(toolVersions)'
Las versiones publicadas creadas antes de que se implementara la función de control de versiones de herramientas no tendrán el campo toolVersions
en su salida. En su lugar, puedes ver su versión de Skaffold con la marca --format 'yaml(skaffoldVersion)'.
Inhabilitar la gestión de versiones de herramientas fijas
Si quieres inhabilitar el control de versiones de las herramientas fijas y usar las herramientas más recientes de una versión determinada, puedes hacerlo especificando la palabra clave especial latest para cada herramienta. A continuación, se muestra un ejemplo de cómo crear una versión que use las versiones más recientes de todas las herramientas:
gcloud deploy releases create RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--project=PROJECT \
--region=REGION \
--docker-version=latest \
--helm-version=latest \
--kpt-version=latest \
--kubectl-version=latest \
--kustomize-version=latest \
--skaffold-version=latest
Cómo especificar una versión concreta de una herramienta
Puedes usar cualquiera de las versiones de la herramienta admitidas. Para especificar la versión que quieres usar, incluye la marca adecuada para la herramienta específica:
gcloud deploy releases create RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--project=PROJECT \
--region=REGION \
--docker-version=DOCKER_VERSION \
--helm-version=HELM_VERSION \
--kpt-version=KPT_VERSION \
--kubectl-version=KUBECTL_VERSION \
--kustomize-version=KUSTOMIZE_VERSION \
--skaffold-version=SKAFFOLD_VERSION
En las herramientas en las que quieras usar la versión predeterminada, puedes omitir la marca de versión correspondiente.
Por ejemplo, el siguiente comando usa Skaffold 2.16.1 y Helm 3.18.3:
gcloud deploy releases create release-001 \
--delivery-pipeline=PIPELINE_NAME \
--skaffold-version=2.16.1 \
--helm-version=3.18.3 \
--project=PROJECT \
--region=REGION
Compatibilidad de versiones de herramientas
Cloud Deploy se encarga de que las versiones de las herramientas sean compatibles en la imagen de Cloud Deploy. Si utilizas la función de sustitución de versiones de herramientas para sustituir versiones de herramientas en la imagen de Cloud Deploy, eres responsable de elegir versiones de herramientas compatibles.
Política de desactivación y mantenimiento de versiones de herramientas
Las versiones de las herramientas se admiten durante 12 meses con un periodo de mantenimiento de 60 días a partir del día en que se importan. Durante este periodo de mantenimiento, las versiones vinculadas a una herramienta seguirán recibiendo asistencia durante 60 días después de que haya caducado la asistencia para esa versión de la herramienta. Puedes seguir creando lanzamientos a partir de esas versiones, pero no puedes crear versiones con una versión de la herramienta que esté en el periodo de mantenimiento.
Una vez transcurrido el periodo de mantenimiento de 60 días, la versión de la herramienta dejará de ser compatible con cualquier operación. Ya no puedes crear lanzamientos a partir de una versión que use la versión no compatible. Sin embargo, todos los datos asociados a la versión se conservan.
Para ver las fechas de mantenimiento y de vencimiento de la versión, ejecuta el siguiente comando:
gcloud deploy releases describe RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--project=PROJECT \
--region=REGION \
--format 'yaml(condition)'
También puedes ver la fecha de mantenimiento y de vencimiento de una herramienta específica ejecutando el siguiente comando:
gcloud artifacts versions list \
--package TOOL_NAME \
--repository tools \
--project cd-image-prod \
--location=REGION
Las fechas de mantenimiento y de vencimiento están disponibles como anotaciones en las versiones correspondientes.