7.3.8. Operator 업데이트

프로세스

1. 다음 단계를 완료하여 카탈로그 파일의 로컬 사본에서 채널 및 버전 정보에 대한 패키지를 검사합니다.

   1. 다음 명령을 실행하여 선택한 패키지에서 채널 목록을 가져옵니다.

      $ jq -s '.[] | select( .schema == "olm.channel" ) | \
        select( .package == "<package_name>") | \
        .name' /<path>/<catalog_name>.json

      예 7.16. 명령 예

      $ jq -s '.[] | select( .schema == "olm.channel" ) | \
        select( .package == "openshift-pipelines-operator-rh") | \
        .name' /home/username/rhoc.json

      예 7.17. 출력 예

      "latest"
      "pipelines-1.11"
      "pipelines-1.12"
      "pipelines-1.13"

   2. 다음 명령을 실행하여 채널에 게시된 버전 목록을 가져옵니다.

      $ jq -s '.[] | select( .package == "<package_name>" ) | \
        select( .schema == "olm.channel" ) | \
        select( .name == "<channel_name>" ) | .entries | \
        .[] | .name' /<path>/<catalog_name>.json

      예 7.18. 명령 예

      $ jq -s '.[] | select( .package == "openshift-pipelines-operator-rh" ) | \
      select( .schema == "olm.channel" ) | select( .name == "latest" ) | \
      .entries | .[] | .name' /home/username/rhoc.json

      예 7.19. 출력 예

      "openshift-pipelines-operator-rh.v1.11.1"
      "openshift-pipelines-operator-rh.v1.12.0"
      "openshift-pipelines-operator-rh.v1.12.1"
      "openshift-pipelines-operator-rh.v1.12.2"
      "openshift-pipelines-operator-rh.v1.13.0"
      "openshift-pipelines-operator-rh.v1.13.1"

2. 다음 명령을 실행하여 Operator 또는 확장의 CR에 지정된 버전 또는 채널을 확인합니다.

   $ oc get operator.operators.operatorframework.io <operator_name> -o yaml

   명령 예

   $ oc get operator.operators.operatorframework.io pipelines-operator -o yaml

   예 7.20. 출력 예

   apiVersion: operators.operatorframework.io/v1alpha1
   kind: Operator
   metadata:
     annotations:
       kubectl.kubernetes.io/last-applied-configuration: |  {"apiVersion":"operators.operatorframework.io/v1alpha1","kind":"Operator","metadata":{"annotations":{},"name":"pipelines-operator"},"spec":{"channel":"latest","packageName":"openshift-pipelines-operator-rh","version":"1.11.1"}}
     creationTimestamp: "2024-02-06T17:47:15Z"
     generation: 2
     name: pipelines-operator
     resourceVersion: "84528"
     uid: dffe2c89-b9c4-427e-b694-ada0b37fc0a9
   spec:
     channel: latest 

   1

   
     packageName: openshift-pipelines-operator-rh
     upgradeConstraintPolicy: Enforce
     version: 1.11.1 

   2

   
   status:
     conditions:
     - lastTransitionTime: "2024-02-06T17:47:21Z"
       message: bundledeployment status is unknown
       observedGeneration: 2
       reason: InstallationStatusUnknown
       status: Unknown
       type: Installed
     - lastTransitionTime: "2024-02-06T17:50:58Z"
       message: resolved to "registry.redhat.io/openshift-pipelines/pipelines-operator-bundle@sha256:e09d37bb1e754db42324fd18c1cb3e7ce77e7b7fcbf4932d0535391579938280"
       observedGeneration: 2
       reason: Success
       status: "True"
       type: Resolved
     resolvedBundleResource: registry.redhat.io/openshift-pipelines/pipelines-operator-bundle@sha256:e09d37bb1e754db42324fd18c1cb3e7ce77e7b7fcbf4932d0535391579938280

   1

   Operator 또는 확장의 채널을 지정합니다.

   2

   Operator 또는 확장의 버전 범위를 지정합니다.

   참고

   채널을 지정하거나 Operator 또는 확장의 CR에 버전 범위를 정의하면 OLM 1.0에 클러스터에 설치된 확인된 버전이 표시되지 않습니다. CR에 지정된 버전 및 채널 정보만 표시됩니다.

   설치된 특정 버전을 찾으려면 spec.source.image.ref 필드의 SHA를 카탈로그의 이미지 참조와 비교해야 합니다.

3. 다음 방법 중 하나를 사용하여 CR을 편집합니다.

   • Operator 또는 확장을 1.12.1 과 같은 특정 버전으로 고정하려면 다음 예와 유사한 CR을 편집합니다.

     pipelines-operator.yaml CR의 예

     apiVersion: operators.operatorframework.io/v1alpha1
     kind: Operator
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       version: 1.12.1 

     1

     1

     버전 1.11.1 에서 1.12.1로 업데이트

   • 허용 가능한 업데이트 버전의 범위를 정의하려면 다음 예와 유사한 CR을 편집합니다.

     버전 범위가 지정된 CR의 예

     apiVersion: operators.operatorframework.io/v1alpha1
     kind: Operator
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       version: ">1.11.1, <1.13" 

     1

     1

     원하는 버전 범위가 버전 1.11.1 보다 크고 1.13 보다 작도록 지정합니다. 자세한 내용은 "버전 범위 지원" 및 "버전 비교 문자열"을 참조하십시오.

   • 채널에서 확인할 수 있는 최신 버전으로 업데이트하려면 다음 예제와 유사한 CR을 편집합니다.

     지정된 채널이 있는 CR의 예

     apiVersion: operators.operatorframework.io/v1alpha1
     kind: Operator
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       channel: pipelines-1.13 

     1

     1

     지정된 채널에서 확인할 수 있는 최신 릴리스를 설치합니다. 채널 업데이트가 자동으로 설치됩니다.

   • 채널 및 버전 범위를 지정하려면 다음 예와 유사한 CR을 편집합니다.

     지정된 채널 및 버전 범위가 있는 CR의 예

     apiVersion: operators.operatorframework.io/v1alpha1
     kind: Operator
     metadata:
       name: pipelines-operator
     spec:
       packageName: openshift-pipelines-operator-rh
       channel: latest
       version: "<1.13"

     자세한 내용은 "대상 버전을 지정하는 CR(사용자 정의 리소스) 예"를 참조하십시오.

4. 다음 명령을 실행하여 클러스터에 업데이트를 적용합니다.

   $ oc apply -f pipelines-operator.yaml

   출력 예

   operator.operators.operatorframework.io/pipelines-operator configured

   작은 정보

   다음 명령을 실행하여 CLI에서 CR을 패치하고 적용할 수 있습니다.

   $ oc patch operator.operators.operatorframework.io/pipelines-operator -p \
     '{"spec":{"version":"1.12.1"}}' \
     --type=merge

   출력 예

   operator.operators.operatorframework.io/pipelines-operator patched