Automatiza las compilaciones con Cloud Build

Automatiza las compilaciones con Cloud Build

En esta página, se explica cómo usar Cloud Build para automatizar las compilaciones.

Cloud Build usa activadores de compilación para habilitar las automatizaciones de CI/CD. Puedes configurar activadores para que escuchen eventos entrantes, como cuando se envía una confirmación nueva a un repositorio o cuando se inicia una solicitud de extracción, y luego invocan automáticamente una compilación cuando llegan eventos nuevos.

Crearás un activador y lo configurarás para que invoque una compilación cada vez que envíes un cambio a un repositorio de GitHub.

---

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

Guiarme

---

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 la API de Cloud Build.

   Habilita la API

5. Instala Google Cloud CLI.

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

   gcloud init

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 la API de Cloud Build.

   Habilita la API

10. Instala Google Cloud CLI.

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

    gcloud init

Si ya instalaste Google Cloud CLI, ejecuta gcloud components update para asegurarte de tener la última versión disponible.

12. Si aún no tienes una cuenta de GitHub, crea una.

13. Si tienes configurada la autenticación de dos factores en GitHub, crea un token de acceso personal para usarlo en lugar de una contraseña de GitHub con la línea de comandos.

Bifurca y clona un repositorio de GitHub de muestra

Necesitarás algún código fuente de muestra para compilar. En esta sección, clonarás un repositorio de código fuente existente que contiene un ejemplo de Hello World en Go a tu propia cuenta de usuario de GitHub.

1. Si aún no tienes una cuenta de GitHub, crea una.

2. Si tienes configurada la autenticación de dos factores en GitHub, crea un token de acceso personal para usarlo en lugar de una contraseña de GitHub con la línea de comandos.

3. Bifurca el repositorio cloud-build-samples en tu propia cuenta de GitHub:

   1. Ve al repositorio cloud-build-samples de Cloud Build.

   2. Haz clic en el ícono Fork ubicado en la esquina superior derecha de la página.

   3. Haz clic en la cuenta de usuario de GitHub en la que deseas bifurcar el repositorio.

      Se te redireccionará automáticamente a la página con la versión bifurcada del repositorio cloud-build-samples.

4. Abre una terminal en tu entorno local.

5. Clona el repositorio bifurcado mediante la ejecución del siguiente comando, en el que GITHUB_USERNAME es el nombre de usuario de tu cuenta de GitHub:

   git clone https://github.com/GITHUB_USERNAME/cloud-build-samples.git

Conecta Cloud Build a tu repositorio

Para compilar código fuente en GitHub con activadores, primero debes conectar Cloud Build a tu repositorio de GitHub. En esta sección, conectarás tu repositorio de cloud-build-samples a Cloud Build.

1. En el menú de navegación de la consola de Google Cloud, haz clic en Cloud Build > Activadores.

   Abrir la página Activadores

2. Selecciona tu proyecto y haz clic en Open.

3. Haz clic en Conectar repositorio.

4. En Seleccionar origen, selecciona GitHub (app de GitHub de Cloud Build).

5. Haz clic en Continuar.

6. Autentica la cuenta de GitHub.

7. En la sección Selecciona un repositorio, elige el nombre de usuario de tu cuenta de GitHub. Si tu nombre de usuario no aparece en la lista, haz lo siguiente:

   1. En la lista Cuenta de GitHub, haz clic en + Agregar.

      Aparecerá una ventana emergente para instalar la app de GitHub de Cloud Build.

   2. Haz clic en tu nombre de usuario de GitHub.

   3. Haz clic en Only certain repositories para instalar la app de GitHub de Cloud Build en determinados repositorios.

   4. En el menú desplegable, selecciona GITHUB_USERNAME/cloud-build-samples, allí GITHUB_USERNAME es el nombre de usuario de tu cuenta de GitHub.

   5. Haz clic en Install.

      Es posible que se te solicite ingresar la contraseña asociada a tu cuenta de GitHub antes de continuar.

   6. Después de la instalación de la app de GitHub de Cloud Build, podrás ver tu nombre de usuario en el menú desplegable del campo Cuenta de GitHub. Selecciona tu nombre de usuario.

8. En Repositorio, selecciona GITHUB_USERNAME/cloud-build-samples.

9. Haz clic en la marca de verificación para aceptar los términos y condiciones de la conexión del activador.

10. Haz clic en Conectar.

11. Haz clic en Listo.

Crearás un activador en la siguiente sección.

Crear un activador

1. Abre la página Activadores en la consola de Google Cloud:

   Abrir la página Activadores

2. Selecciona el proyecto en el menú desplegable del selector de proyectos, que se ubica en la parte superior de la página.

3. Haz clic en Abrir.

4. En la página Activadores, haz clic en Crear activador.

5. En la página Crear activador, ingresa la siguiente configuración:

   • Nombre: Ingresa hello-world-trigger como nombre del activador.

   • Evento: Selecciona Enviar a una rama como evento del repositorio para invocar el activador.

   • Fuente: Selecciona el repositorio cloud-build-samples como el origen que contiene el código fuente y el archivo de configuración de compilación.

   • Configuración de compilación: Elige Archivo de configuración de Cloud Build como archivo de configuración de compilación.

   • Ubicación del archivo de configuración de Cloud Build: Especifica la ruta del archivo de configuración de Cloud Build como quickstart-automate/cloudbuild.yaml.

6. Haz clic en Crear para guardar el activador de compilación.

Confirma un cambio

En esta sección, confirmarás un cambio en el repositorio cloud-build-samples clonado en tu propia cuenta de GitHub.

1. En tu terminal, navega al directorio quickstart-automate:

   cd cloud-build-samples/quickstart-automate

2. Abre el archivo main.go y actualiza la línea que contiene la frase "Hello, world!" por "Hello, universo!"

     package main
   
     import (
         "fmt"
     )
   
     func main() {
         fmt.Println("Hello, universe!")
     }
     

3. Revisa cloudbuild.yaml, que es el archivo de configuración de compilación que usa Cloud Build. Cuando se invoca una compilación con un activador, el paso de compilación de este archivo le indica a Cloud Build que use la imagen golang de Docker Hub para compilar y ejecutar el archivo main.go.

      steps:
      - name: golang
        script: go run quickstart-automate/main.go
      

4. Vuelve al directorio raíz del repositorio:

      cd ..

5. Ejecuta los siguientes comandos para confirmar los cambios en GitHub:

       
       git add quickstart-automate/main.go
       git commit -m "update text"
       git push

   Es posible que debas ingresar tus credenciales cuando envíes código al repositorio. Si se te solicita, ingresa tu nombre de usuario y contraseña o un token de autenticación.

Ya enviaste un cambio a tu repositorio. Tu envío hará que el activador genere una compilación automática.

Ver detalles de compilación

En esta sección, verás los detalles de compilación asociados con la compilación invocada después de confirmar un cambio.

1. En el menú de navegación de la consola de Google Cloud, haz clic en Cloud Build > Historial.

   Abrir la página de Cloud Build

2. Selecciona tu proyecto y haz clic en Open (Abrir).

   Verás la página Historial de compilación:

   

3. En la columna Compilación, haz clic en el nombre de una compilación.

4. En la página Detalles de compilación, haz clic en Artefactos de compilación.

   Verás un resultado similar al siguiente:

   

5. Para ver el registro de compilación, haz clic en el ícono de descarga y consulta el archivo descargado.

Invocaste correctamente una compilación de Cloud Build mediante un activador y visualizaste los detalles de la compilación.

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. En el menú de navegación de la consola de Google Cloud, haz clic en Cloud Build > Activadores.

   Abrir la página Activadores

2. Selecciona tu proyecto y haz clic en Open.

3. En la fila hello-world-trigger, haz clic en el menú de acciones (tres puntos verticales) ubicado en el extremo derecho de la fila.

4. Selecciona Borrar.

Ya borraste el activador asociado al repositorio clonado.

¿Qué sigue?

• Aprende a crear un archivo de configuración de compilación básico.
• Aprende a crear y administrar activadores de compilación.