Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

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

oc-mirror v2 플러그인으로 인해 이미지 미러링 워크플로에 대한 주요 변경 사항이 추가되었습니다. 이 가이드에서는 oc-mirror 플러그인 v2과의 호환성을 보장하면서 마이그레이션에 대한 단계별 지침을 제공합니다.

중요

API 버전을 수정하고 더 이상 사용되지 않는 필드를 제거하여 구성을 수동으로 업데이트해야 합니다. 자세한 내용은 "oc-mirror 플러그인 v1에서 v2로 변경"을 참조하십시오.

6.1. oc-mirror 플러그인 v1에서 v2로 변경
링크 복사

oc-mirror 플러그인 v1에서 v2로 마이그레이션하기 전에 oc-mirror 플러그인 v1과 v2 간의 다음 차이점을 참조하십시오.

  • 명시적 버전 선택: oc-mirror 를 사용할 때 사용자가 --v2 를 명시적으로 지정해야 합니다. 버전을 지정하지 않으면 v1이 기본적으로 실행됩니다. 이 동작은 향후 릴리스에서 변경될 것으로 예상됩니다. 여기서 --v2 는 기본값입니다.

  • 업데이트된 명령: oc-mirror 플러그인 v2의 새 워크플로우에 맞게 워크플로우 미러링 명령이 변경되었습니다.

    • mirror-to-disk의 경우 다음 명령을 실행합니다. 

      $ oc-mirror --config isc.yaml file://<directory_name> --v2
      Copy to Clipboard Toggle word wrap

    • disk-to-mirror의 경우 다음 명령을 실행합니다. 

      $ oc-mirror --config isc.yaml --from file://<directory_name> docker://<remote_registry> --v2
      Copy to Clipboard Toggle word wrap

    • mirror-to-mirror의 경우 다음 명령을 실행합니다. 

      $ oc-mirror --config isc.yaml --workspace file://<directory_name> docker://<remote_registry> --v2
      Copy to Clipboard Toggle word wrap
      참고

      mirror-to-mirror 작업에 --workspace 가 필요합니다.

  • API 버전 업데이트: ImageSetConfiguration API 버전이 v1alpha2 (v1)에서 v2alpha1 (v2)으로 변경됩니다. 마이그레이션 전에 구성 파일을 수동으로 업데이트해야 합니다.

  • 구성 변경:

    • storageConfig 는 oc-mirror 플러그인 v2에서 제거해야 합니다.
    • 증분 미러링은 이제 작업 디렉터리 또는 로컬 캐시를 통해 자동으로 처리됩니다.

  • 결과 디렉터리: 연결이 끊긴 클러스터에 적용할 모든 사용자 정의 리소스는 마이그레이션 후 < workspace_path>/working-dir/cluster-resources 디렉터리에 생성됩니다.

    • oc-mirror 플러그인 v2의 출력은 oc-mirror 플러그인 v1과 동일한 위치에 저장되지 않습니다.

    • 다음 리소스의 작업 디렉터리에서 cluster-resources 폴더를 확인해야 합니다.

      • ImageDigestMirrorSet (IDMS)
      • ImageTagMirrorSet (ITMS)
      • CatalogSource
      • ClusterCatalog
      • UpdateService

  • Workspace 및 디렉터리 이름 지정: 새 oc-mirror v2 규칙을 따르어 버전 간에 전환할 때 잠재적인 데이터 불일치를 방지합니다.

    • oc-mirror 플러그인 v1 oc-mirror-workspace 디렉터리가 더 이상 필요하지 않습니다.
    • 충돌을 방지하려면 oc-mirror 플러그인 v2에 새 디렉터리를 사용합니다.

  • ICSP( ImageContentSourcePolicy ) 리소스를 IDMS/ITMS로 교체:

    중요

    모든 ICSP( ImageContentSourcePolicy ) 리소스를 삭제하면 oc-mirror와 관련이 없는 구성이 제거될 수 있습니다.

    의도하지 않은 삭제를 방지하려면 제거하기 전에 oc-mirror에서 생성한 ICSP 리소스를 식별합니다. 확실하지 않은 경우 클러스터 관리자에게 확인하십시오. 자세한 내용은 "oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치의 이미지 미러링"을 참조하십시오.

    • oc-mirror 플러그인 v2에서 ICSP 리소스는 ImageDigestMirrorSet (IDMS) 및 ImageTagMirrorSet (ITMS) 리소스로 교체됩니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat