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

절차

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
     --etcd-storage-class=<etcd-storage-class> 6

   1

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

   2

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

   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

   출력 예

   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

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

3. 호스트 클러스터의 상태를 확인하려면 다음 명령을 입력하여 해당 HostedCluster 리소스를 참조하십시오.

   $ oc get --namespace clusters hostedclusters

   완전히 프로비저닝된 HostedCluster 오브젝트를 설명하는 다음 예제 출력을 참조하십시오.

   NAMESPACE   NAME      VERSION   KUBECONFIG                 PROGRESS    AVAILABLE   PROGRESSING   MESSAGE
   clusters    example   4.x.0     example-admin-kubeconfig   Completed   True        False         The hosted control plane is available

   4.x.0 을 사용하려는 지원되는 OpenShift Container Platform 버전으로 교체합니다.

절차

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. 항목을 검토하고 생성 을 클릭합니다.

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

7. Hosted 클러스터 보기에서 호스팅된 클러스터의 배포를 모니터링합니다. 호스팅된 클러스터에 대한 정보가 표시되지 않는 경우 모든 클러스터가 선택되어 있는지 확인하고 클러스터 이름을 클릭합니다.
8. 컨트롤 플레인 구성 요소가 준비될 때까지 기다립니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.
9. 노드 풀 상태를 보려면 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

   1

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

   2

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

   3

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

   4

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

   5

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

   6

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

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

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

   $ oc get --namespace clusters hostedclusters

   출력 예

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

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

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

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

   출력 예

   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)

   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}'

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

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

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

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

2. 다음 명령을 입력하여 로드 밸런서 서비스를 생성합니다.

   oc apply -f -
   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

   1

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

   2

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

프로세스

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

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

   출력 예

   192.168.20.30

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

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

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

   DNS 확인 예

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

3. 다음 명령을 입력하여 호스팅 클러스터 상태가 Partial 에서 Completed 로 이동했는지 확인합니다.

   $ oc get --namespace clusters hostedclusters

   출력 예

   NAME            VERSION   KUBECONFIG                       PROGRESS    AVAILABLE   PROGRESSING   MESSAGE
   example         4.x.0     example-admin-kubeconfig         Completed   True        False         The hosted control plane is available

   4.x.0 을 사용하려는 지원되는 OpenShift Container Platform 버전으로 교체합니다.

프로세스

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

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

   $ oc get nodepools --namespace clusters

   출력 예

   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

   4.x.0 을 사용하려는 지원되는 OpenShift Container Platform 버전으로 교체합니다.

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

   $ oc --kubeconfig $CLUSTER_NAME-kubeconfig get nodes

   출력 예

   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

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

   $ oc get nodepools --namespace clusters

   출력 예

   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

   4.x.0 을 사용하려는 지원되는 OpenShift Container Platform 버전으로 교체합니다.