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 deGoogle Cloud .

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

   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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   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

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

4. Install the Google Cloud CLI.

5. Configure the gcloud CLI to use your federated identity.

   For more information, see Sign in to the gcloud CLI with your federated identity.

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

   gcloud init

   Si ya tienes instalada la CLI, asegúrate de ejecutar 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.

En el caso de GKE, crea dos clústeres: quickstart-cluster-for-console-staging y quickstart-cluster-for-console-prod, con la configuración predeterminada. Se debe poder acceder a los extremos de la API de Kubernetes de los clústeres a través de la red desde 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. Sin embargo, 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, ya que Cloud Deploy crea tu archivoskaffold.yamly tu 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 mostrará 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 destinos:

   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 del objetivo 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.

      Para esta guía de inicio rápido, requerimos aprobación en el segundo objetivo, 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 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 del objetivo por console-prod.

   6. Activa la casilla de verificación Require approval for rollouts para este objetivo.

      Para esta guía de inicio rápido, requerimos aprobación en el segundo objetivo, 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, que incluye ambos destinos, sin lanzamientos.

   

Crea una versión

Ahora que tienes una canalización de entrega, con dos destinos, que apunta 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, que muestra la nueva canalización de entrega in-console-quickstart-pipeline, navega a ella 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 Crear una versión. La mayoría de los campos ya están completados. Conserva 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 este 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 el lanzamiento.

   Se muestra la página de detalles del lanzamiento para el primer destino y puedes ver el progreso de este lanzamiento. Tardará unos minutos en completarse. El lanzamiento puede tardar unos segundos en comenzar.

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

   

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

   

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

   Se muestra el diálogo Promocionar.

7. Conserva 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 destino, esta promoción está esperando la aprobación.

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

   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.

   Se inicia el lanzamiento 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 finalice la segunda versión, la aplicación se implementará en el segundo destino y se completará tu canalización de entrega.

Realiza una limpieza

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 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 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 para implementar aplicaciones.

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

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