17.4. 단일 노드 OpenShift 클러스터 배포

프로세스

1. 다음 명령을 실행하여 ibi-ns 네임스페이스를 생성합니다.

   $ oc create namespace ibi-ns

2. 이미지 레지스트리에 대한 Secret 리소스를 생성합니다.

   1. 이미지 레지스트리에 대한 Secret 리소스를 정의하는 YAML 파일을 생성합니다.

      secret-image-registry.yaml 파일의 예:

      apiVersion: v1
      kind: Secret
      metadata:
        name: ibi-image-pull-secret
        namespace: ibi-ns
      stringData:
        .dockerconfigjson: <base64_docker_auth_code>
      type: kubernetes.io/dockerconfigjson

      다음과 같습니다.

      <base64_docker_auth_code>

      base64로 인코딩된 인증 정보 세부 정보를 지정합니다. 이미지 가져오기 보안 사용에 대한 자세한 내용은 "추가 리소스" 섹션을 참조하십시오.

   2. 다음 명령을 실행하여 이미지 레지스트리에 대한 Secret 리소스를 생성합니다.

      $ oc create -f secret-image-registry.yaml

3. 선택 사항: 호스트에 대한 정적 네트워킹을 구성합니다.

   1. nmstate 형식으로 정적 네트워크 구성을 포함하는 Secret 리소스를 생성합니다.

      host-network-config-secret.yaml 파일의 예:

      apiVersion: v1
      kind: Secret
      metadata:
       name: <network_secret_name>
       namespace: ibi-ns
      type: Opaque
      stringData:
       nmstate: |
        interfaces:
          - name: <interface_name>
            type: ethernet
            state: up
            ipv4:
              enabled: true
              address:
                - ip: 192.168.200.25
                  prefix-length: 24
              dhcp: false
            ipv6:
              enabled: false
        dns-resolver:
          config:
            server:
              - <dns_server_1>
              - 192.168.15.48
        routes:
          config:
            - destination: 0.0.0.0/0
              metric: 150
              next-hop-address: 192.168.200.254
              next-hop-interface: <interface_name>
              table-id: 254

      다음과 같습니다.

      <network_secret_name>

      Secret 리소스의 이름을 지정합니다(예: host-network-config-secret ).

      nmstate

      nmstate 형식으로 정적 네트워크 구성을 지정합니다.

      <interface_name>

      호스트의 인터페이스 이름을 지정합니다(예: ens1f0 ). 인터페이스 이름은 운영 체제에 표시된 대로 실제 NIC 이름과 일치해야 합니다. NIC 일치에 MAC 주소를 사용하려면 ID 필드를 mac-address 로 설정합니다.

      dhcp: false

      nmstate 가 인터페이스에 고정 IP 주소를 할당하도록 DHCP가 비활성화되어 있음을 지정합니다.

      <dns_server_1>

      시스템이 도메인 이름을 확인하는 데 사용할 하나 이상의 DNS 서버를 지정합니다(예: 192.168.15.47 ).

      config

      다음 홉 IP 주소 192.168.200.254 에 대한 ens1f0 인터페이스를 통한 기본 경로를 지정합니다.

4. BareMetalHost 및 Secret 리소스를 생성합니다.

   1. BareMetalHost 및 Secret 리소스를 정의하는 YAML 파일을 생성합니다.

      ibi-bmh.yaml 파일의 예:

      apiVersion: metal3.io/v1alpha1
      kind: BareMetalHost
      metadata:
        name: <baremetalhost_name>
        namespace: ibi-ns
      spec:
        online: <online_status>
        bootMACAddress: <boot_mac_address>
        bmc:
          address: <bmc_address>
          credentialsName: <bmh_secret_name>
        preprovisioningNetworkDataName: <network_secret_name>
        automatedCleaningMode: disabled
        externallyProvisioned: true
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: <bmh_secret_name>
        namespace: ibi-ns
      type: Opaque
      data:
        username: <username>
        password: <password>

      다음과 같습니다.

      <baremetalhost_name>

      BareMetalHost 리소스의 이름을 지정합니다(예: ibi-bmh ).

      <online_status>

      호스트가 온라인이어야 하는지 여부를 지정합니다(예: false ).

      <boot_mac_address>

      호스트 부팅 MAC 주소를 지정합니다(예: 00:a5:12:55:62:64 ).

      <bmc_address>

      BMC 주소를 지정합니다(예: redfish-virtualmedia+http://192.168.111.1:8000/redfish/v1/Systems/8a5babac-94d0-4c20-b282-50dc3a0a32b5 ). 가상 미디어 네트워킹 부팅을 지원하는 베어 메탈 호스트 드라이버(예: redfish-virtualmedia 및 idrac-virtualmedia)만 사용할 수 있습니다.

      <bmh_secret_name>

      베어 메탈 호스트 Secret 리소스의 이름을 지정합니다(예: ibi-bmh-bmc-secret ).

      <network_secret_name>

      (선택 사항) 호스트의 정적 네트워크 구성이 포함된 Secret 리소스의 이름을 지정합니다(예: host-network-config-secret ).

      automatedCleaningMode: disabled

      프로비저닝 서비스에서 디스크 검사 중에 시드 이미지와 같은 사전 설치 아티팩트를 모두 삭제하지 못하도록 자동 정리가 비활성화되도록 지정합니다.

      externallyProvisioned: true

      구성 ISO 대신 사전 설치된 디스크에서 부팅할 수 있도록 호스트가 외부적으로 프로비저닝되도록 지정합니다.

      <username>

      BMC 인증의 사용자 이름을 지정합니다.

      <password>

      BMC 인증의 암호를 지정합니다.

   2. 다음 명령을 실행하여 BareMetalHost 및 Secret 리소스를 생성합니다.

      $ oc create -f ibi-bmh.yaml

5. ClusterImageSet 리소스를 생성합니다.

   1. ClusterImageSet 리소스를 정의하는 YAML 파일을 생성합니다.

      ibi-cluster-image-set.yaml 파일의 예:

      apiVersion: hive.openshift.io/v1
      kind: ClusterImageSet
      metadata:
        name: <clusterimageset_name>
      spec:
        releaseImage: <release_image>

      다음과 같습니다.

      <clusterimageset_name>

      ClusterImageSet 리소스의 이름을 지정합니다(예: ibi-img-version-arch ).

      <release_image>

      배포에 사용할 릴리스 이미지의 주소를 지정합니다(예: ibi.example.com:path/to/release/images:version-arch ). 시드 이미지 생성 중에 사용된 이미지 레지스트리와 비교하여 다른 이미지 레지스트리를 사용하는 경우 릴리스 이미지의 OpenShift Container Platform 버전이 동일하게 유지되어야 합니다.

   2. 다음 명령을 실행하여 ClusterImageSet 리소스를 생성합니다.

      $ oc apply -f ibi-cluster-image-set.yaml

6. ImageClusterInstall 리소스를 생성합니다.

   1. ImageClusterInstall 리소스를 정의하는 YAML 파일을 생성합니다.

      ibi-image-cluster-install.yaml 파일의 예:

      apiVersion: extensions.hive.openshift.io/v1alpha1
      kind: ImageClusterInstall
      metadata:
        name: <imageclusterinstall_name>
        namespace: ibi-ns
      spec:
        bareMetalHostRef:
          name: <baremetalhost_name>
          namespace: ibi-ns
        clusterDeploymentRef:
          name: <clusterdeployment_name>
        hostname: <cluster_hostname>
        imageSetRef:
          name: <clusterimageset_name>
        machineNetworks:
        - cidr: 10.0.0.0/24
        #- cidr: fd01::/64
        proxy:
          httpProxy: "http://proxy.example.com:8080"
          #httpsProxy: "http://proxy.example.com:8080"
          #noProxy: "no_proxy.example.com"

      다음과 같습니다.

      <imageclusterinstall_name>

      ImageClusterInstall 리소스의 이름을 지정합니다(예: ibi-image-install ).

      <baremetalhost_name>

      이미지 기반 설치를 대상으로 할 BareMetalHost 리소스를 지정합니다(예: ibi-bmh ).

      <clusterdeployment_name>

      대상 호스트의 이미지 기반 설치에 사용할 ClusterDeployment 리소스의 이름을 지정합니다(예: ibi-cluster-deployment ).

      <cluster_hostname>

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

      <clusterimageset_name>

      배포에 사용할 컨테이너 릴리스 이미지를 정의하는 데 사용한 ClusterImageSet 리소스의 이름을 지정합니다(예: ibi-img-version-arch ).

      machineNetworks

      외부 네트워크의 공용 CIDR(Classless Inter-Domain Routing)을 지정합니다. 듀얼 스택 네트워킹의 경우 목록 형식을 사용하여 IPv4 및 IPv6 CIDR을 모두 지정할 수 있습니다. 목록의 첫 번째 CIDR은 기본 주소 제품군이며 시드 클러스터의 기본 주소 제품군과 일치해야 합니다.

      proxy

      (선택 사항) 클러스터 배포에 사용할 프록시를 지정합니다.

      중요

      클러스터 배포에 프록시 구성이 필요한 경우 다음을 수행해야 합니다.

      • 프록시 구성을 제공하는 시드 클러스터에서 시드 이미지를 생성합니다. 프록시 구성이 일치하지 않아도 됩니다.
      • 설치 매니페스트에서 machineNetwork 필드를 구성합니다.

   2. 다음 명령을 실행하여 ImageClusterInstall 리소스를 생성합니다.

      $ oc create -f ibi-image-cluster-install.yaml

7. ClusterDeployment 리소스를 생성합니다.

   1. ClusterDeployment 리소스를 정의하는 YAML 파일을 생성합니다.

      ibi-cluster-deployment.yaml 파일의 예:

      apiVersion: hive.openshift.io/v1
      kind: ClusterDeployment
      metadata:
        name: <clusterdeployment_name>
        namespace: <namespace>
      spec:
        baseDomain: <base_domain>
        clusterInstallRef:
          group: extensions.hive.openshift.io
          kind: ImageClusterInstall
          name: <imageclusterinstall_name>
          version: v1alpha1
        clusterName: <cluster_name>
        platform:
          none: {}
        pullSecretRef:
          name: <pull_secret_name>

      다음과 같습니다.

      <clusterdeployment_name>

      ClusterDeployment 리소스의 이름을 지정합니다(예: ibi-cluster-deployment ).

      <namespace>

      ClusterDeployment 리소스의 네임스페이스를 지정합니다(예: ibi-ns ).

      <base_domain>

      클러스터가 속해야 하는 기본 도메인을 지정합니다(예: example.com ).

      <imageclusterinstall_name>

      대상 호스트의 이미지 기반 설치에 사용할 컨테이너 이미지를 정의한 ImageClusterInstall 의 이름을 지정합니다(예: ibi-image-install ).

      <cluster_name>

      클러스터 이름을 지정합니다(예: ibi-cluster ).

      <pull_secret_name>

      이미지 레지스트리에서 이미지를 가져오는 데 사용할 시크릿을 지정합니다(예: ibi-image-pull-secret ).

   2. 다음 명령을 실행하여 ClusterDeployment 리소스를 생성합니다.

      $ oc apply -f ibi-cluster-deployment.yaml

8. ManagedCluster 리소스를 생성합니다.

   1. ManagedCluster 리소스를 정의하는 YAML 파일을 생성합니다.

      ibi-managed.yaml 파일의 예:

      apiVersion: cluster.open-cluster-management.io/v1
      kind: ManagedCluster
      metadata:
        name: <managedcluster_name>
      spec:
        hubAcceptsClient: <hub_accepts_client>

      다음과 같습니다.

      <managedcluster_name>

      ManagedCluster 리소스의 이름을 지정합니다(예: sno-ibi ).

      <hub_accepts_client>

      RHACM에서 클러스터를 관리하는지 여부를 지정합니다. 관리를 활성화하려면 true 로 설정합니다.

   2. 다음 명령을 실행하여 ManagedCluster 리소스를 생성합니다.

      $ oc apply -f ibi-managed.yaml

검증

1. 다음 명령을 실행하여 허브 클러스터에서 ImageClusterInstall 의 상태를 확인하여 대상 호스트 설치의 진행 상황을 모니터링합니다.

   $ oc get imageclusterinstall

   출력 예:

   NAME       REQUIREMENTSMET           COMPLETED                     BAREMETALHOSTREF
   target-0   HostValidationSucceeded   ClusterInstallationSucceeded  ibi-bmh

   주의

   ImageClusterInstall 리소스가 삭제되면 IBI Operator에서 BareMetalHost 리소스를 다시 연결하고 머신을 재부팅합니다.

2. 설치가 완료되면 다음 명령을 실행하여 kubeconfig 시크릿을 검색하여 관리 클러스터에 로그인할 수 있습니다.

   $ oc extract secret/<cluster_name>-admin-kubeconfig -n <cluster_namespace>  --to - > <directory>/<cluster_name>-kubeconfig

   다음과 같습니다.

   <cluster_name>

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

   <cluster_namespace>

   클러스터의 네임스페이스를 지정합니다.

   <directory>

   파일을 만들 디렉터리를 지정합니다.