4.3. 카탈로그 관리


클러스터 관리자는 카탈로그 나 운영자 및 Kubernetes 확장 프로그램의 큐레이션된 컬렉션을 클러스터에 추가할 수 있습니다. 운영자 작성자는 이러한 카탈로그에 자신의 제품을 게시합니다. 클러스터에 카탈로그를 추가하면 카탈로그에 게시된 Operator와 확장 프로그램의 버전, 패치, 무선 업데이트에 액세스할 수 있습니다.

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

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

중요

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

4.3.1. OLM v1의 카탈로그에 관하여

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

4.3.2. OLM v1의 Red Hat 제공 운영자 카탈로그

Operator Lifecycle Manager(OLM) 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.19
    type: Image
Copy to Clipboard Toggle word wrap

1
최신 이미지 다이제스트에 대한 원격 레지스트리 폴링 간격을 분 단위로 지정합니다. 폴링을 비활성화하려면 필드를 설정하지 마세요.

인증된 운영자 카탈로그

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.19
    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.19
    type: Image
Copy to Clipboard Toggle word wrap

커뮤니티 운영자 카탈로그

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.19
    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. 클러스터에 카탈로그 추가

Operator Lifecycle Manager(OLM) 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.19 
    4
    
        type: Image
    Copy to Clipboard Toggle word wrap

    1
    카탈로그는 클러스터에 적용되면 자동으로 metadata.name 필드 값으로 레이블이 지정됩니다. 라벨과 카탈로그 선택에 대한 자세한 내용은 "카탈로그 콘텐츠 확인"을 참조하세요.
    2
    선택 사항: 클러스터의 다른 카탈로그와 관련하여 카탈로그의 우선순위를 지정합니다. 자세한 내용은 "우선순위별 카탈로그 선택"을 참조하세요.
    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.19
          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