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 y los destinos de entrega.
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 destinos 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 entrega y los archivos de definición de destino, ejecutas 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 los archivos de configuración de la canalización de entrega y del destino se describe aquí.
Puedes asignarle el nombre que desees a este archivo. Por convención, una configuración de canalización de entrega que incluye definiciones de destino se denomina clouddeploy.yaml, y una que, en cambio, 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 entrega, todos los destinos deben hacer referencia al mismo tipo de tiempo de ejecución (por ejemplo, todos los destinos de GKE o todos los destinos de GKE Enterprise).
Crea una canalización de entrega y destinos con la consola de Google Cloud
Puedes usar la consola de Google Cloud para crear una nueva canalización de entrega y un destino o destinos. Esto es útil para probar Cloud Deploy, pero no es adecuado para cargas de trabajo de producción. (También puedes usar la consola deGoogle 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.
En el caso de GKE, elige Google Kubernetes Engine o selecciona Cloud Run si ese es el entorno de ejecución en el que realizas la implementación.
En Nuevo destino, proporciona un nombre (o conserva el predeterminado).
Si deseas solicitar aprobación en este objetivo, selecciona la casilla de verificación Solicitar aprobación para lanzamientos.
Si vas a usar una estrategia de implementación canary en este destino, 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 quieras crear.
Cuando tengas todos tus destinos, 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 destinos con la consola de Google Cloud , no es necesario que hagas esto.
Para registrar tu canalización de entrega en Cloud Deploy, ejecuta gcloud deploy apply una vez para cada archivo de definición independiente. Es decir, si defines tres destinos en tres archivos, ejecutarás el comando cuatro veces: una para la canalización de entrega y una para cada destino.
El siguiente comando registra una canalización de entrega con sus destinos 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 recursos de destino que puede usar cualquier canalización de entrega en el mismo proyecto y región.
Un ejemplo de un solo archivo
El comando de este ejemplo registra una canalización de entrega y 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 destinos 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 un valor predeterminado (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 esa 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 entrega y destino.
El proveedor de Terraform en versión beta deGoogle Cloud puede incluir compatibilidad con las funciones de Cloud Deploy en vista previa.
Edita canalizaciones y destinos existentes
Luego, puedes editar cualquier canalización de entrega o configuración de destino y ejecutar gcloud
deploy apply para actualizar el recurso de canalización o destino. Sin embargo, esos cambios no afectan los lanzamientos existentes, ya que se administran a través de la canalización de entrega original.
Cómo solicitar aprobación manual para una implementación
Para solicitar la aprobación manual de un destino determinado, incluye la siguiente propiedad en la definición del destino:
requireApproval: true
El valor predeterminado es false. Si omites esta propiedad de la configuración de la canalización de entrega o no proporcionas ningún valor para ella, no se requiere aprobación para implementar en este destino. (Sin embargo, el llamador que intenta promover al destino aún necesita el permiso de IAM clouddeploy.rollouts.create).
Incluso puedes solicitar la aprobación manual en el primer objetivo. Cuando se crea una versión con la CLI para el primer destino, el objeto rollout se crea 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 saber cómo invocar tu canalización de entrega y crear una versión.