3.7. 다중 아키텍처 컴퓨팅 시스템을 사용하여 클러스터로 마이그레이션

프로세스

1. 다음 명령을 실행하여 CVO(Cluster Version Operator)에서 RetrievedUpdates 조건이 True 인지 확인합니다.

   $ oc get clusterversion/version -o=jsonpath="{.status.conditions[?(.type=='RetrievedUpdates')].status}"

   Copy to Clipboard Toggle word wrap

   RetrievedUpates 조건이 False 인 경우 다음 명령을 사용하여 실패에 대한 추가 정보를 찾을 수 있습니다.

   $ oc adm upgrade

   Copy to Clipboard Toggle word wrap

   클러스터 버전 조건 유형에 대한 자세한 내용은 클러스터 버전 조건 유형 이해 를 참조하십시오.

2. RetrievedUpdates 조건이 False 인 경우 다음 명령을 사용하여 채널을 stable-<4.y > 또는 fast-<4.y >로 변경합니다.

   $ oc adm upgrade channel <channel>

   Copy to Clipboard Toggle word wrap

   채널을 설정한 후 RetrievedUpdates 가 True 인지 확인합니다.

   채널에 대한 자세한 내용은 업데이트 채널 및 릴리스 이해 를 참조하십시오.

3. 다음 명령을 사용하여 다중 아키텍처 페이로드로 마이그레이션합니다.

   $ oc adm upgrade --to-multi-arch

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 실행하여 컨트롤 플레인 노드의 아키텍처를 확인합니다.

   $ oc get nodes -o wide

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                          STATUS   ROLES                  AGE    VERSION   INTERNAL-IP EXTERNAL-IP   OS-IMAGE                                         KERNEL-VERSION                 CONTAINER-RUNTIME
   worker-001.example.com        Ready    worker                 100d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   worker-002.example.com        Ready    worker                 98d    v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   worker-003.example.com        Ready    worker                 98d    v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-001.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-002.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-003.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x

   Copy to Clipboard Toggle word wrap

   출력의 KERNEL-VERSION 필드에는 노드의 아키텍처가 표시됩니다.

2. 다음 명령을 실행하여 클러스터가 멀티 페이로드를 사용하는지 확인합니다.

   $ oc adm release info -o jsonpath="{ .metadata.metadata}"

   Copy to Clipboard Toggle word wrap

   다음 출력이 표시되면 클러스터가 다중 아키텍처와 호환됩니다.

   {
    "release.openshift.io/architecture": "multi",
    "url": "https://access.redhat.com/errata/<errata_version>"
   }

   Copy to Clipboard Toggle word wrap

   클러스터에서 다중 페이로드를 사용하지 않는 경우 클러스터를 다중 아키텍처 클러스터로 마이그레이션합니다. 자세한 내용은 "다중 아키텍처 컴퓨팅 머신이 있는 클러스터로 마이그레이션"을 참조하십시오.

3. 다음 명령을 실행하여 단일 아키텍처에서 다중 아키텍처로 이미지 스트림을 업데이트합니다.

   $ oc import-image <multiarch_image_stream_tag>  --from=<registry>/<project_name>/<image_name> \
   --import-mode='PreserveOriginal'

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 컨트롤 플레인 머신 세트를 구성하기 위해 arm64 호환 Amazon Machine Image (AMI)를 가져옵니다.

   $ oc get configmap/coreos-bootimages -n openshift-machine-config-operator -o jsonpath='{.data.stream}' | jq -r '.architectures.aarch64.images.aws.regions."<aws_region>".image' 

   1

   Copy to Clipboard Toggle word wrap

   1

   & lt;aws_region& gt;을 현재 클러스터가 설치된 AWS 리전으로 바꿉니다. 다음 명령을 실행하여 설치된 클러스터의 AWS 리전을 가져올 수 있습니다.

   $ oc get infrastructure cluster -o jsonpath='{.status.platformStatus.aws.region}'

   Copy to Clipboard Toggle word wrap

   출력 예

   ami-xxxxxxx

   Copy to Clipboard Toggle word wrap

5. 다음 명령을 실행하여 arm64 아키텍처를 지원하도록 컨트롤 플레인 머신 세트를 업데이트합니다.

   $ oc edit controlplanemachineset.machine.openshift.io cluster -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   instanceType 필드를 arm64 아키텍처를 지원하는 유형으로 업데이트하고 ami.id 필드를 arm64 아키텍처와 호환되는 AMI로 설정합니다. 지원되는 인스턴스 유형에 대한 자세한 내용은 "64비트 ARM 인프라에서 AWS 테스트 인스턴스 유형"을 참조하십시오.

   AWS의 컨트롤 플레인 머신 세트 구성에 대한 자세한 내용은 "Amazon Web Services의 컨트롤 플레인 구성 옵션"을 참조하십시오.

프로세스

1. 다음 명령을 실행하여 컨트롤 플레인 또는 인프라 노드의 아키텍처를 확인합니다.

   $ oc get nodes -o wide

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                          STATUS   ROLES                  AGE    VERSION   INTERNAL-IP EXTERNAL-IP   OS-IMAGE                                         KERNEL-VERSION                 CONTAINER-RUNTIME
   worker-001.example.com        Ready    infra                 100d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x
   master-001.example.com        Ready    control-plane,master   120d   v1.30.7   10.x.x.x    <none>        Red Hat Enterprise Linux CoreOS 4xx.xx.xxxxx-0   5.x.x-xxx.x.x.el9_xx.x86_64    cri-o://1.30.x

   Copy to Clipboard Toggle word wrap

   출력의 KERNEL-VERSION 필드에는 노드의 아키텍처가 표시됩니다.

2. 다음 명령을 실행하여 클러스터가 멀티 페이로드를 사용하는지 확인합니다.

   $ oc adm release info -o jsonpath="{ .metadata.metadata}"

   Copy to Clipboard Toggle word wrap

   다음 출력이 표시되면 클러스터가 다중 아키텍처와 호환됩니다.

   {
    "release.openshift.io/architecture": "multi",
    "url": "https://access.redhat.com/errata/<errata_version>"
   }

   Copy to Clipboard Toggle word wrap

   클러스터에서 다중 페이로드를 사용하지 않는 경우 클러스터를 다중 아키텍처 클러스터로 마이그레이션합니다. 자세한 내용은 "다중 아키텍처 컴퓨팅 머신이 있는 클러스터로 마이그레이션"을 참조하십시오.

3. 사용자 지정 이미지 스트림을 사용하는 경우 각 이미지 스트림에 대해 다음 명령을 실행하여 단일 아키텍처에서 다중 아키텍처로 업데이트합니다.

   $ oc import-image <multiarch_image_stream_tag>  --from=<registry>/<project_name>/<image_name> \
   --import-mode='PreserveOriginal'

   Copy to Clipboard Toggle word wrap
4. Compute 엔진의 범용 시스템 제품군 (Google 문서)에서 대상 아키텍처와 일치하는 인스턴스 유형을 선택합니다. 사용 가능한 리전 및 영역 테이블(Google 문서)을 확인하여 해당 영역에서 인스턴스 유형이 지원되는지 확인합니다.
5. Compute 엔진(Google 문서)용 범용 머신 제품군의 "지원된 디스크 유형" 섹션에서 선택한 인스턴스 유형에 대해 지원되는 디스크 유형을 선택합니다.

6. 다음 명령을 실행하여 머신 세트가 마이그레이션 후 사용하는 Google Cloud 이미지를 확인합니다.

   $ oc get configmap/coreos-bootimages \
     -n openshift-machine-config-operator \
     -o jsonpath='{.data.stream}' | jq \
     -r '.architectures.aarch64.images.gcp'

   Copy to Clipboard Toggle word wrap

   출력 예

   "gcp": {
       "release": "415.92.202309142014-0",
       "project": "rhcos-cloud",
       "name": "rhcos-415-92-202309142014-0-gcp-aarch64"
     }

   Copy to Clipboard Toggle word wrap

   출력의 project 및 name 매개변수를 사용하여 projects/<project>/global/images/<name> 형식으로 이미지 매개변수를 만듭니다.

7. 컨트롤 플레인을 다른 아키텍처로 마이그레이션하려면 다음 명령을 실행합니다.

   $ oc edit controlplanemachineset.machine.openshift.io cluster -n openshift-machine-api

   Copy to Clipboard Toggle word wrap
   1. disks.type 매개변수를 선택한 디스크 유형으로 바꿉니다.
   2. disks.image 매개변수를 이전에 설정한 image 매개변수로 바꿉니다.
   3. machineType 매개변수를 선택한 인스턴스 유형으로 바꿉니다.

8. 인프라 머신 세트를 다른 아키텍처로 마이그레이션하려면 인프라 머신 세트의 ID를 사용하여 다음 명령을 실행합니다.

   $ oc edit machineset <infra-machine-set_id> -n openshift-machine-api

   Copy to Clipboard Toggle word wrap
   1. disks.type 매개변수를 선택한 디스크 유형으로 바꿉니다.
   2. disks.image 매개변수를 이전에 설정한 image 매개변수로 바꿉니다.
   3. machineType 매개변수를 선택한 인스턴스 유형으로 바꿉니다.