4장. 가상화된 컨트롤 플레인 배포
환경을 준비한 후 기본 설치 방법을 사용하여 가상화된 컨트롤 플레인 클러스터를 설치합니다. 에이전트 기반 설치 프로그램 및 GitOps ZTP(ZTP)는 가상화된 컨트롤 플레인 배포에 권장되는 방법입니다.
4.1. 에이전트 기반 설치 프로그램을 사용하여 가상화된 컨트롤 플레인 배포 링크 복사링크가 클립보드에 복사되었습니다!
에이전트 기반 설치 관리자를 사용하여 가상화된 컨트롤 플레인 클러스터를 배포합니다. 이 방법은 필요한 모든 구성이 포함된 부팅 가능한 ISO를 생성합니다.
Redfish API를 사용하여 KubeVirt Redfish 및 baremetal 작업자 노드를 사용하여 가상화된 컨트롤 플레인 노드 모두에 ISO를 마운트해야 합니다.
사전 요구 사항
- kubevirt Redfish가 호스팅 클러스터에 설치 및 구성되어 있습니다.
- 컨트롤 플레인 VM은 호스팅 클러스터에 생성되고 전원이 꺼집니다. 이 상태에서 KubeVirt Redfish를 통해 VM 전원 라이프사이클 및 부팅 구성을 관리할 수 있습니다.
- KubeVirt Redfish 경로에 대한 네트워크 액세스 권한이 있습니다.
- 에이전트 ISO를 호스팅하는 HTTP 서버를 사용할 수 있습니다.
절차
가상화된 컨트롤 플레인 노드의 KubeVirt Redfish 및 baremetal 작업자 노드의 실제 Redfish 끝점을 가리키는 BMC 주소를 사용하여
install-config.yaml파일을 생성합니다.apiVersion: v1 metadata: name: my-vcp-cluster baseDomain: example.com controlPlane: architecture: amd64 hyperthreading: Enabled name: master replicas: 3 compute: - name: worker architecture: amd64 hyperthreading: Enabled replicas: 2 networking: networkType: OVNKubernetes clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23 serviceNetwork: - 172.30.0.0/16 machineNetwork: - cidr: 10.0.0.0/24 platform: baremetal: provisioningNetwork: Disabled apiVIPs: - 10.0.0.10 ingressVIPs: - 10.0.0.11 hosts: - name: master-0 role: master bootMACAddress: 52:54:00:00:00:01 bootMode: UEFI rootDeviceHints: deviceName: /dev/vda bmc: address: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-0 username: admin password: <password> disableCertificateVerification: false networkConfig: interfaces: - name: enp1s0 mac-address: 52:54:00:00:00:01 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: master-1 role: master bootMACAddress: 52:54:00:00:00:02 bootMode: UEFI rootDeviceHints: deviceName: /dev/vda bmc: address: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-1 username: admin password: <password> disableCertificateVerification: false networkConfig: interfaces: - name: enp1s0 mac-address: 52:54:00:00:00:02 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: master-2 role: master bootMACAddress: 52:54:00:00:00:03 bootMode: UEFI rootDeviceHints: deviceName: /dev/vda bmc: address: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-2 username: admin password: <password> disableCertificateVerification: false networkConfig: interfaces: - name: enp1s0 mac-address: 52:54:00:00:00:03 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: worker-0 role: worker bootMACAddress: e4:43:4b:00:00:01 bootMode: UEFI rootDeviceHints: deviceName: /dev/nvme0n1 bmc: address: redfish-virtualmedia+https://<worker_0_bmc_ip>/redfish/v1/Systems/System.Embedded.1 username: <bmc_username> password: <bmc_password> disableCertificateVerification: false networkConfig: interfaces: - name: ens1f0 mac-address: e4:43:4b:00:00:01 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: worker-1 role: worker bootMACAddress: e4:43:4b:00:00:02 bootMode: UEFI rootDeviceHints: deviceName: /dev/nvme0n1 bmc: address: redfish-virtualmedia+https://<worker_1_bmc_ip>/redfish/v1/Systems/System.Embedded.1 username: <bmc_username> password: <bmc_password> disableCertificateVerification: false networkConfig: interfaces: - name: ens1f0 mac-address: e4:43:4b:00:00:02 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true pullSecret: '<pull_secret>' sshKey: '<ssh_public_key>'다음과 같습니다.
-
플랫폼: baremetal을 사용하면 설치 프로그램이 KubeVirt Redfish 끝점을 통해 컨트롤 플레인 VM을 관리할 수 있습니다. -
apiVIPs및ingressVIPs는 머신 네트워크에서 할당해야 하는 가상 IP 주소를 지정합니다.apiVIPs는 컨트롤 플레인 VM과 동일한 L2 네트워크 세그먼트에 있어야 하며ingressVIP는 작업자 노드와 동일한 L2 네트워크 세그먼트에 있어야 합니다. -
bootMACAddress는 해당 컨트롤 플레인 VM에 있는 네트워크 인터페이스의 MAC 주소와 일치해야 합니다. DHCP를 사용하는 경우 이 MAC에 DHCP 서버에 예약된 IP 주소가 구성되어 있는지 확인합니다. -
컨트롤 플레인 노드의
BMC.address는 KubeVirt Redfish 경로를 지정합니다. <vm_namespace>.<vm_name> 형식은 KubeVirt Redfish에 구성된 향상된 시스템 ID 규칙에 해당합니다. <kubevirt_redfish_route>를 경로 호스트 이름으로 바꾸고 <vm_namespace>를 VM이 포함된 네임스페이스로 바꿉니다.
-
다음 예와 유사한
agent-config.yamlYAML 파일을 생성합니다.apiVersion: v1alpha1 kind: AgentConfig metadata: name: my-vcp-cluster rendezvousIP: 10.0.0.20여기서: *
rendezvousIP필드는 첫 번째 컨트롤 플레인 노드의 IP 주소를 지정합니다. 이 노드는 설치를 조정합니다.다음 명령을 실행하여 에이전트 ISO를 생성합니다.
$ openshift-install agent create image --dir <installation_directory>-
호스팅 클러스터에서 액세스할 수 있는 HTTP 서버에서 생성된
agent.x86_64.iso를 호스팅합니다. 에이전트 ISO에서 각 노드를 부팅합니다.
- 가상화된 컨트롤 플레인 노드의 경우 KubeVirt Redfish를 사용하여 ISO를 마운트하고 VM에 전원을 켭니다.
- baremetal 작업자 노드의 경우 서버의 BMC 인터페이스를 사용하여 ISO 및 부팅을 마운트합니다.
다음 명령을 실행하여 설치 진행 상황을 모니터링합니다.
$ openshift-install agent wait-for install-complete --dir <installation_directory>-
&
lt;installation_directory>를 에이전트 ISO가 생성된 디렉토리의 경로로 바꿉니다.
-
&
검증
설치가 완료되면 클러스터가 작동하는지 확인합니다.
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig $ oc get nodes
4.2. GitOps ZTP를 사용하여 가상화된 컨트롤 플레인 배포 링크 복사링크가 클립보드에 복사되었습니다!
ZTP(ZTP) GitOps Zero Touch Provisioning(ZTP)을 사용하여 가상화된 컨트롤 플레인 클러스터를 대규모로 배포합니다. GitOps ZTP(ZTP)는 GitOps를 사용하여 RHACM(Red Hat Advanced Cluster Management)을 통해 클러스터 배포를 선언적으로 관리합니다.
사전 요구 사항
- RHACM은 hub 클러스터에 설치되어 있습니다.
- kubevirt Redfish가 호스팅 클러스터에 설치 및 구성되어 있습니다.
- 컨트롤 플레인 VM이 생성되고 전원이 꺼집니다.
- Git 리포지토리는 GitOps ZTP 매니페스트에 대해 구성됩니다.
- 클러스터에 풀 시크릿을 사용할 수 있습니다.
절차
각 노드의 BMC 인증 정보가 포함된
SecretCR(사용자 정의 리소스)을 생성합니다. 다음 예제에서는 컨트롤 플레인 노드의 보안을 보여줍니다.apiVersion: v1 kind: Secret metadata: name: master-0-bmc-secret namespace: my-vcp-cluster type: Opaque data: username: <base64_encoded_username> password: <base64_encoded_password>각 노드에 대해 유사한
SecretCR을 생성합니다(예:master-1-bmc-secret,worker-0-bmc-secret등). 가상화된 컨트롤 플레인 노드의 경우 KubeVirt Redfish 인증 정보를 사용합니다. baremetal 작업자 노드의 경우 물리적 서버의 BMC 자격 증명을 사용합니다.클러스터를 정의하는
ClusterInstanceCR(사용자 정의 리소스)을 생성합니다. 가상화된 컨트롤 플레인 노드의 KubeVirt Redfish 및 baremetal 작업자 노드에 대한 실제 Redfish 끝점을 가리키는 BMC 주소를 지정합니다.apiVersion: siteconfig.open-cluster-management.io/v1alpha1 kind: ClusterInstance metadata: name: my-vcp-cluster namespace: my-vcp-cluster spec: baseDomain: example.com clusterImageSetNameRef: "openshift-5.0" clusterName: my-vcp-cluster clusterType: HighlyAvailable platformType: BareMetal networkType: OVNKubernetes clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23 serviceNetwork: - cidr: 172.30.0.0/16 machineNetwork: - cidr: 10.0.0.0/24 apiVIPs: - 10.0.0.10 ingressVIPs: - 10.0.0.11 pullSecretRef: name: assisted-deployment-pull-secret sshPublicKey: "<ssh_public_key>" extraLabels: ManagedCluster: common: "true" sites: "my-vcp-cluster" templateRefs: - name: ai-cluster-templates-v1 namespace: open-cluster-management nodes: - hostName: master-0.my-vcp-cluster.example.com role: master bmcAddress: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-0 bmcCredentialsName: name: master-0-bmc-secret bootMACAddress: 52:54:00:00:00:01 bootMode: UEFI automatedCleaningMode: disabled rootDeviceHints: deviceName: /dev/vda templateRefs: - name: ai-node-templates-v1 namespace: open-cluster-management - hostName: master-1.my-vcp-cluster.example.com role: master bmcAddress: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-1 bmcCredentialsName: name: master-1-bmc-secret bootMACAddress: 52:54:00:00:00:02 bootMode: UEFI automatedCleaningMode: disabled rootDeviceHints: deviceName: /dev/vda templateRefs: - name: ai-node-templates-v1 namespace: open-cluster-management - hostName: master-2.my-vcp-cluster.example.com role: master bmcAddress: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-2 bmcCredentialsName: name: master-2-bmc-secret bootMACAddress: 52:54:00:00:00:03 bootMode: UEFI automatedCleaningMode: disabled rootDeviceHints: deviceName: /dev/vda templateRefs: - name: ai-node-templates-v1 namespace: open-cluster-management - hostName: worker-0.my-vcp-cluster.example.com role: worker bmcAddress: redfish-virtualmedia+https://<worker_0_bmc_ip>/redfish/v1/Systems/System.Embedded.1 bmcCredentialsName: name: worker-0-bmc-secret bootMACAddress: e4:43:4b:00:00:01 bootMode: UEFI automatedCleaningMode: disabled rootDeviceHints: deviceName: /dev/nvme0n1 templateRefs: - name: ai-node-templates-v1 namespace: open-cluster-management - hostName: worker-1.my-vcp-cluster.example.com role: worker bmcAddress: redfish-virtualmedia+https://<worker_1_bmc_ip>/redfish/v1/Systems/System.Embedded.1 bmcCredentialsName: name: worker-1-bmc-secret bootMACAddress: e4:43:4b:00:00:02 bootMode: UEFI automatedCleaningMode: disabled rootDeviceHints: deviceName: /dev/nvme0n1 templateRefs: - name: ai-node-templates-v1 namespace: open-cluster-management다음과 같습니다.
-
platformType: BareMetal을 사용하면 설치 프로그램이 KubeVirt Redfish 끝점을 통해 컨트롤 플레인 VM을 관리할 수 있습니다. -
apiVIPs및ingressVIPs는 머신 네트워크에서 할당해야 하는 가상 IP 주소를 지정합니다.apiVIPs는 컨트롤 플레인 VM과 동일한 L2 네트워크 세그먼트에 있어야 하며ingressVIP는 작업자 노드와 동일한 L2 네트워크 세그먼트에 있어야 합니다. -
컨트롤 플레인 노드의
bmcAddress는 KubeVirt Redfish 경로를 지정합니다. <vm_namespace>.<vm_name> 형식은 KubeVirt Redfish에 구성된 향상된 시스템 ID 규칙에 해당합니다. <kubevirt_redfish_route>를 경로 호스트 이름으로 바꾸고 <vm_namespace>를 VM이 포함된 네임스페이스로 바꿉니다. -
bootMACAddress는 해당 컨트롤 플레인 VM의 네트워크 인터페이스에 할당된 MAC 주소와 일치해야 합니다. DHCP를 사용하는 경우 이 MAC에 DHCP 서버에 예약된 IP 주소가 구성되어 있는지 확인합니다.
-
- 매니페스트를 Git 리포지토리에 커밋합니다.
ArgoCD 또는 GitOps 툴링을 통해 구성을 적용합니다.
ZTP는 필요한 리소스를 생성하고 KubeVirt Redfish를 사용하여 VM을 자동으로 프로비저닝합니다.
검증
hub 클러스터에서 클러스터 배포를 모니터링합니다.
$ oc get managedcluster my-vcp-cluster $ oc get agentclusterinstall my-vcp-cluster -n my-vcp-cluster -o jsonpath='{.status.debugInfo.stateInfo}'
4.3. 설치 관리자 프로비저닝 인프라를 사용하여 가상화된 컨트롤 플레인 배포 링크 복사링크가 클립보드에 복사되었습니다!
설치 관리자 프로비저닝 인프라를 사용하여 가상화된 컨트롤 플레인 클러스터를 배포합니다. 설치 프로그램에서 제공하는 인프라는 설치 프로그램이 하드웨어 프로비저닝, 전원 상태 및 클러스터 초기화를 자동화하는 전체 라이프사이클 관리를 제공합니다.
가상화된 컨트롤 플레인을 위한 설치 관리자 프로비저닝 인프라에는 프로비저닝 네트워크 또는 RHEL 9 프로비저너 노드가 필요합니다. 이 조합에는 추가 요구 사항이 있을 수 있으므로 Red Hat 담당자가 가상화된 컨트롤 플레인 배포에 대한 설치 관리자 프로비저닝 인프라 지원을 확인합니다.
사전 요구 사항
- kubevirt Redfish가 호스팅 클러스터에 설치 및 구성되어 있습니다.
- 컨트롤 플레인 VM은 호스팅 클러스터에 생성되고 전원이 꺼집니다. 이 상태에서 설치는 KubeVirt Redfish를 통해 VM 전원 라이프사이클 및 부팅 구성을 관리합니다.
- RHEL 9 프로비저너 노드를 사용할 수 있거나 프로비저닝 네트워크가 구성되어 있습니다.
- KubeVirt Redfish 경로에 대한 네트워크 액세스 권한이 있습니다.
절차
가상화된 컨트롤 플레인 노드의 KubeVirt Redfish 및 baremetal 작업자 노드의 실제 Redfish 끝점을 가리키는 BMC 주소를 사용하여
install-config.yaml파일을 생성합니다.apiVersion: v1 metadata: name: my-vcp-cluster baseDomain: example.com controlPlane: architecture: amd64 hyperthreading: Enabled name: master replicas: 3 platform: baremetal: {} compute: - name: worker architecture: amd64 hyperthreading: Enabled replicas: 2 platform: baremetal: {} networking: networkType: OVNKubernetes clusterNetwork: - cidr: 10.128.0.0/14 hostPrefix: 23 serviceNetwork: - 172.30.0.0/16 machineNetwork: - cidr: 10.0.0.0/24 platform: baremetal: apiVIPs: - 10.0.0.10 ingressVIPs: - 10.0.0.11 provisioningNetwork: Disabled hosts: - name: master-0 role: master bootMACAddress: 52:54:00:00:00:01 bootMode: UEFI rootDeviceHints: deviceName: /dev/vda bmc: address: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-0 username: admin password: <password> disableCertificateVerification: false networkConfig: interfaces: - name: enp1s0 mac-address: 52:54:00:00:00:01 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: master-1 role: master bootMACAddress: 52:54:00:00:00:02 bootMode: UEFI rootDeviceHints: deviceName: /dev/vda bmc: address: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-1 username: admin password: <password> disableCertificateVerification: false networkConfig: interfaces: - name: enp1s0 mac-address: 52:54:00:00:00:02 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: master-2 role: master bootMACAddress: 52:54:00:00:00:03 bootMode: UEFI rootDeviceHints: deviceName: /dev/vda bmc: address: redfish-virtualmedia+https://<kubevirt_redfish_route>/redfish/v1/Systems/<vm_namespace>.control-plane-2 username: admin password: <password> disableCertificateVerification: false networkConfig: interfaces: - name: enp1s0 mac-address: 52:54:00:00:00:03 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: worker-0 role: worker bootMACAddress: e4:43:4b:00:00:01 bootMode: UEFI rootDeviceHints: deviceName: /dev/nvme0n1 bmc: address: redfish-virtualmedia+https://<worker_0_bmc_ip>/redfish/v1/Systems/System.Embedded.1 username: <bmc_username> password: <bmc_password> disableCertificateVerification: false networkConfig: interfaces: - name: ens1f0 mac-address: e4:43:4b:00:00:01 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true - name: worker-1 role: worker bootMACAddress: e4:43:4b:00:00:02 bootMode: UEFI rootDeviceHints: deviceName: /dev/nvme0n1 bmc: address: redfish-virtualmedia+https://<worker_1_bmc_ip>/redfish/v1/Systems/System.Embedded.1 username: <bmc_username> password: <bmc_password> disableCertificateVerification: false networkConfig: interfaces: - name: ens1f0 mac-address: e4:43:4b:00:00:02 type: ethernet state: up ipv4: enabled: true dhcp: true auto-dns: true ipv6: enabled: true pullSecret: '<pull_secret>' sshKey: '<ssh_public_key>'다음과 같습니다.
-
플랫폼: baremetal을 사용하면 설치 프로그램이 KubeVirt Redfish 끝점을 통해 컨트롤 플레인 VM을 관리할 수 있습니다. -
apiVIPs및ingressVIPs는 머신 네트워크에서 할당해야 하는 가상 IP 주소를 지정합니다.apiVIPs는 컨트롤 플레인 VM과 동일한 L2 네트워크 세그먼트에 있어야 하며ingressVIP는 작업자 노드와 동일한 L2 네트워크 세그먼트에 있어야 합니다. -
bootMACAddress는 해당 컨트롤 플레인 VM에 있는 네트워크 인터페이스의 MAC 주소와 일치해야 합니다. DHCP를 사용하는 경우 이 MAC에 DHCP 서버에 예약된 IP 주소가 구성되어 있는지 확인합니다. -
컨트롤 플레인 노드의
BMC.address는 KubeVirt Redfish 경로를 지정합니다. <vm_namespace>.<vm_name> 형식은 KubeVirt Redfish에 구성된 향상된 시스템 ID 규칙에 해당합니다. <kubevirt_redfish_route>를 경로 호스트 이름으로 바꾸고 <vm_namespace>를 VM이 포함된 네임스페이스로 바꿉니다.
-
다음 명령을 실행하여 설치를 실행합니다.
$ openshift-install create cluster --dir <installation_directory>설치 프로세스에서 KubeVirt Redfish를 사용하여 VM 전원 상태 및 부팅 구성을 자동으로 관리합니다.
검증
설치가 완료되면 다음 명령을 실행하여 클러스터가 작동하는지 확인합니다.
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig $ oc get nodes