5.4. 미러 레지스트리로 이미지 세트 미러링


미러 레지스트리로 이미지를 미러링하면 안전하고 제어된 환경에서 필요한 이미지를 사용할 수 있으므로 더 원활한 배포, 업데이트 및 유지 관리 작업을 수행할 수 있습니다.

5.4.1. 이미지 세트 구성 빌드

oc-mirror 플러그인 v2는 이미지 세트 구성을 입력 파일로 사용하여 미러링에 필요한 이미지를 결정합니다.

ImageSetConfiguration 입력 파일의 예

kind: ImageSetConfiguration
apiVersion: mirror.openshift.io/v2alpha1
mirror:
  platform:
    channels: 
1

    - name: stable-4.13
      minVersion: 4.13.10
      maxVersion: 4.13.10
    graph: true  
2

  operators:
    - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.15 
3

      packages:     
4

       - name: aws-load-balancer-operator
       - name: 3scale-operator
       - name: node-observability-operator
  additionalImages: 
5

   - name: registry.redhat.io/ubi8/ubi:latest
   - name: registry.redhat.io/ubi9/ubi@sha256:20f695d2a91352d4eaa25107535126727b5945bff38ed36a3e59590f495046f0

1
채널을 설정하여 OpenShift Container Platform 이미지를 검색합니다.
2
graph: true 를 추가하여 graph-data 이미지를 빌드 및 미러 레지스트리로 내보냅니다. OSUS(OpenShift Update Service)를 생성하려면 graph-data 이미지가 필요합니다. graph: true 필드에서도 UpdateService 사용자 정의 리소스 매니페스트를 생성합니다. oc CLI(명령줄 인터페이스)는 UpdateService 사용자 정의 리소스 매니페스트를 사용하여 OSUS를 생성할 수 있습니다. 자세한 내용은 OpenShift 업데이트 서비스 정보를 참조하십시오.
3
Operator 카탈로그를 설정하여 OpenShift Container Platform 이미지를 검색합니다.
4
이미지 세트에 포함할 특정 Operator 패키지만 지정합니다. 이 필드를 제거하여 카탈로그의 모든 패키지를 검색합니다.
5
이미지 세트에 포함할 추가 이미지를 지정합니다.
참고

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

5.4.2. 부분적으로 연결이 끊긴 환경에서 이미지 세트 미러링

인터넷 액세스가 제한된 환경에서 oc-mirror 플러그인 v2를 사용하여 이미지 세트를 레지스트리에 미러링할 수 있습니다.

사전 요구 사항

  • oc-mirror 플러그인 v2를 실행하는 환경의 인터넷 및 미러 레지스트리에 액세스할 수 있습니다.

프로세스

  • 다음 명령을 실행하여 지정된 이미지 세트 구성의 이미지를 지정된 레지스트리로 미러링합니다.

    $ oc mirror -c isc.yaml --workspace file://<file_path> docker://<mirror_registry_url> --v2 
    1
    1
    이미지가 저장되고 삭제해야 하는 미러 레지스트리의 URL 또는 주소를 지정합니다.

검증

  1. <file_path> 디렉터리에 생성된 working-dir 디렉터리 내에서 cluster-resources 디렉터리로 이동합니다.
  2. ImageDigestMirrorSet,ImageTagMirrorSetCatalogSource 리소스에 YAML 파일이 있는지 확인합니다.

다음 단계

  • oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터를 구성합니다.

5.4.3. 완전히 연결이 끊긴 환경에서 이미지 세트 미러링

OpenShift Container Platform 클러스터가 공용 인터넷에 액세스할 수 없는 완전히 연결이 끊긴 환경에서 이미지 세트를 미러링할 수 있습니다.

  1. mirror to disk: 미러링을 위해 이미지 세트가 포함된 아카이브를 준비합니다. 인터넷 액세스가 필요합니다.
  2. 수동 단계: 연결이 끊긴 미러 레지스트리의 네트워크로 아카이브를 전송합니다.
  3. 미러링할 디스크: 아카이브에서 대상 연결이 끊긴 레지스트리로 이미지 세트를 미러링하려면 미러 레지스트리에 액세스할 수 있는 환경에서 oc-mirror 플러그인 v2를 실행합니다.

5.4.3.1. 미러에서 디스크로 미러링

oc-mirror 플러그인 v2를 사용하여 이미지 세트를 생성하고 콘텐츠를 디스크에 저장할 수 있습니다. 그런 다음 생성된 이미지 세트를 연결이 끊긴 환경으로 전송하고 대상 레지스트리로 미러링할 수 있습니다.

oc-mirror 플러그인 v2는 이미지 세트 구성에 지정된 소스에서 컨테이너 이미지를 검색하고 로컬 디렉터리의 tar 아카이브에 추가합니다.

프로세스

  • 다음 명령을 실행하여 지정된 이미지 세트 구성의 이미지를 디스크에 미러링합니다.

    $ oc mirror -c isc.yaml file://<file_path> --v2 
    1
    1
    필요한 파일 경로를 추가합니다.

검증

  1. 생성된 <file_path> 디렉터리로 이동합니다.
  2. 아카이브 파일이 생성되었는지 확인합니다.

다음 단계

  • oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터를 구성합니다.

5.4.3.2. 디스크에서 미러로 미러링

oc-mirror 플러그인 v2를 사용하여 디스크에서 대상 미러 레지스트리로 이미지 세트를 미러링할 수 있습니다.

oc-mirror 플러그인 v2는 로컬 디스크에서 컨테이너 이미지를 검색하여 지정된 미러 레지스트리로 전송합니다.

프로세스

  • 디스크에서 이미지 세트 파일을 처리하고 다음 명령을 실행하여 콘텐츠를 대상 미러 레지스트리에 미러링합니다.

    $ oc mirror -c isc.yaml --from file://<file_path> docker://<mirror_registry_url> --v2 
    1
    1
    이미지가 저장되고 삭제해야 하는 미러 레지스트리의 URL 또는 주소를 지정합니다.

검증

  1. <file_path> 디렉터리에 생성된 working-dir 디렉터리 내에서 cluster-resources 디렉터리로 이동합니다.
  2. ImageDigestMirrorSet,ImageTagMirrorSetCatalogSource 리소스에 YAML 파일이 있는지 확인합니다.

다음 단계

  • oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터를 구성합니다.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat
맨 위로 이동