Guía de inicio rápido: Automatiza

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 invocas una compilación de forma automática cuando entran eventos nuevos.

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

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 Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. Habilita la API Cloud Build.

    Habilita la API

  5. Instala e inicializa el SDK de Cloud.
  6. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  7. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  8. Habilita la API Cloud Build.

    Habilita la API

  9. Instala e inicializa el SDK de Cloud.
  10. Si aún no tienes una, crea una en GitHub.

  11. Si tienes configurada la autenticación de dos factores en GitHub, crea un token de acceso personal para usar 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 origen existente que contiene un ejemplo de Hello World en Go en tu propia cuenta de usuario de GitHub.
  1. Si aún no tienes una, crea una en GitHub.

  2. Si tienes configurada la autenticación de dos factores en GitHub, crea un token de acceso personal para usar 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 de Fork 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

Conectar Cloud Build a tu repositorio

Para compilar un 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 Google Cloud Console, 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 fuente, selecciona GitHub (App de GitHub de Cloud Build).

  5. Haz clic en Continuar.

  6. Autentica la cuenta de GitHub.

  7. En la sección Select repostory, selecciona el nombre de usuario de tu cuenta de GitHub. Si tu nombre de usuario no aparece en la lista:

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

      Verá una ventana emergente para instalar la aplicación de GitHub de Cloud Build.

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

    3. Haz clic en Solo ciertos repositorios para instalar la app de GitHub de Cloud Build en ciertos repositorios.

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

    5. Haga clic en Install.

      Es posible que debas 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, ahora 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 como tu repositorio.

  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.

En la siguiente sección, crearás un activador.

Crear un activador

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

    Abrir la página Activadores

  2. Selecciona tu proyecto en el menú desplegable del selector de proyectos 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 el nombre del activador.

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

    • Fuente: Selecciona el repositorio cloud-build-samples como la fuente 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 al archivo de configuración de Cloud Build como quickstart-automate/cloudbuild.yaml.

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

Confirmar un cambio

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

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

    cd code-examples/quickstart-automate
  2. Abre el archivo main.go y actualiza la línea que contiene "Hello, World!". a "Hola, 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 de golang de Docker Hub para compilar. y ejecutar el archivo main.go

             steps:
             - name: golang
               args: ['go', 'run', 'quickstart-automate/main.go']
        
  4. Vuelve al directorio raíz de tu 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 a tu 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 generará una compilación automática por tu activador.

Ver detalles de compilación

En esta sección, verás los detalles de la compilación asociados con tu compilación invocada después de confirmar un cambio.
  1. En el menú de navegación de Google Cloud Console, 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:

    Captura de pantalla de la página de historial de compilaciones para la automatización

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

  4. En la página Build details, haz clic en Build Artifacts.

    Verás un resultado similar al siguiente:

    Captura de pantalla de artefactos de compilación

  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 viste 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 usaste en esta página.

  1. En el menú de navegación de Google Cloud Console, 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ú Acciones (tres puntos verticales) ubicado en el extremo derecho de la fila.

  4. Selecciona Borrar.

Ya borraste el activador asociado con el repositorio clonado.

¿Qué sigue?