Artifact Registry 스토리지 크기 조정

이 페이지에서는 스토리지 가용성을 확인하고 용량이 더 필요한 경우 Artifact Registry 스토리지를 크기 조절하는 방법을 설명합니다.

업그레이드 프로세스 중에 Artifact Registry에 여유 저장공간이 부족하여 작업이 실패하는 경우 다음 안내를 따르세요.

시작하기 전에

스토리지 가용성을 확인하고 Artifact Registry 스토리지를 크기 조절하려면 필요한 ID 및 액세스 역할이 있어야 합니다.

  • 시스템 아티팩트 레지스트리 디버거: 모든 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=$(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% 이고 여유 공간이 85G임을 보여줍니다.

    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. 새 환경 변수를 만들고 새 영구 볼륨 클레임 (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 포드를 다시 시작하여 새 스토리지 크기 업데이트를 구현합니다.

    kubectl --kubeconfig $ORG_INFRA_KUBECONFIG rollout restart deployment \
    -n harbor-system harbor-harbor-harbor-registry

  4. Artifact Registry를 확인하여 사용량과 용량 증가를 확인합니다.