4.3. OpenShift Virtualization에 호스팅된 컨트롤 플레인 배포

프로세스

1. 다음 명령을 입력하여 KubeVirt 플랫폼을 사용하여 호스팅된 클러스터를 생성합니다.

   $ hcp create cluster kubevirt \
     --name <hosted_cluster_name> \

   1

   
     --node-pool-replicas <node_pool_replica_count> \

   2

   
     --pull-secret <path_to_pull_secret> \

   3

   
     --memory <value_for_memory> \

   4

   
     --cores <value_for_cpu> \

   5

   
     --etcd-storage-class=<etcd_storage_class> 

   6

   Copy to Clipboard Toggle word wrap

   1

   호스트 클러스터의 이름을 지정합니다(예: my-hosted-cluster ).

   2

   노드 풀 복제본 수를 지정합니다(예: 3 ). 동일한 수의 복제본을 생성하려면 복제본 수를 0 이상으로 지정해야 합니다. 그렇지 않으면 노드 풀이 생성되지 않습니다.

   3

   풀 시크릿의 경로를 지정합니다(예: /user/name/pullsecret ).

   4

   메모리 값을 지정합니다(예: 6Gi ).

   5

   CPU 값을 지정합니다(예: 2 ).

   6

   etcd 스토리지 클래스 이름을 지정합니다(예: lvm-storageclass ).

   참고

   --release-image 플래그를 사용하여 특정 OpenShift Container Platform 릴리스로 호스팅 클러스터를 설정할 수 있습니다.

   --node-pool-replicas 플래그에 따라 두 개의 가상 머신 작업자 복제본이 있는 클러스터에 대한 기본 노드 풀이 생성됩니다.

2. 잠시 후 다음 명령을 입력하여 호스팅된 컨트롤 플레인 포드가 실행 중인지 확인합니다.

   $ oc -n clusters-<hosted-cluster-name> get pods

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                                  READY   STATUS    RESTARTS   AGE
   capi-provider-5cc7b74f47-n5gkr                        1/1     Running   0          3m
   catalog-operator-5f799567b7-fd6jw                     2/2     Running   0          69s
   certified-operators-catalog-784b9899f9-mrp6p          1/1     Running   0          66s
   cluster-api-6bbc867966-l4dwl                          1/1     Running   0          66s
   .
   .
   .
   redhat-operators-catalog-9d5fd4d44-z8qqk              1/1     Running   0          66s

   Copy to Clipboard Toggle word wrap

   KubeVirt 가상 머신에서 지원하는 작업자 노드가 있는 호스팅된 클러스터는 일반적으로 완전히 프로비저닝되는 데 10-15분이 걸립니다.

프로세스

1. OpenShift Container Platform 웹 콘솔을 열고 관리자 인증 정보를 입력하여 로그인합니다.
2. 콘솔 헤더에서 모든 클러스터 가 선택되어 있는지 확인합니다.
3. Infrastructure > Clusters를 클릭합니다.
4. Create cluster > Red Hat OpenShift Virtualization > Hosted를 클릭합니다.

5. 클러스터 생성 페이지에서 프롬프트에 따라 클러스터 및 노드 풀에 대한 세부 정보를 입력합니다.

   참고
   • 사전 정의된 값을 사용하여 콘솔에서 필드를 자동으로 채우려면 OpenShift Virtualization 인증 정보를 생성할 수 있습니다. 자세한 내용은 "온-프레미스 환경에 대한 인증 정보 생성"을 참조하십시오.
   • 클러스터 세부 정보 페이지에서 풀 시크릿은 OpenShift Container Platform 리소스에 액세스하는 데 사용하는 OpenShift Container Platform 풀 시크릿입니다. OpenShift Virtualization 인증 정보를 선택한 경우 풀 시크릿이 자동으로 채워집니다.

6. 노드 풀 페이지에서 네트워킹 옵션 섹션을 확장하고 노드 풀에 대한 네트워킹 옵션을 구성합니다.

   1. 추가 네트워크 필드에 < namespace>/<name> 형식으로 네트워크 이름을 입력합니다(예: my-namespace/network1 ). 네임스페이스와 이름은 유효한 DNS 레이블이어야 합니다. 여러 네트워크가 지원됩니다.
   2. 기본적으로 Attach default pod network 확인란이 선택됩니다. 추가 네트워크가 있는 경우에만 이 확인란을 지울 수 있습니다.

7. 항목을 검토하고 생성 을 클릭합니다.

   호스팅된 클러스터 보기가 표시됩니다.

검증

1. Hosted 클러스터 보기에서 호스팅된 클러스터의 배포를 모니터링합니다. 호스팅된 클러스터에 대한 정보가 표시되지 않는 경우 모든 클러스터가 선택되어 있는지 확인하고 클러스터 이름을 클릭합니다.
2. 컨트롤 플레인 구성 요소가 준비될 때까지 기다립니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.
3. 노드 풀 상태를 보려면 NodePool 섹션으로 스크롤합니다. 노드를 설치하는 프로세스에는 약 10분이 걸립니다. 노드를 클릭하여 노드가 호스팅된 클러스터에 참여하고 있는지 확인할 수도 있습니다.

프로세스

1. 다음 명령을 실행합니다.

   $ hcp create cluster kubevirt \
     --name <hosted_cluster_name> \ 

   1

   
     --node-pool-replicas <worker_count> \ 

   2

   
     --pull-secret <path_to_pull_secret> \ 

   3

   
     --memory <value_for_memory> \ 

   4

   
     --cores <value_for_cpu> \ 

   5

   
     --base-domain <basedomain> 

   6

   Copy to Clipboard Toggle word wrap

   1

   호스팅된 클러스터의 이름을 지정합니다.

   2

   작업자 수를 지정합니다(예: 2).

   3

   풀 시크릿의 경로를 지정합니다(예: /user/name/pullsecret ).

   4

   메모리 값을 지정합니다(예: 6Gi ).

   5

   CPU 값을 지정합니다(예: 2 ).

   6

   기본 도메인을 지정합니다(예: hypershift.lab ).

   결과적으로 호스팅된 클러스터에는 클러스터 이름과 기본 도메인(예: .apps.example.hypershift.lab )에 대해 구성된 수신 와일드카드가 있습니다. 호스트 클러스터는 고유한 기본 도메인을 사용하여 호스팅 클러스터를 생성한 후 필요한 DNS 레코드 및 로드 밸런서를 구성해야 하므로 부분적 상태로 유지됩니다.

검증

1. 다음 명령을 입력하여 호스팅 클러스터의 상태를 확인합니다.

   $ oc get --namespace clusters hostedclusters

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME            VERSION   KUBECONFIG                       PROGRESS   AVAILABLE   PROGRESSING   MESSAGE
   example                   example-admin-kubeconfig         Partial    True        False         The hosted control plane is available

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 입력하여 클러스터에 액세스합니다.

   $ hcp create kubeconfig --name <hosted_cluster_name> \
     > <hosted_cluster_name>-kubeconfig

   Copy to Clipboard Toggle word wrap

   $ oc --kubeconfig <hosted_cluster_name>-kubeconfig get co

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                       VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   console                                    <4.x.0>     False       False         False      30m     RouteHealthAvailable: failed to GET route (https://console-openshift-console.apps.example.hypershift.lab): Get "https://console-openshift-console.apps.example.hypershift.lab": dial tcp: lookup console-openshift-console.apps.example.hypershift.lab on 172.31.0.10:53: no such host
   ingress                                    <4.x.0>     True        False         True       28m     The "default" ingress controller reports Degraded=True: DegradedConditions: One or more other status conditions indicate a degraded state: CanaryChecksSucceeding=False (CanaryChecksRepetitiveFailures: Canary route checks for the default ingress controller are failing)

   Copy to Clipboard Toggle word wrap

   & lt;4.x.0 >을 사용하려는 지원되는 OpenShift Container Platform 버전으로 바꿉니다.

프로세스

1. 호스팅된 클러스터 인그레스를 노출하는 NodePort 서비스가 이미 존재합니다. 노드 포트를 내보내고 해당 포트를 대상으로 하는 로드 밸런서 서비스를 생성할 수 있습니다.

   1. 다음 명령을 입력하여 HTTP 노드 포트를 가져옵니다.

      $ oc --kubeconfig <hosted_cluster_name>-kubeconfig get services \
        -n openshift-ingress router-nodeport-default \
        -o jsonpath='{.spec.ports[?(@.name=="http")].nodePort}'

      Copy to Clipboard Toggle word wrap

      다음 단계에서 사용할 HTTP 노드 포트 값을 확인합니다.

   2. 다음 명령을 입력하여 HTTPS 노드 포트를 가져옵니다.

      $ oc --kubeconfig <hosted_cluster_name>-kubeconfig get services \
        -n openshift-ingress router-nodeport-default \
        -o jsonpath='{.spec.ports[?(@.name=="https")].nodePort}'

      Copy to Clipboard Toggle word wrap

      다음 단계에서 사용할 HTTPS 노드 포트 값을 확인합니다.

2. YAML 파일에 다음 정보를 입력합니다.

   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: <hosted_cluster_name>
     name: <hosted_cluster_name>-apps
     namespace: clusters-<hosted_cluster_name>
   spec:
     ports:
     - name: https-443
       port: 443
       protocol: TCP
       targetPort: <https_node_port> 

   1

   
     - name: http-80
       port: 80
       protocol: TCP
       targetPort: <http_node_port> 

   2

   
     selector:
       kubevirt.io: virt-launcher
     type: LoadBalancer

   Copy to Clipboard Toggle word wrap

   1

   이전 단계에서 기록한 HTTPS 노드 포트 값을 지정합니다.

   2

   이전 단계에서 기록한 HTTP 노드 포트 값을 지정합니다.

3. 다음 명령을 실행하여 로드 밸런서 서비스를 생성합니다.

   $ oc create -f <file_name>.yaml

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 입력하여 외부 IP 주소를 가져옵니다.

   $ oc -n clusters-<hosted_cluster_name> get service <hosted-cluster-name>-apps \
     -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

   Copy to Clipboard Toggle word wrap

   출력 예

   192.168.20.30

   Copy to Clipboard Toggle word wrap

2. 외부 IP 주소를 참조하는 와일드카드 DNS 항목을 구성합니다. 다음 예제 DNS 항목을 확인합니다.

   *.apps.<hosted_cluster_name\>.<base_domain\>.

   Copy to Clipboard Toggle word wrap

   DNS 항목은 클러스터 내부 및 외부에서 라우팅할 수 있어야 합니다.

   DNS 확인 예

   dig +short test.apps.example.hypershift.lab
   
   192.168.20.30

   Copy to Clipboard Toggle word wrap

프로세스

1. 노드 풀을 생성하려면 다음 정보를 입력합니다. 이 예에서 노드 풀에는 VM에 더 많은 CPU가 할당됩니다.

   export NODEPOOL_NAME=${CLUSTER_NAME}-extra-cpu
   export WORKER_COUNT="2"
   export MEM="6Gi"
   export CPU="4"
   export DISK="16"
   
   $ hcp create nodepool kubevirt \
     --cluster-name $CLUSTER_NAME \
     --name $NODEPOOL_NAME \
     --node-count $WORKER_COUNT \
     --memory $MEM \
     --cores $CPU \
     --root-volume-size $DISK

   Copy to Clipboard Toggle word wrap

2. cluster 네임스페이스에 nodepool 리소스를 나열하여 노드 풀의 상태를 확인합니다.

   $ oc get nodepools --namespace clusters

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                      CLUSTER         DESIRED NODES   CURRENT NODES   AUTOSCALING   AUTOREPAIR   VERSION   UPDATINGVERSION   UPDATINGCONFIG   MESSAGE
   example                   example         5               5               False         False        <4.x.0>
   example-extra-cpu         example         2                               False         False                  True              True             Minimum availability requires 2 replicas, current 0 available

   Copy to Clipboard Toggle word wrap

   & lt;4.x.0 >을 사용하려는 지원되는 OpenShift Container Platform 버전으로 바꿉니다.

검증

1. 잠시 후 다음 명령을 입력하여 노드 풀의 상태를 확인할 수 있습니다.

   $ oc --kubeconfig $CLUSTER_NAME-kubeconfig get nodes

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                      STATUS   ROLES    AGE     VERSION
   example-9jvnf             Ready    worker   97s     v1.27.4+18eadca
   example-n6prw             Ready    worker   116m    v1.27.4+18eadca
   example-nc6g4             Ready    worker   117m    v1.27.4+18eadca
   example-thp29             Ready    worker   4m17s   v1.27.4+18eadca
   example-twxns             Ready    worker   88s     v1.27.4+18eadca
   example-extra-cpu-zh9l5   Ready    worker   2m6s    v1.27.4+18eadca
   example-extra-cpu-zr8mj   Ready    worker   102s    v1.27.4+18eadca

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 입력하여 노드 풀이 예상되는 상태에 있는지 확인합니다.

   $ oc get nodepools --namespace clusters

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                      CLUSTER         DESIRED NODES   CURRENT NODES   AUTOSCALING   AUTOREPAIR   VERSION   UPDATINGVERSION   UPDATINGCONFIG   MESSAGE
   example                   example         5               5               False         False        <4.x.0>
   example-extra-cpu         example         2               2               False         False        <4.x.0>

   Copy to Clipboard Toggle word wrap

   & lt;4.x.0 >을 사용하려는 지원되는 OpenShift Container Platform 버전으로 바꿉니다.