11.2.2.2. 클러스터 API를 사용하도록 머신 API 리소스 마이그레이션
개별 머신 API 객체를 동등한 클러스터 API 객체로 마이그레이션할 수 있습니다.
클러스터 API를 사용하도록 머신 API 리소스를 마이그레이션하는 것은 기술 미리 보기 기능에 불과합니다. 기술 미리 보기 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
사전 요구 사항
- 지원되는 인프라 유형에 OpenShift Container Platform 클러스터를 배포했습니다.
- 클러스터 API 사용을 활성화했습니다.
-
TechPreviewNoUpgrade기능 세트에서MachineAPIMigration기능 게이트를 활성화했습니다. -
cluster-admin권한이 있는 계정을 사용하여 ROSA 클러스터에 액세스할 수 있습니다. -
OpenShift CLI(
oc)가 설치되어 있습니다.
프로세스
다음 명령을 실행하여 클러스터 API 리소스로 마이그레이션하려는 머신 API 리소스를 식별합니다.
$ oc get <resource_kind> -n openshift-machine-api여기서
<resource_kind>는 다음 값 중 하나입니다.machine.machine.openshift.io- 컴퓨팅 또는 제어 평면 머신의 리소스 종류의 정규화된 이름입니다.
machineset.machine.openshift.io- 컴퓨팅 머신 세트의 리소스 종류의 정규화된 이름입니다.
다음 명령을 실행하여 리소스 사양을 편집합니다.
$ oc edit <resource_kind>/<resource_name> -n openshift-machine-api다음과 같습니다.
<resource_kind>-
machine.machine.openshift.io를사용하여 컴퓨팅 머신을 지정하거나machineset.machine.openshift.io를 사용하여 컴퓨팅 머신 세트를 지정합니다. <resource_name>- 클러스터 API 리소스로 마이그레이션하려는 머신 API 리소스의 이름을 지정합니다.
리소스 사양에서
spec.authoritativeAPI필드의 값을 업데이트합니다.apiVersion: machine.openshift.io/v1beta1 kind: <resource_kind> metadata: name: <resource_name> [...] spec: authoritativeAPI: ClusterAPI [...] status: authoritativeAPI: MachineAPI [...]다음과 같습니다.
kind-
마이그레이션할 리소스의 리소스 유형을 지정합니다. 예를 들어, 컴퓨팅 머신 세트의 리소스 종류는
MachineSet이고 컴퓨팅 머신의 리소스 종류는Machine입니다. metadata.name- 마이그레이션할 리소스의 이름을 지정합니다.
spec.authoritativeAPI-
이 리소스를 사용할 권한 있는 API를 지정합니다. 예를 들어, Machine API 리소스를 Cluster API로 마이그레이션하려면
ClusterAPI를지정합니다. status.authoritativeAPI- 현재 권한 있는 API의 값을 지정합니다. 이 값은 현재 어떤 API가 이 리소스를 관리하는지 나타냅니다. 이 사양의 이 부분에 있는 값은 변경하지 마세요.
중요spec.authoritativeAPI필드의 값을 업데이트할 때 다른 값은 변경하지 마십시오. 다른 컨트롤러에서spec.authoritativeAPI필드 업데이트를 처리하기 전에 다른 컨트롤러에서 다른 값으로 업데이트를 처리할 수 있으므로 다른 값을 변경하면 예기치 않은 동작이 발생할 수 있습니다.자세한 내용은 "리소스 구성을 변경할 때 예기치 않은 동작"을 참조하십시오.
검증
다음 명령을 실행하여 변환 상태를 확인하세요.
$ oc -n openshift-machine-api get <resource_kind>/<resource_name> -o json | jq .status.authoritativeAPI다음과 같습니다.
<resource_kind>-
machine.machine.openshift.io를사용하여 컴퓨팅 머신을 지정하거나machineset.machine.openshift.io를 사용하여 컴퓨팅 머신 세트를 지정합니다. <resource_name>- 클러스터 API 리소스로 마이그레이션하려는 머신 API 리소스의 이름을 지정합니다.
-
변환이 진행되는 동안 이 명령은
Migrating값을 반환합니다. 이 값이 오랫동안 지속되면openshift-cluster-api네임스페이스에서cluster-capi-operator배포에 대한 로그를 확인하여 자세한 정보를 얻고 잠재적인 문제를 파악하세요. -
변환이 완료되면 이 명령은
ClusterAPI값을 반환합니다.
- 리소스 구성을 변경할 때 예기치 않은 동작