KRM API artifactregistry.gdc.goog/v1

artifactregistry.gdc.goog/v1

包含 Artifact Registry 群組的 API 結構定義。

BackupConfig

代表內部訊息型別，定義從這個備份方案建立備份的設定。

顯示於： - HarborInstanceBackupPlanSpec - HarborInstanceBackupSpec

欄位	說明
backupRepository 字串	BackupRepository 資源的名稱，用於識別這個 BackupPlan 資源的次要儲存空間。
backupScope BackupScope	備份的資源選取範圍。

BackupPlanState

基礎類型： string 備份方案可能處於的各種狀態。

顯示於： - HarborInstanceBackupPlanStatus

BackupRepositoryState

基礎類型： string 備份存放區可能處於的各種狀態。

出現位置： - HarborInstanceBackupRepositoryStatus

BackupScope

定義要備份的 Harbor 執行個體。

顯示位置： - BackupConfig

欄位	說明
harborInstance 字串	要備份的 Harbor 執行個體名稱 (位於相同命名空間)。

BackupState

基礎類型： string 備份可能處於的各種狀態。

顯示位置： - HarborInstanceBackupStatus

HarborInstance

代表 Harbor 容器登錄檔的例項。

出現位置： - HarborInstanceList

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstance
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec HarborInstanceSpec	Harbor 執行個體的所需狀態。
status HarborInstanceStatus	最近一次觀察到的 Harbor 執行個體狀態。

HarborInstanceBackup

定義 HarborInstance 的 Backup API 結構定義。

顯示位置： - HarborInstanceBackupList

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceBackup
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec HarborInstanceBackupSpec	備份的所需狀態。
status HarborInstanceBackupStatus	最近一次觀察到的備份狀態。

HarborInstanceBackupList

代表 Harbor 執行個體的備份集合。

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceBackupList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items HarborInstanceBackup 陣列

HarborInstanceBackupPlan

定義 HarborInstance 的 BackupPlan API 結構定義。

顯示於： - HarborInstanceBackupPlanList

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceBackupPlan
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec HarborInstanceBackupPlanSpec	備份方案的期望狀態。
status HarborInstanceBackupPlanStatus	最近一次觀察到的備份方案狀態。

HarborInstanceBackupPlanList

代表 Harbor 執行個體的備份方案集合。

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceBackupPlanList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items HarborInstanceBackupPlan 陣列

HarborInstanceBackupPlanSpec

定義備份方案的所需狀態。

適用於： - HarborInstanceBackupPlan

欄位	說明
backupSchedule 安排	根據這項備份方案排定建立備份的時間。
backupConfig BackupConfig	這項備份方案的備份設定。
retentionPolicy RetentionPolicy	根據這項方案建立的備份生命週期。
description 字串	這項備份方案的使用者指定說明字串。

HarborInstanceBackupPlanStatus

定義備份方案的觀察狀態。

適用於： - HarborInstanceBackupPlan

欄位	說明
lastBackupTime 時間	最近一次執行備份作業的時間戳記。
nextBackupTime 時間	下次排定備份作業的時間戳記。
conditions Condition 陣列	條件：- 準備就緒：備份方案的準備就緒狀態，調解內嵌物件時發生的任何錯誤都會顯示在這裡。
state BackupPlanState	備份方案的目前狀態。
reason 字串	使用者可理解的說明，指出備份方案為何處於目前狀態。

HarborInstanceBackupReference

HarborInstanceBackupReference 代表 HarborInstanceBackup 的備份參照。

顯示位置： - HarborInstanceStatus

欄位	說明
name 字串	名稱在命名空間中不得重複，用於參照 HarborInstanceBackup 資源。
namespace 字串	命名空間會定義空間，HarborInstanceBackup 名稱不得重複。

HarborInstanceBackupRepository

代表 Harbor 執行個體的備份存放區執行個體。

顯示位置： - HarborInstanceBackupRepositoryList

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceBackupRepository
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec HarborInstanceBackupRepositorySpec	備份存放區的所需狀態。
status HarborInstanceBackupRepositoryStatus	最近一次觀察到的備份存放區狀態。

HarborInstanceBackupRepositoryList

代表 Harbor 執行個體的備份存放區集合。

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceBackupRepositoryList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items HarborInstanceBackupRepository 陣列

HarborInstanceBackupRepositorySpec

定義 Harbor 備份存放區的所需狀態。

出現位置： - HarborInstanceBackupRepository

欄位	說明
secretReference SecretReference	存取 S3 bucket 的存取密鑰參考資料。私密金鑰應包含 S3 存取權授予流程中的 2 項資料：- access-key-id - access-key
endpoint 字串	用於存取 Harbor 備份存放區的端點。如果是 Google Private Cloud，這是提供租戶專案存取權的 S3 端點。
region 字串	bucket 的指定端點區域。
bucket 字串	端點內要上傳備份資料的 bucket。
description 字串	使用者為這個備份存放區指定的說明字串。

HarborInstanceBackupRepositoryStatus

定義 Harbor 備份存放區的觀察狀態。

出現位置： - HarborInstanceBackupRepository

欄位	說明
conditions Condition 陣列	條件：- 準備就緒：備份存放區的就緒狀態，調解內嵌物件時發生的任何錯誤都會顯示在這裡。
state BackupRepositoryState	備份存放區的目前狀態。
reason 字串	備份存放區處於目前狀態的原因說明 (使用者可理解)。

HarborInstanceBackupSpec

定義備份的所需狀態。

顯示於： - HarborInstanceBackup

欄位	說明
backupPlanName 字串	建立這個備份的備份方案名稱。
backupConfig BackupConfig	備份設定。這個欄位應由使用者明確設定，以進行手動自訂備份。2. 透過填入 backupPlanName，取消設定自動定期備份或手動備份。備份協調器會從備份方案取得設定。
description 字串	備份的選填字串說明。這個欄位不會影響功能。
manual boolean	指定備份資源是否為手動建立。如果為 True，表示這項備份是手動建立；如果為 False，表示這項備份是依據備份方案排程自動建立。
retainDays 整數	保留備份的天數，之後系統會自動刪除備份。這項時間是從備份的 create_time 開始計算。如果未指定這個欄位或設為 0，表示系統不會自動刪除備份。如果是根據備份排程自動建立的備份，這個欄位會指派 BackupPlan.RetentionPolicy.backup_retain_days 的值。如果是手動建立的備份，且未指定這個欄位，服務會指派 BackupPlan.RetentionPolicy.backup_retain_days 的值。預設值為 0。

HarborInstanceBackupStatus

定義備份的觀察狀態。

顯示於： - HarborInstanceBackup

欄位	說明
state BackupState	備份作業的目前狀態。
reason 字串	使用者可理解的說明，指出備份作業目前處於這種狀態的原因。
createTime 時間	建立這項備份資源的時間戳記。這項設定可轉換為 RFC 3339，反之亦然。
completeTime 時間	備份完成時間。
retainExpireTime 時間	系統自動刪除備份的時間。這是唯有輸出欄位，會根據 create_time 和 retain_days 的合併值計算，並在備份的 retain_days 欄位更新時一併更新。
totalSizeBytes 整數	備份總大小 (以位元組為單位)。
registrySizeBytes 整數	資料轉移服務處理的登錄備份總大小，以位元組為單位。
databaseSizeBytes 整數	Dbcluster 匯出作業處理的資料庫備份總大小 (以位元組為單位)。
exportSubDirectory 字串	附加至資料庫匯出位置的子目錄。還原時執行匯入作業時，系統會使用這個檔案。

HarborInstanceList

代表 Harbor 容器登錄檔執行個體集合。

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items HarborInstance 陣列

HarborInstanceProject

代表 Harbor 執行個體中的 Harbor 專案。自訂資源會建立專案必須存在的預期。命名空間是 GDCH 專案名稱，Harbor 執行個體及其 Harbor 專案都屬於該專案。

顯示位置： - HarborInstanceProjectList

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceProject
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec HarborInstanceProjectSpec
status HarborInstanceProjectStatus

HarborInstanceProjectList

包含 HarborInstanceProject 資源清單。

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceProjectList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items HarborInstanceProject 陣列

HarborInstanceProjectSpec

定義 HarborProject 物件的規格或預期狀態。

顯示於： - HarborInstanceProject

欄位	說明
projectName 字串	Harbor 專案名稱。必須符合 Harbor 的命名規則。
harborInstanceRef LocalObjectReference	Harbor 專案所屬的 Harbor 執行個體。
creatorSubject 主旨	建立 Harbor 專案的使用者或群組，以及主體，將成為第一個 Harbor 專案管理員，在 Harbor UI 中管理 Harbor 專案，並授予更多使用者存取權。目前只代表個別使用者。
autoScan boolean	專案是否會在推送時自動掃描圖片。如果未指定，則預設值為 false。

HarborInstanceProjectStatus

定義 HarborInstanceProject 物件的觀察狀態。

顯示於： - HarborInstanceProject

欄位	說明
conditions Condition 陣列	條件包括 ProjectCreated、ProjectDeleted 和 ProjectSubjectAssigned。ProjectCreated 表示在狀態為 true 或 false 的 Harbor 執行個體中建立 Harbor 專案。ProjectDeleted 表示在具有 true 或 false 狀態的 Harbor 執行個體中刪除 Harbor 專案。ProjectSubjectAssigned 表示啟動自訂資源建立作業的使用者或群組，在 Harbor 中會獲得第一個 Harbor 管理員角色，狀態為 true 或 false。

HarborInstanceRestore

定義 HarborInstance 的 Restore API 結構定義。

顯示於： - HarborInstanceRestoreList

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceRestore
metadata ObjectMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
spec HarborInstanceRestoreSpec	還原作業的所需狀態。
status HarborInstanceRestoreStatus	最近一次觀察到的還原狀態。

HarborInstanceRestoreList

代表 HaaS 執行個體的還原集合。

欄位	說明
apiVersion 字串	artifactregistry.gdc.goog/v1
kind 字串	HarborInstanceRestoreList
metadata ListMeta	如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。
items HarborInstanceRestore 陣列

HarborInstanceRestoreReference

HarborInstanceRestoreReference 代表 HarborInstanceRestore 的還原參照。

出現位置： - HarborInstanceSpec

欄位	說明
name 字串	名稱在命名空間中不得重複，用於參照 HarborInstanceRestore 資源。
namespace 字串	命名空間會定義空間，HarborInstanceRestore 名稱不得重複。

HarborInstanceRestoreSpec

定義還原作業的所需狀態。

出現位置： - HarborInstanceRestore

欄位	說明
backupName 字串	這個 Restore 資源用於還原的 Harbor 執行個體備份資源完整名稱。
description 字串	備份說明 (選填)。這不會影響功能。

HarborInstanceRestoreStatus

定義還原作業的觀察狀態。

出現位置： - HarborInstanceRestore

欄位	說明
state RestoreState	目前的還原狀態。
stateReason 字串	使用者可理解的說明，指出還原作業為何處於目前狀態。
startTime 時間	還原程序的建立時間。
completeTime 時間	還原程序的結束時間。

HarborInstanceSpec

代表 Harbor 執行個體的規格或所需狀態。

出現位置： - HarborInstance

欄位	說明
restoreRef HarborInstanceRestoreReference	這個執行個體是透過哪個還原資源還原。這個欄位會由還原對帳程序填入，且建立後即無法變更。

HarborInstanceStatus

代表 Harbor 執行個體的目前狀態。

出現位置： - HarborInstance

欄位	說明
conditions Condition 陣列	HarborInstance 的目前狀態。「Ready」狀態表示 HarborInstance 已準備就緒。
version 字串	Harbor 執行個體的版本。
url 字串	Harbor 執行個體網頁 UI 的網址。
restoreTime 時間	如果執行個體不是透過還原流程建立，還原相關狀態會是空白。還原這個執行個體的時間戳記。
restoreBackupReference HarborInstanceBackupReference	這個執行個體是從哪個備份資源還原。
errorStatus ErrorStatus	ErrorStatus 會保留最近的錯誤，並包含觀察到的時間。
timeSinceLastReady 時間	TimeSinceLastReady 會保留上次 HarborInstance 準備就緒的時間。

RestoreState

基礎類型： string

顯示於： - HarborInstanceRestoreStatus

RetentionPolicy

定義政策，決定何時自動刪除根據這項備份方案建立的備份、方案層級的最短備份保留天數，以及禁止更新任何政策的鎖定。

顯示位置： - HarborInstanceBackupPlanSpec

欄位	說明
backupRetainDays 整數	服務刪除備份的天數。如果指定了這項設定，系統會在備份建立時間 (create_time) 經過 backup_retain_days 後，自動刪除根據這項備份方案建立的備份。如果未指定，系統不會自動刪除依據這項備份方案建立的備份。更新這個欄位不會影響現有的備份。成功更新後建立的備份檔會自動沿用新值。

排程

代表定義 Cron 排程的內部訊息類型。

顯示位置： - HarborInstanceBackupPlanSpec

欄位	說明
cronSchedule 字串	執行作業的 Cron 字串排程。
paused boolean	指定排定的作業是否暫停或取消暫停。如果設為 True，系統會暫停排定的作業，且不會建立自動備份。預設值為 False。