4.7. 사용자 정의 카탈로그 관리

4.7.1.1. 사전 요구 사항

opm CLI를 설치합니다.

4.7.1.2. 인덱스 이미지 생성

opm CLI를 사용하여 인덱스 이미지를 생성할 수 있습니다.

사전 요구 사항

opm 버전 1.12.3 이상
podman 버전 1.9.3+
번들 이미지를 빌드하여 Docker v2-2를 지원하는 레지스트리로 내보냄
중요
OpenShift Container Platform 클러스터의 내부 레지스트리는 미러링 프로세스 중에 필요한 태그 없이 푸시를 지원하지 않으므로 대상 레지스트리로 사용할 수 없습니다.

절차

새 인덱스를 시작합니다.
```
$ opm index add \
    --bundles <registry>/<namespace>/<bundle_image_name>:<tag> \1
    --tag <registry>/<namespace>/<index_image_name>:<tag> \2
    [--binary-image <registry_base_image>] 3
```
1
인덱스에 추가할 번들 이미지를 쉼표로 구분한 목록입니다.
2
인덱스 이미지에 포함할 이미지 태그입니다.
3
선택 사항: 카탈로그 제공에 사용할 대체 레지스트리 기본 이미지입니다.
인덱스 이미지를 레지스트리로 내보냅니다.
1. 필요한 경우 대상 레지스트리로 인증합니다.
```
$ podman login <registry>
```
2. 인덱스 이미지를 내보냅니다.
```
$ podman push <registry>/<namespace>/test-catalog:latest
```

4.7.1.3. 인덱스 이미지에서 카탈로그 생성

인덱스 이미지에서 Operator 카탈로그를 생성하고 OLM(Operator Lifecycle Manager)과 함께 사용하도록 OpenShift Container Platform 클러스터에 적용할 수 있습니다.

사전 요구 사항

인덱스 이미지를 빌드하여 레지스트리로 내보냈습니다.

프로세스

인덱스 이미지를 참조하는 CatalogSource 오브젝트를 생성합니다.
1. 다음을 사양에 맞게 수정하고 catalogsource.yaml 파일로 저장합니다.
```
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: my-operator-catalog
  namespace: openshift-marketplace 1
spec:
  sourceType: grpc
  image: <registry>:<port>/<namespace>/redhat-operator-index:v4.6 2
  displayName: My Operator Catalog
  publisher: <publisher_name> 3
  updateStrategy:
    registryPoll: 4
      interval: 30m
```
  1
  카탈로그 소스를 모든 네임스페이스의 사용자가 전역적으로 사용할 수 있도록 하려면 openshift-marketplace 네임스페이스를 지정합니다. 그러지 않으면 카탈로그의 범위가 지정되고 해당 네임스페이스에 대해서만 사용할 수 있도록 다른 네임스페이스를 지정할 수 있습니다.
  2
  인덱스 이미지를 지정합니다.
  3
  카탈로그를 게시하는 이름 또는 조직 이름을 지정합니다.
  4
  카탈로그 소스는 새 버전을 자동으로 확인하여 최신 상태를 유지할 수 있습니다.
2. 파일을 사용하여 CatalogSource 오브젝트를 생성합니다.
```
$ oc apply -f catalogSource.yaml
```

다음 리소스가 성공적으로 생성되었는지 확인합니다.

Pod를 확인합니다.

$ oc get pods -n openshift-marketplace

출력 예

NAME                                    READY   STATUS    RESTARTS  AGE
my-operator-catalog-6njx6               1/1     Running   0         28s
marketplace-operator-d9f549946-96sgr    1/1     Running   0         26h

카탈로그 소스를 확인합니다.

$ oc get catalogsource -n openshift-marketplace

출력 예

NAME                  DISPLAY               TYPE PUBLISHER  AGE
my-operator-catalog   My Operator Catalog   grpc            5s

패키지 매니페스트 확인합니다.

$ oc get packagemanifest -n openshift-marketplace

출력 예

NAME                          CATALOG               AGE
jaeger-product                My Operator Catalog   93s

이제 OpenShift Container Platform 웹 콘솔의 OperatorHub 페이지에서 Operator를 설치할 수 있습니다.

4.7.1.4. 인덱스 이미지 업데이트

사용자 정의 인덱스 이미지를 참조하는 카탈로그 소스를 사용하도록 OperatorHub를 구성하면 클러스터 관리자가 인덱스 이미지에 번들 이미지를 추가하여 클러스터에 사용 가능한 Operator를 최신 상태로 유지할 수 있습니다.

opm index add 명령을 사용하여 기존 인덱스 이미지를 업데이트할 수 있습니다.

사전 요구 사항

opm 버전 1.12.3 이상
podman 버전 1.9.3+
인덱스 이미지를 빌드하여 레지스트리로 내보냈습니다.
기존 카탈로그 소스에서 인덱스 이미지를 참조합니다.

프로세스

번들 이미지를 추가하여 기존 인덱스를 업데이트합니다.
```
$ opm index add \
    --bundles <registry>/<namespace>/<new_bundle_image>@sha256:<digest> \1
    --from-index <registry>/<namespace>/<existing_index_image>:<existing_tag> \2
    --tag <registry>/<namespace>/<existing_index_image>:<updated_tag> \3
    --pull-tool podman 4
```
1
--bundles 플래그는 인덱스에 추가할 추가 번들 이미지의 쉼표로 구분된 목록을 지정합니다.
2
--from-index 플래그는 이전에 내보낸 인덱스를 지정합니다.
3
--tag 플래그는 업데이트된 인덱스 이미지에 적용할 이미지 태그를 지정합니다.
4
pull-tool 플래그는 컨테이너 이미지를 가져오는 데 사용하는 툴을 지정합니다.
다음과 같습니다.
<registry>
quay.io 또는 mirror.example. com 과 같은 레지스트리의 호스트 이름을 지정합니다.
<namespace>
ocs-dev 또는 abc 와 같은 레지스트리의 네임스페이스를 지정합니다.
<new_bundle_image>
ocs-operator 와 같이 레지스트리에 추가할 새 번들 이미지를 지정합니다.
<digest>
번들 이미지의 SHA 이미지 ID 또는 다이제스트를 지정합니다(예: c7f11097a628f092d8bad148406aa0e0951094a03445fd4bc0775431ef683a41).
<existing_index_image>
이전에 내보낸 이미지를 지정합니다(예: abc-redhat-operator-index ).
<existing_tag>
4.6 과 같이 이전에 푸시된 이미지 태그를 지정합니다.
<updated_tag>
4.6.1 과 같이 업데이트된 인덱스 이미지에 적용할 이미지 태그를 지정합니다.
명령 예
```
$ opm index add \
    --bundles quay.io/ocs-dev/ocs-operator@sha256:c7f11097a628f092d8bad148406aa0e0951094a03445fd4bc0775431ef683a41 \
    --from-index mirror.example.com/abc/abc-redhat-operator-index:4.6 \
    --tag mirror.example.com/abc/abc-redhat-operator-index:4.6.1 \
    --pull-tool podman
```

업데이트된 인덱스 이미지를 내보냅니다.

$ podman push <registry>/<namespace>/<existing_index_image>:<updated_tag>

OLM(Operator Lifecycle Manager)이 정기적으로 카탈로그 소스에서 참조하는 인덱스 이미지를 자동으로 폴링하면 새 패키지가 성공적으로 추가되었는지 확인합니다.
```
$ oc get packagemanifests -n openshift-marketplace
```

4.7.1.5. 인덱스 이미지 정리

Operator 번들 포맷을 기반으로 하는 인덱스 이미지는 Operator 카탈로그의 컨테이너화된 스냅샷입니다. 지정된 패키지 목록을 제외한 인덱스를 모두 정리하여 원하는 Operator만 포함하는 소스 인덱스 복사본을 생성할 수 있습니다.

사전 요구 사항

podman 버전 1.9.3+
grpcurl (타사 명령줄 도구)
opm 버전 1.18.0 이상
Docker v2-2를 지원하는 레지스트리에 액세스
중요
OpenShift Container Platform 클러스터의 내부 레지스트리는 미러링 프로세스 중에 필요한 태그 없이 푸시를 지원하지 않으므로 대상 레지스트리로 사용할 수 없습니다.

절차

4.7.1. 번들 형식을 사용하는 사용자 정의 카탈로그

4.7.1.1. 사전 요구 사항

4.7.1.2. 인덱스 이미지 생성

4.7.1.3. 인덱스 이미지에서 카탈로그 생성

4.7.1.4. 인덱스 이미지 업데이트

4.7.1.5. 인덱스 이미지 정리

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links