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

5.5. oc-mirror 플러그인 v2에서 생성된 사용자 정의 리소스에 관하여

oc-mirror 플러그인 v2는 다음 사용자 정의 리소스를 자동으로 생성합니다.

ImageDigestMirrorSet (IDMS)
이미지 다이제스트 풀 사양을 사용할 때 레지스트리 미러 규칙을 처리합니다. 다이제스트에 의해 이미지 세트의 이미지 중 하나 이상이 미러링되는 경우 생성됩니다.
ImageTagMirrorSet (ITMS)
이미지 태그 풀 사양을 사용할 때 레지스트리 미러 규칙을 처리합니다. 이미지 세트에서 하나 이상의 이미지가 태그로 미러링되는 경우 생성됩니다.
CatalogSource
미러 레지스트리에서 사용 가능한 운영자에 대한 정보를 검색합니다. Operator Lifecycle Manager(OLM) Classic에서 사용됩니다.
ClusterCatalog
미러 레지스트리에서 사용 가능한 클러스터 확장(운영자 포함)에 대한 정보를 검색합니다. OLM v1에서 사용됨.
UpdateService
연결이 끊긴 환경에 업데이트된 그래프 데이터를 제공합니다. OpenShift 업데이트 서비스에서 사용됩니다.

5.5.1. oc-mirror 플러그인에서 생성된 리소스 수정에 대한 제한 사항
링크 복사

oc-mirror 플러그인 v2에서 생성된 리소스를 사용하여 클러스터를 구성하는 경우 특정 필드를 변경해서는 안 됩니다. 이러한 필드를 수정하면 오류가 발생할 수 있으며 지원되지 않습니다.

다음 표에는 변경되지 않아야 하는 리소스와 해당 필드가 나열되어 있습니다.

Expand
표 5.1. oc-mirror에서 생성된 리소스에서 수정되어서는 안 되는 필드
리소스변경하면 안되는 필드

CatalogSource

apiVersion, kind, spec.image

ClusterCatalog

apiVersion, kind, spec.source.image.ref

ImageDigestMirrorSet

apiVersion, kind, spec.imageDigestMirrors

ImageTagMirrorSet

apiVersion, kind, spec.imageTagMirrors

서명 ConfigMap

apiVersion, kind, metadata.namespace, binaryData

UpdateService

apiVersion, kind, spec.graphDataImage, spec.releases

이러한 리소스에 대한 자세한 내용은 CatalogSource , ImageDigestMirrorSet , ImageTagMirrorSet 에 대한 OpenShift API 문서를 참조하세요.

이미지 세트를 미러 레지스트리로 미러링한 후에는 생성된 ImageDigestMirrorSet (IDMS), ImageTagMirrorSet (ITMS), CatalogSource 및 UpdateService 리소스를 클러스터에 적용해야 합니다.

중요

oc-mirror 플러그인 v2에서는 IDMS와 ITMS 파일이 전체 이미지 세트를 포괄하는 반면, oc-mirror 플러그인 v1의 ImageContentSourcePolicy (ICSP) 파일은 그렇지 않습니다. 따라서 증분 미러링 중에 새 이미지만 추가하더라도 IDMS 및 ITMS 파일에는 세트의 모든 이미지가 포함됩니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.

프로세스

  1. cluster-admin 역할의 사용자로 OpenShift CLI에 로그인합니다.

  2. 다음 명령을 실행하여 결과 디렉토리의 YAML 파일을 클러스터에 적용합니다. 

    $ oc apply -f <path_to_oc_mirror_workspace>/working-dir/cluster-resources
    Copy to Clipboard Toggle word wrap

  3. 미러링된 릴리스 이미지가 있는 경우 다음 명령을 실행하여 릴리스 이미지 서명을 클러스터에 적용합니다. 

    $ oc apply -f working-dir/cluster-resources/signature-configmap.json
    Copy to Clipboard Toggle word wrap
    중요

    클러스터 대신 Operator를 미러링하는 경우 이전 명령을 실행하지 마십시오. 명령을 실행하면 적용할 릴리스 이미지 서명이 없기 때문에 오류가 발생합니다.

    또한 YAML 파일은 동일한 디렉터리 working-dir/cluster-resources/ 에서 사용할 수 있습니다. JSON 또는 YAML 형식을 사용할 수 있습니다.

검증

  1. 다음 명령을 실행하여 ImageDigestMirrorSet 리소스가 성공적으로 설치되었는지 확인하세요. 

    $ oc get imagedigestmirrorset
    Copy to Clipboard Toggle word wrap

    oc-mirror 에서 생성된 리소스만 보려면 다음 명령을 실행하세요. 

    $ oc get imagedigestmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

  2. 다음 명령을 실행하여 ImageTagMirrorSet 리소스가 성공적으로 설치되었는지 확인하세요. 

    $ oc get imagetagmirrorset
    Copy to Clipboard Toggle word wrap

    oc-mirror 에서 생성된 리소스만 보려면 다음 명령을 실행하세요. 

    $ oc get imagetagmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

  3. 다음 명령을 실행하여 CatalogSource 리소스가 성공적으로 설치되었는지 확인하세요. 

    $ oc get catalogsource -n openshift-marketplace
    Copy to Clipboard Toggle word wrap

    oc-mirror 에서 생성된 리소스만 보려면 다음 명령을 실행하세요. 

    $ oc get catalogsource -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

  4. 다음 명령을 실행하여 ClusterCatalog 리소스가 성공적으로 설치되었는지 확인하세요. 

    $ oc get clustercatalog
    Copy to Clipboard Toggle word wrap

    oc-mirror 에서 생성된 리소스만 보려면 다음 명령을 실행하세요. 

    $ oc get clustercatalog -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

oc-mirror 플러그인 v2에서 생성된 리소스를 사용하도록 클러스터를 구성한 후, 미러링된 이미지를 사용하여 수행할 수 있는 작업에 대한 자세한 내용은 다음 단계를 참조하세요.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat