3.3. CLI를 사용하여 클러스터 업데이트

프로세스

1. 클러스터를 사용할 수 있는지 확인합니다.

   $ oc get clusterversion
   
   NAME      VERSION   AVAILABLE   PROGRESSING   SINCE   STATUS
   version   4.5.0     True        False         158m    Cluster version is 4.5.0

2. 현재 업데이트 채널 정보를 확인하고 채널이 stable-4.5로 설정되어 있는지 확인합니다.

   $ oc get clusterversion -o json|jq ".items[0].spec"
   
   {
     "channel": "stable-4.5",
     "clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff",
     "upstream": "https://api.openshift.com/api/upgrades_info/v1/graph"
   }

   중요

   프로덕션 클러스터의 경우 stable-* 채널에 가입해야합니다.

3. 사용 가능한 업데이트를 확인하고 적용하려는 업데이트의 버전 번호를 기록해 둡니다.

   $ oc adm upgrade
   
   Cluster version is 4.1.0
   
   Updates:
   
   VERSION IMAGE
   4.1.2   quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b

4. 업데이트를 적용합니다.

   • 최신 버전으로 업데이트하려면 다음을 수행합니다.

     $ oc adm upgrade --to-latest=true 1

   • 특정 버전으로 업데이트하려면 다음을 수행합니다.

     $ oc adm upgrade --to=<version> 1

     1 1

     <version>은 이전 명령의 출력에서 얻을 수 있는 업데이트 버전입니다.

5. 클러스터 버전 Operator의 상태를 확인합니다.

   $ oc get clusterversion -o json|jq ".items[0].spec"
   
   {
     "channel": "stable-4.5",
     "clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff",
     "desiredUpdate": {
       "force": false,
       "image": "quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b",
       "version": "4.5.0" 1
     },
     "upstream": "https://api.openshift.com/api/upgrades_info/v1/graph"
   }

   1

   desiredUpdate 부분의 version 번호가 지정한 값과 일치하는 경우 업데이트가 진행 중입니다.

6. 클러스터 버전 상태 기록에서 업데이트 상태를 모니터링합니다. 모든 개체가 업데이트를 완료하는 데 시간이 걸릴 수 있습니다.

   $ oc get clusterversion -o json|jq ".items[0].status.history"
   
   [
     {
       "completionTime": null,
       "image": "quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b",
       "startedTime": "2019-06-19T20:30:50Z",
       "state": "Partial",
       "verified": true,
       "version": "4.1.2"
     },
     {
       "completionTime": "2019-06-19T20:30:50Z",
       "image": "quay.io/openshift-release-dev/ocp-release@sha256:b8307ac0f3ec4ac86c3f3b52846425205022da52c16f56ec31cbe428501001d6",
       "startedTime": "2019-06-19T17:38:10Z",
       "state": "Completed",
       "verified": false,
       "version": "4.1.0"
     }
   ]

   기록에는 클러스터에 적용된 최신 버전 목록이 포함되어 있습니다. 이 값은 CVO가 업데이트를 적용할 때 업데이트됩니다. 목록은 날짜순으로 정렬되며 최신 업데이트가 목록의 맨 처음에 표시됩니다. 롤아웃이 완료되면 기록의 업데이트 상태는 Completed로 표시되고 업데이트가 실패하거나 완료되지 않은 경우 Partial로표시됩니다.

   중요

   업그레이드가 실패하면 Operator가 중지하고 실패한 구성 요소의 상태를 보고합니다. 클러스터를 이전 버전으로 롤백하는 것은 지원되지 않습니다. 업그레이드에 실패할 경우 Red Hat 지원에 문의하십시오.

7. 업데이트가 완료되면 클러스터 버전이 새 버전으로 업데이트되었는지 확인합니다.

   $ oc get clusterversion
   
   NAME      VERSION     AVAILABLE   PROGRESSING   SINCE     STATUS
   version   4.5.0       True        False         2m        Cluster version is 4.5.0