En esta página, se explica cómo usar Cloud Build para compilar, probar e implementar Go aplicaciones.
Antes de comenzar
En las instrucciones de esta página se supone que estás familiarizado con Go. Además, ten en cuenta la siguiente información:
-
Enable the Cloud Build, Cloud Run, and Artifact Registry APIs.
- Para ejecutar los comandos de
gcloud
en esta página, instala Google Cloud CLI. - Ten tu proyecto de Go a mano.
- Si quieres alojar tu app de Go en contenedores con Cloud Build,
necesitas un
Dockerfile
junto con tu código fuente. - Si deseas almacenar el contenedor compilado en Artifact Registry, crea un repositorio de Docker en Artifact Registry.
- Si deseas almacenar registros de prueba en Cloud Storage, crea un bucket en Cloud Storage.
Permisos de IAM obligatorios
Para almacenar registros de pruebas en Logging, otorga el permiso Creador de objetos de almacenamiento (
roles/storage.objectCreator
) para el bucket de Cloud Storage a tu cuenta de servicio de compilación.Para almacenar imágenes compiladas en Artifact Registry, otorga el rol Escritor de Artifact Registry Rol (
roles/artifactregistry.writer
) a la cuenta de servicio de Build.
Para obtener instrucciones sobre cómo otorgar estos roles, consulta Otorga una función mediante la página de IAM.
Configura compilaciones de Go
La imagen golang
pública de Docker Hub es compatible con la compilación mediante módulos de Go. Usar esta imagen como un paso de compilación en el archivo de configuración de Cloud Build te permite invocar comandos go
dentro de la imagen. Los argumentos que se pasan a este paso de compilación se pasan directamente a la herramienta de golang
, lo que te permite ejecutar cualquier comando de go
en esta imagen.
En esta sección, se explica un archivo de configuración de compilación de ejemplo para una app de Go. Tiene pasos de compilación para compilar la app, agregar pruebas de unidades y, una vez que se aprueban, crear contenedores e implementar la app.
Para compilar la aplicación de Go, sigue estos pasos:
En el directorio raíz de tu proyecto, crea un archivo de configuración de Cloud Build. con el nombre
cloudbuild.yaml
.Compilación y prueba: Si definiste pruebas de unidades en tu aplicación, puedes configurar Cloud Build para ejecutar las pruebas agregando lo siguiente campos en un paso de compilación:
name
: Configura el valor de este campo engolang
para usar la imagen de Golang de Docker Hub en tu tarea.entrypoint
: Establece el valor de este campo en/bin/bash
. Esto te permite para ejecutar comandos de Bash de varias líneas directamente en el paso de compilación.args
: En el campoargs
de un paso de compilación, se toma una lista de argumentos y se los pasa a la imagen a la que se hace referencia en el camponame
. En el siguiente ejemplo, el campoargs
toma los argumentos de lo siguiente:- Ejecutar el generador de registros de prueba para descargar el resultado del registro de prueba.
- Imprimir el resultado del registro.
- Guardar resultados de pruebas en
sponge.log
. - Enviar los resultados en
sponge.log
a un archivo XML JUNIT. Nombre de el archivo XML JUNIT se construye utilizando la versión corta del ID de confirmación asociado con tu compilación. Los pasos de compilación posteriores guardarán los registros de este archivo en Cloud Storage.
Crea contenedores en la app: Después de agregar el paso de compilación a fin de garantizar que las pruebas se hayan aprobado, puedes compilar la aplicación. Cloud Build proporciona una imagen de Docker compilada con anterioridad que puedes usar para organizar tu aplicación de Go en contenedores. Para organizar tu app en contenedores, agrega los siguientes campos en un paso de compilación:
name
: Establece el valor de este campo engcr.io/cloud-builders/docker
para usar la imagen de Docker compilada previamente en tu tarea.args
: Agrega los argumentos para el comandodocker build
como valores para este campo.
En el siguiente paso de compilación, se compila la imagen
myimage
y se etiqueta con la versión corta de tu ID de confirmación. El paso de compilación usa sustituciones para el ID del proyecto, el nombre del repositorio y los valores SHA cortos, por lo tanto, estos se sustituyen automáticamente en el tiempo de compilación. Ten en cuenta que necesitarás para crear o tener un repositorio de Docker en Artifact Registry existente para almacenar la imagen.Envía el contenedor a Artifact Registry: Puedes almacenar el contenedor compilado en Artifact Registry, que es un servicio de Google Cloud que puedes usar para almacenar, administrar y proteger artefactos de compilación. Para hacer esto, deberás tener un repositorio de Docker existente en Artifact Registry. Para configurar Cloud Build a fin de almacenar la imagen en un repositorio de Docker de Artifact Registry, agrega un paso de compilación con los siguientes campos:
name
: Establece el valor de este campo engcr.io/cloud-builders/docker
para usa la imagen oficial del compilador dedocker
para tu tarea.args
: Agrega los argumentos para el comandodocker push
como valores de este campo. Para la URL de destino, ingresa el repositorio de Docker de Artifact Registry en el que deseas almacenar la imagen.
En el siguiente paso de compilación, se envía la imagen que compilaste en el paso anterior a Artifact Registry:
Implementa el contenedor en Cloud Run: Para implementar la imagen en Cloud Run, agrega un paso de compilación con los siguientes campos:
name
: Establece el valor de este campo engoogle/cloud-sdk
para usar gcloud CLI. para invocar el comandogcloud
y, luego, implementar la imagen en Cloud Run.args
: Agrega los argumentos para el comandogcloud run deploy
como los valores de este campo.
En el siguiente paso de compilación, se implementa la imagen compilada con anterioridad en Cloud Run:
Guardar registros de prueba en Cloud Storage: Puedes configurar Cloud Build para almacenar cualquier registro de prueba en Cloud Storage si especificas una ubicación de bucket existente y una ruta de acceso a los registros de prueba.
En el siguiente paso de compilación, se almacenan los registros de prueba que guardaste en el archivo XML JUNIT en un bucket de Cloud Storage:
En el siguiente fragmento, se muestra el archivo de configuración de compilación completo de todos los pasos descritos anteriormente:
Inicia la compilación con gcloud CLI o activadores de compilación. Debes especificar el nombre del repositorio de Artifact Registry cuando inicies la compilar.
Para especificar el repositorio de Artifact Registry cuando inicias la compilación con con gcloud CLI:
gcloud builds submit --region=us-west2 --config=cloudbuild.yaml \ --substitutions=_REPO_NAME="REPO_NAME"
Reemplaza
REPO_NAME
por el nombre de tu Artifact Registry. en un repositorio de confianza.Para especificar el repositorio de Artifact Registry cuando compilas con activadores de compilación, haz lo siguiente: especifica el nombre de tu repositorio de Artifact Registry en la Substitution variables cuando la creación del activador de compilación.
¿Qué sigue?
- Obtén información para realizar implementaciones azul-verde en Compute Engine.
- Obtén más información sobre cómo compilar imágenes de contenedores.
- Obtén más información para solucionar errores de compilación.