6.2. oc-mirror 플러그인 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

   참고

   oc-mirror 플러그인 v1에서 v2로 마이그레이션하는 경우 additionalImages 아래에 나열된 모든 이미지에 대해 명시적 레지스트리 호스트 이름을 사용해야 합니다. 그렇지 않으면 이미지가 잘못된 대상 경로로 미러링됩니다.

2. 다음 명령을 실행하여 IDMS, ITMS, CatalogSource, ClusterCatalog 리소스에 대한 작업 디렉터리 내부의 cluster-resources 디렉터리를 확인합니다.

   $ 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