Almacenar y administrar registros de compilación

Cuando ejecutas compilaciones, Cloud Build recopila y almacena los registros de compilación. En esta página, se explica cómo almacenar, ver y borrar registros de compilación.

Elige dónde almacenar los registros de compilación

Puedes configurar Cloud Build para almacenar registros de compilación en Cloud Logging o en Cloud Storage mediante la inclusión del campo logging en el archivo de configuración de Cloud Build. , Si no especificas un campo logging en el archivo de configuración de compilación, Cloud Build almacena los registros de compilación en Logging y Cloud Storage.

En los siguientes pasos, se almacenan registros de compilación solo en Logging:

  1. En el archivo de configuración de compilación, configura el valor de loggingMode como CLOUD_LOGGING_ONLY:

    YAML

    steps:
    - name: 'gcr.io/cloud-builders/docker'
      args: ['build', '-t', 'gcr.io/myproject/myimage', '.']
    options:
      logging: CLOUD_LOGGING_ONLY
    

    JSON

    {
      "steps": [
      {
        "name": "gcr.io/cloud-builders/docker",
        "args": [
          "build",
          "-t",
          "gcr.io/myproject/myimage",
          "."
        ]
      }
      ],
      "options": {
        "logging": "CLOUD_LOGGING_ONLY"
      }
    }
    
  2. Usa el archivo de configuración de compilación para iniciar una compilación mediante la línea de comandos, la API o los activadores.

Almacena registros de compilación en el bucket predeterminado creado por Google

De forma predeterminada, Cloud Build almacena tus registros de compilación en un bucket de Cloud Storage creado por Google. Puedes ver los registros de compilación almacenados en el bucket de Cloud Storage creado por Google, pero no puedes hacerle otros cambios. Si necesitas control total sobre tu bucket de registros, almacena los registros en un bucket de Cloud Storage creado por el usuario.

Almacena registros de compilación en un bucket creado por el usuario

Permisos de IAM:

Para almacenar registros de compilación en tu propio bucket de Cloud Storage, primero debes otorgar los permisos de IAM necesarios a la cuenta de servicio de Cloud Build o al servicio especificado por el usuario cuenta:

  • Si tu bucket de Cloud Storage y Cloud Build están en el mismo proyecto de Cloud y usas la cuenta de servicio de Cloud Build, tu cuenta de servicio de Cloud Build tiene los permisos de IAM necesarios de forma predeterminada. No es necesario otorgar permisos adicionales.

  • Si tu bucket de Cloud Storage y Cloud Build están en el mismo proyecto de Cloud y estás usando uncuenta de servicio especificada por el usuario , otorgue elAdministrador de almacenamiento a la cuenta de servicio. Para obtener instrucciones sobre cómo otorgar una función a una cuenta de servicio, consulta Otorga funciones en el proyecto.

  • Si tu depósito de Cloud Storage y Cloud Build están en proyectos diferentes de Cloud, otorga la función administrador de almacenamiento a la cuenta de servicio de Cloud Build:

    1. Abrir la página de IAM

      Abrir la página IAM

    2. Selecciona el proyecto en el que ejecutas las 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 anótala. Esta es tu cuenta de servicio de Cloud Build.

    4. Abre la página de IAM en el proyecto en el que se encuentra tu bucket 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.

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

  1. En tu proyecto de Cloud, crea un bucket de Cloud Storage para almacenar tus registros de compilación.

  2. En tu archivo de configuración de compilación, agrega un campo logsBucket que apunte al bucket de Cloud Storage que creaste para almacenar los registros de compilación. En el siguiente archivo de configuración de compilación de ejemplo, se incluyen instrucciones para compilar una imagen de contenedor y almacenar los registros de compilación en un bucket 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"
        }
    
  3. Usa el archivo de configuración de compilación para iniciar una compilación mediante la línea de comandos, la API o los activadores.

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

Visualiza registros de compilación

Permisos de IAM:

  • Si tus registros de compilación están en Logging, otorga la función Visor de registros en el proyecto en el que la compilación está configurada para los principales que desean ver los 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 principal y haz clic en el ícono de lápiz.

    4. Seleccione Logging > función de Visor de registros.

    5. Haz clic en Guardar.

  • Si tus registros de compilación están en el bucket predeterminado de Cloud Storage creado por Google, otorga la función Visualizador del proyecto en el proyecto en el que la compilación está configurada para los principales. que desean ver los 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 principal y haz clic en el ícono de lápiz.

    4. Selecciona la función Proyecto Visualizador.

    5. Haz clic en Guardar.

    Si tus registros de compilación están en un bucket de Cloud Storage especificado por el usuario, otorga la función de Visualizador de objetos de almacenamiento a las principales que quieran ver los 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 principal 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 de 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 la compilación cuando ejecutas gcloud builds submit o en la columna de ID cuando ejecutas gcloud builds list.

gcloud builds log build-id

Borra registros de compilación

No puedes borrar los registros de compilación en el bucket de registros creado por Google.

Para borrar registros de compilación en un bucket de registros creado por el usuario, haz lo siguiente:

  1. Otorga la función administrador de objetos de almacenamiento al usuario o a la cuenta de servicio que borra los registros.

  2. Borra los registros de compilación con las instrucciones para borrar objetos de Cloud Storage en Borra objetos.

Para borrar el bucket de registros creado por el usuario, haz lo siguiente:

  1. Otorga la función administrador de almacenamiento al usuario o a la cuenta de servicio que borra el depósito de registros.

  2. Borra el bucket de registros con las instrucciones para borrar un bucket en Borra buckets.

¿Qué sigue?