Opciones de almacenamiento de registros de compilación

Cuando ejecutas compilaciones, Cloud Build recopila y almacena tus registros de compilación en un bucket de registros. Según la configuración del archivo de configuración de compilación, los registros de compilación se almacenan en buckets de Cloud Logging, buckets de Cloud Storage o en ambas ubicaciones. También puedes configurar el tipo de bucket de Logging o Cloud Storage que contiene tus registros. La ubicación y el tipo de tu bucket afectan tu capacidad para analizar los registros de compilación y la cantidad de control que tienes sobre la configuración del bucket.

Descripción general

Cuando configures tu archivo de configuración de compilación, ten en cuenta lo siguiente:

  • Si deseas controlar el período de retención de los registros de compilación almacenados, envíalos a Logging. El Visor de registros en Logging también proporciona más opciones para buscar registros de compilación específicos en un bucket en comparación con Cloud Storage. Sin embargo, cuando usas Logging, puede haber un retraso entre el momento en que se genera un registro de compilación y el momento en que Logging lo recibe.

  • Si deseas reducir la latencia entre el momento en que se genera un registro de compilación y el momento en que está disponible en Cloud Storage, envía tus registros de compilación a un bucket en Cloud Storage.

La propiedad de tu bucket también afecta la forma en que puedes interactuar con los registros de compilación almacenados. Por ejemplo, un bucket de propiedad del usuario te permite establecer su configuración, mientras que los buckets de propiedad de Cloud de Confiancelos crea Cloud de Confiance y los usuarios no pueden modificarlos. Logging y Cloud Storage tienen varias opciones para configurar el tipo de bucket que recibe tus registros de compilación.

Ubicaciones de buckets

Configura el campo logging en tu archivo de configuración de compilación para determinar dónde se envían los registros de compilación:

  • GCS_ONLY: Los registros de compilación se envían a los buckets de Cloud Storage.
  • CLOUD_LOGGING_ONLY: Los registros de compilación se envían a los buckets de Logging.
  • LEGACY: Los registros de compilación se envían a los buckets de ambas ubicaciones. Si logging no está definido, Cloud Build usa este valor.
  • NONE: No se almacenan los registros de compilación.

Si envías tus registros de compilación a Logging, consulta Configuración de enrutamiento de Cloud Logging para obtener información sobre las opciones de bucket de Logging. Si envías tus registros de compilación a Cloud Storage, consulta la siguiente sección para obtener información sobre los buckets de Cloud Storage disponibles. En la sección Consideraciones sobre la propiedad de bucket buckets, se describen los beneficios y las consideraciones de los buckets según bucket propiedad, independientemente de bucket ubicación.

Opciones de buckets en Cloud Storage

Si tus registros de compilación se envían a Cloud Storage, Cloud Build evalúa los campos logsBucket y defaultLogsBucketBehavior en tu archivo de configuración de compilación para determinar el tipo de bucket de Cloud Storage que recibe los registros de compilación.

El campo logsBucket puede tener cualquier tipo de bucket. Si se define logsBucket, los registros siempre se envían a ese bucket en Cloud Storage, sin importar el valor de defaultLogsBucketBehavior. Si logsBucket no está definido, el valor de defaultLogsBucketBehavior se usa de la siguiente manera:

  • REGIONAL_USER_OWNED_BUCKET: Los registros de compilación se envían al bucket creado por Cloud Build y propiedad del usuario en Cloud Storage. Este bucket se encuentra en el proyecto del usuario y usa la misma región que la compilación.
  • LEGACY_BUCKET: Los registros de compilación se envían al bucket creado por Cloud Build y propiedad de Cloud de Confianceen un proyecto propiedad de Cloud de Confiance.
  • Sin valor: Los registros de compilación se envían a un bucket creado por Cloud Build y propiedad del usuario en Cloud Storage. Este bucket se encuentra en el proyecto del usuario y usa la misma región que la compilación. Si no se puede crear este bucket, los registros de compilación se envían a un bucket creado por Cloud Build y propiedad deCloud de Confianceen un proyecto propiedad de Cloud de Confiance.

Almacenamiento de registros cuando se compila desde Dockerfiles

Para configurar el almacenamiento de registros de compilación cuando compilas desde un Dockerfile, incluye uno de los valores de la marca default-buckets-behavior cuando ejecutes gcloud builds submit:

  • regional-user-owned-bucket: Los registros de compilación se envían al bucket creado por Cloud Build y propiedad del usuario en Cloud Storage. Este bucket se encuentra en el proyecto del usuario y usa la misma región que la compilación.
  • legacy-bucket: Los registros de compilación se envían al bucket creado por Cloud Build y propiedad de Cloud de Confianceen un proyecto propiedad de Cloud de Confiance. Este valor es el mismo que dejar este campo sin definir.

Consideraciones sobre la propiedad de bucket

Independientemente de si usas Cloud Storage o Logging, te recomendamos que envíes tus registros de compilación a un bucket que sea propiedad del usuario. Puede ser un bucket creado por el usuario (por ejemplo, si configuras logsBucket en un bucket que creaste) o un bucket creado por Cloud Build, pero que pertenece al usuario (por ejemplo, si estableciste la configuración de un bucket regional que pertenece al usuario). De esta manera, puedes editar ciertas propiedades de tu bucket y ver los registros en el bucket en cualquier momento. Debido a que los buckets que pertenecen a Cloud de Confiancese encuentran en proyectos que pertenecen aCloud de Confiance, sus buckets no se pueden ver ni editar, y sus registros de compilación solo se pueden ver en la sección Registro de compilación de tu página Detalles de la compilación.

En general, los buckets creados por el usuario proporcionan la mayor flexibilidad en términos de configuración de los parámetros del bucket durante y después de su creación. Sin embargo, en este caso, siempre debes asegurarte de que el bucket creado por el usuario se alinee con las necesidades de tu compilación. En algunos casos, como cuando se administran regiones de buckets, usar un bucket creado por Cloud Build y de propiedad del usuario te permite enviar registros de compilación a un bucket que está disponible en Cloud Storage de forma predeterminada y siempre en la misma región que tu compilación. En la siguiente sección, se proporciona más información sobre este caso de uso:

Consideraciones para las regiones de bucket

Te recomendamos que configures tu bucket de compilación para que se alinee con la región de tu compilación, ya que esta configuración puede ayudarte a cumplir con los requisitos de residencia de datos. Si deseas alinear tus regiones de esta manera, ten en cuenta lo siguiente:

  • Los buckets creados por el usuario en Logging y Cloud Storage usan la región definida durante la creación del bucket. Si configuras un bucket creado por el usuario como el valor logging de tu compilación, asegúrate de que su región coincida con la de tu compilación.

  • Si configuraste tu registro de compilación para usar buckets regionales de propiedad del usuario en Cloud Storage, tus registros de compilación siempre se enviarán a un bucket en la misma región que tu compilación.

  • Los buckets que pertenecen aCloud de Confiancese configuran en una región definida por Cloud de Confiance. Por lo tanto, es posible que esta región no siempre coincida con la región de tu compilación.

Agrega defaultLogsBucketBehavior a los archivos de configuración de compilación existentes

Si agregas la opción defaultLogsBucketBehavior a un archivo de configuración de compilación existente en el que ya configuraste logging o logsBucket, te recomendamos que evalúes todos los parámetros de configuración de almacenamiento de registros para asegurarte de que se almacenen como se espera. Cloud Build ignora defaultLogsBucketBehavior si se cumple alguna de las siguientes condiciones:

  • logging se establece en CLOUD_LOGGING_ONLY o NONE.
  • logging se establece en GCS_ONLY o LEGACY, y se define logsBucket.

Si ejecutas una compilación sin campos de almacenamiento de registros definidos en tu archivo de configuración de compilación, Cloud Build establece logging en LEGACY.

¿Qué sigue?