2장. OpenShift Container Platform의 이미지 레지스트리 Operator


2.1. 클라우드 플랫폼 및 OpenStack의 이미지 레지스트리

Image Registry Operator는 OpenShift 이미지 레지스트리의 단일 인스턴스를 설치하고 레지스트리 스토리지 설정을 포함하여 모든 레지스트리 구성을 관리합니다.

참고

스토리지는 AWS, Azure, Google Cloud, IBM® 또는 RHOSP에 설치 관리자 프로비저닝 인프라 클러스터를 설치할 때만 자동으로 구성됩니다.

AWS, Azure, Google Cloud, IBM® 또는 RHOSP에 설치 관리자 프로비저닝 인프라 클러스터를 설치하거나 업그레이드할 때 Image Registry Operator는 spec.storage.managementState 매개변수를 Managed 로 설정합니다. spec.storage.managementState 매개 변수가 Unmanaged로 설정된 경우 이미지 레지스트리 Operator는 스토리지와 관련된 작업을 수행하지 않습니다.

컨트롤 플레인이 관리 클러스터에 배포된 후 Operator는 클러스터에서 감지된 구성에 따라 기본 configs.imageregistry.operator.openshift.io CR(사용자 정의 리소스) 인스턴스를 생성합니다.

전체 configs.imageregistry.operator.openshift.io CR을 정의하는 데 사용할 수 있는 정보가 충분하지 않으면 불완전한 리소스가 정의되고 Operator는 누락된 항목에 대한 정보로 리소스 상태를 업데이트합니다.

중요

pruner를 관리하기위한 이미지 레지스트리 Operator의 동작은 이미지 레지스트리 Operator의 ClusterOperator 개체에 지정된 ManagementState와는 별개입니다. 이미지 레지스트리 Operator가 Managed 상태가 아닌 경우 이미지 pruner는 Pruning 사용자 정의 리소스로 설정 및 관리할 수 있습니다.

그러나 이미지 레지스트리 Operator의 managementState는 배포된 이미지 pruner 작업의 동작을 변경합니다.

  • Managed: 이미지 pruner의 --prune-registry 플래그가 true로 설정됩니다.
  • Removed: 이미지 pruner의 --prune-registry 플래그가 false 로 설정됩니다. 즉, 이미지 정리기 작업은 etcd의 이미지 메타데이터만 정리합니다.

2.2. 베어 메탈, Nutanix 및 vSphere의 이미지 레지스트리

2.2.1. 설치 중 제거된 이미지 레지스트리

공유 가능한 개체 스토리지를 제공하지 않는 플랫폼에서 OpenShift Image Registry Operator는 자체적으로 Removed로 부트스트랩합니다. 이를 통해 openshift-installer가 이러한 플랫폼 유형에서 설치를 완료할 수 있습니다.

설치 후 managementState를 Removed에서 Managed로 전환하도록 Image Registry Operator 구성을 편집해야 합니다. 이 작업이 완료되면 스토리지를 구성해야 합니다.

2.3. 가용성 영역에 대한 이미지 레지스트리 Operator 배포

Image Registry Operator는 전체 영역 오류 중에 지연된 복구 시간을 방지하기 위해 기본적으로 이미지 레지스트리 Pod를 토폴로지 영역에 분배합니다.

다음 예제 YAML은 기본 토폴로지 제약 조건 매개변수 값을 보여줍니다.

  topologySpreadConstraints:
  - labelSelector:
      matchLabels:
        docker-registry: default
    maxSkew: 1
    topologyKey: kubernetes.io/hostname
    whenUnsatisfiable: DoNotSchedule
  - labelSelector:
      matchLabels:
        docker-registry: default
    maxSkew: 1
    topologyKey: node-role.kubernetes.io/worker
    whenUnsatisfiable: DoNotSchedule
  - labelSelector:
      matchLabels:
        docker-registry: default
    maxSkew: 1
    topologyKey: topology.kubernetes.io/zone
    whenUnsatisfiable: DoNotSchedule

다음 YAML을 참조하여 Operator가 베어 메탈 및 vSphere 인스턴스에 적용되는 영역 관련 토폴로지 제약 조건을 사용하여 배포할 때 Image Registry Operator가 사용하는 기본 매개변수 값을 파악합니다.

 topologySpreadConstraints:
  - labelSelector:
      matchLabels:
        docker-registry: default
    maxSkew: 1
    topologyKey: kubernetes.io/hostname
    whenUnsatisfiable: DoNotSchedule
  - labelSelector:
      matchLabels:
        docker-registry: default
    maxSkew: 1
    topologyKey: node-role.kubernetes.io/worker
    whenUnsatisfiable: DoNotSchedule

클러스터 관리자는 configs.imageregistry.operator.openshift.io/cluster 사양 파일을 구성하여 기본 topologySpreadConstraints 섹션 값을 덮어쓸 수 있습니다.

2.5. 이미지 레지스트리 Operator 설정 매개 변수

configs.imageregistry.operator.openshift.io 리소스를 사용하여 Image Registry Operator를 구성할 수 있습니다. 리소스는 레지스트리 상태, 스토리지, 로깅, 라우팅 및 배포 설정을 관리하기 위한 매개 변수를 제공합니다.

매개변수설명

managementState

Managed: Operator는 설정 리소스가 업데이트되면 레지스트리를 업데이트합니다.

Unmanaged: Operator는 설정 리소스에 대한 변경을 무시합니다.

Removed: Operator는 레지스트리 인스턴스를 제거하고 Operator가 프로비저닝한 모든 스토리지를 삭제합니다.

logLevel

레지스트리 인스턴스의 logLevel을 설정합니다. 기본값은 Normal입니다.

logLevel 에 대한 다음 값이 지원됩니다.

  • Normal
  • Debug
  • Trace
  • TraceAll

httpSecret

기본적으로 생성되는 업로드의 보안을 위해 레지스트리에 필요한 값입니다.

operatorLogLevel

operatorLogLevel 구성 매개변수는 Operator 자체에 대한 의도 기반 로깅과 Operator가 자체적으로 해석해야 하는 집계된 로깅 선택을 관리하는 간단한 방법을 제공합니다. 이 구성 매개변수의 기본값은 Normal 입니다. 세분화된 제어를 제공하지 않습니다.

operatorLogLevel에 대한 다음 값이 지원됩니다.

  • Normal
  • Debug
  • Trace
  • TraceAll

proxy

마스터 API 및 업스트림 레지스트리를 호출할 때 사용할 프록시를 정의합니다.

유사성

affinity 매개변수를 사용하여 이미지 레지스트리 Operator Pod에 대한 Pod 예약 기본 설정 및 제약 조건을 구성할 수 있습니다.

유사성 설정은 podAffinity 또는 podAntiAffinity 사양을 사용할 수 있습니다. 두 옵션 모두 preferredDuringSchedulingIgnoredDuringExecution 규칙 또는 requiredDuringSchedulingIgnoredDuringExecution 규칙을 사용할 수 있습니다.

storage

Storagetype: 레지스트리 스토리지 설정에 대한 세부 정보 (예: S3 버킷 위치 정보 등)입니다. 일반적으로 기본적으로 설정됩니다.

readOnly

레지스트리 인스턴스가 새 이미지를 푸시하거나 기존 이미지를 삭제하려는 시도를 거부해야하는지 여부를 나타냅니다.

requests

API 요청 제한 세부 사항입니다. 추가 요청을 대기열에 추가하기 전에 지정된 레지스트리 인스턴스가 처리할 병렬 요청 수를 제어합니다.

defaultRoute

기본 호스트 이름을 사용하여 외부 경로를 정의할지 여부를 결정합니다. 활성화된 경우 경로는 암호화된 데이터를 다시 암호화합니다. 기본값은 false입니다.

routes

생성할 추가 경로의 배열입니다. 경로의 호스트 이름과 인증서를 지정합니다.

rolloutStrategy

이미지 레지스트리 배포에 대한 롤아웃 전략을 정의합니다. 기본값은 RollingUpdate 입니다.

replicas

레지스트리의 복제본 수입니다.

disableRedirect

백엔드로 리디렉션하지 않고 레지스트리를 통해 모든 데이터를 라우팅할지 여부를 제어합니다. 기본값은 false입니다.

spec.storage.managementState

AWS 또는 Azure에 설치 관리자 프로비저닝 인프라를 사용하여 클러스터를 새로 설치하거나 업그레이드할 때 Image Registry Operator에서 spec.storage.managementState 매개변수를 Managed로 설정합니다.

  • Managed: Image Registry Operator에서 기본 스토리지를 관리합니다. Image Registry Operator의 managementState가 Removed로 설정되면 스토리지가 삭제됩니다.

    • managementState가 Managed로 설정된 경우 Image Registry Operator는 기본 스토리지 장치에 일부 기본 구성을 적용합니다. 예를 들어 Managed로 설정된 경우 Operator는 레지스트리에서 암호화를 사용할 수 있도록 S3 버킷에서 활성화합니다. 제공하는 스토리지에 기본 설정을 적용하지 않으려면 managementState를 Unmanaged로 설정해야 합니다.
  • Unmanaged: Image Registry Operator에서 스토리지 설정을 무시합니다. Image Registry Operator의 managementState가 Removed로 설정되어도 스토리지가 삭제되지 않습니다. 버킷 또는 컨테이너 이름과 같은 기본 스토리지 장치 구성을 제공한 후 spec.storage.managementState에는 아직 값을 설정하지 않은 경우, Image Registry Operator에서 이를 Unmanaged로 구성합니다.

2.6. CRD를 사용하여 이미지 레지스트리 기본 경로 활성화

OpenShift Container Platform에서 Registry Operator는 configs.imageregistry.operator.openshift.io CRD를 사용하여 OpenShift 이미지 레지스트리 기능을 제어합니다. 이 CRD를 패치하여 이미지 레지스트리 기본 경로를 자동으로 활성화합니다.

절차

  • 이미지 레지스트리 Operator CRD에 패치를 적용합니다.

    $ oc patch configs.imageregistry.operator.openshift.io/cluster --type merge -p '{"spec":{"defaultRoute":true}}'

2.7. 이미지 레지스트리 액세스를 위한 추가 신뢰 저장소 구성

image.config.openshift.io/cluster 사용자 정의 리소스(CR)에 대한 이미지 레지스트리 액세스 중에 신뢰할 추가 CA(인증 기관)가 있는 구성 맵에 대한 참조를 추가할 수 있습니다.

사전 요구 사항

  • CA(인증 기관)는 PEM으로 인코딩되어야 합니다.

절차

  1. openshift-config 네임스페이스에 구성 맵을 생성한 다음 image.config.openshift.io CR의 AdditionalTrustedCA 매개변수에 구성 맵 이름을 사용합니다. 이렇게 하면 클러스터가 외부 이미지 레지스트리에 연결할 때 신뢰할 수 있는 CA가 추가됩니다.

    이미지 레지스트리 CA 구성 맵의 예

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: my-registry-ca
    data:
      registry.example.com: |
        -----BEGIN CERTIFICATE-----
        ...
        -----END CERTIFICATE-----
      registry-with-port.example.com..5000: |
        -----BEGIN CERTIFICATE-----
        ...
        -----END CERTIFICATE-----

    다음과 같습니다.

    data:registry.example.com:
    이 CA를 신뢰할 레지스트리의 호스트 이름의 예입니다.
    data:registry-with-port.example.com..5000:

    이 CA를 신뢰할 포트가 있는 레지스트리의 호스트 이름의 예입니다. 레지스트리에 registry-with-port.example.com:5000 과 같은 포트가 있는 경우: 을 .. 로 교체해야 합니다.

    PEM 인증서 콘텐츠는 신뢰할 각 추가 레지스트리 CA의 값입니다.

  2. 선택 사항: 다음 명령을 실행하여 추가 CA를 구성합니다.

    $ oc create configmap registry-config --from-file=<external_registry_address>=ca.crt -n openshift-config
    $ oc edit image.config.openshift.io cluster
    spec:
      additionalTrustedCA:
        name: registry-config

2.8. 이미지 레지스트리 Operator에 대한 스토리지 인증 정보 구성

configs.imageregistry.operator.openshift.io CR(사용자 정의 리소스) 및 ConfigMap 리소스 외에도 스토리지 인증 정보 구성은 별도의 시크릿 리소스를 통해 Operator에 제공됩니다. 이 리소스는 openshift-image-registry 네임스페이스 내에 있습니다.

스토리지 액세스 및 관리에 필요한 사용자 정의 인증 정보를 생성하는 image-registry-private-configuration-user 시크릿을 생성할 수 있습니다. 기본 인증 정보가 있는 경우 사용자 정의 인증 정보는 Operator에서 사용하는 기본 인증 정보를 재정의합니다.

절차

  • 필수 키가 포함된 OpenShift Container Platform 시크릿을 생성합니다.

    $ oc create secret generic image-registry-private-configuration-user --from-literal=KEY1=value1 --from-literal=KEY2=value2 --namespace openshift-image-registry
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동