En esta página, se describe cómo crear la canalización de entrega y los destinos que describen dónde y cómo Cloud Deploy implementará tu aplicación. Consulta el esquema del archivo de configuración para obtener una descripción de la estructura del archivo YAML para las canalizaciones de entrega y los destinos.
Información acerca de la canalización de entrega y los destinos
Tu canalización de entrega describe una progresión de destinos de implementación. Puedes definir esos objetivos en el mismo archivo que la canalización de entrega o en uno o más archivos separados.
Después de crear la canalización de publicación y los archivos de definición de destino, debes
ejecutar gcloud deploy apply en cada uno de esos archivos para registrarlos como
recursos de Cloud Deploy.
Define la canalización de entrega y los destinos
La estructura de la canalización de entrega y los archivos de configuración de destino se describen aquí.
Puedes llamar a este archivo como desees. Por convención, una configuración de canalización de entrega que incluye definiciones de destino se denomina clouddeploy.yaml, y una que, en su lugar, hace referencia a destinos definidos en uno o más archivos separados se denomina delivery-pipeline.yaml.
El destino puede apuntar a GKE, GKE Enterprise o Cloud Run. Dentro de una canalización de lanzamiento, todos los destinos deben hacer referencia al mismo tipo de entorno de ejecución (por ejemplo, todo GKE o todo GKE Enterprise).
Crea una canalización de publicación y destinos con la consola de Google Cloud
Puedes usar la consola de Google Cloud para crear una nueva canalización de publicación y un objetivo o varios. Esto es útil para probar Cloud Deploy, pero no es adecuado para cargas de trabajo de producción. (También puedes usar la consola de Google Cloud para crear una versión).
Para crear la canalización de entrega, sigue estos pasos:
En la página Canalizaciones de entrega, haz clic en Crear.
Proporciona un nombre (o conserva el predeterminado) y, de forma opcional, una descripción.
Selecciona tu región.
Elige tu entorno de ejecución.
Para GKE, elige Google Kubernetes Engine o selecciona Cloud Run si ese es el entorno de ejecución al que deseas implementar.
En Nuevo destino, proporciona un nombre (o mantén el predeterminado).
Si deseas solicitar una aprobación para este objetivo, selecciona la casilla de verificación Solicitar aprobación para los lanzamientos.
Si vas a usar una estrategia de implementación Canary en este objetivo, selecciona la casilla de verificación Habilitar Canary.
Haz clic en Listo.
Haz clic en Agregar destino y sigue estos pasos para cada destino adicional que desees crear.
Cuando tengas todos tus objetivos, haz clic en Crear para crear la canalización de entrega y los recursos de destino.
Registra la canalización de entrega y los destinos
Si creaste tu canalización y tus objetivos con la consola de Google Cloud, no es necesario que lo hagas.
Para registrar tu canalización de entrega con Cloud Deploy, debes ejecutar
gcloud deploy apply una vez para cada archivo de definición independiente. Es decir, si defines tres destinos en tres archivos, ejecutarías el comando cuatro veces: una para la canalización de entrega y una para cada destino.
El siguiente comando registra una canalización de publicación con sus objetivos definidos en el mismo archivo.
gcloud deploy apply --file=PIPELINE_CONFIG \
--region=LOCATION \
--project=PROJECT
Ahora tienes una canalización de entrega que puede administrar la implementación de tus versiones y los recursos de destino que puede usar cualquier canalización de entrega en el mismo proyecto y región.
Ejemplo de un solo archivo
El comando de este ejemplo registra una canalización de publicación y los destinos que se definen en el mismo archivo:
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1
Un ejemplo que usa archivos diferentes
En este ejemplo, hay tres objetivos definidos en tres archivos separados, por lo que debes ejecutar cuatro comandos:
gcloud deploy apply --file=delivery-pipeline.yaml --region=us-central1 && \
gcloud deploy apply --file=target_dev.yaml --region=us-central1 && \
gcloud deploy apply --file=target_staging.yaml --region=us-central1 && \
gcloud deploy apply --file=target_prod.yaml --region=us-central1
La marca --region es obligatoria, a menos que hayas establecido una configuración predeterminada (con gcloud
config set deploy/region [REGION]). La región debe ser la misma para la canalización de entrega y todos los destinos a los que hace referencia la canalización.
Crea la canalización de entrega y los destinos con Terraform
También puedes usar el proveedor de Terraform de Google Cloud para crear recursos de canalización de lanzamiento y destino.
Es posible que el proveedor de Terraform beta de Google Cloud incluya compatibilidad con las funciones de Cloud Deploy en la versión preliminar.
Edita canalizaciones y destinos existentes
Más adelante, puedes editar cualquier canalización de entrega o configuración de destino y ejecutar gcloud
deploy apply para actualizar la canalización o el recurso de destino. Sin embargo, esos cambios no afectan a ninguna versión existente, ya que están administrados por la canalización de lanzamiento original.
Cómo solicitar aprobación manual para una implementación
Para solicitar la aprobación manual de un objetivo determinado, incluye la siguiente propiedad en la definición del objetivo:
requireApproval: true
El valor predeterminado es false. Si omites esta propiedad de la configuración de la canalización de publicación o no proporcionas ningún valor para ella, la implementación en este destino no requiere aprobación. (Sin embargo, el llamador que intenta promocionar al objetivo aún necesita el permiso de IAM clouddeploy.rollouts.create).
Incluso puedes solicitar una aprobación manual en el primer objetivo. Cuando se crea una versión con la CLI para el primer destino, se crea rollout automáticamente. Si se requiere aprobación, Cloud Deploy crea el
rollout, pero en un estado de lanzamiento pendiente hasta que se otorgue la aprobación.
¿Qué sigue?
Consulta Cómo implementar tu aplicación para descubrir cómo invocar tu canalización de entrega y crear una versión.