7.3. OLM 1.0의 카탈로그에서 Operator 설치 (기술 프리뷰)
클러스터 관리자는 카탈로그 또는 Operator 및 Kubernetes 확장의 컬렉션을 클러스터에 추가할 수 있습니다. Operator 작성자는 해당 카탈로그에 제품을 게시합니다. 클러스터에 카탈로그를 추가할 때 카탈로그에 게시된 Operator 및 확장의 버전, 패치 및 무선 업데이트에 액세스할 수 있습니다.
OLM(Operator Lifecycle Manager) 1.0의 현재 기술 프리뷰 릴리스에서는 CR(사용자 정의 리소스)을 사용하여 CLI에서 카탈로그 및 Operator를 선언적으로 관리합니다.
OLM 1.0은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
7.3.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
cluster-admin
권한이 있는 계정을 사용하여 OpenShift Container Platform 클러스터에 액세스참고OpenShift Container Platform 4.16의 경우 OLM 1.0에 대한 문서화된 절차는 CLI 기반 전용입니다. 또는 관리자는 YAML 가져오기 및 검색 페이지와 같은 일반 방법을 사용하여 웹 콘솔에서 관련 오브젝트를 생성하고 볼 수 있습니다. 그러나 기존 OperatorHub 및 설치된 Operator 페이지에는 OLM 1.0 구성 요소가 표시되지 않습니다.
클러스터에서
TechPreviewNoUpgrade
기능 세트 활성화주의TechPreviewNoUpgrade
기능 세트를 활성화하면 취소할 수 없으며 마이너 버전 업데이트가 허용되지 않습니다. 이러한 기능 세트는 프로덕션 클러스터에서는 권장되지 않습니다.-
워크스테이션에 설치된 OpenShift CLI(
oc
)
7.3.2. OLM 1.0의 카탈로그 정보 링크 복사링크가 클립보드에 복사되었습니다!
카탈로그 구성 요소를 사용하여 Operator 및 컨트롤러와 같은 Kubernetes 확장 카탈로그를 쿼리하여 설치 가능한 콘텐츠를 검색할 수 있습니다. Catalogd는 클러스터 내 클라이언트의 카탈로그 콘텐츠의 압축을 풀고 OLM(Operator Lifecycle Manager) 1.0 마이크로 서비스 제품군의 일부입니다. 현재 catalogd는 컨테이너 이미지로 패키지 및 배포되는 카탈로그 콘텐츠의 압축을 풉니다.
고유한 이름이 없는 Operator 또는 확장을 설치하려고 하면 설치에 실패하거나 예기치 않은 결과가 발생할 수 있습니다. 이는 다음과 같은 이유로 발생합니다.
- mulitple 카탈로그가 클러스터에 설치된 경우 OLM(Operator Lifecycle Manager) 1.0에는 Operator 또는 확장을 설치할 때 카탈로그를 지정하는 메커니즘이 포함되지 않습니다.
- OLM 1.0에서는 클러스터에 설치할 수 있는 모든 Operator 및 확장을 해당 번들 및 패키지에 고유한 이름을 사용해야 합니다.
7.3.3. OLM 1.0의 Red Hat 제공 Operator 카탈로그 링크 복사링크가 클립보드에 복사되었습니다!
OLM(Operator Lifecycle Manager) 1.0에는 기본적으로 Red Hat 제공 Operator 카탈로그가 포함되어 있지 않습니다. Red Hat 제공 카탈로그를 클러스터에 추가하려면 카탈로그의 CR(사용자 정의 리소스)을 생성하여 클러스터에 적용합니다. 다음 CR(사용자 정의 리소스) 예제에서는 OLM 1.0에 대한 카탈로그 리소스를 생성하는 방법을 보여줍니다.
registry.redhat.io
의 Red Hat 제공 Operator 카탈로그와 같은 보안 레지스트리에서 호스팅되는 카탈로그를 사용하려면 openshift-catalogd
네임스페이스에 풀 시크릿 범위가 지정되어야 합니다. 자세한 내용은 "보안 레지스트리에서 호스팅되는 카탈로그의 풀 시크릿 생성"을 참조하십시오.
Red Hat Operator 카탈로그의 예
- 1
- 최신 이미지 다이제스트를 위해 원격 레지스트리를 폴링하는 간격을 지정합니다. 기본값은
24h
입니다. 유효한 단위에는 초(s
), 분(m
) 및 시간(h
)이 포함됩니다. 폴링을 비활성화하려면0s
와 같은 0 값을 설정합니다.
인증된 Operator 카탈로그의 예
커뮤니티 Operator 카탈로그의 예
다음 명령은 클러스터에 카탈로그를 추가합니다.
명령 구문
oc apply -f <catalog_name>.yaml
$ oc apply -f <catalog_name>.yaml
- 1
redhat-operators.yaml
과 같은 카탈로그 CR을 지정합니다.
7.3.4. 보안 레지스트리에서 호스팅되는 카탈로그의 풀 시크릿 생성 링크 복사링크가 클립보드에 복사되었습니다!
registry.redhat.io
의 Red Hat 제공 Operator 카탈로그와 같은 보안 레지스트리에서 호스팅되는 카탈로그를 사용하려면 openshift-catalogd
네임스페이스에 풀 시크릿 범위가 지정되어야 합니다.
현재 catalogd는 OpenShift Container Platform 클러스터에서 글로벌 풀 시크릿을 읽을 수 없습니다. Catalogd는 배포된 네임스페이스에서만 보안에 대한 참조를 읽을 수 있습니다.
사전 요구 사항
- 보안 레지스트리의 로그인 인증 정보
- 워크스테이션에 Docker 또는 Podman이 설치되어 있어야 합니다.
프로세스
보안 레지스트리에 대한 로그인 인증 정보가 있는
.dockercfg
파일이 이미 있는 경우 다음 명령을 실행하여 가져오기 보안을 생성합니다.oc create secret generic <pull_secret_name> \ --from-file=.dockercfg=<file_path>/.dockercfg \ --type=kubernetes.io/dockercfg \ --namespace=openshift-catalogd
$ oc create secret generic <pull_secret_name> \ --from-file=.dockercfg=<file_path>/.dockercfg \ --type=kubernetes.io/dockercfg \ --namespace=openshift-catalogd
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.1. 명령 예
oc create secret generic redhat-cred \ --from-file=.dockercfg=/home/<username>/.dockercfg \ --type=kubernetes.io/dockercfg \ --namespace=openshift-catalogd
$ oc create secret generic redhat-cred \ --from-file=.dockercfg=/home/<username>/.dockercfg \ --type=kubernetes.io/dockercfg \ --namespace=openshift-catalogd
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 보안 레지스트리의 로그인 인증 정보가 있는
$HOME/.docker/config.json
파일이 이미 있는 경우 다음 명령을 실행하여 풀 시크릿을 생성합니다.oc create secret generic <pull_secret_name> \ --from-file=.dockerconfigjson=<file_path>/.docker/config.json \ --type=kubernetes.io/dockerconfigjson \ --namespace=openshift-catalogd
$ oc create secret generic <pull_secret_name> \ --from-file=.dockerconfigjson=<file_path>/.docker/config.json \ --type=kubernetes.io/dockerconfigjson \ --namespace=openshift-catalogd
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.2. 명령 예
oc create secret generic redhat-cred \ --from-file=.dockerconfigjson=/home/<username>/.docker/config.json \ --type=kubernetes.io/dockerconfigjson \ --namespace=openshift-catalogd
$ oc create secret generic redhat-cred \ --from-file=.dockerconfigjson=/home/<username>/.docker/config.json \ --type=kubernetes.io/dockerconfigjson \ --namespace=openshift-catalogd
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 보안 레지스트리에 대한 로그인 인증 정보가 있는 Docker 구성 파일이 없는 경우 다음 명령을 실행하여 가져오기 보안을 생성합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.3. 명령 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.5. 클러스터에 카탈로그 추가 링크 복사링크가 클립보드에 복사되었습니다!
클러스터에 카탈로그를 추가하려면 카탈로그 CR(사용자 정의 리소스)을 생성하여 클러스터에 적용합니다.
사전 요구 사항
registry.redhat.io
의 Red Hat 제공 Operator 카탈로그와 같은 보안 레지스트리에서 호스팅되는 카탈로그를 사용하려면openshift-catalogd
네임스페이스에 풀 시크릿 범위가 지정되어야 합니다. 자세한 내용은 "보안 레지스트리에서 호스팅되는 카탈로그의 풀 시크릿 생성"을 참조하십시오.
프로세스
다음 예와 유사한 카탈로그 CR(사용자 정의 리소스)을 생성합니다.
예:
redhat-operators.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 클러스터에 카탈로그를 추가합니다.
oc apply -f redhat-operators.yaml
$ oc apply -f redhat-operators.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
catalog.catalogd.operatorframework.io/redhat-operators created
catalog.catalogd.operatorframework.io/redhat-operators created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 카탈로그 상태를 확인합니다.
다음 명령을 실행하여 카탈로그를 사용할 수 있는지 확인합니다.
oc get catalog
$ oc get catalog
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME AGE redhat-operators 20s
NAME AGE redhat-operators 20s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 카탈로그의 상태를 확인합니다.
oc describe catalog
$ oc describe catalog
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.6. 카탈로그에서 설치할 Operator 찾기 링크 복사링크가 클립보드에 복사되었습니다!
클러스터에 카탈로그를 추가한 후 카탈로그를 쿼리하여 설치할 Operator 및 확장을 찾을 수 있습니다. 카탈로그를 쿼리하려면 먼저 카탈로그 서버 서비스를 전달하도록 포트해야 합니다.
사전 요구 사항
- 클러스터에 카탈로그를 추가했습니다.
-
jq
CLI 툴을 설치했습니다.
프로세스
포트 다음 명령을 실행하여
openshift-catalogd
네임스페이스에서 카탈로그 서버 서비스를 전달합니다.oc -n openshift-catalogd port-forward svc/catalogd-catalogserver 8080:80
$ oc -n openshift-catalogd port-forward svc/catalogd-catalogserver 8080:80
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 카탈로그의 JSON 파일을 로컬로 다운로드합니다.
curl -L http://localhost:8080/catalogs/<catalog_name>/all.json \ -C - -o /<path>/<catalog_name>.json -C - -o /<path>/<catalog_name>.json
$ curl -L http://localhost:8080/catalogs/<catalog_name>/all.json \ -C - -o /<path>/<catalog_name>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.4. 명령 예
curl -L http://localhost:8080/catalogs/redhat-operators/all.json \ -C - -o /home/username/catalogs/rhoc.json -C - -o /home/username/catalogs/rhoc.json
$ curl -L http://localhost:8080/catalogs/redhat-operators/all.json \ -C - -o /home/username/catalogs/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령 중 하나를 실행하여 카탈로그의 Operator 및 확장 목록을 반환합니다.
include:snippets/olmv1-tp-extension-support.adoc[]
다음 명령을 실행하여 로컬 카탈로그 파일에서 모든 Operator 및 확장 프로그램 목록을 가져옵니다.
jq -s '.[] | select(.schema == "olm.package") | .name' \ /<path>/<filename>.json
$ jq -s '.[] | select(.schema == "olm.package") | .name' \ /<path>/<filename>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.5. 명령 예
jq -s '.[] | select(.schema == "olm.package") | .name' \ /home/username/catalogs/rhoc.json
$ jq -s '.[] | select(.schema == "olm.package") | .name' \ /home/username/catalogs/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.6. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow AllNamespaces
설치 모드를 지원하는 패키지 목록을 가져오고 다음 명령을 실행하여 로컬 카탈로그 파일의 Webhook를 사용하지 않습니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.7. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
다음 명령을 실행하여 Operator 또는 확장의 메타데이터 콘텐츠를 검사합니다.
jq -s '.[] | select( .schema == "olm.package") | \ select( .name == "<package_name>")' /<path>/<catalog_name>.json
$ jq -s '.[] | select( .schema == "olm.package") | \ select( .name == "<package_name>")' /<path>/<catalog_name>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.8. 명령 예
jq -s '.[] | select( .schema == "olm.package") | \ select( .name == "openshift-pipelines-operator-rh")' \ /home/username/rhoc.json
$ jq -s '.[] | select( .schema == "olm.package") | \ select( .name == "openshift-pipelines-operator-rh")' \ /home/username/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.9. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.6.1. 공통 카탈로그 쿼리 링크 복사링크가 클립보드에 복사되었습니다!
jq
CLI 툴을 사용하여 카탈로그를 쿼리할 수 있습니다.
쿼리 | 요청 |
---|---|
카탈로그에서 사용 가능한 패키지 |
jq -s '.[] | select( .schema == "olm.package") | \ .name' <catalog_name>.json
|
|
|
패키지 메타데이터 |
jq -s '.[] | select( .schema == "olm.package") | \ select( .name == "<package_name>")' <catalog_name>.json
|
패키지의 카탈로그 Blob |
jq -s '.[] | select( .package == "<package_name>")' \ <catalog_name>.json
|
쿼리 | 요청 |
---|---|
패키지의 채널 |
jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "<package_name>") | .name' \ <catalog_name>.json
|
채널의 버전 |
jq -s '.[] | select( .package == "<package_name>" ) | \ select( .schema == "olm.channel" ) | \ select( .name == "<channel_name>" ) | \ .entries | .[] | .name' <catalog_name>.json
|
|
jq -s '.[] | select( .schema == "olm.channel" ) | \ select ( .name == "<channel>") | \ select( .package == "<package_name>")' \ <catalog_name>.json
|
쿼리 | 요청 |
---|---|
패키지의 번들 |
jq -s '.[] | select( .schema == "olm.bundle" ) | \ select( .package == "<package_name>") | .name' \ <catalog_name>.json
|
|
jq -s '.[] | select( .schema == "olm.bundle" ) | \ select ( .name == "<bundle_name>") | \ select( .package == "<package_name>")' \ <catalog_name>.json
|
7.3.7. 카탈로그에서 클러스터 확장 설치 링크 복사링크가 클립보드에 복사되었습니다!
OLM(Operator Lifecycle Manager) 1.0은 클러스터 범위인 registry+v1
번들 형식을 통해 레거시 OLM Operator를 포함하여 클러스터 확장 설치를 지원합니다. CR(사용자 정의 리소스)을 생성하고 클러스터에 적용하여 카탈로그에서 확장을 설치할 수 있습니다.
OLM 1.0은 종속성 확인을 지원하지 않습니다. 확장이 다른 API 또는 패키지에 대한 종속성을 선언하는 경우 확장을 설치하기 전에 클러스터에 종속 항목이 있어야 합니다.
현재 OLM 1.0에서는 다음 기준을 충족하는 확장 기능을 설치할 수 있습니다.
-
확장에서는
AllNamespaces
설치 모드를 사용해야 합니다. - 확장에서는 Webhook를 사용하지 않아야 합니다.
Webhook를 사용하거나 단일 또는 지정된 네임스페이스 집합을 대상으로 하는 클러스터 확장은 설치할 수 없습니다.
사전 요구 사항
- 클러스터에 카탈로그를 추가했습니다.
- 카탈로그 파일의 로컬 사본을 다운로드했습니다.
-
jq
CLI 툴을 설치했습니다.
프로세스
다음 단계를 완료하여 카탈로그 파일의 로컬 사본에서 채널 및 버전 정보에 대한 패키지를 검사합니다.
다음 명령을 실행하여 선택한 패키지에서 채널 목록을 가져옵니다.
jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "<package_name>") | \ .name' /<path>/<catalog_name>.json
$ jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "<package_name>") | \ .name' /<path>/<catalog_name>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.10. 명령 예
jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "openshift-pipelines-operator-rh") | \ .name' /home/username/rhoc.json
$ jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "openshift-pipelines-operator-rh") | \ .name' /home/username/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.11. 출력 예
"latest" "pipelines-1.11" "pipelines-1.12" "pipelines-1.13" "pipelines-1.14"
"latest" "pipelines-1.11" "pipelines-1.12" "pipelines-1.13" "pipelines-1.14"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 채널에 게시된 버전 목록을 가져옵니다.
jq -s '.[] | select( .package == "<package_name>" ) | \ select( .schema == "olm.channel" ) | \ select( .name == "<channel_name>" ) | .entries | \ .[] | .name' /<path>/<catalog_name>.json
$ jq -s '.[] | select( .package == "<package_name>" ) | \ select( .schema == "olm.channel" ) | \ select( .name == "<channel_name>" ) | .entries | \ .[] | .name' /<path>/<catalog_name>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.12. 명령 예
jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \ select( .schema == "olm.channel" ) | select( .name == "latest" ) | \ .entries | .[] | .name' /home/username/rhoc.json
$ jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \ select( .schema == "olm.channel" ) | select( .name == "latest" ) | \ .entries | .[] | .name' /home/username/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.13. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
새 네임스페이스에 확장을 설치하려면 다음 명령을 실행합니다.
oc adm new-project <new_namespace>
$ oc adm new-project <new_namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예와 유사한 CR을 생성합니다.
pipelines-operator.yaml
CR의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
<namespace>
-
openshift-operators
또는my-extension
와 같이 번들을 설치할 네임스페이스를 지정합니다. 확장 기능은 여전히 클러스터 범위이며 다른 네임스페이스에 설치된 리소스가 포함될 수 있습니다. <channel>
-
선택 사항: 설치 또는 업데이트하려는 패키지에 대해
pipelines-1.11
또는latest
와 같은 채널을 지정합니다. <version>
선택 사항: 설치 또는 업데이트하려는 패키지의
1.11.1
,1.12.x
또는 >=1.12.1
과 같은 버전 범위를 지정합니다. 자세한 내용은 "대상 버전을 지정하는 CR(사용자 정의 리소스) 예" 및 "버전 범위에 대한 지원"을 참조하십시오.중요고유한 이름이 없는 Operator 또는 확장을 설치하려고 하면 설치에 실패하거나 예기치 않은 결과가 발생할 수 있습니다. 이는 다음과 같은 이유로 발생합니다.
- mulitple 카탈로그가 클러스터에 설치된 경우 OLM(Operator Lifecycle Manager) 1.0에는 Operator 또는 확장을 설치할 때 카탈로그를 지정하는 메커니즘이 포함되지 않습니다.
- OLM 1.0에서는 클러스터에 설치할 수 있는 모든 Operator 및 확장을 해당 번들 및 패키지에 고유한 이름을 사용해야 합니다.
다음 명령을 실행하여 클러스터에 CR을 적용합니다.
oc apply -f pipeline-operator.yaml
$ oc apply -f pipeline-operator.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
clusterextension.olm.operatorframework.io/pipelines-operator created
clusterextension.olm.operatorframework.io/pipelines-operator created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 Operator 또는 확장의 CR을 YAML 형식으로 표시합니다.
oc get clusterextension pipelines-operator -o yaml
$ oc get clusterextension pipelines-operator -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.14. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
spec.channel
- 확장의 CR에 정의된 채널을 표시합니다.
spec.version
- 확장의 CR에 정의된 버전 또는 버전 범위를 표시합니다.
status.conditions
- 확장의 상태 및 상태에 대한 정보를 표시합니다.
유형: 더 이상 사용되지 않음
다음 중 하나 이상이 더 이상 사용되지 않는지 여부를 표시합니다.
유형: PackageDeprecated
- 해결된 패키지가 더 이상 사용되지 않는지 여부를 표시합니다.
유형: ChannelDeprecated
- 해결된 채널이 더 이상 사용되지 않는지 여부를 표시합니다.
유형: BundleDeprecated
- 해결된 번들이 더 이상 사용되지 않는지 여부를 표시합니다.
status
필드의False
값은reason: 더 이상 사용되지 않는 조건이 더 이상
사용되지 않음을 나타냅니다.status
필드의True
값은reason: 더 이상 사용되지 않는 조건이 더 이상 사용되지
않음을 나타냅니다.installedBundle.name
- 설치된 번들의 이름을 표시합니다.
installedBundle.version
- 설치된 번들의 버전을 표시합니다.
resolvedBundle.name
- 확인된 번들의 이름을 표시합니다.
resolvedBundle.version
- 해결된 번들의 verson을 표시합니다.
다음 명령을 실행하여 번들 배포에 대한 정보를 가져옵니다.
oc get bundleDeployment pipelines-operator -o yaml
$ oc get bundleDeployment pipelines-operator -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.15. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.8. 클러스터 확장 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
CR(사용자 정의 리소스)을 수동으로 편집하고 변경 사항을 적용하여 클러스터 확장 또는 Operator를 업데이트할 수 있습니다.
사전 요구 사항
- 카탈로그가 설치되어 있어야 합니다.
- 카탈로그 파일의 로컬 사본을 다운로드했습니다.
- Operator 또는 확장이 설치되어 있어야 합니다.
-
jq
CLI 툴을 설치했습니다.
프로세스
다음 단계를 완료하여 카탈로그 파일의 로컬 사본에서 채널 및 버전 정보에 대한 패키지를 검사합니다.
다음 명령을 실행하여 선택한 패키지에서 채널 목록을 가져옵니다.
jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "<package_name>") | \ .name' /<path>/<catalog_name>.json
$ jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "<package_name>") | \ .name' /<path>/<catalog_name>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.16. 명령 예
jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "openshift-pipelines-operator-rh") | \ .name' /home/username/rhoc.json
$ jq -s '.[] | select( .schema == "olm.channel" ) | \ select( .package == "openshift-pipelines-operator-rh") | \ .name' /home/username/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.17. 출력 예
"latest" "pipelines-1.11" "pipelines-1.12" "pipelines-1.13" "pipelines-1.14"
"latest" "pipelines-1.11" "pipelines-1.12" "pipelines-1.13" "pipelines-1.14"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 채널에 게시된 버전 목록을 가져옵니다.
jq -s '.[] | select( .package == "<package_name>" ) | \ select( .schema == "olm.channel" ) | \ select( .name == "<channel_name>" ) | .entries | \ .[] | .name' /<path>/<catalog_name>.json
$ jq -s '.[] | select( .package == "<package_name>" ) | \ select( .schema == "olm.channel" ) | \ select( .name == "<channel_name>" ) | .entries | \ .[] | .name' /<path>/<catalog_name>.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.18. 명령 예
jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \ select( .schema == "olm.channel" ) | select( .name == "latest" ) | \ .entries | .[] | .name' /home/username/rhoc.json
$ jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \ select( .schema == "olm.channel" ) | select( .name == "latest" ) | \ .entries | .[] | .name' /home/username/rhoc.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.19. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
다음 명령을 실행하여 Operator 또는 확장의 CR에 지정된 버전 또는 채널을 확인합니다.
oc get clusterextension <operator_name> -o yaml
$ oc get clusterextension <operator_name> -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 명령 예
oc get clusterextension pipelines-operator -o yaml
$ oc get clusterextension pipelines-operator -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.20. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 방법 중 하나를 사용하여 CR을 편집합니다.
Operator 또는 확장을
1.12.1
과 같은 특정 버전으로 고정하려면 다음 예와 유사한 CR을 편집합니다.pipelines-operator.yaml
CR의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 버전
1.11.1
에서1.12.1
로 업데이트
허용 가능한 업데이트 버전의 범위를 정의하려면 다음 예와 유사한 CR을 편집합니다.
버전 범위가 지정된 CR의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 원하는 버전 범위가 버전
1.11.1
보다 크고1.13
보다 작도록 지정합니다. 자세한 내용은 "버전 범위 지원" 및 "버전 비교 문자열"을 참조하십시오.
채널에서 확인할 수 있는 최신 버전으로 업데이트하려면 다음 예제와 유사한 CR을 편집합니다.
지정된 채널이 있는 CR의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 지정된 채널에서 확인할 수 있는 최신 릴리스를 설치합니다. 채널 업데이트가 자동으로 설치됩니다.
채널 및 버전 범위를 지정하려면 다음 예와 유사한 CR을 편집합니다.
지정된 채널 및 버전 범위가 있는 CR의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 자세한 내용은 "대상 버전을 지정하는 CR(사용자 정의 리소스) 예"를 참조하십시오.
다음 명령을 실행하여 클러스터에 업데이트를 적용합니다.
oc apply -f pipelines-operator.yaml
$ oc apply -f pipelines-operator.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
clusterextension.olm.operatorframework.io/pipelines-operator configured
clusterextension.olm.operatorframework.io/pipelines-operator configured
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 작은 정보다음 명령을 실행하여 CLI에서 CR을 패치하고 적용할 수 있습니다.
oc patch clusterextension/pipelines-operator -p \ '{"spec":{"version":"<1.13"}}' \ --type=merge
$ oc patch clusterextension/pipelines-operator -p \ '{"spec":{"version":"<1.13"}}' \ --type=merge
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
clusterextension.olm.operatorframework.io/pipelines-operator patched
clusterextension.olm.operatorframework.io/pipelines-operator patched
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 채널 및 버전 업데이트가 적용되었는지 확인합니다.
oc get clusterextension pipelines-operator -o yaml
$ oc get clusterextension pipelines-operator -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.21. 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
문제 해결
더 이상 사용되지 않거나 존재하지 않는 대상 버전 또는 채널을 지정하는 경우 다음 명령을 실행하여 확장 상태를 확인할 수 있습니다.
oc get clusterextension <operator_name> -o yaml
$ oc get clusterextension <operator_name> -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예 7.22. 존재하지 않는 버전의 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.9. 업그레이드 제약 조건 의미 링크 복사링크가 클립보드에 복사되었습니다!
설치된 클러스터 확장에 대한 업그레이드 에지를 결정할 때 OLM(Operator Lifecycle Manager) 1.0은 OpenShift Container Platform 4.16에서 시작하는 레거시 OLM 의미 체계를 지원합니다. 이 지원은 몇 가지 차이점이 있지만 대체
,건너뛰기,
동작을 따릅니다.
skipRange
지시문을 포함하여 레거시 OLM의
OLM 1.0은 레거시 OLM 의미 체계를 지원하여 카탈로그의 업그레이드 그래프를 정확하게 준수합니다.
원래의 기존 OLM 구현의 차이점
가능한 여러 successor가 있는 경우 OLM 1.0 동작은 다음과 같은 방식으로 다릅니다.
- 기존 OLM에서는 채널 헤드에 가장 가까운 후속 항목이 선택됩니다.
- OLM 1.0에서 의미 체계(semver)가 가장 높은 후속 버전이 선택됩니다.
다음 파일 기반 카탈로그(FBC) 채널 항목을 고려하십시오.
# ... - name: example.v3.0.0 skips: ["example.v2.0.0"] - name: example.v2.0.0 skipRange: >=1.0.0 <2.0.0
# ... - name: example.v3.0.0 skips: ["example.v2.0.0"] - name: example.v2.0.0 skipRange: >=1.0.0 <2.0.0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 1.0.0
이 설치된 경우 OLM 1.0 동작은 다음과 같은 방식으로 다릅니다.-
v2.0.0
을 건너뛰고대체
체인에 있지 않기 때문에 레거시 OLM에는v2.0.0
으로의 업그레이드 엣지가 표시되지 않습니다. -
OLM 1.0에는
대체
체인의 개념이 없으므로 OLM 1.0에 업그레이드 엣지가 표시됩니다. OLM 1.0은 현재 설치된 버전을 처리하는replace
,skip
또는skipRange
값이 있는 모든 항목을 찾습니다.
-
이 기술 프리뷰 단계에서 레거시 OLM 의미 체계를 선호하기 위해 OpenShift Container Platform 4.15에서는 시맨틱 버전 관리(semver) 업그레이드 제한에 대한 지원이 도입되었지만 4.16에서는 비활성화되어 있습니다.
7.3.9.1. 버전 범위 지원 링크 복사링크가 클립보드에 복사되었습니다!
OLM(Operator Lifecycle Manager) 1.0에서는 Operator 또는 확장의 CR(사용자 정의 리소스)에서 비교 문자열을 사용하여 버전 범위를 지정할 수 있습니다. CR에 버전 범위를 지정하는 경우 OLM 1.0은 버전 범위 내에서 해결할 수 있는 최신 버전의 Operator를 설치하거나 업데이트합니다.
해결된 버전 워크플로
- 해결된 버전은 Operator 및 환경의 제약 조건을 충족하는 최신 버전의 Operator입니다.
- 지정된 범위 내의 Operator 업데이트가 성공적으로 확인되면 자동으로 설치됩니다.
- 지정된 범위를 벗어나거나 성공적으로 해결할 수 없는 경우 업데이트가 설치되지 않습니다.
7.3.9.2. 버전 비교 문자열 링크 복사링크가 클립보드에 복사되었습니다!
Operator 또는 확장의 CR(사용자 정의 리소스)의 spec.version
필드에 비교 문자열을 추가하여 버전 범위를 정의할 수 있습니다. 비교 문자열은 공백 또는 쉼표로 구분된 값 목록과 큰따옴표("
)로 묶인 하나 이상의 비교 연산자입니다. OR 또는 double vertical bar ( || ) 비교 연산자를 포함 하 여 다른 비교 문자열을 추가할 수 있습니다.You can add another comparison string by including an OR
, or double vertical bar (||
), comparison operator between the strings.
비교 연산자 | 정의 |
---|---|
| 동일 |
| 같지 않음 |
| 보다 큼 |
| 보다 작음 |
| 크거나 같음 |
| 작거나 같음 |
다음 예와 유사한 범위 비교를 사용하여 Operator 또는 확장의 CR에서 버전 범위를 지정할 수 있습니다.
버전 범위 비교 예
모든 유형의 비교 문자열에 와일드카드 문자를 사용할 수 있습니다. OLM 1.0에서는 x
,X
및 별표(*
)를 와일드카드 문자로 허용합니다. 등호(=
) 비교 연산자와 함께 와일드카드 문자를 사용하는 경우 패치 또는 마이너 버전 수준에서 비교를 정의합니다.
와일드카드 비교 | 일치하는 문자열 |
---|---|
|
|
|
|
|
|
|
|
틸드(~
) 비교 연산자를 사용하여 패치 릴리스 비교를 수행할 수 있습니다. 패치 릴리스 비교에서는 다음 주요 버전까지 마이너 버전을 지정합니다.
패치 릴리스 비교 | 일치하는 문자열 |
---|---|
|
|
|
|
|
|
|
|
|
|
caret(^
) 비교 연산자를 사용하여 주요 릴리스를 비교할 수 있습니다. 첫 번째 안정적인 릴리스가 게시되기 전에 주요 릴리스 비교를 수행하는 경우 마이너 버전은 API의 안정성 수준을 정의합니다. 의미 체계 버전 관리 (semver) 사양에서 첫 번째 안정적인 릴리스는 1.0.0
버전으로 게시됩니다.
주요 릴리스 비교 | 일치하는 문자열 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7.3.9.3. 대상 버전을 지정하는 CR(사용자 정의 리소스)의 예 링크 복사링크가 클립보드에 복사되었습니다!
OLM(Operator Lifecycle Manager) 1.0에서 클러스터 관리자는 사용자 정의 리소스(CR)에서 Operator 또는 확장의 대상 버전을 선언적으로 설정할 수 있습니다.
다음 필드 중 하나를 지정하여 대상 버전을 정의할 수 있습니다.
- 채널
- 버전 번호
- 버전 범위
CR에 채널을 지정하면 OLM 1.0은 지정된 채널 내에서 해결할 수 있는 최신 버전의 Operator 또는 확장 버전을 설치합니다. 지정된 채널에 업데이트가 게시되면 OLM 1.0이 채널에서 확인할 수 있는 최신 릴리스로 자동으로 업데이트됩니다.
지정된 채널이 있는 CR의 예
- 1
- 지정된 채널에서 확인할 수 있는 최신 릴리스를 설치합니다. 채널 업데이트가 자동으로 설치됩니다.
CR에서 Operator 또는 확장의 대상 버전을 지정하면 OLM 1.0이 지정된 버전을 설치합니다. 대상 버전이 CR에 지정되면 업데이트가 카탈로그에 게시될 때 OLM 1.0에서 대상 버전이 변경되지 않습니다.
클러스터에 설치된 Operator 버전을 업데이트하려면 Operator의 CR을 수동으로 편집해야 합니다. Operator의 대상 버전을 지정하면 Operator 버전이 지정된 릴리스에 고정됩니다.
대상 버전이 지정된 CR의 예
- 1
- 대상 버전을 지정합니다. 설치된 Operator 또는 확장 버전을 업데이트하려면 CR을 원하는 대상 버전으로 수동으로 업데이트해야 합니다.
Operator 또는 확장에 허용되는 다양한 버전을 정의하려면 비교 문자열을 사용하여 버전 범위를 지정할 수 있습니다. 버전 범위를 지정하면 OLM 1.0은 Operator 컨트롤러가 해결할 수 있는 Operator 또는 확장의 최신 버전을 설치합니다.
버전 범위가 지정된 CR의 예
- 1
- 원하는 버전 범위가 버전
1.11.1
보다 크도록 지정합니다. 자세한 내용은 "버전 범위 지원"을 참조하십시오.
CR을 생성하거나 업데이트한 후 다음 명령을 실행하여 구성 파일을 적용합니다.
명령 구문
oc apply -f <extension_name>.yaml
$ oc apply -f <extension_name>.yaml
7.3.9.4. 업데이트 또는 롤백 강제 적용 링크 복사링크가 클립보드에 복사되었습니다!
OLM 1.0은 다음 주요 버전 또는 롤백에 대한 자동 업데이트를 이전 버전으로 지원하지 않습니다. 주요 버전 업데이트 또는 롤백을 수행하려면 수동으로 업데이트를 확인하고 강제 적용해야 합니다.
수동 업데이트 또는 롤백을 강제 적용하는 결과를 확인해야 합니다. 강제 업데이트 또는 롤백을 확인하지 않으면 데이터 손실과 같은 심각한 결과가 발생할 수 있습니다.
사전 요구 사항
- 카탈로그가 설치되어 있어야 합니다.
- Operator 또는 확장이 설치되어 있어야 합니다.
프로세스
다음 예와 같이 Operator 또는 확장의 CR(사용자 정의 리소스)을 편집합니다.
CR 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 Operator 또는 extensions CR에 변경 사항을 적용합니다.
oc apply -f <extension_name>.yaml
$ oc apply -f <extension_name>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.10. Operator 삭제 링크 복사링크가 클립보드에 복사되었습니다!
ClusterExtension
CR(사용자 정의 리소스)을 삭제하여 Operator 및 해당 CRD(사용자 정의 리소스 정의)를 삭제할 수 있습니다.
사전 요구 사항
- 카탈로그가 설치되어 있어야 합니다.
- Operator가 설치되어 있어야 합니다.
프로세스
다음 명령을 실행하여 Operator 및 해당 CRD를 삭제합니다.
oc delete clusterextension <operator_name>
$ oc delete clusterextension <operator_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
clusterextension.olm.operatorframework.io "<operator_name>" deleted
clusterextension.olm.operatorframework.io "<operator_name>" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 Operator 및 해당 리소스가 삭제되었는지 확인합니다.
다음 명령을 실행하여 Operator가 삭제되었는지 확인합니다.
oc get clusterextensions
$ oc get clusterextensions
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
No resources found
No resources found
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 Operator의 시스템 네임스페이스가 삭제되었는지 확인합니다.
oc get ns <operator_name>-system
$ oc get ns <operator_name>-system
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Error from server (NotFound): namespaces "<operator_name>-system" not found
Error from server (NotFound): namespaces "<operator_name>-system" not found
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3.11. 카탈로그 삭제 링크 복사링크가 클립보드에 복사되었습니다!
CR(사용자 정의 리소스)을 삭제하여 카탈로그를 삭제할 수 있습니다.
사전 요구 사항
- 카탈로그가 설치되어 있어야 합니다.
프로세스
다음 명령을 실행하여 카탈로그를 삭제합니다.
oc delete catalog <catalog_name>
$ oc delete catalog <catalog_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
catalog.catalogd.operatorframework.io "my-catalog" deleted
catalog.catalogd.operatorframework.io "my-catalog" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 카탈로그가 삭제되었는지 확인합니다.
oc get catalog
$ oc get catalog
Copy to Clipboard Copied! Toggle word wrap Toggle overflow