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 registros de compilación

Puedes configurar Cloud Build para almacenar registros de compilación en Cloud Logging o Cloud Storage si incluyes el 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 tu archivo de configuración de compilación, establece el valor de logging como CLOUD_LOGGING_ONLY:

    Plantilla de

    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 con 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 registros de compilación almacenados en el bucket de Cloud Storage creado por Google, pero no puedes realizar ningún otro cambio. 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 a la cuenta de servicio especificada por el usuario:

  • 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 usas una cuenta de servicio especificada por el usuario, otorga la función Administrador de almacenamiento a la cuenta de servicio. Si deseas obtener instrucciones para 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 Agregar.

    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. Haz clic en Guardar.

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

    Plantilla de

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

    JSON

        {
          "steps": [
           {
             "name": "gcr.io/cloud-builders/docker",
             "args": [
               "build",
               "-t",
               "gcr.io/myproject/myimage",
               "."
             ]
           }
           ],
           "logsBucket": "gs://mylogsbucket",
           "options": {
             "logging": "GCS_ONLY"
           }
        }
    
  3. Usa el archivo de configuración de compilación para iniciar una compilación con 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 visualizador 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 del correo electrónico del principal y haz clic en el ícono de lápiz.

    4. Selecciona la función Logging > Visor de registros.

    5. Haz clic en Guardar.

  • Si tus registros de compilación están en el depósito 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 del 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 se encuentran 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 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 del 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. Haz clic en Guardar.

Para ver los registros de compilación en Cloud Build, haz lo siguiente:

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 Abrir.

  3. En el menú desplegable Región, selecciona la región de la compilación.

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

  5. 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

  6. Si tus registros se almacenan en Logging, en el panel Registro de compilación, haz clic en el ícono para ver los registros en el Explorador de registros.

    Captura de pantalla de los registros de compilación en el Explorador de registros

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

Para ver los registros de compilación en GitHub y GitHub Enterprise, haz lo siguiente:

Si creas un activador de GitHub o GitHub Enterprise y especificas --include-logs-with-status como opción, puedes ver los registros de compilación en GitHub y GitHub Enterprise.

Para ver los registros de compilación en GitHub y GitHub Enterprise, sigue estos pasos:

  1. Navega al repositorio asociado a tu activador.

  2. Navega a tu lista de confirmaciones.

  3. Ubica la fila de la confirmación de la que deseas ver los registros de compilación.

  4. Haz clic en el ícono de resultado en la fila de tu confirmación.

    Verás una lista de verificaciones asociadas a tu confirmación.

  5. Haz clic en Detalles en la fila para la que quieras ver los registros de compilación.

    Verá la página Resumen asociada con su confirmación. Si creaste un activador con la marca --include-logs-with-status, verás los registros de compilación en la sección Detalles de la página.

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?