Crea una canalización y un lanzamiento en la consola de Google Cloud

Crea una canalización y un lanzamiento en la consola de Google Cloud

En esta página, se muestra cómo usar la consola de Google Cloud para crear una canalización de entrega de Cloud Deploy y, luego, crear una versión para esa canalización.

En esta guía de inicio rápido, harás lo siguiente:

1. Crea dos clústeres de GKE o configura dos servicios de Cloud Run.

2. Crea una canalización de entrega y dos destinos con la consola de Google Cloud.

3. Crea una versión con la consola de Google Cloud para crear una instancia de tu canalización de entrega.

   Después de crear esta versión, la aplicación se implementa automáticamente en el destino.

4. Consulta los resultados en la consola de Google Cloud.

Antes de comenzar

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. Habilita las API de Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage.

   Habilita las API

5. Instala Google Cloud CLI.

6. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

   gcloud init

   Nota: Puedes ejecutar la CLI de gcloud en la consola de Google Cloud sin instalar Google Cloud CLI. Para ejecutar la CLI de gcloud en la consola de Google Cloud, usa Cloud Shell.

7. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

8. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

9. Habilita las API de Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage.

   Habilita las API

10. Instala Google Cloud CLI.

11. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init

    Nota: Puedes ejecutar la CLI de gcloud en la consola de Google Cloud sin instalar Google Cloud CLI. Para ejecutar la CLI de gcloud en la consola de Google Cloud, usa Cloud Shell.

Si ya tienes instalada la CLI, asegúrate de estar ejecutando la versión más reciente:

gcloud components update

Crea tu entorno de ejecución

Si realizas la implementación en Cloud Run, puedes omitir este comando.

Para GKE, crea dos clústeres, quickstart-cluster-for-console-staging y quickstart-cluster-for-console-prod, con la configuración predeterminada. Los extremos de la API de Kubernetes de los clústeres deben ser accesibles para la red desde la Internet pública. Los clústeres de GKE son accesibles de forma externa de forma predeterminada.

gcloud container clusters create-auto quickstart-cluster-for-console-staging \
                 --project=PROJECT_ID \
                 --region=us-central1 && \
gcloud container clusters create-auto quickstart-cluster-for-console-prod \
                 --project=PROJECT_ID \
                 --region=us-central1

Crea una canalización de entrega y dos destinos

Puedes usar Cloud Deploy para crear una canalización de entrega y destinos según la configuración especificada en uno o más archivos YAML. Pero también puedes crear una canalización de entrega con la consola de Google Cloud.

En esta sección, usarás la consola de Google Cloud para crear una canalización de entrega y dos destinos. Cuando usas la consola de Google Cloud, no necesitas crear ningún archivo YAML; Cloud Deploy crea tu skaffold.yaml y el manifiesto por ti.

1. En la consola de Google Cloud, navega a la página principal de Cloud Deploy.

   Abrir la página Canalizaciones de entrega

2. Haz clic en Create.

   

   Se muestra el formulario Crear una canalización de entrega.

3. En el campo Nombre de la canalización, reemplaza el texto predeterminado por in-console-quickstart-pipeline.

4. De manera opcional, ingresa una descripción para esta canalización de entrega.

5. En el menú desplegable Región, selecciona us-central1.

6. Selecciona tu entorno de ejecución.

   Si realizas la implementación en GKE, selecciona Google Kubernetes Engine. De lo contrario, selecciona Cloud Run.

7. Crea tus objetivos:

   GKE

   1. En Nuevo objetivo, en el campo Nombre del destino, reemplaza el texto predeterminado por console-staging.

   2. En el menú desplegable Clúster de Kubernetes Engine, selecciona quickstart-cluster-for-console-staging.

   3. Haz clic en Listo.

   4. Haz clic en Agregar destino.

      Reemplaza el texto predeterminado del Nombre del destino por console-prod.

   5. Selecciona quickstart-cluster-for-console-prod en el menú desplegable Clúster de Kubernetes Engine.

   6. Selecciona Requerir aprobación para los lanzamientos.

      Para esta guía de inicio rápido, se requiere aprobación en el segundo destino, pero no en el primero.

   7. Haz clic en Crear para crear esta canalización de entrega.

      

   Cloud Run

   1. En Nuevo objetivo, en el campo Nombre del destino, reemplaza el texto predeterminado por console-staging.

   2. En el menú desplegable Región, selecciona us-central1.

   3. Haz clic en Listo.

   4. Haz clic en Agregar destino.

   5. Reemplaza el texto predeterminado del Nombre del destino por console-prod.

   6. Activa la casilla de verificación Requerir aprobación para lanzamientos en este destino.

      Para esta guía de inicio rápido, se requiere aprobación en el segundo destino, pero no en el primero.

   7. Haz clic en Crear para crear esta canalización de entrega.

      

   Nota: Si la cuenta de servicio predeterminada de Compute Engine no tiene los permisos necesarios, puedes hacer clic en el botón Otorgar para agregarlos cuando se te solicite.

   Ahora tienes una canalización de entrega con dos destinos, lista para crear una versión.
   Se muestra la página de la canalización con ambos destinos, sin lanzamientos.

   

Crea una versión

Ahora que tienes una canalización de entrega con dos destinos que apuntan a dos clústeres de GKE o dos servicios de Cloud Run, puedes crear una versión para implementar tu aplicación en el primer destino.

1. Si aún no estás en la página de la canalización de entrega, en la que se muestra la nueva canalización de entrega in-console-quickstart-pipeline, navega hasta allí.

   Se muestra la visualización de la canalización, sin lanzamientos.

2. Haz clic en el botón Crear versión.

   Se muestra el diálogo Crear una versión. La mayoría de los campos ya están propagados. Conserva estos valores predeterminados.

   

   Puedes hacer clic en el botón Ver manifiesto (View manifest) para ver el manifiesto generado automáticamente, para cualquier destino, y puedes hacer clic en Ver archivo de Skaffold (View Skaffold file) si quieres ver el skaffold.yaml generado. También puedes editarlos, pero en esta guía de inicio rápido, déjalos como están.

3. De manera opcional, agrega una descripción para esta versión en el campo Descripción.

4. Haz clic en Crear para iniciar la versión.

   Se muestra la página de detalles del lanzamiento para el primer destino, y puedes ver su progreso. Tardará unos minutos en completarse. Es posible que el lanzamiento demore algunos segundos en comenzar.

5. Cuando finalice el primer lanzamiento, haz clic en el nombre de la canalización de entrega para ir a la página de la canalización de entrega.

   

   Se muestra la visualización de la canalización con el lanzamiento completo en el primer destino.

   

6. Haz clic en Ascender para iniciar el lanzamiento al siguiente objetivo.

   Se mostrará el diálogo Promote.

7. Conserva los valores predeterminados, agrega una Descripción del lanzamiento si lo deseas y, luego, haz clic en Promover.

   Debido a que seleccionamos Requerir aprobación para lanzamientos cuando creamos el segundo destino, esta promoción está pendiente de aprobación.

8. Haz clic en Revisar, en la visualización de la canalización de entrega.

   Se mostrará la página de aprobación.

   

9. Vuelve a hacer clic en Revisar y, en el diálogo de aprobación, haz clic en Aprobar.

   El lanzamiento se inicia para el segundo destino. Puedes volver a hacer clic en el nombre de la canalización de entrega para ver el progreso en la visualización de la canalización.

Cuando finaliza el segundo lanzamiento, la aplicación se implementa en el segundo destino y se completa la canalización de entrega.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página.

1. Borra los clústeres de GKE o los servicios de Cloud Run:

   GKE

   gcloud container clusters delete quickstart-cluster-for-console-staging --region=us-central1 --project=PROJECT_ID \
   && gcloud container clusters delete quickstart-cluster-for-console-prod --region=us-central1 --project=PROJECT_ID
   

   Cloud Run

   gcloud run services delete in-console-quickstart-pipeline-target-1 --region=us-central1 --project=PROJECT_ID \
   && gcloud run services delete in-console-quickstart-pipeline-target-2 --region=us-central1 --project=PROJECT_ID
   

2. En la página de la canalización de entrega, haz clic en Borrar para borrar la canalización de entrega, la versión y los lanzamientos.

   Escribe el nombre de la canalización en el campo proporcionado y haz clic en Confirmar para terminar de borrar los recursos.

   

3. Borra ambos destinos:

   gcloud deploy targets delete console-staging --region=us-central1  && \
   gcloud deploy targets delete console-prod --region=us-central1
   

4. Borra los buckets de Cloud Storage que creó Cloud Deploy.

   Uno termina en _clouddeploy y el otro es [region].deploy-artifacts.[project].appspot.com.

   Abrir la página del navegador de Cloud Storage

Eso es todo, finalizaste la guía de inicio rápido.

¿Qué sigue?

• Obtén más información sobre Cloud Deploy.

• Aprende los conceptos básicos para implementar aplicaciones.

• Prueba la explicación de Cloud Deploy.

• Obtén información para administrar tus manifiestos.

• Aprende a combinar las herramientas de CI/CD de Google Cloud para desarrollar y entregar software de manera eficaz a GKE.