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를 구성할 수 있습니다. 리소스는 레지스트리 상태, 스토리지, 로깅, 라우팅 및 배포 설정을 관리하기 위한 매개 변수를 제공합니다.
| 매개변수 | 설명 |
|---|---|
|
|
|
|
|
레지스트리 인스턴스의
|
|
| 기본적으로 생성되는 업로드의 보안을 위해 레지스트리에 필요한 값입니다. |
|
|
|
|
| 마스터 API 및 업스트림 레지스트리를 호출할 때 사용할 프록시를 정의합니다. |
|
|
유사성 설정은 |
|
|
|
|
| 레지스트리 인스턴스가 새 이미지를 푸시하거나 기존 이미지를 삭제하려는 시도를 거부해야하는지 여부를 나타냅니다. |
|
| API 요청 제한 세부 사항입니다. 추가 요청을 대기열에 추가하기 전에 지정된 레지스트리 인스턴스가 처리할 병렬 요청 수를 제어합니다. |
|
|
기본 호스트 이름을 사용하여 외부 경로를 정의할지 여부를 결정합니다. 활성화된 경우 경로는 암호화된 데이터를 다시 암호화합니다. 기본값은 |
|
| 생성할 추가 경로의 배열입니다. 경로의 호스트 이름과 인증서를 지정합니다. |
|
|
이미지 레지스트리 배포에 대한 롤아웃 전략을 정의합니다. 기본값은 |
|
| 레지스트리의 복제본 수입니다. |
|
|
백엔드로 리디렉션하지 않고 레지스트리를 통해 모든 데이터를 라우팅할지 여부를 제어합니다. 기본값은 |
|
|
AWS 또는 Azure에 설치 관리자 프로비저닝 인프라를 사용하여 클러스터를 새로 설치하거나 업그레이드할 때 Image Registry Operator에서
|
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으로 인코딩되어야 합니다.
절차
openshift-config네임스페이스에 구성 맵을 생성한 다음image.config.openshift.ioCR의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의 값입니다.
선택 사항: 다음 명령을 실행하여 추가 CA를 구성합니다.
$ oc create configmap registry-config --from-file=<external_registry_address>=ca.crt -n openshift-config$ oc edit image.config.openshift.io clusterspec: 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