9장. SiteConfig 리소스를 사용한 고급 관리 클러스터 구성
SiteConfig
CR(사용자 정의 리소스)을 사용하여 설치 시 관리 클러스터에 사용자 정의 기능 및 구성을 배포할 수 있습니다.
9.1. GitOps ZTP 파이프라인에서 추가 설치 매니페스트 사용자 정의
GitOps ZTP(ZTP) 파이프라인의 설치 단계에 포함할 추가 매니페스트 세트를 정의할 수 있습니다. 이러한 매니페스트는 site Config CR
(사용자 정의 리소스)에 연결되며 설치 중에 클러스터에 적용됩니다. 설치 시 MachineConfig
CR을 포함하면 설치 프로세스의 효율성이 향상됩니다.
사전 요구 사항
- 사용자 지정 사이트 구성 데이터를 관리하는 Git 리포지토리를 생성합니다. 리포지토리는 hub 클러스터에서 액세스할 수 있어야 하며 Argo CD 애플리케이션의 소스 리포지토리로 정의해야 합니다.
프로세스
- GitOps ZTP 파이프라인에서 클러스터 설치를 사용자 정의하는 데 사용하는 추가 매니페스트 CR 세트를 생성합니다.
사용자 지정
/siteconfig
디렉터리에서 추가 매니페스트를 위한 하위 디렉터리/custom-manifest
를 생성합니다. 다음 예제에서는/custom-manifest
폴더가 있는 샘플/siteconfig
를 보여줍니다.siteconfig ├── site1-sno-du.yaml ├── site2-standard-du.yaml ├── extra-manifest/ └── custom-manifest └── 01-example-machine-config.yaml
참고전체에서 사용되는 하위 디렉터리 이름
/custom-manifest
및/extra-manifest
는 예제 이름 전용입니다. 이러한 이름을 사용할 필요는 없으며 이러한 하위 디렉터리의 이름을 지정하는 방법에 대한 제한은 없습니다. 이 예에서/extra-manifest
는ztp-site-generate
컨테이너에서/extra-manifest
의 콘텐츠를 저장하는 Git 하위 디렉터리를 나타냅니다.-
사용자 정의 매니페스트 CR을
siteconfig/custom-manifest
디렉터리에 추가합니다. SiteConfig
CR에서extraManifests.searchPaths
필드에 디렉터리 이름을 입력합니다. 예를 들면 다음과 같습니다.clusters: - clusterName: "example-sno" networkType: "OVNKubernetes" extraManifests: searchPaths: - extra-manifest/ 1 - custom-manifest/ 2
-
SiteConfig
,/extra-manifest
CR 및/custom-manifest
CR을 저장하고 사이트 구성 리포지터리로 푸시합니다.
클러스터 프로비저닝 중에 GitOps ZTP 파이프라인은 /custom-manifest
디렉터리의 CR을 extra-manifest /에 저장된 추가
매니페스트 세트에 추가합니다.
4.14 버전의 extraManifestPath
에는 사용 중단 경고가 적용됩니다.
extraManifestPath
는 계속 지원되지만 extraManifests.searchPaths
를 사용하는 것이 좋습니다. SiteConfig
파일에 extraManifests.searchPaths
를 정의하는 경우 GitOps ZTP 파이프라인은 사이트 설치 중에 ztp-site-generate
컨테이너에서 매니페스트를 가져오지 않습니다.
Siteconfig
CR에서 extraManifestPath
및 extraManifests.searchPaths
를 모두 정의하는 경우 extraManifests.searchPaths
에 정의된 설정이 우선합니다.
ztp-site-generate
컨테이너에서 /extra-manifest
의 내용을 추출하여 GIT 리포지토리로 내보내는 것이 좋습니다.