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. 인프라 > 클러스터를 클릭합니다.
4. 클러스터 만들기 > Red Hat OpenShift Virtualization > 호스팅을 클릭합니다.

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

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

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

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

7. 입력 내용을 검토하고 '만들기'를 클릭하세요.

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

8. 호스팅된 클러스터 보기에서 호스팅된 클러스터의 배포를 모니터링합니다. 호스팅된 클러스터에 대한 정보가 보이지 않으면 모든 클러스터가 선택되어 있는지 확인하고 클러스터 이름을 클릭하세요.
9. 컨트롤 플레인 구성 요소가 준비될 때까지 기다립니다. 이 과정은 몇 분 정도 걸릴 수 있습니다.
10. 노드 풀 상태를 보려면 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 레코드와 부하 분산 장치를 구성해야 하므로 부분적 상태로 유지됩니다.

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

   $ 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

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

   $ 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

   <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. 다음 명령을 입력하여 로드 밸런서 서비스를 생성합니다.

   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

   Copy to Clipboard Toggle word wrap

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

   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

3. 다음 명령을 입력하여 호스팅된 클러스터 상태가 Partial(부분) 에서 Completed(완료) 로 변경되었는지 확인하세요.

   $ oc get --namespace clusters hostedclusters

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

   <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

   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                               False         False                  True              True             Minimum availability requires 2 replicas, current 0 available

   Copy to Clipboard Toggle word wrap

   <4.x.0>을 사용하려는 지원되는 OpenShift Container Platform 버전으로 바꾸세요.

3. 시간이 지나면 다음 명령을 입력하여 노드 풀의 상태를 확인할 수 있습니다.

   $ 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

4. 다음 명령을 입력하여 노드 풀이 예상한 상태인지 확인하세요.

   $ 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

   <4.x.0>을 사용하려는 지원되는 OpenShift Container Platform 버전으로 바꾸세요.