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

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

En esta página, se muestra cómo usar la Google Cloud consola de 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 Google Cloud consola.

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

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

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

Antes de comenzar

Accede a tu Google Cloud cuenta de. 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.
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
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud init
Nota: Puedes ejecutar gcloud CLI en la Google Cloud consola de sin instalar Google Cloud CLI. Para ejecutar el gcloud CLI en la Google Cloud consola, usa Cloud Shell.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

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

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 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 en función de la configuración especificada en uno o más archivos YAML. Sin embargo, también puedes crear una canalización de entrega con la Google Cloud consola de.

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

1. En la Google Cloud consola de, 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 Pipeline name, reemplaza el texto predeterminado por in-console-quickstart-pipeline.

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

5. En el menú desplegable Region, 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 New target, en el campo Target name, reemplaza el texto predeterminado por console-staging.

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

   3. Haz clic en Listo.

   4. Haz clic en Agregar destino.

      Reemplaza el texto predeterminado de Target name por console-prod.

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

   6. Selecciona Require approval for rollouts.

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

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

      

   Cloud Run

   1. En New target, en el campo Target name, reemplaza el texto predeterminado por console-staging.

   2. En el menú desplegable Region, selecciona us-central1.

   3. Haz clic en Listo.

   4. Haz clic en Agregar destino.

   5. Reemplaza el texto predeterminado de Target name por console-prod.

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

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

   7. Haz clic en Create 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 Grant 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 muestra 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 hasta allí ahora.

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

2. Haz clic en el botón Create release.

   Se muestra el diálogo Crear una versión. La mayoría de los campos se propagan previamente. Conserva estos valores predeterminados.

   

   Puedes hacer clic en el botón View manifest para ver el manifiesto generado automáticamente, para cualquiera de los destinos, y puedes hacer clic en View Skaffold file 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 Description.

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

   Se muestra la página de detalles del lanzamiento para el lanzamiento al primer destino, y puedes observar el progreso de este lanzamiento. Tardará unos minutos en completarse. Es posible que el lanzamiento tarde unos segundos en iniciarse.

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 de la canalización de entrega.

   

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

   

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

   Se muestra el diálogo Promote.

7. Conserva los valores predeterminados, agrega una Rollout description si lo deseas y, luego, haz clic en Promote.

   Como seleccionamos Require approval for rollouts cuando creamos el segundo destino, esta promoción está esperando aprobación.

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

   Se muestra la página de aprobación.

   

9. Haz clic en Review de nuevo y, en el diálogo de aprobación, haz clic en Approve.

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

Cuando finalice el segundo lanzamiento, la aplicación se implementará en el segundo destino y se completará la canalización de entrega.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu Google Cloud cuenta de 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 Delete 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 Confirm 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 de la implementación de 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 a GKE.