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의 새로운 워크플로우에 맞게 변경되었습니다.

    • 디스크로 미러링하려면 다음 명령을 실행하세요. 

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

    • 디스크-투-미러링의 경우 다음 명령을 실행합니다. 

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

    • 미러 투 미러의 경우 다음 명령을 실행합니다. 

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

      --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

  • 작업 공간 및 디렉토리 명명: 버전 간 전환 시 잠재적인 데이터 불일치를 방지하기 위해 새로운 oc-mirror v2 규칙을 따릅니다.

    • oc-mirror 플러그인 v1 oc-mirror-workspace 디렉토리는 더 이상 필요하지 않습니다.
    • 충돌을 피하기 위해 oc-mirror 플러그인 v2에 대한 새 디렉토리를 사용하세요.

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

    중요

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

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

    • 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