Guía de inicio rápido: Automatizar

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 IC/EC. Puedes configurar activadores para escuchar 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, invoca automáticamente una compilación cuando entran nuevos eventos.

Crearás un activador y configurarás ese activador 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 proyecto

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita la API Cloud Build.

    Habilita la API

  5. Instala e inicializa el SDK de Cloud.
  6. Si aún no tienes una, crea una en GitHub.
  7. 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.

Prepara los archivos fuente

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 con tu propia cuenta de usuario de GitHub.

  1. Dirígete al repositorio cloud-build-samples de Cloud Build.

  2. Bifurcar el repositorio cloud-build-samples en tu propia cuenta de GitHub

    1. Haz clic en el ícono de Fork en la esquina superior derecha de la página.
    2. Haz clic en la cuenta de usuario de GitHub en la que deseas bifurcar el repositorio.

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

  3. Clona el repositorio en tu máquina local; para ello, ejecuta el siguiente comando en tu terminal, 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
    
  4. Navega al directorio quickstart-automate.

     cd cloud-build-samples/quickstart-automate
    

    Verás los siguientes archivos que contienen el código fuente para tu ejemplo de Hello World:

    • main.go: Una aplicación de Go de muestra que imprime Hello, world!

       package main
      
       import (
           "fmt"
       )
      
       func main() {
           fmt.Println("Hello, world!")
       }
      
    • cloudbuild.yaml: Es el archivo de configuración de compilación que usa Cloud Build para realizar acciones especificadas como pasos de compilación. El paso de compilación que se usa en este archivo indica a Cloud Build que use la imagen golang de Docker Hub para compilar y ejecutar el archivo main.go.

       steps:
       - name: golang
         args: ['go', 'run', 'quickstart-automate/main.go']
      

Conecta tu repositorio

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

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

    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. Haga clic en Continuar.

  6. Autentica tu cuenta de GitHub.

  7. En la sección Seleccionar repositorio, haz clic en Agregar para ingresar el nombre de usuario de tu cuenta de GitHub.

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

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

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

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

  11. Haga clic en Install.

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

  12. Después de la instalación de la aplicación 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.

  13. En Repositorio, selecciona GITHUB_USERNAME/cloud-build-samples como tu repositorio.

  14. Haz clic en la marca de verificación para aceptar los Términos y Condiciones de la conexión activador.

  15. Haz clic en Conectar.

  16. Haga clic en Listo.

    Creará un activador en la siguiente sección.

Crear un activador

En esta sección, crearás un activador.

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

    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. Haz clic en Crear activador.

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

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

    2. Evento: Selecciona Enviar a una rama como el evento de repositorio para invocar el activador.

    3. Fuente: selecciona el repositorio cloud-build-samples como fuente, que contiene tu código fuente y tu archivo de configuración de compilación.

    4. Configuración de la compilación: Elige el archivo de configuración de Cloud Build como el archivo de configuración de compilación.

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

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

Cómo confirmar un cambio

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

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

      cd code-examaples/quickstart-automate
    
  2. Abre el archivo main.go en tu terminal.

  3. Actualiza la línea que contiene "Hello, world!"". por "Hello, Unicode"

      package main
    
      import (
          "fmt"
      )
    
      func main() {
          fmt.Println("Hello, universe!")
      }
    
  4. Navega al directorio raíz de tu repositorio:

    cd ..
    
  5. Confirma tus cambios en GitHub mediante la ejecución del siguiente comando:

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

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

Envió un cambio a su repositorio. El envío generará una compilación automática por el activador.

Ver detalles de compilación

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

  1. Abre la página de Cloud Build en Google Cloud Console.

    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 Historial de compilación para automatizar

  3. Haz clic en una compilación en particular.

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

  4. Para ver los artefactos de la compilación, en Resumen de la compilación, haz clic en Artefactos de compilación.

    Verás un resultado similar al siguiente:

    Captura de pantalla de artefactos de compilación

    Puedes descargar tu registro de compilación desde esta página.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

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

    Abrir la página Activadores de compilación

  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. Ubica la fila con el activador que deseas borrar.

  5. Haz clic en el menú (puntos suspensivos verticales) que se ubica en el extremo derecho de la fila.

  6. Selecciona Borrar.

Ya borraste el activador asociado con tu repositorio clonado.

¿Qué sigue?