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 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 laGoogle Cloud consola.

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 implementa automáticamente en el destino.

4. Consulta los resultados en la Google Cloud consola.

Antes de comenzar

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.
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
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.
Enable the APIs
Install the Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a 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 sin instalar Google Cloud CLI. Para ejecutar gcloud CLI en la consola de Google Cloud , usa Cloud Shell.

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

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.

Enable the APIs

Install the Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a 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 sin instalar Google Cloud CLI. Para ejecutar gcloud CLI en la consola de Google Cloud , usa Cloud Shell.

Si ya instalaste la CLI, asegúrate de ejecutar la versión más reciente:

gcloud components update

Crea tu entorno de ejecución

Si implementas 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 Google Cloud console, no necesitas crear ningún archivo YAML. 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. 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 destino, 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 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 destino, 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 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 y ningún lanzamiento.

   

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 cuadro de 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, luego, 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 el lanzamiento.

   Se muestra la página de detalles del lanzamiento para el primer objetivo, 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 su página.

   

   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 de la versión 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. En la visualización de la canalización de entrega, haz clic en Revisar.

   Se muestra 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 inició 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.



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

• Prueba la explicación de Cloud Deploy.

• 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.