19.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.12.1-x86_64-live.x86_64.iso)

      1

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

      1

      OpenShift Container Platform 버전(예: 4.12.1)

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

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

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

절차

1. 프로비저닝 리소스를 활성화하여 모든 네임스페이스를 조사하고 연결이 끊긴 환경에 대한 미러를 구성합니다. 자세한 내용은 중앙 인프라 관리 서비스 활성화를 참조하십시오.

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

   $ oc edit AgentServiceConfig

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

   - cpuArchitecture: x86_64
       openshiftVersion: "4.12"
       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: multicluster-engine 1
     labels:
       app: assisted-service
   data:
     ca-bundle.crt: <certificate> 2
     registries.conf: | 3
       unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
   
       [[registry]]
         location = <mirror_registry_url> 4
         insecure = false
         mirror-by-digest-only = true

   1

   ConfigMap 네임스페이스는 multicluster-engine 으로 설정해야 합니다.

   2

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

   3

   미러 레지스트리의 구성 파일입니다. 미러 레지스트리 구성은 Discovery 이미지의 /etc/containers/registries.conf 에 미러 정보를 추가합니다. 미러 정보는 설치 프로그램에 전달될 때 install-config.yaml 파일의 imageContentSources 섹션에 저장됩니다. HUB 클러스터에서 실행 중인 지원 서비스 Pod는 구성된 미러 레지스트리에서 컨테이너 이미지를 가져옵니다.

   4

   미러 레지스트리의 URL입니다. 미러 레지스트리를 구성할 때 oc adm release mirror 명령을 실행하여 imageContentSources 섹션의 URL을 사용해야 합니다. 자세한 내용은 OpenShift Container Platform 이미지 저장소 미러링 섹션을 참조하십시오.

   이 업데이트는 다음과 같이 AgentServiceConfig 사용자 정의 리소스에서 mirrorRegistryRef 를 업데이트합니다.

   출력 예

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
     namespace: multicluster-engine 1
   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 2
     osImages:
       - openshiftVersion: <ocp_version>
         url: <iso_url> 3

   1

   ConfigMap 네임스페이스와 일치하도록 AgentServiceConfig 네임스페이스를 multicluster-engine 으로 설정합니다.

   2

   관련 ConfigMap CR에 지정된 정의와 일치하도록 mirrorRegistryRef.name 을 설정합니다.

   3

   httpd 서버에서 호스팅되는 ISO의 URL 설정

절차

1. 다음 명령을 실행하여 AgentServiceConfig CR(사용자 정의 리소스)을 업데이트합니다.

   $ oc edit AgentServiceConfig agent

2. CR에 unauthenticatedRegistries 필드를 추가합니다.

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
   spec:
     unauthenticatedRegistries:
     - example.registry.com
     - example.registry2.com
     ...

   인증되지 않은 레지스트리는 AgentServiceConfig 리소스의 spec.unauthenticatedRegistries 에 나열됩니다. 이 목록의 레지스트리는 설명된 클러스터 설치에 사용된 풀 시크릿에 항목이 필요하지 않습니다. assisted-service 는 설치에 사용되는 모든 이미지 레지스트리에 대한 인증 정보가 포함되어 있는지 확인하여 풀 시크릿을 검증합니다.

1. hub 클러스터에 대한 디버그 쉘 프롬프트를 엽니다.

   $ oc debug node/<node_name>

2. 다음 명령을 실행하여 인증되지 않은 레지스트리에 대한 액세스를 테스트합니다.

   sh-4.4# podman login -u kubeadmin -p $(oc whoami -t) <unauthenticated_registry>

   다음과 같습니다.

   <unauthenticated_registry>

   새 레지스트리(예: unauthenticated-image-registry.openshift-image-registry.svc:5000 )입니다.

   출력 예

   Login Succeeded!

절차

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

   참고

   연결이 끊긴 환경의 경우 로컬 레지스트리에 미러링된 ztp-site-generate 이미지를 사용하여 out/argocd/deployment/argocd-openshift-gitops-patch.json 파일을 수정합니다. 다음 명령을 실행합니다.

   $ oc patch argocd openshift-gitops -n openshift-gitops --type='json' \
   -p='[{"op": "replace", "path": "/spec/repo/initContainers/0/image", \
   "value": "<local_registry>/<ztp_site_generate_image_ref>"}]'

   다음과 같습니다.

   <local_registry>

   연결이 끊긴 레지스트리의 URL입니다(예: my.local.registry:5000).

   <ztp-site-generate-image-ref>

   로컬 레지스트리의 미러링된 ztp-site-generate 이미지의 경로입니다(예: openshift4-ztp-site-generate:custom ).

3. RHACM 2.7 이상에서는 다중 클러스터 엔진에서 기본적으로 cluster-proxy-addon 기능을 활성화합니다. 이 기능을 비활성화하려면 다음 패치를 적용하여 이 애드온을 담당하는 관련 허브 클러스터 및 관리 클러스터 Pod를 비활성화하고 제거합니다.

   $ oc patch multiclusterengines.multicluster.openshift.io multiclusterengine --type=merge --patch-file out/argocd/deployment/disable-cluster-proxy-addon.json

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

   $ 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.12

   $ mkdir -p ./out

   $ podman run --log-driver=none --rm registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.12 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 파일의 예가 포함되어 있습니다.