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


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

5.4.1. 이미지 세트 구성 생성

oc-mirror 플러그인 v2를 사용하여 이미지를 미러링하려면 먼저 이미지 세트 구성 파일을 생성해야 합니다. 이 이미지 세트 구성 파일은 oc-mirror 플러그인 v2의 다른 구성 설정과 함께 미러링할 OpenShift Container Platform 릴리스, Operator 및 기타 이미지를 정의합니다.

사전 요구 사항

  • 컨테이너 이미지 레지스트리 인증 정보 파일이 생성되어 있습니다. 자세한 내용은 이미지를 미러링할 수 있는 인증 정보 구성을 참조하십시오.

프로세스

  • ImageSetConfiguration YAML 파일을 생성하고 필요한 이미지를 포함하도록 수정합니다.

    ImageSetConfiguration YAML 파일의 예

    kind: ImageSetConfiguration
    apiVersion: mirror.openshift.io/v2alpha1
    mirror:
      platform:
        channels:
        - name: stable-4.20 
    1
    
          minVersion: 4.20.2
          maxVersion: 4.20.2
        graph: true 
    2
    
      operators:
        - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.20 
    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
    Copy to Clipboard Toggle word wrap

    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
    이미지 세트에 포함할 추가 이미지를 지정합니다.

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

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

사전 요구 사항

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

프로세스

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

    $ oc mirror -c <image_set_configuration> --workspace file://<file_path> docker://<mirror_registry_url> --v2 
    1
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <image_set_configuration>
    이미지 세트 구성 파일의 이름을 지정합니다.
    <file_path>
    클러스터 리소스가 생성될 디렉터리를 지정합니다.
    <mirror_registry_url>
    이미지가 저장되고 삭제해야 하는 미러 레지스트리의 URL 또는 주소를 지정합니다.

검증

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

다음 단계

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

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

OpenShift Container Platform 클러스터가 공용 인터넷에 액세스할 수 없는 완전히 연결이 끊긴 환경에서 이미지 세트를 미러링할 수 있습니다. 다음 고급 워크플로에서는 미러링 프로세스를 설명합니다.

  1. mirror to disk: 이미지 세트를 아카이브로 미러링합니다.
  2. 디스크 전송: 압축 파일을 연결이 끊긴 미러 레지스트리의 네트워크로 수동으로 전송합니다.
  3. Disk to mirror: 아카이브에서 대상 연결이 끊긴 레지스트리로 이미지 세트를 미러링합니다.

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

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

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

프로세스

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

    $ oc mirror -c <image_set_configuration> file://<file_path> --v2
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <image_set_configuration>
    이미지 세트 구성 파일의 이름을 지정합니다.
    <file_path>
    이미지 세트를 포함하는 아카이브가 생성될 디렉터리를 지정합니다.

검증

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

다음 단계

  • 디스크에서 미러로 미러링

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

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

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

프로세스

  1. 미러링된 이미지 세트가 포함된 디스크를 대상 미러 레지스트리가 포함된 환경으로 전송합니다.
  2. 디스크에서 이미지 세트 파일을 처리하고 다음 명령을 실행하여 콘텐츠를 대상 미러 레지스트리에 미러링합니다.

    $ oc mirror -c <image_set_configuration> --from file://<file_path> docker://<mirror_registry_url> --v2
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <image_set_configuration>
    이미지 세트 구성 파일의 이름을 지정합니다.
    <file_path>
    아카이브를 포함하는 디스크의 디렉터리를 지정합니다. 이 폴더에는 클러스터에 적용할 수 있도록 생성된 클러스터 리소스도 포함됩니다(예: ImageDigestMirrorSet (IDMS) 또는 ImageTagMirrorSet (ITMS) 리소스).
    <mirror_registry_url>
    이미지가 저장되는 미러 레지스트리의 URL 또는 주소를 지정합니다.

검증

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

다음 단계

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

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat