16.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> 1
      type: kubernetes.io/dockerconfigjson

      1

      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: host-network-config-secret 1
       namespace: ibi-ns
      type: Opaque
      stringData:
       nmstate: | 2
        interfaces:
          - name: ens1f0 3
            type: ethernet
            state: up
            ipv4:
              enabled: true
              address:
                - ip: 192.168.200.25
                  prefix-length: 24
              dhcp: false 4
            ipv6:
              enabled: false
        dns-resolver:
          config:
            server:
              - 192.168.15.47 5
              - 192.168.15.48
        routes:
          config: 6
            - destination: 0.0.0.0/0
              metric: 150
              next-hop-address: 192.168.200.254
              next-hop-interface: ens1f0
              table-id: 254

      1

      Secret 리소스의 이름을 지정합니다.

      2

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

      3

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

      4

      nmstate 가 인터페이스에 고정 IP 주소를 할당하도록 하려면 dhcp: false 를 지정해야 합니다.

      5

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

      6

      이 예에서 기본 경로는 ens1f0 인터페이스를 통해 다음 홉 IP 주소 192.168.200.254 로 구성됩니다.

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

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

      ibi-bmh.yaml 파일 예

      apiVersion: metal3.io/v1alpha1
      kind: BareMetalHost
      metadata:
        name: ibi-bmh 1
        namespace: ibi-ns
      spec:
        online: false 2
        bootMACAddress: 00:a5:12:55:62:64 3
        bmc:
          address: redfish-virtualmedia+http://192.168.111.1:8000/redfish/v1/Systems/8a5babac-94d0-4c20-b282-50dc3a0a32b5 4
          credentialsName: ibi-bmh-bmc-secret 5
        preprovisioningNetworkDataName: host-network-config-secret 6
        automatedCleaningMode: disabled 7
        externallyProvisioned: true 8
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: ibi-bmh-secret 9
        namespace: ibi-ns
      type: Opaque
      data:
        username: <user_name> 10
        password: <password> 11

      1

      BareMetalHost 리소스의 이름을 지정합니다.

      2

      호스트가 온라인 상태인지 여부를 지정합니다.

      3

      호스트 부팅 MAC 주소를 지정합니다.

      4

      BMC 주소를 지정합니다. 가상 미디어 네트워킹 부팅을 지원하는 베어 메탈 호스트 드라이버(예: redfish-virtualmedia 및 idrac-virtualmedia)만 사용할 수 있습니다.

      5

      베어 메탈 호스트 Secret 리소스의 이름을 지정합니다.

      6

      선택 사항: 호스트에 정적 네트워크 구성이 필요한 경우 구성이 포함된 Secret 리소스의 이름을 지정합니다.

      7

      프로비저닝 서비스에서 디스크 검사 중에 시드 이미지와 같은 사전 설치 아티팩트를 모두 삭제하지 못하도록 automatedCleaningMode:disabled 를 지정해야 합니다.

      8

      구성 ISO 대신 호스트가 사전 설치된 디스크에서 부팅되도록 하려면 external Provisioned: true 를 지정해야 합니다.

      9

      Secret 리소스의 이름을 지정합니다.

      10

      사용자 이름을 지정합니다.

      11

      암호를 지정합니다.

   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: ibi-img-version-arch 1
      spec:
        releaseImage: ibi.example.com:path/to/release/images:version-arch 2

      1

      ClusterImageSet 리소스의 이름을 지정합니다.

      2

      배포에 사용할 릴리스 이미지의 주소를 지정합니다. 시드 이미지 생성 중에 사용된 이미지 레지스트리와 비교하여 다른 이미지 레지스트리를 사용하는 경우 릴리스 이미지의 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: ibi-image-install 1
        namespace: ibi-ns
      spec:
        bareMetalHostRef:
          name: ibi-bmh 2
          namespace: ibi-ns
        clusterDeploymentRef:
          name: ibi-cluster-deployment 3
        hostname: ibi-host 4
        imageSetRef:
          name: ibi-img-version-arch 5
        machineNetwork: 10.0.0.0/24 6
        proxy: 7
          httpProxy: "http://proxy.example.com:8080"
          #httpsProxy: "http://proxy.example.com:8080"
          #noProxy: "no_proxy.example.com"

      1

      ImageClusterInstall 리소스의 이름을 지정합니다.

      2

      이미지 기반 설치를 대상으로 할 BareMetalHost 리소스를 지정합니다.

      3

      대상 호스트의 이미지 기반 설치에 사용할 ClusterDeployment 리소스의 이름을 지정합니다.

      4

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

      5

      배포에 사용할 컨테이너 릴리스 이미지를 정의하는 데 사용한 ClusterImageSet 리소스의 이름을 지정합니다.

      6

      외부 네트워크의 공용 CIDR(Classless Inter-Domain Routing)을 지정합니다.

      7

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

      중요

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

      • 프록시 구성을 제공하는 시드 클러스터에서 시드 이미지를 생성합니다. 프록시 구성이 일치하지 않아도 됩니다.
      • 설치 매니페스트에서 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: ibi-cluster-deployment 1
        namespace: ibi-ns 2
      spec:
        baseDomain: example.com 3
        clusterInstallRef:
          group: extensions.hive.openshift.io
          kind: ImageClusterInstall
          name: ibi-image-install 4
          version: v1alpha1
        clusterName: ibi-cluster 5
        platform:
          none: {}
        pullSecretRef:
          name: ibi-image-pull-secret 6

      1

      ClusterDeployment 리소스의 이름을 지정합니다.

      2

      ClusterDeployment 리소스의 네임스페이스를 지정합니다.

      3

      클러스터가 속해야 하는 기본 도메인을 지정합니다.

      4

      대상 호스트의 이미지 기반 설치에 사용할 컨테이너 이미지를 정의한 ImageClusterInstall 의 이름을 지정합니다.

      5

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

      6

      이미지 레지스트리에서 이미지를 가져오는 데 사용할 시크릿을 지정합니다.

   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: sno-ibi 1
      spec:
        hubAcceptsClient: true 2

      1

      ManagedCluster 리소스의 이름을 지정합니다.

      2

      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 >는 파일을 생성할 디렉터리입니다.

프로세스

1. 다음을 실행하여 작업 디렉터리를 생성합니다.

   $ mkdir ibi-config-iso-workdir 1

   1

   ibi-config-iso-workdir 을 작업 디렉터리의 이름으로 바꿉니다.

2. 설치 매니페스트를 생성합니다.

   1. install-config 매니페스트를 정의하는 YAML 파일을 생성합니다.

      install-config.yaml 파일 예

      apiVersion: v1
      metadata:
        name: sno-cluster-name
      baseDomain: host.example.com
      compute:
        - architecture: amd64
          hyperthreading: Enabled
          name: worker
          replicas: 0
      controlPlane:
        architecture: amd64
        hyperthreading: Enabled
        name: master
        replicas: 1
      networking:
        clusterNetwork:
        - cidr: 10.128.0.0/14
          hostPrefix: 23
        machineNetwork:
        - cidr: 192.168.200.0/24
        networkType: OVNKubernetes
        serviceNetwork:
        - 172.30.0.0/16
      platform:
        none: {}
      fips: false
      cpuPartitioningMode: "AllNodes"
      pullSecret: '{"auths":{"<your_pull_secret>"}}}'
      sshKey: 'ssh-rsa <your_ssh_pub_key>'

      중요

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

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

3. 선택 사항: 다음 명령을 실행하여 작업 디렉터리에 구성 템플릿을 생성합니다.

   $ openshift-install image-based create config-template --dir ibi-config-iso-workdir/

   출력 예

   INFO Config-Template created in: ibi-config-iso-workdir

   이 명령은 작업 디렉터리에 image-based-config.yaml 구성 템플릿을 생성합니다.

   #
   # Note: This is a sample ImageBasedConfig file showing
   # which fields are available to aid you in creating your
   # own image-based-config.yaml file.
   #
   apiVersion: v1beta1
   kind: ImageBasedConfig
   metadata:
     name: example-image-based-config
   additionalNTPSources:
     - 0.rhel.pool.ntp.org
     - 1.rhel.pool.ntp.org
   hostname: change-to-hostname
   releaseRegistry: quay.io
   # networkConfig contains the network configuration for the host in NMState format.
   # See https://nmstate.io/examples.html for examples.
   networkConfig:
     interfaces:
       - name: eth0
         type: ethernet
         state: up
         mac-address: 00:00:00:00:00:00
         ipv4:
           enabled: true
           address:
             - ip: 192.168.122.2
               prefix-length: 23
           dhcp: false

4. 구성 파일을 편집합니다.

   image-based-config.yaml 파일의 예

   #
   # Note: This is a sample ImageBasedConfig file showing
   # which fields are available to aid you in creating your
   # own image-based-config.yaml file.
   #
   apiVersion: v1beta1
   kind: ImageBasedConfig
   metadata:
     name: sno-cluster-name
   additionalNTPSources:
     - 0.rhel.pool.ntp.org
     - 1.rhel.pool.ntp.org
   hostname: host.example.com
   releaseRegistry: quay.io
   # networkConfig contains the network configuration for the host in NMState format.
   # See https://nmstate.io/examples.html for examples.
   networkConfig:
       interfaces:
         - name: ens1f0
           type: ethernet
           state: up
           ipv4:
             enabled: true
             dhcp: false
             auto-dns: false
             address:
               - ip: 192.168.200.25
                 prefix-length: 24
           ipv6:
             enabled: false
       dns-resolver:
         config:
           server:
             - 192.168.15.47
             - 192.168.15.48
       routes:
         config:
         - destination: 0.0.0.0/0
           metric: 150
           next-hop-address: 192.168.200.254
           next-hop-interface: ens1f0

5. 다음 명령을 실행하여 작업 디렉터리에 구성 ISO를 생성합니다.

   $ openshift-install image-based create config-image --dir ibi-config-iso-workdir/

   출력 예

   INFO Adding NMConnection file <ens1f0.nmconnection>
   INFO Consuming Install Config from target directory
   INFO Consuming Image-based Config ISO configuration from target directory
   INFO Config-Image created in: ibi-config-iso-workdir/auth

   작업 디렉터리의 출력을 확인합니다.

   출력 예

   ibi-config-iso-workdir/
   ├── auth
   │   ├── kubeadmin-password
   │   └── kubeconfig
   └── imagebasedconfig.iso

6. 기본 방법을 사용하여 사전 설치된 호스트에 imagebasedconfig.iso 를 연결하고 호스트를 다시 시작하여 구성 프로세스를 완료하고 클러스터를 배포합니다.

1. 다음 명령을 실행하여 kubeconfig 환경 변수를 kubeconfig 파일로 내보냅니다.

   $ export KUBECONFIG=ibi-config-iso-workdir/auth/kubeconfig

2. 다음 명령을 실행하여 클러스터가 응답하는지 확인합니다.

   $ oc get nodes

   출력 예

   NAME                                         STATUS   ROLES                  AGE     VERSION
   node/sno-cluster-name.host.example.com       Ready    control-plane,master   5h15m   v1.30.3