3.4. oc-mirror 플러그인 v1에서 v2로 마이그레이션

프로세스

1. API 버전을 수정하고 ImageSetConfiguration 에서 더 이상 사용되지 않는 필드를 제거합니다.

   oc-mirror 플러그인 v1 구성을 사용한 ImageSetConfiguration 파일 예시

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   mirror:
     platform:
       channels:
         - name: stable-4.17
       graph: true
     helm:
       repositories:
         - name: sbo
           url: https://redhat-developer.github.io/service-binding-operator-helm-chart/
     additionalImages:
       - name: registry.redhat.io/ubi8/ubi:latest
       - name: quay.io/openshifttest/hello-openshift@sha256:example_hash
     operators:
       - catalog: oci:///test/redhat-operator-index
         packages:
           - name: aws-load-balancer-operator
   storageConfig:  # REMOVE this field in v2
     local:
       path: /var/lib/oc-mirror

   Copy to Clipboard Toggle word wrap

   oc-mirror 플러그인 v2 구성을 사용한 ImageSetConfiguration 파일 예시

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v2alpha1
   mirror:
     platform:
       channels:
         - name: stable-4.17
       graph: true
     helm:
       repositories:
         - name: sbo
           url: https://redhat-developer.github.io/service-binding-operator-helm-chart/
     additionalImages:
       - name: registry.redhat.io/ubi8/ubi:latest
       - name: quay.io/openshifttest/hello-openshift@sha256:example_hash
     operators:
       - catalog: oci:///test/redhat-operator-index
         packages:
           - name: aws-load-balancer-operator

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 작업 디렉토리 내의 cluster-resources 디렉토리에서 IDMS, ITMS, CatalogSource 및 ClusterCatalog 리소스를 확인하세요.

   $ ls <v2_workspace>/working-dir/cluster-resources/

   Copy to Clipboard Toggle word wrap

3. 마이그레이션이 완료되면 미러링된 이미지와 카탈로그를 사용할 수 있는지 확인하세요.

   • 미러링 중에 오류 또는 경고가 발생하지 않았는지 확인합니다.
   • 오류 파일이 생성되지 않았는지 확인하세요( working-dir/logs/mirroring_errors_YYYYMMdd_HHmmss.txt ).

4. 다음 명령을 사용하여 미러링된 이미지와 카탈로그를 사용할 수 있는지 확인하세요.

   $ oc get catalogsource -n openshift-marketplace

   Copy to Clipboard Toggle word wrap

   $ oc get imagedigestmirrorset,imagetagmirrorset

   Copy to Clipboard Toggle word wrap

   자세한 내용은 "oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치에 대한 이미지 미러링"을 참조하세요.

5. 선택 사항: oc-mirror 플러그인 v1을 사용하여 미러링된 이미지를 제거합니다.

   1. oc-mirror 플러그인 v1을 사용하여 이미지를 미러링합니다.

   2. ImageSetConfiguration 파일에서v1alpha2 (v1)에서 v2alpha1 (v2)으로 API 버전을 업데이트한 다음 다음 명령을 실행합니다.

      $ oc-mirror -c isc.yaml file://some-dir --v2

      Copy to Clipboard Toggle word wrap
      참고

      StorageConfig 는 ImageSetConfiguration 및 DeleteImageSetConfiguration 파일의 유효한 필드가 아닙니다. oc-mirror 플러그인 v2로 업데이트할 때 이 필드를 제거합니다.

   3. 다음 명령을 실행하여 삭제 매니페스트를 생성하고 v1 이미지를 삭제합니다.

      $ oc-mirror delete --config=delete-isc.yaml --generate --delete-v1-images --workspace file://some-dir docker://registry.example:5000  --v2

      Copy to Clipboard Toggle word wrap
      중요

      oc-mirror 플러그인 v2는 oc-mirror 플러그인 v1과 달리 대상 레지스트리를 자동으로 정리하지 않습니다. 더 이상 필요하지 않은 이미지를 정리하려면 --delete-v1-images 명령 플래그와 함께 v2의 삭제 기능을 사용하세요.

      oc-mirror 플러그인 v1로 미러링된 모든 이미지가 제거되면 더 이상 이 플래그를 사용할 필요가 없습니다. oc-mirror 플러그인 v2로 미러링된 이미지를 삭제해야 하는 경우 --delete-v1-images를 설정하지 마세요.

      이미지 삭제에 대한 자세한 내용은 "연결이 끊긴 환경에서 이미지 삭제"를 참조하세요.

   4. 다음 명령을 실행하여 생성된 매니페스트를 기반으로 이미지를 삭제합니다.

      $ oc-mirror delete --delete-yaml-file some-dir/working-dir/delete/delete-images.yaml docker://registry.example:5000 --v2

      Copy to Clipboard Toggle word wrap