4.3. 카탈로그 관리


클러스터 관리자는 카탈로그 또는 Operator 및 Kubernetes 확장의 컬렉션을 클러스터에 추가할 수 있습니다. Operator 작성자는 해당 카탈로그에 제품을 게시합니다. 클러스터에 카탈로그를 추가할 때 카탈로그에 게시된 Operator 및 확장의 버전, 패치 및 무선 업데이트에 액세스할 수 있습니다.

CR(사용자 정의 리소스)을 사용하여 CLI에서 카탈로그 및 확장을 선언적으로 관리할 수 있습니다.

파일 기반 카탈로그는 OLM(Operator Lifecycle Manager) 카탈로그 형식의 최신 버전입니다. 일반 텍스트 기반(JSON 또는 YAML)과 이전 SQLite 데이터베이스 형식의 선언적 구성 진화이며 완전히 이전 버전과 호환됩니다.

중요

Kubernetes는 후속 릴리스에서 제거된 특정 API를 주기적으로 사용하지 않습니다. 결과적으로 Operator는 API를 제거한 Kubernetes 버전을 사용하는 OpenShift Container Platform 버전에서 시작하여 제거된 API를 사용할 수 없습니다.

4.3.1. OLM v1의 카탈로그 정보

카탈로그 구성 요소를 사용하여 Operator 및 컨트롤러와 같은 Kubernetes 확장 카탈로그를 쿼리하여 설치 가능한 콘텐츠를 검색할 수 있습니다. Catalogd는 클러스터 내 클라이언트의 카탈로그 콘텐츠의 압축을 풀고 OLM(Operator Lifecycle Manager) v1 마이크로 서비스 제품군의 일부입니다. 현재 catalogd는 컨테이너 이미지로 패키지 및 배포되는 카탈로그 콘텐츠의 압축을 풉니다.

4.3.2. OLM v1의 Red Hat 제공 Operator 카탈로그

OLM(Operator Lifecycle Manager) v1에는 기본적으로 클러스터에 다음과 같은 Red Hat 제공 Operator 카탈로그가 포함되어 있습니다. 클러스터에 추가 카탈로그를 추가하려면 카탈로그의 사용자 정의 리소스(CR)를 생성하여 클러스터에 적용합니다. 다음 CR(사용자 정의 리소스) 예제에서는 클러스터에 설치된 기본 카탈로그를 보여줍니다.

Red Hat Operators 카탈로그

apiVersion: olm.operatorframework.io/v1
kind: ClusterCatalog
metadata:
  name: openshift-redhat-operators
spec:
  priority: -100
  source:
    image:
      pollIntervalMinutes: <poll_interval_duration> 
1

      ref: registry.redhat.io/redhat/redhat-operator-index:v4.20
    type: Image
Copy to Clipboard Toggle word wrap

1
최신 이미지 다이제스트를 위해 원격 레지스트리를 폴링하는 간격(분)을 지정합니다. 폴링을 비활성화하려면 필드를 설정하지 마십시오.

인증된 Operator 카탈로그

apiVersion: olm.operatorframework.io/v1
kind: ClusterCatalog
metadata:
  name: openshift-certified-operators
spec:
priority: -200
  source:
    type: image
    image:
      pollIntervalMinutes: 10
      ref: registry.redhat.io/redhat/certified-operator-index:v4.20
    type: Image
Copy to Clipboard Toggle word wrap

Red Hat Marketplace 카탈로그

apiVersion: olm.operatorframework.io/v1
kind: ClusterCatalog
metadata:
  name: openshift-redhat-marketplace
spec:
  priority: -300
  source:
    image:
      pollIntervalMinutes: 10
      ref: registry.redhat.io/redhat/redhat-marketplace-index:v4.20
    type: Image
Copy to Clipboard Toggle word wrap

커뮤니티 Operator 카탈로그

apiVersion: olm.operatorframework.io/v1
kind: ClusterCatalog
metadata:
  name: openshift-community-operators
spec:
  priority: -400
  source:
    image:
      pollIntervalMinutes: 10
      ref: registry.redhat.io/redhat/community-operator-index:v4.20
    type: Image
Copy to Clipboard Toggle word wrap

다음 명령은 클러스터에 카탈로그를 추가합니다.

명령 구문

$ oc apply -f <catalog_name>.yaml 
1
Copy to Clipboard Toggle word wrap

1
my-catalog.yaml 과 같은 카탈로그 CR을 지정합니다.

4.3.3. 클러스터에 카탈로그 추가

OLM(Operator Lifecycle Manager) v1 사용을 위해 클러스터에 카탈로그를 추가하려면 ClusterCatalog CR(사용자 정의 리소스)을 생성하여 클러스터에 적용합니다.

프로세스

  1. 다음 예와 유사한 카탈로그 CR(사용자 정의 리소스)을 생성합니다.

    my-redhat-operators.yaml 파일 예

    apiVersion: olm.operatorframework.io/v1
    kind: ClusterCatalog
    metadata:
      name: my-redhat-operators 
    1
    
    spec:
      priority: 1000 
    2
    
      source:
        image:
          pollIntervalMinutes: 10 
    3
    
          ref: registry.redhat.io/redhat/community-operator-index:v4.20 
    4
    
        type: Image
    Copy to Clipboard Toggle word wrap

    1
    카탈로그는 클러스터에 적용할 때 metadata.name 필드의 값으로 자동으로 레이블이 지정됩니다. 레이블 및 카탈로그 선택에 대한 자세한 내용은 "Catalog 콘텐츠 확인"을 참조하십시오.
    2
    선택 사항: 클러스터의 다른 카탈로그와 관련하여 카탈로그의 우선 순위를 지정합니다. 자세한 내용은 "Catalog selection by priority"를 참조하십시오.
    3
    최신 이미지 다이제스트를 위해 원격 레지스트리를 폴링하는 간격(분)을 지정합니다. 폴링을 비활성화하려면 필드를 설정하지 마십시오.
    4
    spec.source.image.ref 필드에 카탈로그 이미지를 지정합니다.
  2. 다음 명령을 실행하여 클러스터에 카탈로그를 추가합니다.

    $ oc apply -f my-redhat-operators.yaml
    Copy to Clipboard Toggle word wrap

    출력 예

    clustercatalog.olm.operatorframework.io/my-redhat-operators created
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 카탈로그 상태를 확인합니다.

    1. 다음 명령을 실행하여 카탈로그를 사용할 수 있는지 확인합니다.

      $ oc get clustercatalog
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                            LASTUNPACKED   SERVING   AGE
      my-redhat-operators             55s            True      64s
      openshift-certified-operators   83m            True      84m
      openshift-community-operators   43m            True      84m
      openshift-redhat-marketplace    83m            True      84m
      openshift-redhat-operators      54m            True      84m
      Copy to Clipboard Toggle word wrap

    2. 다음 명령을 실행하여 카탈로그의 상태를 확인합니다.

      $ oc describe clustercatalog my-redhat-operators
      Copy to Clipboard Toggle word wrap

      출력 예

      Name:         my-redhat-operators
      Namespace:
      Labels:       olm.operatorframework.io/metadata.name=my-redhat-operators
      Annotations:  <none>
      API Version:  olm.operatorframework.io/v1
      Kind:         ClusterCatalog
      Metadata:
        Creation Timestamp:  2025-02-18T20:28:50Z
        Finalizers:
          olm.operatorframework.io/delete-server-cache
        Generation:        1
        Resource Version:  50248
        UID:               86adf94f-d2a8-4e70-895b-31139f2eeab7
      Spec:
        Availability Mode:  Available
        Priority:           1000
        Source:
          Image:
            Poll Interval Minutes:  10
            Ref:                    registry.redhat.io/redhat/community-operator-index:v4.20
          Type:                     Image
      Status: 
      1
      
        Conditions:
          Last Transition Time:  2025-02-18T20:29:00Z
          Message:               Successfully unpacked and stored content from resolved source
          Observed Generation:   1
          Reason:                Succeeded 
      2
      
          Status:                True
          Type:                  Progressing
          Last Transition Time:  2025-02-18T20:29:00Z
          Message:               Serving desired content from resolved source
          Observed Generation:   1
          Reason:                Available
          Status:                True
          Type:                  Serving
        Last Unpacked:           2025-02-18T20:28:59Z
        Resolved Source:
          Image:
            Ref:  registry.redhat.io/redhat/community-operator-index@sha256:11627ea6fdd06b8092df815076e03cae9b7cede8b353c0b461328842d02896c5 
      3
      
          Type:   Image
        Urls:
          Base:  https://catalogd-service.openshift-catalogd.svc/catalogs/my-redhat-operators
      Events:    <none>
      Copy to Clipboard Toggle word wrap

      1
      카탈로그 상태를 설명합니다.
      2
      카탈로그가 현재 상태에 있는 이유를 표시합니다.
      3
      카탈로그의 이미지 참조를 표시합니다.

4.3.4. 카탈로그 삭제

CR(사용자 정의 리소스)을 삭제하여 카탈로그를 삭제할 수 있습니다.

사전 요구 사항

  • 카탈로그가 설치되어 있어야 합니다.

프로세스

  • 다음 명령을 실행하여 카탈로그를 삭제합니다.

    $ oc delete clustercatalog <catalog_name>
    Copy to Clipboard Toggle word wrap

    출력 예

    clustercatalog.olm.operatorframework.io "my-redhat-operators" deleted
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 카탈로그가 삭제되었는지 확인합니다.

    $ oc get clustercatalog
    Copy to Clipboard Toggle word wrap

4.3.5. 기본 카탈로그 비활성화

기본적으로 OpenShift Container Platform에 포함된 Red Hat 제공 카탈로그를 비활성화할 수 있습니다.

프로세스

  • 다음 명령을 실행하여 기본 카탈로그를 비활성화합니다.

    $ oc patch clustercatalog openshift-certified-operators -p \
      '{"spec": {"availabilityMode": "Unavailable"}}' --type=merge
    Copy to Clipboard Toggle word wrap

    출력 예

    clustercatalog.olm.operatorframework.io/openshift-certified-operators patched
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 카탈로그가 비활성화되었는지 확인합니다.

    $ oc get clustercatalog openshift-certified-operators
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                            LASTUNPACKED   SERVING   AGE
    openshift-certified-operators                  False     6h54m
    Copy to Clipboard Toggle word wrap

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat