Almacenar y visualizar registros de compilación

Cuando ejecutas compilaciones, Cloud Build recopila y almacena tus registros de compilación en un depósito de Cloud Storage creado por Google. Sin embargo, puedes elegir almacenar los registros en tu propio depósito de Cloud Storage. Según dónde se almacenen los registros de compilación, es posible que los usuarios requieran permisos de IAM diferentes para verlos.

En esta página, se explica cómo almacenar los registros de compilación y otorgar los permisos adecuados a los usuarios para ver los registros de compilación.

Almacena registros de compilación

Usa el campo logsBucket en tu archivo de configuración de Cloud Build para especificar un depósito de Cloud Storage en el que deseas almacenar los registros de compilación. Si no configuras este campo, Cloud Build usará el depósito predeterminado de Cloud Storage para almacenar tus registros de compilación.

Para especificar un depósito de Cloud Storage a fin de almacenar registros de compilación sigue estos pasos:

  1. En el proyecto de Cloud, crea un depósito de Cloud Storage para almacenar los registros de compilación.

  2. [Opcional, si tu depósito de Cloud Storage y Cloud Build están en diferentes proyectos de Cloud]. Otorga la función de Administrador de almacenamiento a la cuenta de servicio de Cloud Build de la siguiente manera:

    1. Abrir la página de IAM

      Abrir la página IAM

    2. Selecciona el proyecto en el que ejecutas compilaciones con Cloud Build.

    3. En la tabla de permisos, ubica la dirección de correo electrónico que termina en @cloudbuild.gserviceaccount.com y anotala. Esta es tu cuenta de servicio de Cloud Build.

    4. Abre la página de IAM en el proyecto donde se encuentra tu depósito de Cloud Storage:

      Abrir la página IAM

    5. Haga clic en Add.

    6. Ingresa la dirección de correo electrónico de la cuenta de servicio de Cloud Build.

    7. Selecciona Cloud Storage > Administrador de almacenamiento.

    8. Haga clic en Save.

  3. En tu archivo de configuración de Cloud Build, agrega un campo logsBucket que apunte al depósito de Cloud Storage que creaste para almacenar registros de compilación. El siguiente ejemplo de archivo de configuración de compilación contiene instrucciones para compilar una imagen de contenedor y almacenar los registros de compilación en un depósito llamado mylogsbucket:

    YAML

        steps:
        - name: 'gcr.io/cloud-builders/docker'
          args: [ 'build', '-t', 'gcr.io/myproject/myimage', '.' ]
        logsBucket: 'gs://mylogsbucket'
    

    JSON

        {
          "steps": [
           {
             "name": "gcr.io/cloud-builders/docker",
             "args": [
               "build",
               "-t",
               "gcr.io/myproject/myimage",
               "."
             ]
           }
           ],
           "logsBucket": "gs://mylogsbucket"
        }
    
  4. Usa el archivo de configuración de compilación para iniciar una compilación de forma manual o automatizar compilaciones mediante activadores.

Cuando se completa la compilación, Cloud Build almacena los registros en el depósito de Cloud Storage que especificaste en el archivo de configuración de compilación.

Ver registros de compilación

Los permisos de IAM que necesitas para ver los registros de compilación dependen de si tus registros se encuentran en el depósito predeterminado de Cloud Storage o en un depósito especificado por el usuario.

Si tus registros de compilación están en el depósito predeterminado de Cloud Storage, otorga la función de Lector del proyecto en el proyecto en el que la compilación está configurada para los miembros que quieran Ver registros de compilación:

  1. Abrir la página de IAM

    Abrir la página IAM

  2. Selecciona tu proyecto y haz clic en Open.

  3. En la tabla de permisos, busca el ID de correo electrónico del miembro y haz clic en el ícono de lápiz.

  4. Selecciona la función Proyecto Visualizador.

  5. Haga clic en Save.

Si tus registros de compilación están en un depósito de Cloud Storage especificado por el usuario, otorga la función Storage Object Viewer a los miembros que deseen ver registros de compilación:

  1. Abrir la página de IAM

    Abrir la página IAM

  2. Selecciona tu proyecto y haz clic en Open.

  3. En la tabla de permisos, busca el ID de correo electrónico del miembro y haz clic en el ícono de lápiz.

  4. Selecciona la función Cloud Storage > Visualizador de objetos de almacenamiento.

  5. Haga clic en Save.

Para ver los registros de compilación realiza los siguientes pasos:

Console

  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.

  3. En la página Historial de compilación, haz clic en una compilación específica.

  4. En la página Compilar detalles, en Pasos, haz clic en Compilar resumen para ver los registros de compilación de toda tu compilación o haz clic en un paso de compilación para ver registros de compilación para ese paso.

    Captura de pantalla de los registros de compilación en la página Detalles de compilación

gcloud

Ejecuta el comando gcloud builds log, en el que build-id es el ID de la compilación para la que deseas obtener registros de compilación. El ID de compilación se muestra al final del proceso de envío de compilación cuando ejecutas gcloud builds submit o en la columna de ID cuando ejecutas gcloud builds list.

gcloud builds log build-id

Qué sigue