17.3. RHACM 및 siteConfig 리소스를 사용하여 관리형 클러스터 설치

• 빈 서버에 호스트 운영 체제(RHCOS) 설치
• OpenShift Container Platform 배포
• 클러스터 정책 및 사이트 서브스크립션 생성
• 서버 운영 체제에 필요한 네트워크 구성
• 프로필 Operator 배포 및 성능 프로필, PTP 및 SR-IOV와 같은 필요한 소프트웨어 관련 구성 수행

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.
• 필요한 설치 및 정책 CR을 생성하기 위해 hub 클러스터를 구성하셨습니다.

• 사용자 지정 사이트 구성 데이터를 관리하는 Git 리포지토리를 생성했습니다. 리포지토리는 hub 클러스터에서 액세스할 수 있어야 하며 ArgoCD 애플리케이션의 소스 리포지토리로 구성해야 합니다. 자세한 내용은 "GITOP ZTP 사이트 구성 리포지토리 준비"를 참조하십시오.

  참고

  소스 리포지토리를 생성할 때 ztp-site-generate 컨테이너에서 추출한 argocd/deployment/argocd-openshift-gitops-patch.json patch-file을 사용하여 ArgoCD 애플리케이션을 패치해야 합니다. " ArgoCD를 사용하여 hub 클러스터 구성"을 참조하십시오.

• 관리 클러스터를 프로비저닝할 준비를 하려면 각 베어 메탈 호스트에 대해 다음이 필요합니다.

  네트워크 연결

  네트워크에는 DNS가 필요합니다. hub 클러스터에서 관리 클러스터 호스트에 연결할 수 있어야 합니다. hub 클러스터와 관리 클러스터 호스트 간에 계층 3 연결이 있는지 확인합니다.

  BMC(Baseboard Management Controller) 세부 정보

  ZTP는 BMC 사용자 이름과 암호 세부 정보를 사용하여 클러스터 설치 중에 BMC에 연결합니다. GitOps ZTP 플러그인은 사이트 Git 리포지토리의 site Config CR을 기반으로 hub 클러스터에서 ManagedCluster CR을 관리합니다. 각 호스트에 대해 개별 BMCSecret CR을 수동으로 생성합니다.

  절차

  1. hub 클러스터에서 필요한 관리 클러스터 시크릿을 생성합니다. 이러한 리소스는 클러스터 이름과 일치하는 이름이 있는 네임스페이스에 있어야 합니다. 예를 들어 out/argocd/example/siteconfig/example-sno.yaml 에서 클러스터 이름과 네임스페이스는 example-sno 입니다.

     1. 다음 명령을 실행하여 클러스터 네임스페이스를 내보냅니다.

        $ export CLUSTERNS=example-sno

     2. 네임스페이스를 생성합니다.

        $ oc create namespace $CLUSTERNS

  2. 관리형 클러스터의 pull secret 및 BMC Secret CR을 생성합니다. 풀 시크릿에는 OpenShift Container Platform 및 모든 필수 Operator 설치에 필요한 모든 인증 정보가 포함되어야 합니다. 자세한 내용은 "관리된 베어 메탈 호스트 시크릿 생성"을 참조하십시오.

     참고

     보안은 이름으로 SiteConfig CR(사용자 정의 리소스)에서 참조합니다. 네임스페이스는 SiteConfig 네임스페이스와 일치해야 합니다.

  3. Git 리포지토리의 로컬 복제본에 클러스터용 SiteConfig CR을 생성합니다.

     1. out/argocd/example/siteconfig/ 디렉터리에서 CR에 대한 적절한 예제를 선택합니다. 폴더에는 단일 노드, 3-노드 및 표준 클러스터의 예제 파일이 포함되어 있습니다.

        • example-sno.yaml
        • example-3node.yaml
        • example-standard.yaml

     2. 예제 파일의 클러스터와 호스트 세부 정보를 원하는 클러스터 유형과 일치하도록 변경합니다. 예를 들면 다음과 같습니다.

        # example-node1-bmh-secret & assisted-deployment-pull-secret은 동일한 네임스페이스 example-sno --- apiVersion: ran.openshift.io/v1 종류 아래에 생성해야 합니다. siteConfig metadata: name: "example-sno" namespace: "example-sno" spec: baseDomain: "example.com" pullSecretRef: name: "assisted-deployment-pull-secret" clusterImageSetNameRef: "openshift-4.10" sshPublicKey: "ssh-rsa AAAA…​" 클러스터: - clusterName: "example-sno" networkType: "OVNKubernetes" # installConfigOverrides는 siteConfig를 통해 install-config # 매개변수를 전달하는 일반적인 방법입니다. 'capabilities' 필드는 # 구성 가능 openshift 기능을 구성합니다. 이 'capabilities' 설정에서 # 구성 요소의 선택적 세트에서 marketplace 구성 요소를 모두 제거합니다. # - OperatorLifecycleManager는 4.15 이상에 필요합니다. NodeTuning은 4.13 이상에 필요합니다. 4.12 및 이전 installConfigOverrides: | "capabilities": { "baselineCapabilitySet": "None", # - OperatorLifecycleManager에 필요합니다. "additionalEnabledCapabilities": [ "NodeTuning", "OperatorLifecycleManager" ] } # crun 매니페스트를 4.13+의 추가 설치 시간 매니페스트의 일부로 포함하는 것이 좋습니다. # crun 매니페스트는 source-crs/optional-extra-manifest/에서 가져올 수 있으며 git repo ie.sno-extra-manifest에 추가할 수 있습니다. # extraManifestPath: sno-extra-manifest clusterLabels: # 이 예제 클러스터 라벨은 PolicyGenTemplate 예제 ut-profile 예제 "latest"의 bindingRules에 해당합니다. 이 예제 클러스터 레이블은 ../policygentemplates: # ./policygentemplates/common-ranGen.yaml의 PolicyGenTemplate 예제에 있는 bindingRules에 해당합니다. 은 'common: true' common: true: true # ../policygentemplates/group-du-sno-ranGen.yaml이 있는 모든 클러스터에 적용됩니다. 'group-du-sno: ""' group-du-sno: "" # ../policygentemplates/example-sno-site.yaml이 적용됩니다. 'sites: "example-sno"'가 있는 모든 클러스터의 경우 일반적으로 클러스터 이름이 일치하거나 포함해야 합니다. 단일 클러스터 사이트 : "example-sno" clusterNetwork: -cidr: 1001:1::/48 hostPrefix: 64 machineNetwork: - cidr: 1111:2222:3333:4444::/64 serviceNetwork: - 1001:2::/112 추가NTPSources: - 1111:2222:3333:4444::2 # 워크로드 파티셔닝을 위해 클러스터를 시작합니다. 특정 예약/isolated CPUSets 설정은 PolicyTemplate #을 통해 수행됩니다. 전체 안내서는 Workload 파티셔닝 기능을 참조하십시오. cpu CryostatingMode: AllNodes # 필요한 경우 이 클러스터에 대해 생성된 KlusterletAddonConfig를 재정의하는 데 사용할 수 있습니다. crTemplates: # KlusterletAddonConfig: "KlusterletAddonConfigOverride.yaml" 노드: - hostName: "example-node1.example.com" role: "master" # optionally; 호스트에서 원하는 BIOS 설정을 구성하는 데 사용할 수 있습니다. #biosConfigRef: # filePath: "example-hw.profile" bmcAddress: "idrac-virtualmedia+https://[1111:2222:3333:4444::bbbb:1]/redfish/v1/Systems/System.Embedded.1" bmcCredentialsName: name: "example-node1-bmh-secret" bootMACAddress: "AA:#159:CC:DD:EE:11" # UEFISecureBoot를 사용하여 보안 부팅 bootMode: "UEFI" rootDeviceHints: deviceName: "/dev/disk/by-path/pci-0000:01:00.0:2:0:0" # ignitionConfigOverride를 사용하여 /var/lib/containers 의 디스크 파티션을 활성화합니다. 일부 값을 업데이트해야 합니다. 자세한 내용은 ignitionConfigOverride: | { "ignition": { "version": "3.2.0" }, "storage": { "disks": [ { "device": "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0", " { "label": "var-lib-containers", " { "label": "var-lib-containers"를 참조하십시오. "sizeMiB": 0, "startMiB": 250000 } ], "wipeTable": false } ], "filesystems": [ { "device": "/dev/disk/by-partlabel/var-lib-containers", "format": "xfs", "mountOptions": [ "defaults", "prjquota" ], "path": "/var/lib/containers", "wipeFilesystem": true } ], "systemd": { "units": " "contents": " Butane\n[Unit]\nRequires=systemd-disk-by\dev-disk-by\x2dlabel-var2dlib\x2dcontainers\x2dcontainers. prjquota\n\n\n[Install]\n[Install]\nRequiredBy=local-fs.target", "enabled": true, "name": "var-lib-containers.mount" } } nodeNetwork: interfaces: - name: eno1 macAddress: "AA:#159:CC:DD:EE:11" config: interfaces: interface: interface: - name: eno1 type: ethernet state: up ipv4: enabled: false ipv6: enabled: true address: # 고정 IP 주소가 있는 SNO 사이트의 경우 노드별 # API 및 Ingress IP는 모두 동일해야 합니다. # ip: 1111:22:22:22:22:22:22:22:3333:4444::aaa:1 접두사-length: 64 dns-resolver: config: search:- example.com 서버: - 1111:22:3333:4444::2 routes: config: - destination: ::/0 next-hop-interface: eno1 next-hop-address: 1111:2222:3333:4444::1 table-id: 254

        +

        참고

        BMC 주소 지정에 대한 자세한 내용은 "ECDHE 리소스" 섹션을 참조하십시오. installConfigOverrides 및 ignitionConfigOverride 필드는 쉽게 읽을 수 있도록 확장됩니다.

     3. out/argocd/extra-manifest 에서 기본 extra-manifest MachineConfig CR 세트를 검사할 수 있습니다. 이는 설치 시 클러스터에 자동으로 적용됩니다.
     4. 선택 사항: 프로비저닝된 클러스터에서 추가 설치 시간 매니페스트를 프로비저닝하려면 Git 리포지토리에 디렉터리(예: sno-extra-manifest/ )를 생성하고 사용자 정의 매니페스트 CR을 이 디렉터리에 추가합니다. SiteConfig.yaml 이 extraManifestPath 필드에서 이 디렉터리를 참조하는 경우 이 참조되는 디렉터리의 모든 CR이 기본 매니페스트 세트에 추가됩니다.
  4. out/argocd/example/siteconfig/ kustomization.yaml 에 표시된 예와 유사하게 generators 섹션의 kustomization.yaml 파일에 SiteConfig CR을 추가합니다.

  5. Git 리포지토리 에서 siteConfig CR 및 관련 kustomization.yaml 변경 사항을 커밋하고 변경 사항을 내보냅니다.

     ArgoCD 파이프라인은 변경 사항을 감지하고 관리형 클러스터 배포를 시작합니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.

사전 요구 사항

• OpenShift CLI(oc)가 설치되어 있습니다.
• cluster-admin 권한이 있는 사용자로 hub 클러스터에 로그인했습니다.