5.12. oc-mirror 플러그인 v2의 이미지 세트 구성 매개변수


oc-mirror 플러그인 v2에는 미러링할 이미지를 정의하는 이미지 세트 구성 파일이 필요합니다. 다음 표에는 ImageSetConfiguration 리소스에 사용 가능한 매개변수가 나열되어 있습니다.

참고

minVersionmaxVersion 속성을 사용하여 특정 Operator 버전 범위를 필터링하면 여러 채널 헤드 오류가 발생할 수 있습니다. 오류 메시지는 여러 채널 헤드 가 있음을 나타냅니다. 필터가 적용되면 Operator의 업데이트 그래프가 잘립니다.

OLM에는 모든 Operator 채널에 정확히 하나의 엔드 포인트, 즉 최신 버전의 Operator가 있는 업데이트 그래프를 형성하는 버전이 포함되어 있어야 합니다. 필터 범위가 적용되면 해당 그래프는 두 개 이상의 개별 그래프 또는 두 개 이상의 끝점이 있는 그래프로 전환할 수 있습니다.

이 오류를 방지하려면 최신 버전의 Operator를 필터링하지 마십시오. Operator에 따라 오류가 계속 실행되는 경우 maxVersion 속성을 늘리거나 minVersion 속성을 줄여야 합니다. 모든 Operator 그래프는 다를 수 있으므로 오류가 해결될 때까지 이러한 값을 조정해야 할 수 있습니다.

Expand
표 5.3. ImageSetConfiguration 매개변수
매개변수설명

apiVersion

ImageSetConfiguration 콘텐츠의 API 버전입니다.

문자열 예: mirror.openshift.io/v2alpha1

archiveSize

이미지 세트 내의 각 아카이브 파일의 최대 크기(GiB)입니다.

정수 예: 4

kubeVirtContainer

true 로 설정하면 HyperShift KubeVirt CoreOS 컨테이너의 이미지를 포함합니다.

부울 예 ImageSetConfiguration 파일:

apiVersion: mirror.openshift.io/v2alpha1
kind: ImageSetConfiguration
mirror:
  platform:
    channels:
    - name: stable-4.16
      minVersion: 4.16.0
      maxVersion: 4.16.0
    kubeVirtContainer: true
Copy to Clipboard Toggle word wrap

mirror

이미지 세트의 구성입니다.

개체

mirror.additionalImages

이미지 세트의 추가 이미지 구성입니다.

개체 배열

예제:

additionalImages:
  - name: registry.redhat.io/ubi8/ubi:latest
Copy to Clipboard Toggle word wrap

mirror.additionalImages.name

미러링할 이미지의 태그 또는 다이제스트입니다.

문자열 예: registry.redhat.io/ubi8/ubi:latest

mirror.blockedImages

미러링을 차단할 태그 또는 다이제스트(SHA)가 있는 이미지 목록입니다.

문자열 배열 예: docker.io/ Cryostat/alpine

mirror.helm

이미지 세트의 helm 구성입니다. oc-mirror 플러그인은 수동으로 수정된 values.yaml 파일이 있는 helm 차트를 지원하지 않습니다.

개체

mirror.helm.local

미러링할 로컬 helm 차트입니다.

개체의 배열입니다. 예를 들면 다음과 같습니다.

local:
  - name: podinfo
    path: /test/podinfo-5.0.0.tar.gz
Copy to Clipboard Toggle word wrap

mirror.helm.local.charts.imagePaths

로컬 helm 차트 내부의 컨테이너 이미지의 사용자 정의 경로입니다.

+

참고

oc-mirror 는 잘 알려진 경로를 검색하여 helm 차트에서 컨테이너 이미지를 탐지하고 미러링합니다. 이 필드를 사용하여 사용자 정의 경로를 지정할 수도 있습니다.

+

참고

런타임 시 Operator 컨트롤러에서 동적으로 배포하는 피연산자 이미지는 일반적으로 컨트롤러의 배포 템플릿 내의 환경 변수에서 참조합니다. oc-mirror 가 이러한 환경 변수에 액세스할 수 있는 동안 OpenShift Container Platform 4.20 이전에는 이미지 이외의 참조(예: 로그 수준)를 포함한 모든 값을 미러링하려고 시도하여 오류가 발생했습니다. 이번 업데이트를 통해 이러한 환경 변수에서 참조하는 컨테이너 이미지만 미러링할 수 있습니다.

문자열 배열입니다. 예: "- {.spec.template.spec.custom[*].image}".

mirror.helm.local.name

미러링할 로컬 helm 차트의 이름입니다.

문자열. 예: podinfo.

mirror.helm.local.path

미러링할 로컬 helm 차트의 경로입니다.

문자열. 예: /test/podinfo-5.0.0.tar.gz.

mirror.helm.repositories

미러링할 원격 helm 리포지토리입니다.

개체의 배열입니다. 예를 들면 다음과 같습니다.

repositories:
  - name: podinfo
    url: https://example.github.io/podinfo
    charts:
      - name: podinfo
        version: 5.0.0
         imagePaths:
         - "{.spec.template.spec.custom[*].image}"
Copy to Clipboard Toggle word wrap

mirror.helm.repositories.name

미러링할 helm 저장소 이름입니다.

문자열. 예: podinfo.

mirror.helm.repositories.url

미러링할 helm 리포지토리의 URL입니다.

문자열. 예: https://example.github.io/podinfo.

mirror.helm.repositories.charts

미러링할 원격 helm 차트입니다.

개체의 배열입니다.

mirror.helm.repositories.charts.name

미러링할 helm 차트의 이름입니다.

문자열. 예: podinfo.

mirror.helm.repositories.charts.imagePaths

helm 차트 내부의 컨테이너 이미지의 사용자 정의 경로입니다.

+

참고

oc-mirror 는 잘 알려진 경로를 검색하여 helm 차트에서 컨테이너 이미지를 탐지하고 미러링합니다. 이 필드를 사용하여 사용자 정의 경로를 지정할 수도 있습니다.

+

참고

런타임 시 Operator 컨트롤러에서 동적으로 배포하는 피연산자 이미지는 일반적으로 컨트롤러의 배포 템플릿 내의 환경 변수에서 참조합니다. oc-mirror 가 이러한 환경 변수에 액세스할 수 있는 동안 OpenShift Container Platform 4.20 이전에는 이미지 이외의 참조(예: 로그 수준)를 포함한 모든 값을 미러링하려고 시도하여 오류가 발생했습니다. 이번 업데이트를 통해 이러한 환경 변수에서 참조하는 컨테이너 이미지만 미러링할 수 있습니다.

문자열 배열입니다. 예: "- {.spec.template.spec.custom[*].image}".

mirror.operators

이미지 세트의 Operator 구성

개체 배열

예제:

operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:4.20
    packages:
      - name: elasticsearch-operator
        minVersion: '2.4.0'
Copy to Clipboard Toggle word wrap

mirror.operators.catalog

이미지 세트에 포함할 Operator 카탈로그입니다.

문자열 예: registry.redhat.io/redhat/redhat-operator-index:v4.15

mirror.operators.full

true 인 경우 전체 카탈로그, Operator 패키지 또는 Operator 채널을 다운로드합니다.

부울 값은 false 입니다.

mirror.operators.packages

Operator 패키지 구성입니다.

개체 배열

예제:

operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:4.20
    packages:
      - name: elasticsearch-operator
        minVersion: '5.2.3-31'
Copy to Clipboard Toggle word wrap

mirror.operators.packages.name

이미지 세트에 포함할 Operator 패키지 이름입니다.

문자열 예: elasticsearch-operator

mirror.operators.packages.channels

Operator 패키지 채널 구성

개체

mirror.operators.packages.channels.name

이미지 세트에 포함할 Operator 채널 이름은 패키지 내에서 고유합니다.

문자열 Eample: fast 또는 stable-v4.15

mirror.operators.packages.channels.maxVersion

Operator의 가장 높은 버전은 존재하는 모든 채널에서 미러링됩니다.

문자열 예: 5.2.3-31

mirror.operators.packages.channels.minVersion

존재하는 모든 채널에 미러링할 가장 낮은 버전의 Operator

문자열 예: 5.2.3-31

mirror.operators.packages.maxVersion

존재하는 모든 채널에 미러링할 Operator의 가장 높은 버전입니다.

문자열 예: 5.2.3-31

mirror.operators.packages.minVersion

존재하는 모든 채널에 미러링할 Operator의 가장 낮은 버전입니다.

문자열 예: 5.2.3-31

mirror.operators.targetCatalog

참조된 카탈로그를 미러링하는 대체 이름 및 선택적 네임스페이스 계층 구조

문자열 예: my-namespace/my-operator-catalog

mirror.operators.targetCatalogSourceTemplate

oc-mirror 플러그인 v2에서 생성한 catalogSource 사용자 정의 리소스를 완료하는 데 사용할 템플릿의 디스크 경로입니다.

문자열 예: /tmp/catalog-source_template.yaml 템플릿 파일의 예:

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: discarded
  namespace: openshift-marketplace
spec:
  image: discarded
  sourceType: grpc
  updateStrategy:
    registryPoll:
      interval: 30m0s
Copy to Clipboard Toggle word wrap

mirror.operators.targetTag

targetName 또는 targetCatalog 에 추가할 대체 태그입니다.

문자열 예: v1

mirror.platform

이미지 세트의 플랫폼 구성입니다.

개체

mirror.platform.architectures

미러링할 플랫폼 릴리스 페이로드의 아키텍처입니다.

문자열 배열은 다음과 같습니다.

architectures:
  - amd64
  - arm64
  - multi
  - ppc64le
  - s390x
Copy to Clipboard Toggle word wrap

기본값은 amd64 입니다. 값 multi 를 사용하면 사용 가능한 모든 아키텍처에 대해 미러링이 지원되므로 개별 아키텍처를 지정할 필요가 없습니다.

mirror.platform.channels

이미지 세트의 플랫폼 채널 구성입니다.

오브젝트 배열은 다음과 같습니다.

channels:
  - name: stable-4.12
  - name: stable-4.20
Copy to Clipboard Toggle word wrap

mirror.platform.channels.full

true 인 경우 minVersion 을 채널의 첫 번째 릴리스로 설정하고 maxVersion 을 채널의 마지막 릴리스로 설정합니다.

부울 값 기본값은 false입니다.

mirror.platform.channels.name

릴리스 채널의 이름

문자열 예: stable-4.15

mirror.platform.channels.minVersion

미러링할 참조된 플랫폼의 최소 버전입니다.

문자열 예: 4.12.6

mirror.platform.channels.maxVersion

참조된 플랫폼의 가장 높은 버전을 미러링합니다.

문자열 예: 4.15.1

mirror.platform.channels.shortestPath

경로 미러링 또는 전체 범위 미러링을 전환합니다.

부울 값 기본값은 false입니다.

mirror.platform.channels.type

미러링할 플랫폼의 유형

문자열 예: ocp 또는 okd. 기본값은 ocp 입니다.

mirror.platform.graph

OSUS 그래프가 이미지 세트에 추가되고 나중에 미러에 게시되는지 여부를 나타냅니다.

부울 값 기본값은 false입니다.

mirror.operators.packages.defaultChannel

필터링에서 기본 채널을 제외할 때 정의해야 합니다.

개체의 배열입니다. 예를 들면 다음과 같습니다.

 mirror:
  operators:
    - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.20
      packages:
        - name: rhods-operator
          defaultChannel: fast
          channels:
            - name: fast
Copy to Clipboard Toggle word wrap

5.12.1. DeleteImageSetConfiguration 매개변수

oc-mirror 플러그인 v2와 함께 이미지 제거를 사용하려면 미러 레지스트리에서 삭제할 이미지를 정의하는 DeleteImageSetConfiguration.yaml 구성 파일을 사용해야 합니다. 다음 표에는 DeleteImageSetConfiguration 리소스에 사용 가능한 매개변수가 나열되어 있습니다.

Expand
표 5.4. DeleteImageSetConfiguration 매개변수
매개변수설명

apiVersion

DeleteImageSetConfiguration 콘텐츠의 API 버전입니다.

문자열 예: mirror.openshift.io/v2alpha1

삭제

삭제할 이미지 세트의 구성입니다.

개체

delete.additionalImages

삭제 이미지 세트의 추가 이미지 구성입니다.

오브젝트 배열은 다음과 같습니다.

additionalImages:
  - name: registry.redhat.io/ubi8/ubi:latest
Copy to Clipboard Toggle word wrap

delete.additionalImages.name

삭제할 이미지의 태그 또는 다이제스트입니다.

문자열 예: registry.redhat.io/ubi8/ubi:latest

delete.operators

삭제 이미지 세트의 Operator 구성입니다.

오브젝트 배열은 다음과 같습니다.

operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:{product-version}
    packages:
      - name: elasticsearch-operator
        minVersion: '2.4.0'
Copy to Clipboard Toggle word wrap

delete.operators.catalog

삭제 이미지 세트에 포함할 Operator 카탈로그입니다.

문자열 예: registry.redhat.io/redhat/redhat-operator-index:v4.15

delete.operators.full

true인 경우 전체 카탈로그, Operator 패키지 또는 Operator 채널을 삭제합니다.

부울 값 기본값은 false입니다.

delete.operators.packages

Operator 패키지 구성

오브젝트 배열은 다음과 같습니다.

operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:{product-version}
    packages:
      - name: elasticsearch-operator
        minVersion: '5.2.3-31'
Copy to Clipboard Toggle word wrap

delete.operators.packages.name

삭제 이미지 세트에 포함할 Operator 패키지 이름입니다.

문자열 예: elasticsearch-operator

delete.operators.packages.channels

Operator 패키지 채널 구성

개체

delete.operators.packages.channels.name

삭제 이미지 세트에 포함할 Operator 채널 이름(패키지 내에서 고유함)입니다.

문자열 예: fast 또는 stable-v4.15

delete.operators.packages.channels.maxVersion

선택한 채널 내에서 삭제할 Operator의 가장 높은 버전입니다.

문자열 예: 5.2.3-31

delete.operators.packages.channels.minVersion

존재하는 선택 범위 내에서 삭제할 Operator의 가장 낮은 버전입니다.

문자열 예: 5.2.3-31

delete.operators.packages.maxVersion

존재하는 모든 채널에서 삭제할 Operator의 가장 높은 버전입니다.

문자열 예: 5.2.3-31

delete.operators.packages.minVersion

존재하는 모든 채널에서 삭제할 Operator의 가장 낮은 버전입니다.

문자열 예: 5.2.3-31

delete.platform

이미지 세트의 플랫폼 구성

개체

delete.platform.architectures

삭제할 플랫폼 릴리스 페이로드의 아키텍처입니다.

문자열 배열은 다음과 같습니다.

architectures:
  - amd64
  - arm64
  - multi
  - ppc64le
  - s390x
Copy to Clipboard Toggle word wrap

기본값은 amd64입니다.

delete.platform.channels

이미지 세트의 플랫폼 채널 구성입니다.

개체 배열

예제:

channels:
  - name: stable-4.12
  - name: stable-4.20
Copy to Clipboard Toggle word wrap

delete.platform.channels.full

true 인 경우 minVersion 을 채널의 첫 번째 릴리스로 설정하고 maxVersion 을 채널의 마지막 릴리스로 설정합니다.

부울 값 기본값은 false입니다.

delete.platform.channels.name

릴리스 채널의 이름

문자열 예: stable-4.15

delete.platform.channels.minVersion

삭제할 참조 플랫폼의 최소 버전입니다.

문자열 예: 4.12.6

delete.platform.channels.maxVersion

삭제할 가장 높은 버전의 참조 플랫폼입니다.

문자열 예: 4.15.1

delete.platform.channels.shortestPath

가장 짧은 경로를 삭제하고 전체 범위를 삭제하는 사이를 전환합니다.

부울 값 기본값은 false입니다.

delete.platform.channels.type

삭제할 플랫폼의 유형

문자열 예: ocp 또는 okd 기본값은 ocp입니다.

delete.platform.graph

미러 레지스트리에서도 OSUS 그래프가 삭제되었는지 여부를 확인합니다.

부울 값 기본값은 false입니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat