Compila y prueba aplicaciones de Go

En esta página, se explica cómo usar Cloud Build para compilar y probar tus aplicaciones en Go, subir tus artefactos a Artifact Registry, generar información de procedencia y guardar tus registros de prueba en Cloud Storage.

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:

Crea una cuenta de servicio personalizada de Cloud Build

Ejecuta el siguiente comando en Google Cloud CLI para crear una cuenta de servicio personalizada de Cloud Build:

  gcloud iam service-accounts create cloud-build-go \
  --description="Build and test Go applications" \
  --display-name="Cloud Build Go" \
  --project="PROJECT_NAME"

Usarás esta cuenta de servicio para compilar y probar tu aplicación de Go.

Configura los permisos de IAM

Para configurar tu nueva cuenta de servicio con los permisos necesarios para compilar y también implementar aplicaciones de Go, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Cloud Build Permisos:

    Ir a Permisos

  2. Ve al menú Cuenta de servicio y selecciona tu cuenta de servicio de cloud-build-go.

  3. Establece el estado de los siguientes roles como Habilitado:

    • Administrador de Cloud Run (roles/run.admin): Permite que Cloud Build implemente servicios nuevos en Cloud Run.
    • Administrador de almacenamiento (roles/storage.admin): Permite leer y escribir desde Cloud Storage.
    • Escritor de Artifact Registry (roles/artifactregistry.writer): Permite extraer imágenes de Artifact Registry y escribir en él.
    • Escritor de registros (roles/logging.logWriter): Permite escribir entradas de registro en Cloud Logging.
    • Editor de Cloud Build (roles/cloudbuild.builds.editor): Permite que tu cuenta de servicio ejecute compilaciones.

Configura compilaciones de Go

La imagen golang de Docker Hub pública admite la compilación con 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 muestra cómo crear un archivo de configuración de compilación de ejemplo para una app en Go desde el repositorio de Git cloud-build-samples. El archivo de configuración de compilación tiene pasos para compilar la app, agregar pruebas de unidades y, después de que se aprueben las pruebas, implementar la app.

Para compilar la aplicación de Go de ejemplo, haz lo siguiente:

  1. Configura pruebas de unidades: Si definiste pruebas de unidades en tu aplicación, puedes configurar Cloud Build para que ejecute las pruebas. Para ello, agrega los siguientes campos en un paso de compilación:

    • name: Configura el valor de este campo en golang para usar la imagen de Go desde Docker Hub para tu tarea.
    • entrypoint: Establece el valor de este campo en /bin/bash. Esto te permite ejecutar comandos de Bash de varias líneas directamente desde el paso de compilación.

    • args: En el campo args 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 campo name. En el siguiente ejemplo, el campo args toma los argumentos para 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.

      • Se generan los resultados en sponge.log en un archivo XML JUNIT. El nombre del archivo XML de JUNIT se construye con 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.

        steps:
  # Run tests and save to file
  - name: golang:1.23
    entrypoint: /bin/bash
    args:
      - -c
      - |
        go install github.com/jstemmer/go-junit-report/v2@latest
        2>&1 go test -timeout 1m -v ./... | /go/bin/go-junit-report -set-exit-code -iocopy -out ${SHORT_SHA}_test_log.xml

  2. Sube a Artifact Registry: En tu archivo de configuración, usa el campo goModules para especificar la ruta de acceso a tu aplicación y tu repositorio de Go en Artifact Registry:

    # Upload Go module to artifact registry
artifacts:
  goModules:
    - repositoryName: 'repositoryName'
      repositoryLocation: 'location'
      repositoryProjectId: 'projectId'
      sourcePath: 'sourcePath'
      modulePath: 'appPath'
      moduleVersion: 'version'

    Reemplaza los siguientes valores:

    • repositoryName: Es el nombre de tu repositorio de Go en Artifact Registry.
    • location: Es la ubicación de tu repositorio en Artifact Registry.
    • projectId: Es el ID del proyecto Google Cloud que contiene tu repositorio de Artifact Registry.
    • sourcePath: Es la ruta de acceso al archivo go.mod en el espacio de trabajo de la compilación.
    • appPath: Es la ruta de acceso a tu aplicación empaquetada.
    • version: Es el número de versión de tu aplicación, con el formato de números y puntos, como v1.0.1.

  3. Opcional: Habilita la generación de procedencia

    Cloud Build puede generar metadatos de procedencia de compilación verificables de Supply chain Levels for Software Artifacts (SLSA) para proteger tu canalización de integración continua.

    Para habilitar la generación de procedencia, agrega requestedVerifyOption: VERIFIED a la sección options de tu archivo de configuración.

    Una vez que se complete la compilación, podrás ver los detalles del repositorio en Artifact Registry.

    También puedes ver los metadatos de procedencia de la compilación y validar la procedencia.

  4. 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:

    # Save test logs to Google Cloud Storage
artifacts:
  objects:
    location: gs://$_BUCKET_NAME/
    paths:
      - ${SHORT_SHA}_test_log.xml

    En el siguiente fragmento, se muestra el archivo de configuración de compilación completo para los pasos anteriores:

      steps:
    # Run tests and save to file
    - name: golang:1.23
      entrypoint: /bin/bash
      args:
        - -c
        - |
          go install github.com/jstemmer/go-junit-report/v2@latest
          2>&1 go test -timeout 1m -v ./... | /go/bin/go-junit-report -set-exit-code -iocopy -out ${SHORT_SHA}_test_log.xml

  # Store golang modules in Google Artifact Registry
  artifacts:
    goModules:
      - repositoryName: 'repositoryName'
        repositoryLocation: 'location'
        repositoryProjectId: 'projectId'
        sourcePath: 'sourcePath'
        modulePath: 'appPath'
        moduleVersion: 'version'

  5. Inicia la compilación con la CLI de gcloud o crea un activador de compilación:

Google Cloud CLI 

 gcloud builds submit --region=us-west2 --config=cloudbuild.yaml \
     --substitutions=_AR_REPO_NAME="AR_REPO_NAME"

Activadores de compilación

Sigue los pasos en Crea un activador de compilación. En el campo Variables de sustitución, también debes proporcionar el nombre de tu repositorio de Artifact Registry y el nombre de tu bucket de Cloud Storage para los registros de prueba.

¿Qué sigue?