調整 Artifact Registry 儲存空間大小

本頁面說明如何檢查儲存空間可用性,以及在需要更多容量時調整 Artifact Registry 儲存空間大小。

如果在升級過程中,Artifact Registry 的可用儲存空間不足,導致作業失敗,請按照下列操作說明處理。

事前準備

如要查看儲存空間可用性及調整 Artifact Registry 儲存空間大小,您必須具備必要的 Identity and Access 角色:

  • 系統構件登錄檔偵錯工具:具備所有 Harbor 資源的讀寫權限。請要求安全管理員授予您「系統構件登錄檔偵錯工具」(sar-debugger) 叢集角色。

檢查機構基礎架構叢集中的 Artifact Registry 儲存空間用量

您可以檢查機構基礎架構叢集中的 Artifact Registry 目前儲存空間用量,決定儲存空間分配的後續步驟。請按照下列步驟操作:

  1. 匯出機構基礎架構叢集 Artifact Registry 的 kubeconfig 路徑:

    export ORG_INFRA_KUBECONFIG=KUBECONFIG_FILE_PATH
    

    KUBECONFIG_FILE_PATH 替換為機構基礎架構叢集的 kubeconfig 檔案路徑。

  2. 將現有的 Artifact Registry Pod 設為環境變數:

    pod=$(kubectl --kubeconfig $ORG_INFRA_KUBECONFIG get pods -n harbor-system -l goharbor.io/operator-controller=registry -o name)
    
  3. 列印 Artifact Registry 儲存空間用量的輸出內容:

    kubectl --kubeconfig $ORG_INFRA_KUBECONFIG exec $pod -n harbor-system \
        -c registry -- df -h
    

    在輸出內容中找出已掛接的路徑 /var/lib/registry,即可查看 Artifact Registry 儲存空間用量。以下範例輸出內容顯示 Artifact Registry 儲存空間用量為 40%,且有 85 GB 的可用空間:

    Filesystem                                    Size Used Avail Use% Mounted on
    overlay                                       484G  43G  441G   9% /
    tmpfs                                          64M    0   64M   0% /dev
    tmpfs                                          24G    0   24G   0% /sys/fs/cgroup
    /dev/sda1                                     484G  43G  441G   9% /storage
    tmpfs                                          43G  12K   43G   1% /harbor_cust_cert/ca.crt
    shm                                            64M    0   64M   0% /dev/shm
    tmpfs                                          43G 4.0K   43G   1% /etc/registry/auth
    /dev/mapper/3600a09807770457a795d5452356a3345 147G  54G   85G  40% /var/lib/registry
    tmpfs                                          24G    0   24G   0% /proc/acpi
    tmpfs                                          24G    0   24G   0% /proc/scsi
    tmpfs                                          24G    0   24G   0% /sys/firmware
    

    確認Avail檔案系統的/var/lib/registry大小大於要上傳的映像檔大小。如有需要,您可以按照下一節的步驟調整儲存空間大小。

套用新的儲存空間大小

如有需要,可以調整 Artifact Registry 的儲存空間大小。 請按照下列步驟操作:

  1. 建立新的環境變數,並將其設為新的永久磁碟區聲明 (PVC) 儲存空間大小:

    STORAGE_SIZE=400G
    
  2. 將新的儲存空間大小套用至 Artifact Registry:

    kubectl --kubeconfig $ORG_INFRA_KUBECONFIG patch Persistentvolumeclaim/harbor-registry \
        -n harbor-system --type=merge \
        -p '{"spec": {"resources": {"requests": {"storage": "'$STORAGE_SIZE'"}}}}'
    
  3. 重新啟動 Artifact Registry Pod,以實作新的儲存空間大小更新:

    kubectl --kubeconfig $ORG_INFRA_KUBECONFIG rollout restart deployment \
        -n harbor-system harbor-harbor-harbor-registry
    
  4. 如要確認用量和容量增加情形,請查看 Artifact Registry