1.2. Red Hat OpenShift GitOps Operator에 관리형 클러스터 등록
푸시 모델을 사용하여 OpenShift GitOps를 구성하려면 Kubernetes 관리 클러스터에 대해 하나 이상의 Red Hat Advanced Cluster Management 세트를 OpenShift GitOps Operator 인스턴스에 등록할 수 있습니다. 등록한 후에는 해당 클러스터에 애플리케이션을 배포할 수 있습니다. 개발, 스테이징 및 프로덕션 환경의 클러스터 전체에서 애플리케이션 일관성을 자동화하는 OpenShift GitOps 환경을 설정합니다.
1.2.1. 사전 요구 사항
- Red Hat Advanced Cluster Management for Kubernetes에 Red Hat OpenShift GitOps Operator 를 설치해야 합니다.
- 하나 이상의 관리 클러스터를 가져옵니다.
- 관리 클러스터를 OpenShift GitOps에 등록하려면 Creating a ManagedClusterSet 설명서를 완료합니다.
1.2.2. Red Hat OpenShift GitOps에 관리형 클러스터 등록
관리 클러스터를 OpenShift GitOps에 등록하려면 다음 단계를 완료합니다.
-
OpenShift GitOps가 배포된 네임스페이스에 대한 관리형 클러스터 세트 바인딩을 생성합니다. 관리 클러스터를
openshift-gitops
네임스페이스에 바인딩하는 예는multicloud-integrations
managedclusterset
바인딩 예제를 참조하십시오. 추가 리소스 섹션에서 ManagedClusterSetBinding 생성에 대한 자세한 내용은ManagedClusterSetBinding
리소스 생성 을 참조하십시오. 배치 정보는 ManagedClusterSets에서 ManagedClusters 필터링 을 참조하십시오. 관리 클러스터 세트 바인딩에 사용되는 네임스페이스에서
배치
사용자 정의 리소스를 생성하여 OpenShift GitOps Operator 인스턴스에 등록할 관리 클러스터 세트를 선택합니다.multicloud-integration
배치 예제를 템플릿으로 사용합니다. 배치 정보는 배치와 함께 ManagedClusterSets 사용을 참조하십시오.참고:
- OpenShift Container Platform 클러스터만 다른 Kubernetes 클러스터가 아닌 OpenShift GitOps Operator 인스턴스에 등록됩니다.
-
일부 불안정한 네트워크 시나리오에서는 관리 클러스터가 일시적으로 사용할 수
없거나
연결할 수 없는
상태가 될 수 있습니다. 자세한 내용은 Red Hat Advanced Cluster Management 및 OpenShift GitOps의 배치 허용 오차 구성 을 참조하십시오.
GitOpsCluster
사용자 지정 리소스를 생성하여 배치 결정에서 OpenShift GitOps의 지정된 인스턴스로 관리 클러스터 집합을 등록합니다. 이를 통해 OpenShift GitOps 인스턴스에서 해당 Red Hat Advanced Cluster Management 관리 클러스터에 애플리케이션을 배포할 수 있습니다.multicloud-integrations
OpenShift GitOps 클러스터 예제를 사용합니다.참고: 참조된
배치
리소스는GitOpsCluster
리소스와 동일한 네임스페이스에 있어야 합니다. 다음 예제를 참조하십시오.apiVersion: apps.open-cluster-management.io/v1beta1 kind: GitOpsCluster metadata: name: gitops-cluster-sample namespace: dev spec: argoServer: cluster: local-cluster argoNamespace: openshift-gitops placementRef: kind: Placement apiVersion: cluster.open-cluster-management.io/v1beta1 name: all-openshift-clusters 1
- 1
placementRef.name
값은all-openshift-clusters
이며argoNamespace: openshift-gitops
에 설치된 OpenShift GitOps 인스턴스의 대상 클러스터로 지정됩니다.argoServer.cluster
사양에는local-cluster
값이 필요합니다.
- 변경 사항을 저장하십시오. 이제 OpenShift GitOps 워크플로에 따라 애플리케이션을 관리할 수 있습니다.
1.2.3. Red Hat OpenShift GitOps에 OpenShift Container Platform 클러스터 등록
이제 Red Hat Advanced Cluster Management GitOpsCluster
리소스를 사용하여 OpenShift GitOps 클러스터에 OpenShift Container Platform 클러스터를 등록할 수 있습니다. 이 기능을 사용하면 OpenShift GitOps 콘솔을 사용하여 비OpenShift Container Platform 클러스터에 애플리케이션 리소스를 배포할 수 있습니다. OpenShift GitOps에 비 OpenShift Container Platform 클러스터를 등록하려면 다음 단계를 완료하십시오.
비 OpenShift Container Platform
ManagedCluster
리소스사양에서
API 서버 URL로 이동하여 다음 명령을 실행하여 검증합니다.oc get managedclusters eks-1
출력이 다음 정보와 유사한지 확인합니다.
NAME HUB ACCEPTED MANAGED CLUSTER URLS JOINED AVAILABLE AGE eks-1 true https://5E336C922AB16684A332C10535B8D407.gr7.us-east-2.eks.amazonaws.com True True 37m
OpenShift Container Platform
MangedCluster
리소스사양
의 API 서버 URL이 비어 있으면 다음 단계를 완료하여 수동으로 업데이트합니다.API 서버 URL을 완료하려면 다음 명령을 실행하여
MangedCluster
리소스사양
을 편집합니다.oc edit managedclusters eks-1
YAML이 다음 파일과 유사한지 확인합니다.
spec: managedClusterClientConfigs: - caBundle: ZW1wdHlDQWJ1bmRsZQo= url: https://5E336C922AB16684A332C10535B8D407.gr7.us-east-2.eks.amazonaws.com
변경 사항을 저장한 다음 다음 명령을 실행하여 API 서버가 완료되었는지 확인합니다.
oc get managedclusters eks-1
- 출력이 다음 정보와 유사한지 확인합니다.
NAME HUB ACCEPTED MANAGED CLUSTER URLS JOINED AVAILABLE AGE eks-1 true https://5E336C922AB16684A332C10535B8D407.gr7.us-east-2.eks.amazonaws.com True True 37m
클러스터 보안이 생성되었는지 확인하려면
openshift-gitops
네임스페이스로 이동하여GitOpsCluster
리소스 상태가 보고되는지확인합니다
.참고:
Red Hat Advanced Cluster Management 2.12 이상에서는 다음 가져오기 모드를 사용하는 경우 모든 유형의 OpenShift Container Platform
ManagedCluster
리소스에 대한 API 서버 URL이 자동으로 렌더링됩니다.- 기존 클러스터에 대한 서버 URL 및 API 토큰을 입력합니다.
-
기존 클러스터에 대한
kubeconfig
파일을 입력합니다.
다음 경우
ManagedClusters
리소스 중 하나에 API 서버 URL을 비워 둘 수 있습니다.- OpenShift Container Platform이 아닌 클러스터는 버전 2.12 이전 Red Hat Advanced Cluster Management Hub 클러스터로 가져옵니다.
-
비 OpenShift Container Platform 클러스터는 가져오기 모드인 가져오기 모드인
가져오기 명령을
통해 버전 2.12의 Red Hat Advanced Cluster Management Hub 클러스터로 수동으로 가져옵니다.
1.2.4. Red Hat OpenShift GitOps 토큰
OpenShift GitOps Operator와 통합할 때 배치 및 ManagedClusterSetBinding
사용자 정의 리소스를 통해 OpenShift GitOps 네임스페이스에 바인딩된 모든 관리형 클러스터에 대해 ManagedCluster
에 액세스할 수 있는 토큰이 있는 시크릿은 OpenShift GitOps 인스턴스 서버 네임스페이스에 생성됩니다.
OpenShift GitOps 컨트롤러에서 리소스를 관리형 클러스터에 동기화하려면 이 시크릿이 필요합니다. 기본적으로 서비스 계정 애플리케이션 관리자는 관리 클러스터에 대한 클러스터 관리자 권한으로 작동하여 OpenShift GitOps 인스턴스 서버 네임스페이스에서 OpenShift GitOps 클러스터 시크릿을 생성합니다. 기본 네임스페이스는 openshift-gitops
입니다.
이 기본값을 사용하지 않으려면 OpenShift GitOps 인스턴스 서버 네임스페이스에서 OpenShift GitOps 클러스터 시크릿을 생성하기 위해 관리 클러스터에 대한 사용자 지정 권한이 있는 서비스 계정을 생성합니다. 기본 네임스페이스는 여전히 openshift-gitops
입니다. 자세한 내용은 Argo CD 내보내기 모델에 대한 사용자 지정 서비스 계정 생성 을 참조하십시오.
1.2.5. 추가 리소스
자세한 내용은 다음 리소스 및 예제를 참조하십시오.