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

Crea una canalización y una versión 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 publicación.

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

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

Antes de comenzar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

Si ya tienes instalada la CLI, asegúrate de que estás 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 a la red desde la Internet pública. Los clústeres de GKE tienen acceso externo 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 publicación y objetivos basados en la configuración especificada en uno o más archivos YAML. Sin embargo, también puedes crear una canalización de publicación 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 es necesario que crees ningún archivo YAML. Cloud Deploy crea tu skaffold.yaml y 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. Haga clic en Crear.

   

   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 objetivo, 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 de Nombre de destino por console-prod.

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

   6. Selecciona Requiere aprobación para los lanzamientos.

      En esta guía de inicio rápido, requerimos la aprobación del segundo objetivo, pero no del primero.

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

      

   Cloud Run

   1. En Nuevo objetivo, en el campo Nombre del objetivo, 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 de Nombre de destino por console-prod.

   6. Activa la casilla de verificación Requiere aprobación para los lanzamientos para este objetivo.

      En esta guía de inicio rápido, requerimos la aprobación del segundo objetivo, pero no del primero.

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

      

   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, en la que se muestran ambos objetivos, 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 canalización de publicación, que muestra la nueva canalización de publicación in-console-quickstart-pipeline, navega allí ahora.

   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 Create a release. La mayoría de los campos están prepropagados. Mantén estos valores predeterminados.

   

   Puedes hacer clic en el botón Ver manifiesto para ver el manifiesto generado automáticamente para cualquiera de los destinos, y puedes hacer clic en Ver archivo de Skaffold para ver el skaffold.yaml generado. También puedes editarlos, pero para esta guía de inicio rápido, déjalos como están.

3. De forma 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 lanzamiento al primer objetivo, y puedes observar el progreso de este lanzamiento. Tardará unos minutos en completarse. Es posible que el lanzamiento tarde unos 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 objetivo.

   

6. Haz clic en Promocionar para comenzar el lanzamiento al siguiente destino.

   Se muestra el diálogo Promocionar.

7. Mantén los valores predeterminados, agrega una descripción del lanzamiento si lo deseas y, luego, haz clic en Promocionar.

   Como seleccionamos Solicitar aprobación para lanzamientos cuando creamos el segundo objetivo, esta promoción está esperando aprobación.

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

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

   

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

   Se inicia el lanzamiento para el segundo objetivo. Puedes volver a hacer clic en el nombre de la canalización de publicación 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 objetivo y se completa la canalización de publicación.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste 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 objetivos:

   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 con _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 de la implementación de 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 forma eficaz a GKE.