13.2. 클러스터 API 시작하기

절차

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

   1

   클러스터 ID를 클러스터 이름으로 지정합니다.

   2

   클러스터의 인프라 종류를 지정합니다. 다음 값이 유효합니다.

   • AWSCluster: 클러스터가 AWS(Amazon Web Services)에서 실행되고 있습니다.
   • GCPCluster: 클러스터가 GCP(Google Cloud Platform)에서 실행되고 있습니다.

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

   $ oc create -f <cluster_resource_file>.yaml

절차

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

   1

   apiVersion 은 플랫폼에 따라 다릅니다. 자세한 내용은 공급자의 샘플 Cluster API 인프라 리소스 YAML을 참조하십시오. 다음 값이 유효합니다.

   • infrastructure.cluster.x-k8s.io/v1beta1: GCP(Google Cloud Platform) 클러스터가 사용하는 버전입니다.
   • infrastructure.cluster.x-k8s.io/v1beta1: AWS(Amazon Web Services) 클러스터가 사용하는 버전입니다.

   2

   클러스터의 인프라 종류를 지정합니다. 이 값은 플랫폼 값과 일치해야 합니다. 다음 값이 유효합니다.

   • AWSCluster: 클러스터가 AWS에서 실행되고 있습니다.
   • GCPCluster: 클러스터가 GCP에서 실행되고 있습니다.

   3

   클러스터 이름을 지정합니다.

   4

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

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

   $ oc create -f <infrastructure_resource_file>.yaml

절차

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

   1

   머신 템플릿 유형을 지정합니다. 이 값은 플랫폼 값과 일치해야 합니다. 다음 값이 유효합니다.

   • AWSMachineTemplate: 클러스터가 AWS(Amazon Web Services)에서 실행되고 있습니다.
   • GCPMachineTemplate: 클러스터가 GCP(Google Cloud Platform)에서 실행되고 있습니다.

   2

   머신 템플릿의 이름을 지정합니다.

   3

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

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

   $ oc create -f <machine_template_resource_file>.yaml

절차

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
   # ...

   1

   컴퓨팅 머신 세트의 이름을 지정합니다.

   2

   클러스터 이름을 지정합니다.

   3

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

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

   $ oc create -f <machine_set_resource_file>.yaml

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

   $ oc get machineset -n openshift-cluster-api 1

   1

   openshift-cluster-api 네임스페이스를 지정합니다.

   출력 예

   NAME                 CLUSTER          REPLICAS   READY   AVAILABLE   AGE   VERSION
   <machine_set_name>   <cluster_name>   1          1       1           17m

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