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

프로세스

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

   $ oc create namespace ibi-ns

   Copy to Clipboard Toggle word wrap

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

   1. 이미지 레지스트리의 비밀 리소스를 정의하는 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

      Copy to Clipboard Toggle word wrap

      1

      base64로 인코딩된 자격 증명 세부 정보를 제공해야 합니다. 이미지 풀 시크릿 사용에 대한 자세한 내용은 "추가 리소스" 섹션을 참조하세요.

   2. 다음 명령을 실행하여 이미지 레지스트리에 대한 비밀 리소스를 만듭니다.

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

      Copy to Clipboard Toggle word wrap

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

   1. nmstate 형식으로 정적 네트워크 구성을 포함하는 비밀 리소스를 만듭니다.

      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

      Copy to Clipboard Toggle word wrap

      1

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

      2

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

      3

      호스트의 인터페이스 이름을 지정합니다. 인터페이스 이름은 운영 체제에 표시되는 실제 NIC 이름과 일치해야 합니다. NIC 매칭에 MAC 주소를 사용하려면 식별자 필드를 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

      Copy to Clipboard Toggle word wrap

      1

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

      2

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

      3

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

      4

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

      5

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

      6

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

      7

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

      8

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

      9

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

      10

      사용자 이름을 지정하세요.

      11

      비밀번호를 입력하세요.

   2. 다음 명령을 실행하여 BareMetalHost 및 Secret 리소스를 만듭니다.

      $ oc create -f ibi-bmh.yaml

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

      1

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

      2

      배포에 사용할 릴리스 이미지의 주소를 지정합니다. 시드 이미지 생성 중에 사용된 이미지 레지스트리와 다른 이미지 레지스트리를 사용하는 경우 릴리스 이미지의 OpenShift Container Platform 버전이 동일하게 유지되는지 확인하세요.

   2. 다음 명령을 실행하여 ClusterImageSet 리소스를 만듭니다.

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

      Copy to Clipboard Toggle word wrap

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"

      Copy to Clipboard Toggle word wrap

      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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

      1

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

      2

      ClusterDeployment 리소스에 대한 네임스페이스를 지정합니다.

      3

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

      4

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

      5

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

      6

      이미지 레지스트리에서 이미지를 가져올 때 사용할 비밀번호를 지정합니다.

   2. 다음 명령을 실행하여 ClusterDeployment 리소스를 만듭니다.

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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

      1

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

      2

      RHACM이 클러스터를 관리할 수 있도록 하려면 true를 지정합니다.

   2. 다음 명령을 실행하여 ManagedCluster 리소스를 만듭니다.

      $ oc apply -f ibi-managed.yaml

      Copy to Clipboard Toggle word wrap

검증

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

   $ oc get imageclusterinstall

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

   주의

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

2. 설치가 완료되면 다음 명령을 실행하여 관리되는 클러스터에 로그인하기 위한 kubeconfig 비밀번호를 검색할 수 있습니다.

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

   Copy to Clipboard Toggle word wrap
   • <cluster_name> 은 클러스터의 이름입니다.
   • <cluster_namespace> 는 클러스터의 네임스페이스입니다.
   • <directory>는 파일을 생성할 디렉터리입니다.

프로세스

1. 다음을 실행하여 작업 디렉토리를 만듭니다.

   $ mkdir ibi-config-iso-workdir 

   1

   Copy to Clipboard Toggle word wrap

   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:
        machineNetwork:
        - cidr: 192.168.200.0/24
      platform:
        none: {}
      fips: false
      cpuPartitioningMode: "AllNodes"
      pullSecret: '{"auths":{"<your_pull_secret>"}}}'
      sshKey: 'ssh-rsa <your_ssh_pub_key>'

      Copy to Clipboard Toggle word wrap

      중요

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

      • 프록시 구성을 특징으로 하는 시드 클러스터에서 시드 이미지를 만듭니다. 프록시 구성이 일치할 필요는 없습니다.
      • 설치 매니페스트에서 machineNetwork 필드를 구성합니다.
   2. 작업 디렉토리에 파일을 저장합니다.

3. 선택 사항입니다. 다음 명령을 실행하여 작업 디렉토리에 구성 템플릿을 만듭니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

   이 명령은 작업 디렉토리에 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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

5. 다음 명령을 실행하여 작업 디렉토리에 구성 ISO를 만듭니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

   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

   Copy to Clipboard Toggle word wrap

   작업 디렉토리에서 출력을 확인하세요.

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap