Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

13.2. 클러스터 API 시작하기

중요

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

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

Cluster API 기술 프리뷰의 경우 Cluster API에 수동으로 필요한 기본 리소스를 생성해야 합니다.

13.2.1. Cluster API 기본 리소스 생성
링크 복사

Cluster API 기본 리소스를 생성하려면 클러스터 리소스 매니페스트에서 < cluster_name > 매개변수에 사용하는 클러스터 ID 값을 가져와야 합니다.

13.2.1.1. 클러스터 ID 값 가져오기
링크 복사

OpenShift CLI(oc)를 사용하여 클러스터 ID 값을 찾을 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 클러스터를 배포했습니다.
  • cluster-admin 권한이 있는 계정을 사용하여 클러스터에 액세스할 수 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.

프로세스

  • 다음 명령을 실행하여 클러스터 ID의 값을 가져옵니다. 

    $  oc get infrastructure cluster \
   -o jsonpath='{.status.infrastructureName}'
    Copy to Clipboard Toggle word wrap

YAML 매니페스트 파일을 생성하고 OpenShift CLI(oc)로 적용하여 Cluster API 기본 리소스를 수동으로 생성할 수 있습니다.

13.2.1.2. Cluster API 클러스터 리소스 생성
링크 복사

YAML 매니페스트 파일을 생성하고 OpenShift CLI(oc)로 적용하여 클러스터 리소스를 생성할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 클러스터를 배포했습니다.
  • 클러스터 API 사용을 활성화했습니다.
  • cluster-admin 권한이 있는 계정을 사용하여 클러스터에 액세스할 수 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • 클러스터 ID 값이 있습니다.

프로세스

  1. 다음과 유사한 YAML 파일을 생성합니다. 이 절차에서는 & lt;cluster_resource_file>.yaml 을 예제 파일 이름으로 사용합니다. 

    apiVersion: cluster.x-k8s.io/v1beta1
kind: Cluster
metadata:
  name: <cluster_name>
    1 
    
  namespace: openshift-cluster-api
spec:
  infrastructureRef:
    apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
    kind: <infrastructure_kind>
    2 
    
    name: <cluster_name>
    namespace: openshift-cluster-api
    Copy to Clipboard Toggle word wrap
    1
    클러스터 ID를 클러스터 이름으로 지정합니다.
    2
    클러스터의 인프라 유형을 지정합니다. 다음 값이 유효합니다.
    Expand
    클러스터 클라우드 공급자현재의

    AWS(Amazon Web Services)

    AWSCluster

    Google Cloud

    GCPCluster

    Red Hat OpenStack Platform (RHOSP)

    OpenStackCluster

    VMware vSphere

    VSphereCluster

  2. 다음 명령을 실행하여 클러스터 CR을 생성합니다. 

    $ oc create -f <cluster_resource_file>.yaml
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 클러스터 CR이 있는지 확인합니다. 

    $ oc get cluster
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME             PHASE          AGE    VERSION
<cluster_name>   Provisioning   4h6m
    Copy to Clipboard Toggle word wrap

    PHASE 값이 프로비저닝 되면 클러스터 리소스가 준비됩니다.

13.2.1.3. 클러스터 API 인프라 리소스 생성
링크 복사

YAML 매니페스트 파일을 생성하고 OpenShift CLI(oc)로 적용하여 공급자별 인프라 리소스를 생성할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 클러스터를 배포했습니다.
  • 클러스터 API 사용을 활성화했습니다.
  • cluster-admin 권한이 있는 계정을 사용하여 클러스터에 액세스할 수 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • 클러스터 ID 값이 있습니다.
  • 클러스터 리소스를 생성하고 적용했습니다.

프로세스

  1. 다음과 유사한 YAML 파일을 생성합니다. 이 절차에서는 & lt;infrastructure_resource_file>.yaml 을 예제 파일 이름으로 사용합니다. 

    apiVersion: infrastructure.cluster.x-k8s.io/<version>
    1 
    
kind: <infrastructure_kind>
    2 
    
metadata:
  name: <cluster_name>
    3 
    
  namespace: openshift-cluster-api
spec:
    4
    Copy to Clipboard Toggle word wrap
    1
    apiVersion 은 플랫폼에 따라 다릅니다. 자세한 내용은 공급자의 샘플 Cluster API 인프라 리소스 YAML을 참조하십시오. 다음 값이 유효합니다.
    • infrastructure.cluster.x-k8s.io/v1beta2: AWS(Amazon Web Services) 클러스터가 사용하는 버전입니다.
    • infrastructure.cluster.x-k8s.io/v1beta1: Google Cloud, RHOSP(Red Hat OpenStack Platform) 및 VMware vSphere 클러스터가 사용하는 버전입니다.
    2
    클러스터의 인프라 유형을 지정합니다. 이 값은 플랫폼의 값과 일치해야 합니다. 다음 값이 유효합니다.
    Expand
    클러스터 클라우드 공급자현재의

    AWS(Amazon Web Services)

    AWSCluster

    Google Cloud

    GCPCluster

    Red Hat OpenStack Platform (RHOSP)

    OpenStackCluster

    VMware vSphere

    VSphereCluster

    3
    클러스터 이름을 지정합니다.
    4
    환경에 대한 세부 정보를 지정합니다. 이러한 매개변수는 공급자별로 다릅니다. 자세한 내용은 공급자의 샘플 Cluster API 인프라 리소스 YAML을 참조하십시오.

  2. 다음 명령을 실행하여 인프라 CR을 생성합니다. 

    $ oc create -f <infrastructure_resource_file>.yaml
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 인프라 CR이 생성되었는지 확인합니다. 

    $ oc get <infrastructure_kind>
    Copy to Clipboard Toggle word wrap

    여기서 <infrastructure_kind>는 플랫폼에 해당하는 값입니다.

    출력 예

    NAME             CLUSTER          READY
<cluster_name>   <cluster_name>   true
    Copy to Clipboard Toggle word wrap

    참고

    이 출력에는 클라우드 공급자와 관련된 추가 열이 포함될 수 있습니다.

13.2.1.4. 클러스터 API 머신 템플릿 생성
링크 복사

YAML 매니페스트 파일을 생성하고 OpenShift CLI(oc)로 적용하여 공급자별 머신 템플릿 리소스를 생성할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 클러스터를 배포했습니다.
  • 클러스터 API 사용을 활성화했습니다.
  • cluster-admin 권한이 있는 계정을 사용하여 클러스터에 액세스할 수 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • 클러스터 및 인프라 리소스를 생성하고 적용했습니다.

프로세스

  1. 다음과 유사한 YAML 파일을 생성합니다. 이 절차에서는 & lt;machine_template_resource_file>.yaml 을 예제 파일 이름으로 사용합니다. 

    apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: <machine_template_kind>
    1 
    
metadata:
  name: <template_name>
    2 
    
  namespace: openshift-cluster-api
spec:
  template:
    spec:
    3
    Copy to Clipboard Toggle word wrap
    1
    머신 템플릿 유형을 지정합니다. 이 값은 플랫폼의 값과 일치해야 합니다. 다음 값이 유효합니다.
    Expand
    클러스터 클라우드 공급자현재의

    AWS(Amazon Web Services)

    AWSMachineTemplate

    Google Cloud

    GCPMachineTemplate

    Red Hat OpenStack Platform (RHOSP)

    OpenStackMachineTemplate

    VMware vSphere

    VSphereMachineTemplate

    2
    머신 템플릿의 이름을 지정합니다.
    3
    환경에 대한 세부 정보를 지정합니다. 이러한 매개변수는 공급자별로 다릅니다. 자세한 내용은 공급자의 샘플 Cluster API 머신 템플릿 YAML을 참조하십시오.

  2. 다음 명령을 실행하여 머신 템플릿 CR을 생성합니다. 

    $ oc create -f <machine_template_resource_file>.yaml
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 머신 템플릿 CR이 생성되었는지 확인합니다. 

    $ oc get <machine_template_kind>
    Copy to Clipboard Toggle word wrap

    여기서 <machine_template_kind >는 플랫폼에 해당하는 값입니다.

    출력 예

    NAME              AGE
<template_name>   77m
    Copy to Clipboard Toggle word wrap

13.2.1.5. 클러스터 API 컴퓨팅 머신 세트 생성
링크 복사

Cluster API를 사용하여 선택한 특정 워크로드에 대한 머신 컴퓨팅 리소스를 동적으로 관리하는 컴퓨팅 머신 세트를 생성할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 클러스터를 배포했습니다.
  • 클러스터 API 사용을 활성화했습니다.
  • cluster-admin 권한이 있는 계정을 사용하여 클러스터에 액세스할 수 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • 클러스터, 인프라 및 머신 템플릿 리소스를 생성했습니다.

프로세스

  1. 다음과 유사한 YAML 파일을 생성합니다. 이 절차에서는 & lt;machine_set_resource_file>.yaml 을 예제 파일 이름으로 사용합니다. 

    apiVersion: cluster.x-k8s.io/v1beta1
kind: MachineSet
metadata:
  name: <machine_set_name>
    1 
    
  namespace: openshift-cluster-api
spec:
  clusterName: <cluster_name>
    2 
    
  replicas: 1
  selector:
    matchLabels:
      test: example
  template:
    metadata:
      labels:
        test: example
    spec:
    3 
    
# ...
    Copy to Clipboard Toggle word wrap
    1
    컴퓨팅 머신 세트의 이름을 지정합니다.
    2
    클러스터 이름을 지정합니다.
    3
    환경에 대한 세부 정보를 지정합니다. 이러한 매개변수는 공급자별로 다릅니다. 자세한 내용은 공급자의 샘플 Cluster API 컴퓨팅 머신 세트 YAML을 참조하십시오.

  2. 다음 명령을 실행하여 컴퓨팅 머신 세트 CR을 생성합니다. 

    $ oc create -f <machine_set_resource_file>.yaml
    Copy to Clipboard Toggle word wrap

  3. 다음 명령을 실행하여 컴퓨팅 머신 세트 CR이 생성되었는지 확인합니다. 

    $ oc get machineset -n openshift-cluster-api
    1
    Copy to Clipboard Toggle word wrap
    1
    openshift-cluster-api 네임스페이스를 지정합니다.

    출력 예

    NAME                 CLUSTER          REPLICAS   READY   AVAILABLE   AGE   VERSION
<machine_set_name>   <cluster_name>   1          1       1           17m
    Copy to Clipboard Toggle word wrap

    새 컴퓨팅 머신 세트가 사용 가능한 경우 REPLICAS 및 AVAILABLE 값이 일치합니다. 컴퓨팅 머신 세트를 사용할 수 없는 경우 몇 분 기다렸다가 명령을 다시 실행합니다.

검증

  • 컴퓨팅 머신 세트가 필수 구성에 따라 시스템을 생성하고 있는지 확인하려면 다음 명령을 실행하여 클러스터의 시스템 및 노드 목록을 검토합니다.

    • 클러스터 API 머신 목록을 확인합니다. 

      $ oc get machine -n openshift-cluster-api
      1
      Copy to Clipboard Toggle word wrap
      1
      openshift-cluster-api 네임스페이스를 지정합니다.

      출력 예

      NAME                             CLUSTER          NODENAME                                 PROVIDERID      PHASE     AGE     VERSION
<machine_set_name>-<string_id>   <cluster_name>   <ip_address>.<region>.compute.internal   <provider_id>   Running   8m23s
      Copy to Clipboard Toggle word wrap

    • 노드 목록을 확인합니다. 

      $ oc get node
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                                       STATUS   ROLES    AGE     VERSION
<ip_address_1>.<region>.compute.internal   Ready    worker   5h14m   v1.28.5
<ip_address_2>.<region>.compute.internal   Ready    master   5h19m   v1.28.5
<ip_address_3>.<region>.compute.internal   Ready    worker   7m      v1.28.5
      Copy to Clipboard Toggle word wrap

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat