19.13. 단일 관리 클러스터 설치를 위한 사용자 정의 리소스 생성

절차

1. NMStateConfig 사용자 정의 리소스를 생성합니다.

   apiVersion: agent-install.openshift.io/v1beta1
   kind: NMStateConfig
   metadata:
    name: <cluster_name>
    namespace: <cluster_name>
    labels:
      sno-cluster-<cluster-name>: <cluster_name>
   spec:
    config:
      interfaces:
        - name: eth0
          type: ethernet
          state: up
          ipv4:
            enabled: true
            address:
              - ip: <ip_address> 1
                prefix-length: <public_network_prefix> 2
            dhcp: false
      dns-resolver:
        config:
          server:
            - <dns_resolver> 3
      routes:
        config:
          - destination: 0.0.0.0/0
            next-hop-address: <gateway> 4
            next-hop-interface: eth0
            table-id: 254
    interfaces:
      - name: "eth0" 5
        macAddress: <mac_address> 6

   1

   대상 베어 메탈 호스트의 고정 IP 주소입니다.

   2

   대상 베어 메탈 호스트의 고정 IP 주소 서브넷 접두사입니다.

   3

   대상 베어 메탈 호스트의 DNS 서버.

   4

   대상 베어 메탈 호스트의 게이트웨이입니다.

   5

   interfaces 섹션에 지정된 이름과 일치해야 합니다.

   6

   인터페이스의 mac 주소입니다.

2. BareMetalHost 사용자 정의 리소스를 생성할 때 mac 주소 중 하나가 NMStateConfig 대상 베어 메탈 호스트의 mac 주소와 일치하는지 확인합니다.

3. InfraEnv 사용자 정의 리소스를 생성할 때 InfraEnv 사용자 정의 리소스의 NMStateConfig 사용자 정의 리소스에서 라벨을 참조합니다.

   apiVersion: agent-install.openshift.io/v1beta1
   kind: InfraEnv
   metadata:
     name: <cluster_name>
     namespace: <cluster_name>
   spec:
     clusterRef:
       name: <cluster_name>
       namespace: <cluster_name>
     sshAuthorizedKey: <public_key>
     agentLabels: 1
       location: "<label-name>"
     pullSecretRef:
       name: assisted-deployment-pull-secret
     nmStateConfigLabelSelector:
       matchLabels:
         sno-cluster-<cluster-name>: <cluster_name> # Match this label

   1

   일치하는 레이블을 설정합니다. 이 레이블은 에이전트가 부팅될 때 적용됩니다.

1. 검색 이미지 ISO 파일이 타겟 시스템에서 생성 및 부팅됩니다.
2. ISO 파일이 대상 시스템에서 성공적으로 부팅되면 대상 시스템의 하드웨어 정보를 보고합니다.
3. 모든 호스트가 발견되면 OpenShift Container Platform이 설치됩니다.
4. OpenShift Container Platform 설치를 완료하면 허브에서 대상 클러스터에 klusterlet 서비스를 설치합니다.
5. 요청된 애드온 서비스는 대상 클러스터에 설치됩니다.

절차

1. 관리 클러스터의 상태를 확인합니다.

   $ oc get managedcluster

   True 는 관리 클러스터가 준비되었음을 나타냅니다.

2. 에이전트 상태를 확인합니다.

   $ oc get agent -n <cluster_name>

3. describe 명령을 사용하여 에이전트 상태에 대한 자세한 설명을 제공합니다. BackendError,InputError ,ValidationsFailing,InstallationFailed 및 AgentIsConnected가 포함된 상태를 인식합니다. 이러한 상태는 Agent 및 Agent ClusterInstall 사용자 정의 리소스와 관련이 있습니다.

   $ oc describe agent -n <cluster_name>

4. 클러스터 프로비저닝 상태를 확인합니다.

   $ oc get agentclusterinstall -n <cluster_name>

5. 클러스터 프로비저닝 상태에 대한 자세한 설명을 제공하려면 describe 명령을 사용합니다.

   $ oc describe agentclusterinstall -n <cluster_name>

6. 관리 클러스터의 애드온 서비스의 상태를 확인합니다.

   $ oc get managedclusteraddon -n <cluster_name>

7. 관리 클러스터의 kubeconfig 파일의 인증 정보를 검색합니다.

   $ oc get secret -n <cluster_name> <cluster_name>-admin-kubeconfig -o jsonpath={.data.kubeconfig} | base64 -d > <directory>/<cluster_name>-kubeconfig

절차

1. 미러 레지스트리 구성이 포함된 ConfigMap 을 생성합니다.

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: assisted-installer-mirror-config
     namespace: assisted-installer
     labels:
       app: assisted-service
   data:
     ca-bundle.crt: <certificate> 1
     registries.conf: |  2
       unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
   
       [[registry]]
         location = <mirror_registry_url>  3
         insecure = false
         mirror-by-digest-only = true

   1

   미러 레지스트리를 생성할 때 사용되는 미러 레지스트리의 인증서입니다.

   2

   미러 레지스트리의 구성입니다.

   3

   미러 레지스트리의 URL입니다.

   그러면 다음과 같이 AgentServiceConfig 사용자 정의 리소스에서 mirrorRegistryRef 가 업데이트되었습니다.

   출력 예

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
     namespace: assisted-installer
   spec:
     databaseStorage:
       volumeName: <db_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <db_storage_size>
     filesystemStorage:
       volumeName: <fs_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <fs_storage_size>
     mirrorRegistryRef:
       name: 'assisted-installer-mirror-config'
     osImages:
       - openshiftVersion: <ocp_version>
         rootfs: <rootfs_url> 1
         url: <iso_url> 2

   1 2

   HTTPD 서버의 URL과 일치해야 합니다.

2. 연결이 끊긴 설치의 경우 연결이 끊긴 네트워크를 통해 연결할 수 있는 NTP 시계를 배포해야 합니다. 서버 역할을 하도록 chrony를 구성하고, /etc/chrony.conf 파일을 편집하고, 다음과 같은 허용된 IPv6 범위를 추가하여 이 작업을 수행할 수 있습니다.

   # Allow NTP client access from local network.
   #allow 192.168.0.0/16
   local stratum 10
   bindcmdaddress ::
   allow 2620:52:0:1310::/64

절차

1. AgentClusterInstall 사용자 정의 리소스에서 IPv6 주소의 in clusterNetwork 및 serviceNetwork 를 수정합니다.

   apiVersion: extensions.hive.openshift.io/v1beta1
   kind: AgentClusterInstall
   metadata:
     # Only include the annotation if using OVN, otherwise omit the annotation
     annotations:
       agent-install.openshift.io/install-config-overrides: '{"networking":{"networkType":"OVNKubernetes"}}'
     name: <cluster_name>
     namespace: <cluster_name>
   spec:
     clusterDeploymentRef:
       name: <cluster_name>
     imageSetRef:
       name: <cluster_image_set>
     networking:
       clusterNetwork:
       - cidr: "fd01::/48"
         hostPrefix: 64
       machineNetwork:
       - cidr: <machine_network_cidr>
       serviceNetwork:
       - "fd02::/112"
     provisionRequirements:
       controlPlaneAgents: 1
       workerAgents: 0
     sshPublicKey: <public_key>

2. NMStateConfig 사용자 지정 리소스를 사용자가 정의한 IPv6 주소로 업데이트합니다.

절차

1. 관리 클러스터의 상태를 확인합니다.

   $ oc get managedcluster

   출력 예

   NAME            HUB ACCEPTED   MANAGED CLUSTER URLS   JOINED   AVAILABLE   AGE
   SNO-cluster     true                                   True     True      2d19h

   AVAILABLE 열의 상태가 True 이면 관리 클러스터가 허브에서 관리되고 있습니다.

   AVAILABLE 열의 상태가 Unknown 이면 관리 클러스터가 허브에서 관리되지 않습니다. 다음 단계를 사용하여 자세한 정보를 확인하십시오.

2. AgentClusterInstall 설치 상태를 확인합니다.

   $ oc get clusterdeployment -n <cluster_name>

   출력 예

   NAME        PLATFORM            REGION   CLUSTERTYPE   INSTALLED    INFRAID    VERSION  POWERSTATE AGE
   Sno0026    agent-baremetal                               false                          Initialized
   2d14h

   INSTALLED 열의 상태가 false 이면 설치가 실패합니다.

3. 설치에 실패하면 다음 명령을 입력하여 AgentClusterInstall 리소스의 상태를 검토합니다.

   $ oc describe agentclusterinstall -n <cluster_name> <cluster_name>

4. 오류를 해결하고 클러스터를 재설정합니다.

   1. 클러스터의 관리 클러스터 리소스를 제거합니다.

      $ oc delete managedcluster <cluster_name>

   2. 클러스터의 네임스페이스를 제거합니다.

      $ oc delete namespace <cluster_name>

      그러면 이 클러스터에 대해 생성된 네임스페이스 범위의 사용자 정의 리소스가 모두 삭제됩니다. 계속하기 전에 ManagedCluster CR 삭제가 완료될 때까지 기다려야 합니다.

   3. 관리 클러스터에 대한 사용자 정의 리소스를 다시 생성합니다.