에이전트 기반 설치 관리자를 사용하여 온프레미스 클러스터 설치

1. install-config.yaml 파일에서 fips 필드의 값을 True 로 설정해야 합니다.

   샘플 install-config.yaml.file

   apiVersion: v1
   baseDomain: test.example.com
   metadata:
     name: sno-cluster
   fips: True

2. 선택 사항: ZTP 매니페스트를 사용하는 경우 agent-cluster-install.yaml 파일의 Agent-install.openshift.io/install-config-overrides 필드에서 fips 값을 True 로 설정해야 합니다.

   agent-cluster-install.yaml 파일 샘플

   apiVersion: extensions.hive.openshift.io/v1beta1
   kind: AgentClusterInstall
   metadata:
     annotations:
       agent-install.openshift.io/install-config-overrides: '{"fips": True}'
     name: sno-cluster
     namespace: sno-cluster-test

절차

1. 로그인 인증 정보를 사용하여 OpenShift Container Platform 웹 콘솔에 로그인합니다.

2. Datacenter 로 이동합니다.

   
3. 로컬 에서 에이전트 기반 설치 관리자 실행을 클릭합니다. 에이전트 페이지를 사용하여 베어 메탈에 OpenShift Container Platform을 로컬로 설치합니다.

4. 선택 사항: 또는 Select an OpenShift Container Platform 클러스터 유형에서 Bare Metal (x86_64) 을 클릭하여 페이지를 생성할 수도 있습니다. OpenShift Container Platform 클러스터 생성: 베어 메탈 페이지로 이동합니다. 그런 다음 로컬 에이전트 기반 을 선택하여 에이전트 페이지를 사용하여 로컬로 베어 메탈에 OpenShift Container Platform 설치 로 이동합니다.

   
5. 운영 체제 및 아키텍처를 선택합니다.
6. 설치 프로그램 다운로드를 클릭하여 설치 프로그램을 다운로드하고 추출합니다.
7. 풀 시크릿 다운로드를 클릭하거나 풀 시크릿 복사를 클릭하여 풀 시크릿을 다운로드하거나 복사할 수 있습니다.
8. 명령행 툴 다운로드를 클릭하고 openshift-install 바이너리를 PATH 에 있는 디렉터리에 배치합니다.

9. 다음 명령을 실행하여 nmstate 종속성을 설치합니다.

   $ sudo dnf install /usr/bin/nmstatectl -y

10. openshift-install 바이너리를 PATH에 있는 디렉터리에 배치합니다.

11. 다음 명령을 실행하여 설치 구성을 저장할 디렉터리를 생성합니다.

    $ mkdir ~/<directory_name>

    참고

    에이전트 기반 설치에 권장되는 방법입니다. ZTP 매니페스트 사용은 선택 사항입니다.

12. install-config.yaml 파일을 생성합니다.

    $ cat << EOF > ./my-cluster/install-config.yaml
    apiVersion: v1
    baseDomain: test.example.com
    compute:
    - architecture: amd64
      hyperthreading: Enabled
      name: worker
      replicas: 0
    controlPlane:
      architecture: amd64
      hyperthreading: Enabled
      name: master
      replicas: 1
    metadata:
      name: sno-cluster 

    1

    
    networking:
      clusterNetwork:
      - cidr: 10.128.0.0/14
        hostPrefix: 23
      machineNetwork:
      - cidr: 192.168.111.0/16
      networkType: OVNKubernetes 

    2

    
      serviceNetwork:
      - 172.30.0.0/16
    platform:
      none: {}
    pullSecret: '<pull_secret>' 

    3

    
    sshKey: |
      <ssh_pub_key> 

    4

    
      EOF

    1

    필수 항목입니다.

    2

    설치할 클러스터 네트워크 플러그인입니다. 지원되는 값은 OVNKubernetes 및 OpenShiftSDN 입니다. 기본값은 OVNKubernetes 입니다.

    3

    풀 시크릿을 입력합니다.

    4

    ssh 공개 키를 입력합니다.

    참고

    플랫폼을 vSphere 또는 baremetal 로 설정하면 다음 세 가지 방법으로 클러스터 노드의 IP 주소 끝점을 구성할 수 있습니다.

    • IPv4
    • IPv6
    • IPv4 및 IPv6 병렬(dual-stack)

    듀얼 스택 네트워킹의 예

    networking:
      clusterNetwork:
        - cidr: 172.21.0.0/16
          hostPrefix: 23
        - cidr: fd02::/48
          hostPrefix: 64
      machineNetwork:
        - cidr: 192.168.11.0/16
        - cidr: 2001:DB8::/32
      serviceNetwork:
        - 172.22.0.0/16
        - fd03::/112
      networkType: OVNKubernetes
    platform:
      baremetal:
        apiVIPs:
        - 192.168.11.3
        - 2001:DB8::4
        ingressVIPs:
        - 192.168.11.4
        - 2001:DB8::5

    IPv6는 베어 메탈 플랫폼에서만 지원됩니다.

13. agent-config.yaml 파일을 생성합니다.

    $ cat > agent-config.yaml << EOF
    apiVersion: v1alpha1
    kind: AgentConfig
    metadata:
      name: sno-cluster
    rendezvousIP: 192.168.111.80 

    1

    
    hosts: 

    2

    
      - hostname: master-0 

    3

    
        interfaces:
          - name: eno1
            macAddress: 00:ef:44:21:e6:a5
        rootDeviceHints: 

    4

    
          deviceName: /dev/sdb
        networkConfig: 

    5

    
          interfaces:
            - name: eno1
              type: ethernet
              state: up
              mac-address: 00:ef:44:21:e6:a5
              ipv4:
                enabled: true
                address:
                  - ip: 192.168.111.80
                    prefix-length: 23
                dhcp: false
          dns-resolver:
            config:
              server:
                - 192.168.111.1
          routes:
            config:
              - destination: 0.0.0.0/0
                next-hop-address: 192.168.111.2
                next-hop-interface: eno1
                table-id: 254
      EOF

    1

    이 IP 주소는 부트스트랩 프로세스를 수행하고 assisted-service 구성 요소를 실행하는 노드를 결정하는 데 사용됩니다. networkConfig 매개변수에 하나 이상의 호스트의 IP 주소를 지정하지 않는 경우 rendezvous IP 주소를 제공해야 합니다. 이 주소를 제공하지 않으면 제공된 호스트의 networkConfig 에서 하나의 IP 주소가 선택됩니다.

    2

    호스트 구성은 선택 사항입니다. 정의된 호스트 수는 compute.replicas 및 controlPlane.replicas 매개변수 값의 합계인 install-config.yaml 파일에 정의된 총 호스트 수를 초과해서는 안 됩니다.

    3

    선택적 hostname 매개변수는 DHCP(Dynamic Host Configuration Protocol) 또는 역방향 DNS 조회에서 가져온 호스트 이름을 재정의합니다. 각 호스트에는 이러한 방법 중 하나에서 제공하는 고유한 호스트 이름이 있어야 합니다.

    4

    rootDeviceHints 매개변수를 사용하면 RHCOS(Red Hat Enterprise Linux CoreOS) 이미지를 특정 장치에 프로비저닝할 수 있습니다. 장치를 검색한 순서대로 검사하고 검색된 값을 팁 값과 비교합니다. 힌트 값과 일치하는 첫 번째 검색된 장치를 사용합니다.

    5

    이 선택적 매개 변수를 설정하여 NMState 형식으로 호스트의 네트워크 인터페이스를 구성합니다.

14. 다음 명령을 실행하여 에이전트 이미지를 생성합니다.

    $ openshift-install --dir <install_directory> agent create image

    참고

    RHCOS(Red Hat Enterprise Linux CoreOS)는 기본 디스크에서 다중 경로를 지원하므로 하드웨어 장애에 대한 탄력성이 강화된 호스트 가용성을 높일 수 있습니다. 기본 /etc/multipath.conf 구성이 있는 에이전트 ISO 이미지에서 멀티패스는 기본적으로 활성화됩니다.

15. 베어 메탈 시스템에서 agent.x86_64.iso 이미지를 부팅합니다.

16. 선택 사항: 부트스트랩 호스트(ndezvous 호스트)가 재부팅되는 시기를 확인하려면 다음 명령을 실행합니다.

    $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete \ 

    1

    
        --log-level=info 

    2

    1

    & lt;install_directory > 의 경우 에이전트 ISO가 생성된 디렉터리의 경로를 지정합니다.

    2

    다른 설치 세부 사항을 보려면 info 대신 warn, debug 또는 error를 지정합니다.

    출력 예

    ...................................................................
    ...................................................................
    INFO Bootstrap configMap status is complete
    INFO cluster bootstrap is complete

    이 명령은 Kubernetes API 서버가 컨트롤 플레인 시스템에서 부트스트랩되었다는 신호를 보낼 때 성공합니다.

17. 진행 상황을 추적하고 성공적으로 설치를 확인하려면 다음 명령을 실행합니다.

    $ openshift-install --dir <install_directory> agent wait-for install-complete 

    1

    1

    & lt;install_directory > 디렉터리에 대해 에이전트 ISO가 생성된 디렉터리의 경로를 지정합니다.

    출력 예

    ...................................................................
    ...................................................................
    INFO Cluster is installed
    INFO Install complete!
    INFO To access the cluster as the system:admin user when using 'oc', run
    INFO     export KUBECONFIG=/home/core/installer/auth/kubeconfig
    INFO Access the OpenShift web-console here: https://console-openshift-console.apps.sno-cluster.test.example.com

프로세스

1. 다음 명령을 실행하고 출력을 수집합니다.

   $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete --log-level=debug

   오류 메시지의 예

   ...
   ERROR Bootstrap failed to complete: : bootstrap process timed out: context deadline exceeded

2. 이전 명령의 출력에 오류가 있거나 부트스트랩이 진행되지 않은 경우 노드 0에서 다음 명령을 실행하고 출력을 수집합니다.

   $ ssh core@<node-ip> sudo /usr/local/bin/agent-gather -O > <local_tmp_path>/agent-gather.tar.xz

   참고

   노드 0에서 데이터를 수집할 때만 필요하지만 모든 노드에서 이 데이터를 수집하는 것이 유용할 수 있습니다.

3. 부트스트랩이 완료되고 클러스터 노드가 재부팅되면 다음 명령을 실행하고 출력을 수집합니다.

   $ ./openshift-install --dir <install_directory> agent wait-for install-complete --log-level=debug

4. 이전 명령의 출력에 오류가 표시되면 다음 단계를 수행합니다.

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

      $ export KUBECONFIG=<install_directory>/auth/kubeconfig

   2. 디버깅에 대한 정보를 수집하려면 다음 명령을 실행합니다.

      $ oc adm must-gather

   3. 다음 명령을 실행하여 작업 디렉터리에 생성된 must-gather 디렉터리에서 압축 파일을 만듭니다.

      $ tar cvaf must-gather.tar.gz <must_gather_directory>

5. /auth 하위 디렉토리를 제외하고 배포 중에 사용되는 설치 디렉터리를 Red Hat 고객 포털 의 지원 케이스에 연결합니다.
6. 이 절차에서 수집된 다른 모든 데이터를 지원 케이스에 첨부합니다.

프로세스

1. 유효한 install-config.yaml 및 agent-config.yaml 파일을 포함할 < assets_directory > 폴더를 생성합니다. 이 디렉터리는 모든 자산을 저장하는 데 사용됩니다.

2. OpenShift Container Platform 이미지 리포지토리, 다중 클러스터 엔진 및 LSO를 미러링하려면 다음 설정으로 ImageSetConfiguration.yaml 파일을 생성합니다.

   Example ImageSetConfiguration.yaml

     kind: ImageSetConfiguration
     apiVersion: mirror.openshift.io/v1alpha2
     archiveSize: 4 

   1

   
     storageConfig: 

   2

   
       imageURL: <your-local-registry-dns-name>:<your-local-registry-port>/mirror/oc-mirror-metadata 

   3

   
       skipTLS: true
     mirror:
       platform:
         architectures:
           - "amd64"
         channels:
           - name: stable-4.12 

   4

   
             type: ocp
       additionalImages:
         - name: registry.redhat.io/ubi8/ubi:latest
       operators:
         - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.12 

   5

   
           packages: 

   6

   
             - name: multicluster-engine 

   7

   
             - name: local-storage-operator 

   8

   1

   이미지 세트 내의 각 파일의 최대 크기(GiB)를 지정합니다.

   2

   이미지 세트 메타데이터를 수신할 백엔드 위치를 설정합니다. 이 위치는 레지스트리 또는 로컬 디렉터리일 수 있습니다. 기술 프리뷰 OCI 기능을 사용하지 않는 한 storageConfig 값을 지정해야 합니다.

   3

   스토리지 백엔드의 레지스트리 URL을 설정합니다.

   4

   설치 중인 버전의 OpenShift Container Platform 이미지가 포함된 채널을 설정합니다.

   5

   설치 중인 OpenShift Container Platform 이미지가 포함된 Operator 카탈로그를 설정합니다.

   6

   이미지 세트에 포함할 특정 Operator 패키지 및 채널만 지정합니다. 이 필드를 제거하여 카탈로그의 모든 패키지를 검색합니다.

   7

   멀티 클러스터 엔진 패키지 및 채널.

   8

   LSO 패키지 및 채널

   참고

   이 파일은 콘텐츠를 미러링할 때 oc mirror 명령에 필요합니다.

3. 특정 OpenShift Container Platform 이미지 저장소, 다중 클러스터 엔진 및 LSO를 미러링하려면 다음 명령을 실행합니다.

   $ oc mirror --dest-skip-tls --config ocp-mce-imageset.yaml docker://<your-local-registry-dns-name>:<your-local-registry-port>

4. install-config.yaml 파일에서 레지스트리 및 인증서를 업데이트합니다.

   Example imageContentSources.yaml

     imageContentSources:
       - source: "quay.io/openshift-release-dev/ocp-release"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/openshift/release-images"
       - source: "quay.io/openshift-release-dev/ocp-v4.0-art-dev"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/openshift/release"
       - source: "registry.redhat.io/ubi8"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/ubi8"
       - source: "registry.redhat.io/multicluster-engine"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/multicluster-engine"
       - source: "registry.redhat.io/rhel8"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/rhel8"
       - source: "registry.redhat.io/redhat"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/redhat"

   또한 install-config.yaml 의 additionalTrustBundle 필드에 인증서가 있는지 확인합니다.

   예: install-config.yaml

   additionalTrustBundle: |
     -----BEGIN CERTIFICATE-----
     zzzzzzzzzzz
     -----END CERTIFICATE-------

   중요

   oc mirror 명령은 여러 출력을 사용하여 oc-mirror-workspace 라는 폴더를 생성합니다. 여기에는 OpenShift Container Platform 및 선택한 Operator에 필요한 모든 미러를 식별하는 imageContentSourcePolicy.yaml 파일이 포함됩니다.

5. 다음 명령을 실행하여 클러스터 매니페스트를 생성합니다.

   $ openshift-install agent create cluster-manifests

   이 명령은 미러 구성이 포함된 미러 폴더를 포함하도록 클러스터 매니페스트 폴더를 업데이트합니다.

프로세스

1. < assets_directory> 폴더에 openshift 라는 하위 폴더를 생성합니다. 이 하위 폴더는 배포된 클러스터를 추가로 사용자 지정하기 위해 설치 중에 적용할 추가 매니페스트를 저장하는 데 사용됩니다. & lt;assets_directory > 폴더에는 install-config.yaml 및 agent-config.yaml 파일을 포함한 모든 자산이 포함되어 있습니다.

   참고

   설치 프로그램에서 추가 매니페스트를 확인하지 않습니다.

2. 다중 클러스터 엔진의 경우 다음 매니페스트를 생성하여 < assets_directory>/openshift 폴더에 저장합니다.

   Example mce_namespace.yaml

     apiVersion: v1
     kind: Namespace
     metadata:
       labels:
         openshift.io/cluster-monitoring: "true"
       name: multicluster-engine

   Example mce_operatorgroup.yaml

     apiVersion: operators.coreos.com/v1
     kind: OperatorGroup
     metadata:
       name: multicluster-engine-operatorgroup
       namespace: multicluster-engine
     spec:
       targetNamespaces:
       - multicluster-engine

   Example mce_subscription.yaml

     apiVersion: operators.coreos.com/v1alpha1
     kind: Subscription
     metadata:
       name: multicluster-engine
       namespace: multicluster-engine
     spec:
       channel: "stable-2.1"
       name: multicluster-engine
       source: redhat-operators
       sourceNamespace: openshift-marketplace

   참고

   지원되는 설치 관리자(AI)를 사용하여 RHACM(Red Hat Advanced Cluster Management)을 사용하여 대규모로 DCU(Distributed Unit)를 설치할 수 있습니다. 이러한 분산 단위는 hub 클러스터에서 활성화되어야 합니다. AI 서비스에는 수동으로 생성되는 PV(영구 볼륨)가 필요합니다.

3. AI 서비스의 경우 다음 매니페스트를 생성하여 < assets_directory>/openshift 폴더에 저장합니다.

   Example lso_namespace.yaml

     apiVersion: v1
     kind: Namespace
     metadata:
       annotations:
         openshift.io/cluster-monitoring: "true"
       name: openshift-local-storage

   Example lso_operatorgroup.yaml

     apiVersion: operators.coreos.com/v1
     kind: OperatorGroup
     metadata:
       name: local-operator-group
       namespace: openshift-local-storage
     spec:
       targetNamespaces:
         - openshift-local-storage

   Example lso_subscription.yaml

     apiVersion: operators.coreos.com/v1alpha1
     kind: Subscription
     metadata:
       name: local-storage-operator
       namespace: openshift-local-storage
     spec:
       installPlanApproval: Automatic
       name: local-storage-operator
       source: redhat-operators
       sourceNamespace: openshift-marketplace

   참고

   모든 매니페스트를 생성한 후 파일 시스템이 다음과 같이 표시되어야 합니다.

   파일 시스템 예

   <assets_directory>
       ├─ install-config.yaml
       ├─ agent-config.yaml
       └─ /openshift
           ├─ mce_namespace.yaml
           ├─ mce_operatorgroup.yaml
           ├─ mce_subscription.yaml
           ├─ lso_namespace.yaml
           ├─ lso_operatorgroup.yaml
           └─ lso_subscription.yaml

4. 다음 명령을 실행하여 에이전트 ISO 이미지를 생성합니다.

   $ openshift-install agent create image --dir <assets_directory>

5. 이미지가 준비되면 대상 시스템을 부팅하고 설치가 완료될 때까지 기다립니다.

6. 설치를 모니터링하려면 다음 명령을 실행합니다.

   $ openshift-install agent wait-for install-complete --dir <assets_directory>

   참고

   완전한 기능 허브 클러스터를 구성하려면 다음 매니페스트를 생성하고 $ oc apply -f <manifest-name> 명령을 실행하여 수동으로 적용해야 합니다. 매니페스트 생성 순서가 중요하며 필요한 경우 대기 조건이 표시됩니다.

7. AI 서비스에 필요한 PV의 경우 다음 매니페스트를 생성합니다.

     apiVersion: local.storage.openshift.io/v1
     kind: LocalVolume
     metadata:
      name: assisted-service
      namespace: openshift-local-storage
     spec:
      logLevel: Normal
      managementState: Managed
      storageClassDevices:
        - devicePaths:
            - /dev/vda
            - /dev/vdb
          storageClassName: assisted-service
          volumeMode: Filesystem

8. 다음 명령을 사용하여 후속 매니페스트를 적용하기 전에 PV의 가용성을 기다립니다.

   $ oc wait localvolume -n openshift-local-storage assisted-service --for condition=Available --timeout 10m

   참고

   The `devicePath` is an example and may vary depending on the actual hardware configuration used.

9. 다중 클러스터 엔진 인스턴스에 대한 매니페스트를 생성합니다.

   Example MultiClusterEngine.yaml

     apiVersion: multicluster.openshift.io/v1
     kind: MultiClusterEngine
     metadata:
       name: multiclusterengine
     spec: {}

10. AI 서비스를 활성화하는 매니페스트를 생성합니다.

    agentserviceconfig.yaml예

      apiVersion: agent-install.openshift.io/v1beta1
      kind: AgentServiceConfig
      metadata:
        name: agent
        namespace: assisted-installer
      spec:
       databaseStorage:
        storageClassName: assisted-service
        accessModes:
        - ReadWriteOnce
        resources:
         requests:
          storage: 10Gi
       filesystemStorage:
        storageClassName: assisted-service
        accessModes:
        - ReadWriteOnce
        resources:
         requests:
          storage: 10Gi

11. 나중에 대화하는 클러스터를 배포할 매니페스트를 생성합니다.

    Example clusterimageset.yaml

      apiVersion: hive.openshift.io/v1
      kind: ClusterImageSet
      metadata:
        name: "4.12"
      spec:
        releaseImage: quay.io/openshift-release-dev/ocp-release:4.12.0-x86_64

12. 에이전트가 설치된 클러스터(Multicluster 엔진 및 지원 서비스를 호스트)를 hub 클러스터 클러스터로 가져오는 매니페스트를 생성합니다.

    예: autoimport.yaml

      apiVersion: cluster.open-cluster-management.io/v1
      kind: ManagedCluster
      metadata:
       labels:
         local-cluster: "true"
         cloud: auto-detect
         vendor: auto-detect
       name: local-cluster
      spec:
       hubAcceptsClient: true

13. 관리 클러스터가 생성될 때까지 기다립니다.

    $ oc wait -n multicluster-engine managedclusters local-cluster --for condition=ManagedClusterJoined=True --timeout 10m