11.2.2.2. 클러스터 API를 사용하도록 머신 API 리소스 마이그레이션


개별 Machine API 오브젝트를 동등한 Cluster API 오브젝트로 마이그레이션할 수 있습니다.

중요

클러스터 API를 사용하도록 머신 API 리소스를 마이그레이션하는 것은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

  • 지원되는 인프라 유형에 OpenShift Container Platform 클러스터를 배포했습니다.
  • 클러스터 API 사용을 활성화했습니다.
  • TechPreviewNoUpgrade 기능 세트에서 MachineAPIMigration 기능 게이트를 활성화했습니다.
  • cluster-admin 권한이 있는 계정을 사용하여 클러스터에 액세스할 수 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.

프로세스

  1. 다음 명령을 실행하여 클러스터 API 리소스로 마이그레이션할 Machine API 리소스를 식별합니다.

    $ oc get <resource_kind> -n openshift-machine-api

    여기서 <resource_kind >는 다음 값 중 하나입니다.

    machine.machine.openshift.io
    컴퓨팅 또는 컨트롤 플레인 시스템에 대한 리소스 종류의 정규화된 이름입니다.
    machineset.machine.openshift.io
    컴퓨팅 머신 세트의 리소스 유형의 정규화된 이름입니다.
  2. 다음 명령을 실행하여 리소스 사양을 편집합니다.

    $ oc edit <resource_kind>/<resource_name> -n openshift-machine-api

    다음과 같습니다.

    <resource_kind>
    machineset.machine.openshift.io 를 사용하여 machine.machine.openshift.io 또는 컴퓨팅 머신 세트를 사용하여 컴퓨팅 머신을 지정합니다.
    <resource_name>
    Cluster API 리소스로 마이그레이션할 Machine API 리소스의 이름을 지정합니다.
  3. 리소스 사양에서 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 리소스를 클러스터 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>
    machineset.machine.openshift.io 를 사용하여 machine.machine.openshift.io 또는 컴퓨팅 머신 세트를 사용하여 컴퓨팅 머신을 지정합니다.
    <resource_name>
    Cluster API 리소스로 마이그레이션할 Machine API 리소스의 이름을 지정합니다.
    • 변환이 진행되는 동안 이 명령은 Migrating 값을 반환합니다. 이 값이 장기간 지속되는 경우 openshift-cluster-api 네임스페이스에서 cluster-capi-operator 배포의 로그를 확인하고 잠재적인 문제를 확인합니다.
    • 변환이 완료되면 이 명령은 ClusterAPI 값을 반환합니다.
  • 리소스 구성을 변경할 때 예기치 않은 동작
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동