Ejecuta compilaciones con la app de GitHub

Cloud Build proporciona una App de GitHub de Google Cloud Build, que compila tu código de forma automática cada vez que creas una rama o código de envío nuevo para GitHub. En este instructivo, se explica cómo instalar y configurar la app y usarla para compilar tu código en GitHub.

Objetivos

En este instructivo, podrás realizar estas acciones:

  • Preparar un repositorio de GitHub con algún código fuente para compilar
  • Instalar y configurar la app de GitHub de Google Cloud Build
  • Realizar cambios en tu código fuente en GitHub y crear una solicitud de extracción para los cambios
  • Observar que la app de Google Cloud Build compile tu código a la hora de crear una solicitud de extracción
  • Ver los resultados de la compilación en GitHub y GCP Console
  • Aprender sobre las distintas formas de configurar tus compilaciones

Costos

En este instructivo, se usan los componentes facturables siguientes de Cloud Platform:

  • Cloud Build

    Los primeros 120 minutos de compilación por día son gratis; se te cobrará por las compilaciones consumidas por encima de este límite. Para obtener más información, consulta la calculadora de precios.

  • Container Registry

    Si compilas con un Dockerfile y almacenas la imagen compilada en Container Registry, se te cobrará por el almacenamiento y la salida de red que consumen tus imágenes de Docker. Para obtener más información, consulta la página Precios de Container Registry.

Antes de comenzar

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. Select or create a Google Cloud Platform project.

    Go to the Manage resources page

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

    Descubre cómo puedes habilitar la facturación

  4. Crea una cuenta de GitHub si aún no la tienes.

Prepara un repositorio de GitHub con archivos fuente

A fin de usar la app de Google Cloud Build, tu repositorio debe contener un Dockerfile o un archivo cloudbuild.yaml para configurar tu compilación.

El Dockerfile es el archivo de configuración para compilar los contenedores Docker. Si usas la app para compilaciones de Docker, es suficiente si tu repositorio contiene un Dockerfile. El ejemplo de este instructivo está configurado con un Dockerfile.

cloudbuild.yaml es el archivo de configuración para Cloud Build. Usa un cloudbuild.yaml en las situaciones siguientes:

  • Si deseas regular tus compilaciones de Docker, puedes proporcionar un cloudbuild.yaml, además del Dockerfile. Si tu repositorio contiene un Dockerfile y un cloudbuild.yaml, la app de Google Cloud Build usará el cloudbuild.yaml para configurar las compilaciones.

  • Si deseas usar la app de Google Cloud Build para compilaciones que no son de Docker.

Para obtener instrucciones sobre cómo crear un cloudbuild.yaml, lee la Descripción general de la configuración de compilación y Crea un archivo de configuración de compilación básico.

A modo de trabajar con el ejemplo de este instructivo, necesitas un repositorio de GitHub de muestra con algún código fuente para compilar. Sigue estos pasos para bifurcar un repositorio que contiene los archivos fuente usados en este instructivo. Entre los archivos fuente en el repositorio, se incluyen un archivo helloworld.sh y un Dockerfile que usarás para compilar la imagen de Docker.

  1. En GitHub, navega hasta /GoogleCloudBuild/gcbapp-dockerfile-example.

  2. En la esquina derecha superior de la página, haz clic en Fork (Bifurcación).

    Captura de pantalla del botón de bifurcación

    Ahora tienes una copia del repositorio gcbapp-dockerfile-example con archivos fuente.

Instala la app de Google Cloud Build

En esta sección, instalarás la app de Google Cloud Build y configurarás una integración continua para gcbapp-dockerfile-example.

Durante la instalación y el proceso de configuración, se te pedirá, primero, que autorices a la app de Google Cloud Build a conectarse a Google Cloud Platform. Luego de la autorización, se te redirecciona a GCP Console, donde seleccionarás tu proyecto de GCP y la cuenta de facturación. Después, se te redireccionará de nuevo a GitHub.

En los pasos siguientes, se te proporcionan instrucciones de instalación de la app solo para el repositorio gcbapp-dockerfile-example. Sin embargo, puedes elegir instalar la app para más repositorios o todos.

  1. Dirígete a la página de la app de GitHub para obtener la app de Google Cloud Build.

    Ir a la página de la app de Cloud Build

  2. Haz clic en Install (Instalar).

  3. Selecciona el nombre de usuario o tu organización.

  4. Selecciona Only select repositories (Solo seleccionar repositorios) y, luego, ingresa gcbapp-dockerfile-example.

  5. Haz clic en Install (Instalar).

    Se mostrará la página de autorización, en la que se te pide que autorices a la app de Google Cloud Build para que se conecte a Google Cloud Platform.

    Captura de pantalla del botón autorizar

  6. Haz clic en Autorizar a Google Cloud Build a través de GoogleCloudBuild.

    Se te redireccionará a GCP Console.

  7. En Create or select a project (Crear o seleccionar un proyecto), selecciona Select an existing project (Seleccionar un proyecto existente) y haz clic en Next (Siguiente).

  8. Selecciona tu proyecto de GCP y haz clic en Siguiente.

    Aparecerá un cuadro de diálogo que pide tu consentimiento para conectar tu app de Google Cloud Build a Google Cloud Platform.

  9. Marca la opción I consent to Google storing my GitHub App installation information and transferring my content from GitHub to Google in order to provide the connected service. (Acepto que Google almacene la información de instalación de mi app de GitHub y que transfiera mis contenidos desde GitHub a Google para proporcionar el servicio conectado) y haz clic en Connect (Conectar).

    GCP asociará tu proyecto de GCP con GitHub y te redireccionará de nuevo a GitHub. Aparecerá la página de la app de Google Cloud Build.

¡Ya instalaste la app de Google Cloud Build!

Compila con la app de Google Cloud Build

Los archivos fuente en gcbapp-dockerfile-example consisten de un archivo simple helloworld.sh y un Dockerfile. En esta sección, realizarás cambios al código en helloworld.sh y crearás una solicitud de extracción para verificar en tus cambios.

La app de Google Cloud Build compila tu código cuando creas o modificas una rama. Debido a que comenzar una solicitud de extracción lleva a la creación de una rama nueva o a la modificación de una rama existente, tu código se compila cada vez que inicias una solicitud de extracción nueva.

  1. Abre helloworld.sh en gcbapp-dockerfile-example:

    https://github.com/[GITHUB_USERNAME]/gcbapp-dockerfile-example/blob/master/helloworld.sh
    
  2. Haz clic en el ícono de lápiz para editar el archivo.

    Captura de pantalla del botón editar archivo

  3. Agrega la línea siguiente al final del archivo:

    echo "The time is $(date)."
    
  4. Selecciona Create a new branch for this commit and start a pull request. (Crear una rama nueva para esta confirmación y comenzar una solicitud de extracción) y haz clic en Propose file change (Proponer cambio de archivo).

  5. Haz clic en Create pull request (Crear solicitud de extracción).

    Esto le da inicio a Cloud Build para compilar tu código.

  6. Dirígete a la pestaña Checks (Verificaciones).

    Captura de pantalla de la pestaña verificaciones

    Verás que Cloud Build compiló tus cambios y deberías poder ver que se completó tu compilación de forma correcta. También verás otros detalles de compilación como el tiempo que demoró en compilar tu código, el ID de compilación, etcétera.

  7. Haz clic en View more details on Google Cloud Build (Ver más detalles en Google Cloud Build).

    Se abre la página Build details (Detalles de compilación) en GCP Console, en la que puedes ver información de la compilación como el estado, registros y pasos de la compilación.

  8. Dirígete a la pestaña GitHub en tu navegador y, luego, a la pestaña Conversation (Conversación).

    Captura de pantalla de la pestaña conversación

  9. Haz clic en Merge pull request (Combinar solicitud de extracción) y, luego, en Confirm merge (Confirmar combinación).

    Listo. Ya verificaste que tu código cambia de compilación de forma correcta y registraste tus cambios.

Ejemplos adicionales

Aquí hay algunos repositorios de muestra que contienen ejemplos de código que usan cloudbuild.yaml como el archivo de configuración. Puedes bifurcar los repositorios y usar los pasos descritos en este instructivo para compilar el código:

Limpieza

Después de terminar el instructivo {{builder_name_short}}, puedes limpiar los recursos que creaste en Google Cloud Platform así no se factura por estos en el futuro. En la sección siguiente, se describe cómo borrar o desactivar estos recursos.

Desinstala la app de Google Cloud Build

  1. Dirígete a la página de la app de GitHub para Google Cloud Build.

    Ir a la página de la app de Cloud Build

  2. Haz clic en Configurar.

  3. Selecciona tu nombre de usuario o la organización en la que instalaste la app.

  4. Haz clic en Desinstalar.

Borra el repositorio de GitHub

  1. En GitHub, navega hacia la página principal del repositorio.

    https://github.com/[GITHUB_USERNAME]/gcbapp-dockerfile-example
    
  2. En el nombre de tu repositorio, haz clic en Configuración.

  3. En Zona de peligro, haz clic en Borrar este repositorio.

  4. Ingresa el nombre de tu repositorio para confirmar y, luego, haz clic en Entiendo las consecuencias, borrar este repositorio.

Borra las imágenes del contenedor

  1. Abre la página de Container Registry en Google Cloud Platform Console.

    Abrir la página de Container Registry

  2. Selecciona tu proyecto y haz clic en Abrir.

  3. Abre gcbapp-dockerfile-example.

  4. Selecciona todas las imágenes y haz clic en Borrar.

Las imágenes que creaste como parte de este instructivo se borran de tu proyecto.

Borra el proyecto

La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.

Para borrar el proyecto, haz lo siguiente:

  1. In the GCP Console, go to the Projects page.

    Go to the Projects page

  2. In the project list, select the project you want to delete and click Delete .
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

Pasos siguientes

  • Prueba otras características de Google Cloud Platform por tu cuenta. Revisa nuestros instructivos.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Cloud Build