9.3. OpenShift Update Service를 사용하여 연결이 끊긴 환경에서 클러스터 업데이트

프로세스

1. 웹 콘솔에서 Operator OperatorHub를 클릭합니다.

   참고

   Update 서비스를 Filter by keyword…​에 입력합니다. Operator를 더 빠르게 찾을 수 있는 필드입니다.

2. 사용 가능한 Operator 목록에서 OpenShift Update Service를 선택한 다음 설치를 클릭합니다.

   1. 채널 v1은 이 릴리스에서 사용할 수 있는 유일한 채널이므로 업데이트 채널로 선택됩니다.
   2. 설치 모드에서 클러스터의 특정 네임스페이스를 선택합니다.
   3. 설치된 네임스페이스의 네임스페이스를 선택하거나 권장 네임스페이스 openshift-update-service를 수락합니다.

   4. 승인 전략을 선택합니다.

      • 자동 전략을 사용하면 Operator 새 버전이 준비될 때 OLM(Operator Lifecycle Manager)이 자동으로 Operator를 업데이트할 수 있습니다.
      • 수동 전략을 사용하려면 클러스터 관리자가 Operator 업데이트를 승인해야 합니다.
   5. 설치를 클릭합니다.
3. Operator Installed Operator 페이지로 전환하여 OpenShift Update Service Operator가 설치되었는지 확인합니다.
4. OpenShift Update Service가 선택한 네임스페이스에 성공 상태로 나열되어 있는지 확인합니다.

프로세스

1. OpenShift OpenShift Update Service Operator의 네임스페이스를 생성합니다.

   1. OpenShift Update Service Operator에 대해 Namespace 오브젝트 YAML 파일 (예: update-service-namespace.yaml)을 만듭니다.

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-update-service
        annotations:
          openshift.io/node-selector: ""
        labels:
          openshift.io/cluster-monitoring: "true" 1

      1

      이 네임스페이스에서 Operator가 권장하는 클러스터 모니터링을 사용하도록 하려면 openshift.io/cluster-monitoring 레이블을 설정합니다.

   2. 네임스페이스를 생성합니다.

      $ oc create -f <filename>.yaml

      예를 들면 다음과 같습니다.

      $ oc create -f update-service-namespace.yaml

2. 다음 오브젝트를 생성하여 OpenShift Update Service Operator를 설치합니다.

   1. OperatorGroup 오브젝트 YAML 파일을 만듭니다 (예: update-service-operator-group.yaml).

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: update-service-operator-group
      spec:
        targetNamespaces:
        - openshift-update-service

   2. OperatorGroup 오브젝트를 생성합니다.

      $ oc -n openshift-update-service create -f <filename>.yaml

      예를 들면 다음과 같습니다.

      $ oc -n openshift-update-service create -f update-service-operator-group.yaml

   3. Subscription 오브젝트 YAML 파일(예: update-service-subscription.yaml)을 생성합니다.

      서브스크립션의 예

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: update-service-subscription
      spec:
        channel: v1
        installPlanApproval: "Automatic"
        source: "redhat-operators" 1
        sourceNamespace: "openshift-marketplace"
        name: "cincinnati-operator"

      1

      Operator를 제공하는 카탈로그 소스의 이름을 지정합니다. 사용자 정의 OLM(Operator Lifecycle Manager)을 사용하지 않는 클러스터의 경우 redhat-operators를 지정합니다. OpenShift Container Platform 클러스터가 연결이 끊긴 환경에 설치된 경우 OLM(Operator Lifecycle Manager)을 구성할 때 생성된 CatalogSource 오브젝트의 이름을 지정합니다.

   4. Subscription 오브젝트를 생성합니다.

      $ oc create -f <filename>.yaml

      예를 들면 다음과 같습니다.

      $ oc -n openshift-update-service create -f update-service-subscription.yaml

      OpenShift Update Service Operator는 openshift-update-service 네임스페이스에 설치되고 openshift-update-service 네임스페이스를 대상으로 합니다.

3. Operator 설치를 확인합니다.

   $ oc -n openshift-update-service get clusterserviceversions

   출력 예

   NAME                             DISPLAY                    VERSION   REPLACES   PHASE
   update-service-operator.v4.6.0   OpenShift Update Service   4.6.0                Succeeded
   ...

   OpenShift Update Service Operator가 나열된 경우 설치에 성공한 것입니다. 버전 번호가 표시된 것과 다를 수 있습니다.

프로세스

1. 웹 콘솔에서 Operator Installed Operator를 클릭합니다.
2. 설치된 Operator 목록에서 OpenShift Update Service를 선택합니다.
3. Update Service 탭을 클릭합니다.
4. Create UpdateService를 클릭합니다.
5. Name 필드에 이름을 입력합니다. (예: service)
6. Graph Data Image 필드에 "OpenShift Update Service 그래프 데이터 컨테이너 이미지 생성"에 생성된 graph-data 컨테이너 이미지에 로컬 pullspec을 입력합니다(예: registry.example.com/openshift/graph-data:latest ).
7. Releases 필드에서 "OpenShift Container Platform 이미지 리포지토리 미러링"의 릴리스 이미지를 포함하도록 생성된 로컬 레지스트리 및 리포지토리를 입력합니다(예: registry.example.com/ocp4/openshift4-release-images ).
8. Replicas 필드에 2를 입력합니다.
9. Create를 클릭하여 OpenShift Update Service 애플리케이션을 생성합니다.

10. OpenShift Update Service 애플리케이션 확인

    • Update Service 탭의 UpdateServices 목록에서 방금 만든 업데이트 서비스 애플리케이션을 클릭합니다.
    • Resources 탭을 클릭합니다.
    • 각 애플리케이션 리소스의 상태가 Created인지 확인합니다.

프로세스

1. OpenShift Update Service 대상 네임스페이스를 구성합니다(예: openshift-update-service ).

   $ NAMESPACE=openshift-update-service

   네임스페이스는 Operator 그룹의 targetNamespaces 값과 일치해야 합니다.

2. OpenShift Update Service 애플리케이션의 이름을 구성합니다(예: service ).

   $ NAME=service

3. "OpenShift Container Platform 이미지 리포지토리 미러링"에 구성된 릴리스 이미지의 로컬 레지스트리 및 리포지토리를 구성합니다(예: registry.example.com/ocp4/openshift4-release-images ).

   $ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images

4. graph-data 이미지의 로컬 pullspec 을 "OpenShift Update Service 그래프 데이터 컨테이너 이미지 생성"에서 생성된 graph-data 컨테이너 이미지로 설정합니다(예: registry.example.com/openshift/graph-data:latest ).

   $ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest

5. OpenShift Update Service 애플리케이션 오브젝트를 생성합니다.

   $ oc -n "${NAMESPACE}" create -f - <<EOF
   apiVersion: updateservice.operator.openshift.io/v1
   kind: UpdateService
   metadata:
     name: ${NAME}
   spec:
     replicas: 2
     releases: ${RELEASE_IMAGES}
     graphDataImage: ${GRAPH_DATA_IMAGE}
   EOF

6. OpenShift Update Service 애플리케이션 확인

   1. 다음 명령을 사용하여 정책 엔진 경로를 가져옵니다.

      $ while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done

      명령이 성공할 때까지 폴링해야 할 수도 있습니다.

   2. 정책 엔진에서 그래프를 검색합니다. channel에 유효한 버전을 지정해야 합니다. 예를 들어 OpenShift Container Platform 4.8에서 실행하는 경우 stable-4.8을 사용합니다.

      $ while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done

      이 경우 그래프 요청이 성공할 때까지 폴링되지만 미러링된 릴리스 이미지에 따라 결과 그래프가 비어 있을 수 있습니다.

프로세스

1. 웹 콘솔에서 Operator Installed Operator를 클릭합니다.
2. 설치된 Operator 목록에서 OpenShift Update Service를 선택합니다.
3. Update Service 탭을 클릭합니다.
4. 설치된 OpenShift Update Service 애플리케이션 목록에서 삭제할 애플리케이션을 선택한 다음Delete UpdateService를 클릭합니다.
5. Delete UpdateService? 확인 프롬프트에서 Delete를 클릭하여 삭제를 확인합니다.

프로세스

1. OpenShift Update Service 애플리케이션이 생성된 네임스페이스(예: openshift-update-service)를 사용하여 OpenShift Update Service 애플리케이션 이름을 가져옵니다.

   $ oc get updateservice -n openshift-update-service

   출력 예

   NAME      AGE
   service   6s

2. 이전 단계의 NAME 값과 OpenShift Update Service 애플리케이션이 생성된 네임스페이스(예: openshift-update-service)를 사용하여 OpenShift Update Service 애플리케이션을 삭제합니다.

   $ oc delete updateservice service -n openshift-update-service

   출력 예

   updateservice.updateservice.operator.openshift.io "service" deleted

프로세스

1. 웹 콘솔에서 Operator Installed Operator를 클릭합니다.
2. 설치된 Operator 목록에서 OpenShift Update Service을 선택하고 Uninstall Operator를 클릭합니다.
3. Uninstall Operator? 확인 대화 상자에서 Uninstall를 클릭하고 제거를 확인합니다.

프로세스

1. OpenShift Update Service Operator가 포함된 프로젝트로 변경합니다(예: openshift-update-service ).

   $ oc project openshift-update-service

   출력 예

   Now using project "openshift-update-service" on server "https://example.com:6443".

2. OpenShift Update Service Operator Operator 그룹의 이름을 가져옵니다.

   $ oc get operatorgroup

   출력 예

   NAME                             AGE
   openshift-update-service-fprx2   4m41s

3. operator 그룹을 삭제합니다(예: openshift-update-service-fprx2 ).

   $ oc delete operatorgroup openshift-update-service-fprx2

   출력 예

   operatorgroup.operators.coreos.com "openshift-update-service-fprx2" deleted

4. OpenShift Update Service Operator 서브스크립션의 이름을 가져옵니다.

   $ oc get subscription

   출력 예

   NAME                      PACKAGE                   SOURCE                        CHANNEL
   update-service-operator   update-service-operator   updateservice-index-catalog   v1

5. 이전 단계의 Name 값을 사용하여 currentCSV 필드에서 구독한 OpenShift Update Service Operator의 현재 버전을 확인합니다.

   $ oc get subscription update-service-operator -o yaml | grep " currentCSV"

   출력 예

     currentCSV: update-service-operator.v0.0.1

6. 서브스크립션을 삭제합니다(예: update-service-operator).

   $ oc delete subscription update-service-operator

   출력 예

   subscription.operators.coreos.com "update-service-operator" deleted

7. 이전 단계의 currentCSV 값을 사용하여 OpenShift Update Service Operator의 CSV를 삭제합니다.

   $ oc delete clusterserviceversion update-service-operator.v0.0.1

   출력 예

   clusterserviceversion.operators.coreos.com "update-service-operator.v0.0.1" deleted