22.2. ZTP 용 hub 클러스터 준비

절차

1. 미러 호스트에 로그인합니다.

2. mirror.openshift.com 에서 RHCOS ISO 및 RootFS 이미지를 가져옵니다. 예를 들면 다음과 같습니다.

   1. 필요한 이미지 이름 및 OpenShift Container Platform 버전을 환경 변수로 내보냅니다.

      $ export ISO_IMAGE_NAME=<iso_image_name> 1

      $ export ROOTFS_IMAGE_NAME=<rootfs_image_name> 1

      $ export OCP_VERSION=<ocp_version> 1

      1

      ISO 이미지 이름(예: rhcos-4.11.1-x86_64-live.x86_64.iso)

      1

      rootfs 이미지 이름(예: rhcos-4.11.1-x86_64-live-rootfs.x86_64.img)

      1

      OpenShift Container Platform 버전(예: 4.11.1)

   2. 필요한 이미지를 다운로드합니다.

      $ sudo wget https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/4.11/${OCP_VERSION}/${ISO_IMAGE_NAME} -O /var/www/html/${ISO_IMAGE_NAME}

      $ sudo wget https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/4.11/${OCP_VERSION}/${ROOTFS_IMAGE_NAME} -O /var/www/html/${ROOTFS_IMAGE_NAME}

절차

1. 다음 명령을 실행하여 AgentServiceConfig CR을 업데이트합니다.

   $ oc edit AgentServiceConfig

2. CR의 items.spec.osImages 필드에 다음 항목을 추가합니다.

   - cpuArchitecture: x86_64
       openshiftVersion: "4.11"
       rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
       url: https://<mirror-registry>/<path>/rhcos-live.x86_64.iso

   다음과 같습니다.

   <host>

   대상 미러 레지스트리 HTTP 서버의 FQDN(정규화된 도메인 이름)입니다.

   <path>

   대상 미러 레지스트리의 이미지 경로입니다.

   편집기를 저장하고 종료하여 변경 사항을 적용합니다.

절차

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
   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과 일치해야 합니다.

절차

1. ArgoCD 파이프라인 구성을 준비합니다.

   1. 예제 디렉터리와 유사한 디렉터리 구조를 사용하여 Git 리포지토리를 생성합니다. 자세한 내용은 " GitOps ZTP 사이트 구성 리포지토리 준비"를 참조하십시오.

   2. ArgoCD UI를 사용하여 리포지토리에 대한 액세스를 구성합니다. 설정에서 다음을 구성합니다.

      • 리포지토리 - 연결 정보를 추가합니다. URL은 .git 로 끝나야 합니다(예: https://repo.example.com/repo.git 및 인증 정보).
      • 인증서 - 필요한 경우 리포지토리의 공용 인증서를 추가합니다.

   3. Git 리포지토리를 기반으로 두 개의 ArgoCD 애플리케이션 out/argocd/deployment/clusters-app.yaml 및 out/argocd/deployment/policies-app.yaml 을 수정합니다.

      • Git 리포지토리를 가리키도록 URL을 업데이트합니다. URL은 .git 로 끝납니다(예: https://repo.example.com/repo.git).
      • targetRevision 은 모니터링할 Git 리포지토리 분기를 나타냅니다.
      • path 는 각각 site Config 및 PolicyGenTemplate CR의 경로를 지정합니다.

2. ZTP GitOps 플러그인을 설치하려면 이전에 out/argocd/deployment/ 디렉터리에 추출된 패치 파일을 사용하여 hub 클러스터의 ArgoCD 인스턴스를 패치해야 합니다. 다음 명령을 실행합니다.

   $ oc patch argocd openshift-gitops \
   -n openshift-gitops --type=merge \
   --patch-file out/argocd/deployment/argocd-openshift-gitops-patch.json

3. 다음 명령을 사용하여 허브 클러스터에 파이프라인 구성을 적용합니다.

   $ oc apply -k out/argocd/deployment

절차

1. site Config 및 PolicyGenTemplate CR에 대한 별도의 경로를 사용하여 디렉터리 구조를 생성합니다.

2. 다음 명령을 사용하여 ztp-site-generate 컨테이너 이미지에서 argocd 디렉터리를 내보냅니다.

   $ podman pull registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.11

   $ mkdir -p ./out

   $ podman run --log-driver=none --rm registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.11 extract /home/ztp --tar | tar x -C ./out

3. out 디렉터리에 다음 하위 디렉터리가 포함되어 있는지 확인합니다.

   • 아웃/extra-manifest 에는 SiteConfig 에서 추가 매니페스트 configMap 을 생성하는 데 사용하는 소스 CR 파일이 포함되어 있습니다.
   • out/source-crs 에는 PolicyGenTemplate 이 RHACM(Red Hat Advanced Cluster Management) 정책을 생성하는 데 사용하는 소스 CR 파일이 포함되어 있습니다.
   • out/argocd/deployment 에는 이 프로세스의 다음 단계에서 사용할 수 있도록 hub 클러스터에 적용하는 패치 및 YAML 파일이 포함되어 있습니다.
   • out/argocd/example 에는 권장 구성을 나타내는 SiteConfig 및 PolicyGenTemplate 파일의 예가 포함되어 있습니다.