15.4. GitOps ZTP를 사용하여 단일 노드 OpenShift 클러스터에 대한 이미지 기반 업그레이드 수행

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 YAML 파일을 생성합니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors: 1
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke1
         - spoke4
         - spoke6
     ibuSpec:
       seedImageRef: 2
         image: quay.io/seed/image:4.16.0-rc.1
         version: 4.16.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
     extraManifests: 3
       - name: example-extra-manifests
         namespace: openshift-lifecycle-agent
     oadpContent: 4
       - name: oadp-cm
         namespace: openshift-adp
     plan: 5
     - actions: ["Prep"]
       rolloutStrategy:
         maxConcurrency: 2
         timeout: 2400

   1

   업그레이드할 클러스터입니다.

   2

   대상 플랫폼 버전, 사용할 시드 이미지, 이미지에 액세스하는 데 필요한 시크릿입니다.

   3

   선택 사항: 시드 이미지에 없는 추가 매니페스트를 대상 클러스터에 적용합니다. 사용자 정의 카탈로그 소스에 ConfigMap 오브젝트도 적용합니다.

   4

   OADP Backup 및 Restore CR이 포함된 ConfigMap 리소스 목록입니다.

   5

   업그레이드 계획 세부 정보.

2. hub 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

3. hub 클러스터에서 다음 명령을 실행하여 상태 업데이트를 모니터링합니다.

   $ oc get ibgu -o yaml

   출력 예

   # ...
   status:
     clusters:
     - completedActions:
       - action: Prep
       name: spoke1
     - completedActions:
       - action: Prep
       name: spoke4
     - failedActions:
       - action: Prep
       name: spoke6
   # ...

   예제 계획의 이전 출력은 Prep 단계에서만 시작되고 이전 단계의 결과에 따라 계획에 작업을 추가합니다. TALM은 업그레이드가 성공하거나 실패했는지 표시하는 레이블을 클러스터에 추가합니다. 예를 들어 lcm.openshift.io/ibgu-prep-failed 가 Prep 단계에 실패한 클러스터에 적용됩니다.

   실패를 조사한 후 업그레이드 계획에 AbortOnFailure 단계를 추가할 수 있습니다. lcm.openshift.io/ibgu-<action >으로 레이블이 지정된 클러스터를 Idle 단계로 다시 이동합니다. 선택한 클러스터의 업그레이드와 관련된 모든 리소스가 삭제됩니다.

4. 선택 사항: 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 AbortOnFailure 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["AbortOnFailure"], "rolloutStrategy": {"maxConcurrency": 5, "timeout": 10}}}]'

   1. 다음 명령을 실행하여 상태 업데이트를 계속 모니터링합니다.

      $ oc get ibgu -o yaml

5. 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["Upgrade"], "rolloutStrategy": {"maxConcurrency": 2, "timeout": 30}}}]'

6. 선택 사항: 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 AbortOnFailure 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["AbortOnFailure"], "rolloutStrategy": {"maxConcurrency": 5, "timeout": 10}}}]'

   1. 다음 명령을 실행하여 상태 업데이트를 계속 모니터링합니다.

      $ oc get ibgu -o yaml

7. 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["FinalizeUpgrade"], "rolloutStrategy": {"maxConcurrency": 10, "timeout": 3}}}]'

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 YAML 파일을 생성합니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors: 1
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke1
         - spoke4
         - spoke6
     ibuSpec:
       seedImageRef: 2
         image: quay.io/seed/image:4.17.0-rc.1
         version: 4.17.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
       extraManifests: 3
         - name: example-extra-manifests
           namespace: openshift-lifecycle-agent
       oadpContent: 4
         - name: oadp-cm
           namespace: openshift-adp
     plan: 5
     - actions: ["Prep", "Upgrade", "FinalizeUpgrade"]
       rolloutStrategy:
         maxConcurrency: 200 6
         timeout: 2400 7

   1

   업그레이드할 클러스터입니다.

   2

   대상 플랫폼 버전, 사용할 시드 이미지, 이미지에 액세스하는 데 필요한 시크릿입니다.

   3

   선택 사항: 시드 이미지에 없는 추가 매니페스트를 대상 클러스터에 적용합니다. 사용자 정의 카탈로그 소스에 ConfigMap 오브젝트도 적용합니다.

   4

   OADP Backup 및 Restore CR이 포함된 ConfigMap 리소스입니다.

   5

   업그레이드 계획 세부 정보.

   6

   일괄로 업데이트할 클러스터 수입니다.

   7

   작업을 완료하는 시간 제한(분)입니다.

2. hub 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 별도의 YAML 파일을 생성합니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors:
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke4
     ibuSpec:
       seedImageRef:
         image: quay.io/seed/image:4.16.0-rc.1
         version: 4.16.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
     extraManifests:
       - name: example-extra-manifests
         namespace: openshift-lifecycle-agent
     oadpContent:
       - name: oadp-cm
         namespace: openshift-adp
     plan:
     - actions: ["Abort"]
       rolloutStrategy:
         maxConcurrency: 5
         timeout: 10

   Prep 단계를 완료한 모든 관리형 클러스터는 Idle 단계로 다시 이동합니다.

2. hub 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 별도의 YAML 파일을 생성합니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors:
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke4
     ibuSpec:
       seedImageRef:
         image: quay.io/seed/image:4.17.0-rc.1
         version: 4.17.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
     extraManifests:
       - name: example-extra-manifests
         namespace: openshift-lifecycle-agent
     oadpContent:
       - name: oadp-cm
         namespace: openshift-adp
     plan:
     - actions: ["Rollback", "FinalizeRollback"]
       rolloutStrategy:
         maxConcurrency: 200
         timeout: 2400

2. hub 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

   정의된 라벨과 일치하는 모든 관리형 클러스터는 롤백 으로 다시 이동한 다음 Idle 단계를 수행하여 롤백을 완료합니다.