建構記錄儲存空間選項

執行建構作業時,Cloud Build 會收集建構記錄,並儲存在記錄檔 bucket。根據建構設定檔設定,建構記錄會儲存在 Cloud Logging bucket、Cloud Storage bucket 或這兩個位置。您也可以設定包含記錄檔的 Logging 或 Cloud Storage bucket 類型。bucket 的位置和類型會影響您分析建構記錄的能力,以及您對 bucket 設定的控制程度。

總覽

設定建構設定檔時,請考量下列事項:

  • 如要控管已儲存建構記錄的保留期限,請將記錄傳送至 Logging。相較於 Cloud Storage,Logging 的記錄檢視器也提供更多選項,可在 bucket 中搜尋特定建構作業記錄。不過,使用 Logging 時,建構記錄產生後,可能要過一段時間才會傳送至 Logging。

  • 如要縮短建構記錄生成到可在 Cloud Storage 中使用的延遲時間,請將建構記錄傳送至 Cloud Storage 中的 bucket。

bucket 的擁有權也會影響您與儲存建構記錄的互動方式。舉例來說,使用者擁有的 bucket 可讓您調整 bucket 設定,而 Cloud de Confiance擁有的 bucket 則是由 Cloud de Confiance建立,使用者無法變更。Logging 和 Cloud Storage 提供多種選項,可設定接收建構記錄檔的值區類型。

值區位置

在建構設定檔中設定 logging 欄位,決定建構記錄的傳送位置:

  • GCS_ONLY:建構記錄會傳送至 Cloud Storage bucket。
  • CLOUD_LOGGING_ONLY:建構作業記錄會傳送至 Logging bucket。
  • LEGACY:建構作業記錄會傳送至這兩個位置的 bucket。如果未定義 logging,Cloud Build 會使用這個值。
  • NONE:不儲存建構作業記錄。

如果您將建構記錄傳送至 Logging,請參閱「Cloud Logging 轉送設定」,瞭解 Logging bucket 選項。如果您將建構記錄傳送至 Cloud Storage,請參閱下列章節,瞭解可用的 Cloud Storage bucket。「值區擁有權考量事項」一節說明值區擁有權的優點和考量事項,無論值區位置為何。

Cloud Storage 的 bucket 選項

如果建構記錄傳送至 Cloud Storage,Cloud Build 會評估建構設定檔中的 logsBucket 和 defaultLogsBucketBehavior 欄位,判斷接收建構記錄的 Cloud Storage bucket 類型。

logsBucket 欄位可包含任何類型的值區。如果定義了 logsBucket,無論 defaultLogsBucketBehavior 值為何,記錄一律會傳送至 Cloud Storage 中的該 bucket。如果未定義 logsBucket,則會使用 defaultLogsBucketBehavior 的值,如下所示:

  • REGIONAL_USER_OWNED_BUCKET:建構記錄會傳送至 Cloud Storage 中由 Cloud Build 建立且由使用者擁有的 bucket。這個 bucket 位於使用者的專案中,且與建構作業位於相同區域。
  • LEGACY_BUCKET:建構記錄會傳送至 Cloud Build 建立且由 Cloud de Confiance擁有的 bucket,該 bucket 位於 Cloud de Confiance擁有的專案中。
  • 無值:建構記錄會傳送至 Cloud Build 建立且由使用者擁有的 Cloud Storage bucket。這個 bucket 位於使用者的專案中,且與建構作業位於相同區域。如果無法建立這個 bucket,建構記錄會傳送至Cloud de Confiance擁有的專案中,由 Cloud Build 建立且由 Cloud de Confiance擁有的 bucket。

使用 Dockerfile 建構時的記錄儲存空間

如要在透過 Dockerfile 建構時設定建構記錄儲存空間,請在執行 gcloud builds submit 時加入其中一個 default-buckets-behavior 旗標值:

  • regional-user-owned-bucket:建構記錄會傳送至 Cloud Storage 中由 Cloud Build 建立且由使用者擁有的 bucket。這個 bucket 位於使用者的專案中,且與建構作業位於相同區域。
  • legacy-bucket:建構記錄會傳送至 Cloud Build 建立且由 Cloud de Confiance擁有的 bucket,該 bucket 位於 Cloud de Confiance擁有的專案中。這個值與未定義此欄位相同。

值區擁有權注意事項

無論您使用 Cloud Storage 還是 Logging,建議您將建構記錄傳送至使用者擁有的 bucket。這可以是使用者建立的值區 (例如,如果您將 logsBucket 設為您建立的值區),也可以是 Cloud Build 建立但由使用者擁有的值區 (例如,如果您為區域性使用者擁有的值區進行設定)。這樣一來,您就能隨時編輯 bucket 的特定屬性,並查看 bucket 中的記錄。由於 Cloud de Confiance擁有的 bucket 位於Cloud de Confiance擁有的專案中,因此無法查看或編輯這些 bucket,且只能在「Build details」(建構作業詳細資料) 頁面的「Build log」(建構作業記錄) 區段中查看建構作業記錄。

一般來說,使用者建立的 bucket 在建立期間和建立後,都能提供最大的 bucket 設定彈性。不過,在這種情況下,您必須確保使用者建立的值區符合建構需求。在某些情況下 (例如管理 bucket 區域),使用 Cloud Build 建立且由使用者擁有的 bucket,可讓您將建構記錄傳送至 Cloud Storage 預設提供的 bucket,且一律與建構作業位於相同區域。以下各節將進一步說明這個用途:

Bucket 區域的注意事項

建議您設定建構 bucket,使其與建構作業的區域一致,這項設定可能有助於遵守資料落地規定。如要以這種方式調整區域,請考量下列事項:

  • 使用者在 Logging 和 Cloud Storage 中建立的 bucket,會使用建立時定義的區域。如果您將使用者建立的值區設為建構作業的 logging 值,請確認該值區的區域與建構作業區域相符。

  • 如果您將建構記錄設為使用 Cloud Storage 中區域性使用者擁有的 bucket,建構記錄一律會傳送至與建構作業位於相同區域的 bucket。

  • Cloud de Confiance擁有的 bucket 會設為 Cloud de Confiance定義的區域。因此,這個區域不一定會與建構作業的區域一致。

將 defaultLogsBucketBehavior 新增至現有建構設定檔

如果您要將 defaultLogsBucketBehavior 選項新增至先前已設定 logging 或 logsBucket 的現有建構設定檔,建議您評估所有記錄儲存設定,確保記錄會按照預期方式儲存。如果符合下列任一情況,Cloud Build 會忽略 defaultLogsBucketBehavior:

  • logging 設為 CLOUD_LOGGING_ONLY 或 NONE。
  • logging 設為 GCS_ONLY 或 LEGACY,且已定義 logsBucket。

如果您執行建構作業,但建構設定檔中未定義記錄儲存空間欄位,Cloud Build 會將 logging 設為 LEGACY。

後續步驟