Artifact Registry ストレージのサイズを変更する

このページでは、ストレージの可用性を確認する方法と、容量が不足している場合に Artifact Registry ストレージのサイズを変更する方法について説明します。

アップグレード プロセス中に Artifact Registry の空き容量が不足し、オペレーションが失敗した場合は、次の手順に沿って操作します。

始める前に

ストレージの可用性を確認して Artifact Registry ストレージのサイズを変更するには、必要な ID とアクセスロールが必要です。

  • システム Artifact Registry デバッガ: すべての 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
    

    /var/lib/registry ファイル システムの Avail サイズが、アップロードするイメージ ファイルのサイズよりも大きいことを確認します。必要に応じて、次のセクションの手順に沿ってこのストレージのサイズを変更できます。

新しいストレージ サイズを適用する

必要に応じて、Artifact Registry のストレージのサイズを変更できます。次の手順を行います。

  1. 新しい環境変数を作成し、新しい PersistentVolumeClaim(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 を確認して、使用量と容量の増加を確認します。