18장. 수동으로 호스트 클러스터 가져오기
호스팅된 컨트롤 플레인을 사용할 수 있게 되면 호스팅된 클러스터는 멀티 클러스터 엔진 Operator로 자동으로 가져옵니다.
18.1. 가져온 호스팅 클러스터를 관리하는 데 대한 제한 사항 링크 복사링크가 클립보드에 복사되었습니다!
호스팅된 클러스터는 독립 실행형 OpenShift Container Platform 또는 타사 클러스터와 달리 Kubernetes Operator의 로컬 멀티 클러스터 엔진으로 자동으로 가져옵니다. 호스팅된 클러스터는 에이전트에서 클러스터의 리소스를 사용하지 않도록 호스팅 모드에서 일부 에이전트를 실행합니다.
호스팅된 클러스터를 자동으로 가져오는 경우 관리 클러스터에서 HostedCluster 리소스를 사용하여 호스팅된 클러스터에서 노드 풀과 컨트롤 플레인을 업데이트할 수 있습니다. 노드 풀과 컨트롤 플레인을 업데이트하려면 "호스트 클러스터에서 노드 풀 업그레이드" 및 "호스팅 클러스터에서 컨트롤 플레인 업그레이드"를 참조하십시오.
RHACM(Red Hat Advanced Cluster Management)을 사용하여 호스팅된 클러스터를 로컬 다중 클러스터 엔진 Operator 이외의 위치로 가져올 수 있습니다. 자세한 내용은 "Red Hat Advanced Cluster Management에서 Kubernetes Operator 호스팅 클러스터용 다중 클러스터 엔진 검색"을 참조하십시오.
이 토폴로지에서는 클러스터가 호스팅되는 Kubernetes Operator에 대한 명령줄 인터페이스 또는 로컬 다중 클러스터 엔진의 콘솔을 사용하여 호스팅되는 클러스터를 업데이트해야 합니다. RHACM 허브 클러스터를 통해 호스팅된 클러스터를 업데이트할 수 없습니다.
18.2. 수동으로 호스트 클러스터 가져오기 링크 복사링크가 클립보드에 복사되었습니다!
일반적으로 호스팅된 컨트롤 플레인을 사용할 수 있게 되면 호스팅된 클러스터는 멀티 클러스터 엔진 Operator로 자동으로 가져옵니다. 그러나 필요에 따라 호스팅 클러스터를 수동으로 가져올 수 있습니다.
절차
-
콘솔에서 인프라
클러스터를 클릭하고 가져올 호스팅 클러스터를 선택합니다. 호스팅 클러스터 가져오기 를 클릭합니다.
참고검색된 호스팅 클러스터의 경우 콘솔에서 가져올 수도 있지만 클러스터는 업그레이드 가능 상태여야 합니다. 호스팅된 컨트롤 플레인을 사용할 수 없기 때문에 호스팅된 클러스터가 업그레이드 가능한 상태가 아닌 경우 클러스터에서 가져오기가 비활성화됩니다. 가져오기 를 클릭하여 프로세스를 시작합니다. 클러스터가 업데이트를 수신하는 동안 상태가
Importing된 다음Ready로 변경됩니다.
18.3. AWS에서 수동으로 호스트 클러스터 가져오기 링크 복사링크가 클립보드에 복사되었습니다!
명령줄 인터페이스를 사용하여 AWS(Amazon Web Services)에서 호스팅 클러스터를 가져올 수 있습니다.
절차
다음 샘플 YAML 파일을 사용하여
ManagedCluster리소스를 생성합니다.apiVersion: cluster.open-cluster-management.io/v1 kind: ManagedCluster metadata: annotations: import.open-cluster-management.io/hosting-cluster-name: local-cluster import.open-cluster-management.io/klusterlet-deploy-mode: Hosted open-cluster-management/created-via: hypershift labels: cloud: auto-detect cluster.open-cluster-management.io/clusterset: default name: <hosted_cluster_name> vendor: OpenShift name: <hosted_cluster_name> spec: hubAcceptsClient: true leaseDurationSeconds: 60&
lt;hosted_cluster_name>을 호스트된 클러스터 이름으로 바꿉니다.다음 명령을 실행하여 리소스를 적용합니다.
$ oc apply -f <file_name>&
lt;file_name>을 이전 단계에서 생성한 YAML 파일 이름으로 바꿉니다.Red Hat Advanced Cluster Management를 설치한 경우 다음 샘플 YAML 파일을 사용하여
KlusterletAddonConfig리소스를 생성합니다. 다중 클러스터 엔진 Operator만 설치한 경우 다음 단계를 건너뜁니다.apiVersion: agent.open-cluster-management.io/v1 kind: KlusterletAddonConfig metadata: name: <hosted_cluster_name> namespace: <hosted_cluster_namespace> spec: clusterName: <hosted_cluster_name> clusterNamespace: <hosted_cluster_namespace> clusterLabels: cloud: auto-detect vendor: auto-detect applicationManager: enabled: true certPolicyController: enabled: true iamPolicyController: enabled: true policyController: enabled: true searchCollector: enabled: false-
&
lt;hosted_cluster_name>을 호스트된 클러스터 이름으로 바꿉니다. -
&
lt;hosted_cluster_namespace>를 호스팅된 클러스터 네임스페이스의 이름으로 바꿉니다.
-
&
다음 명령을 실행하여 리소스를 적용합니다.
$ oc apply -f <file_name>&
lt;file_name>을 이전 단계에서 생성한 YAML의 이름으로 바꿉니다.가져오기 프로세스가 완료되면 콘솔에 호스팅된 클러스터가 표시됩니다. 다음 명령을 실행하여 호스팅 클러스터의 상태를 확인할 수도 있습니다.
$ oc get managedcluster <hosted_cluster_name>
18.4. 멀티 클러스터 엔진 Operator로 호스트 클러스터 자동 가져오기 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
컨트롤 플레인을 사용할 수 있게 되면 호스팅된 클러스터는 멀티 클러스터 엔진 Operator로 자동으로 가져옵니다. 필요한 경우 호스팅 클러스터의 자동 가져오기를 비활성화할 수 있습니다.
자동 가져오기를 비활성화하더라도 이전에 가져온 호스팅 클러스터는 영향을 받지 않습니다. 다중 클러스터 엔진 Operator 2.5로 업그레이드하고 자동 가져오기가 활성화되면 컨트롤 플레인을 사용할 수 있는 경우 가져오지 않은 모든 호스팅 클러스터를 자동으로 가져옵니다.
Red Hat Advanced Cluster Management가 설치된 경우 모든 Red Hat Advanced Cluster Management 애드온도 활성화됩니다.
자동 가져오기가 비활성화되면 새로 생성된 호스팅 클러스터만 자동으로 가져오지 않습니다. 이미 가져온 호스트 클러스터는 영향을 받지 않습니다. 콘솔을 사용하거나 ManagedCluster 및 KlusterletAddonConfig 사용자 정의 리소스를 생성하여 클러스터를 수동으로 가져올 수 있습니다.
절차
허브 클러스터에서 다음 명령을 입력하여 다중 클러스터 엔진 Operator가 설치된 네임스페이스의
AddonDeploymentConfig리소스에 있는hypershift-addon-deploy-config사양을 엽니다.$ oc edit addondeploymentconfig hypershift-addon-deploy-config \ -n multicluster-enginespec.customizedVariables섹션에서 다음 예와 같이 값이"true"인autoImportDisabled변수를 추가합니다.apiVersion: addon.open-cluster-management.io/v1alpha1 kind: AddOnDeploymentConfig metadata: name: hypershift-addon-deploy-config namespace: multicluster-engine spec: customizedVariables: - name: hcMaxNumber value: "80" - name: hcThresholdNumber value: "60" - name: autoImportDisabled value: "true"-
자동 가져오기를 다시 활성화하려면
autoImportDisabled변수 값을"false"로 설정하거나AddonDeploymentConfig리소스에서 변수를 제거합니다.