Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

1.8. 검색 서비스

OpenShift Cluster Manager 에서 사용할 수 있는 OpenShift Container Platform 클러스터를 검색할 수 있습니다. 검색 후 관리할 클러스터를 가져올 수 있습니다. Discovery 서비스는 백엔드 및 콘솔 사용에 Discover Operator를 사용합니다.

OpenShift Cluster Manager 인증 정보가 있어야 합니다. 인증 정보를 생성해야 하는 경우 OpenShift Cluster Manager의 인증 정보 생성 을 참조하십시오.

필요한 액세스: 관리자

1.8.1. 서비스 계정 인증
링크 복사

OpenShift Cluster Manager 에서 사용할 수 있는 OpenShift Container Platform 클러스터를 검색하려면 서비스 계정으로 인증해야 합니다. OpenShift Cluster Manager 오프라인 토큰은 더 이상 사용되지 않습니다.

사전 요구 사항

1.8.1.1. 인증
링크 복사

서비스 계정으로 인증하려면 다음 절차를 참조하십시오.

  1. 다중 클러스터 엔진 운영자 콘솔에서 service-account client-id 및 client-secret 쌍으로 새 인증 정보 시크릿을 생성합니다.
  2. 다중 클러스터 엔진 operator Discovery 서비스에서 올바르게 인증하고 클러스터를 검색할 수 있도록 서비스 계정 client-id 및 client-secret 쌍을 지정합니다.
  3. 가져오기를 위해 AWS DiscoveredCluster 리소스에서 Red Hat OpenShift Service를 관리형 클러스터로 설정합니다. service-account 자격 증명을 사용하여 시작된 AWS 가져오기 흐름의 Red Hat OpenShift Service는 클러스터를 인증하고 가져옵니다.
Expand
표 1.10. 배포된 구성 요소 목록
Role액세스 권한

OpenShift Cluster Manager cluster autoscaler editor

클러스터 자동 스케일러에서 업데이트 작업 수행

OpenShift Cluster Manager cluster editor

클러스터에서 업데이트 작업 수행

OpenShift Cluster Manager 클러스터 프로비저너

클러스터에서 프로비저닝 작업 수행

OpenShift Cluster Manager cluster viewer

클러스터에서 읽기 작업 수행

OpenShift Cluster Manager IdP editor

IdP에서 업데이트 작업 수행

OpenShift Cluster Manager 시스템 풀 편집기

머신 풀에서 업데이트 작업 수행

OpenShift Cluster Manager 조직 관리자

연결된 조직의 클러스터에서 사용 가능한 모든 작업을 수행합니다.

서브스크립션 뷰어

모든 서브스크립션 리소스에서 읽기 작업을 수행합니다.

1.8.2. 콘솔을 사용하여 Discovery 구성
링크 복사

콘솔을 통해 클러스터를 찾도록 Discovery를 구성합니다. 클러스터에서 Discovery 기능을 구성할 때 DiscoveryConfig 리소스가 OpenShift Cluster Manager에 연결하여 조직의 일부인 클러스터 검색을 시작해야 합니다. 별도의 인증 정보를 사용하여 여러 DiscoveryConfig 리소스를 생성할 수 있습니다.

클러스터를 검색한 후 콘솔의 Discovered clusters 탭에 표시되는 클러스터를 가져올 수 있습니다. 제품 콘솔을 사용하여 Discovery를 활성화합니다.

필수 액세스: 인증 정보가 생성된 네임스페이스에 대한 액세스입니다.

사전 요구 사항

1.8.2.1. 콘솔에서 검색된 클러스터 가져오기
링크 복사

다른 인프라 공급자에서 검색된 클러스터를 수동으로 가져오려면 다음 단계를 완료합니다.

  1. 기존 클러스터 페이지로 이동하여 Discovered clusters 탭을 클릭합니다.
  2. Discovered clusters 테이블에서 가져올 클러스터를 찾습니다.
  3. 옵션 메뉴에서 클러스터 가져오기 를 선택합니다.
  4. 검색된 클러스터의 경우 문서를 사용하여 수동으로 가져오거나 클러스터 가져오기를 자동으로 선택할 수 있습니다.
  5. 인증 정보 또는 Kubeconfig 파일을 사용하여 자동으로 가져오려면 콘텐츠를 복사하여 붙여넣습니다.
  6. 가져오기 를 클릭합니다.

1.8.2.2. 검색된 클러스터 보기
링크 복사

인증 정보를 설정하고 가져올 클러스터를 검색한 후 콘솔에서 해당 정보를 볼 수 있습니다.

  1. Clusters > Discovered clusters 를 클릭합니다.

  2. 다음 정보로 채워진 테이블을 확인합니다.

    • name 은 OpenShift Cluster Manager에 지정된 표시 이름입니다. 클러스터에 표시 이름이 없으면 클러스터 콘솔 URL을 기반으로 생성된 이름이 표시됩니다. OpenShift Cluster Manager에서 콘솔 URL이 없거나 수동으로 수정된 경우 클러스터 외부 ID가 표시됩니다.
    • 네임스페이스 는 인증 정보 및 검색된 클러스터를 생성한 네임스페이스입니다.
    • type 은 검색된 클러스터 Red Hat OpenShift 유형입니다.
    • 배포 버전은 검색된 클러스터 Red Hat OpenShift 버전입니다.
    • 인프라 공급자는 검색된 클러스터의 클라우드 공급자입니다.
    • 마지막 활성 은 검색된 클러스터가 마지막으로 활성화된 시간입니다.
    • 검색된 클러스터가 생성 될 때 생성됩니다.
    • 검색된 클러스터가 검색된 시기를 검색합니다.
    • 클러스터 유형은 클러스터 의 플랫폼 유형(예: OpenShift Container Platform 또는 AWS의 Red Hat OpenShift Service)입니다.
    • 인프라 공급자는 AWS(Amazon Web Services) 또는 Microsoft Azure와 같이 클러스터가 실행되는 위치에 따라 필터링합니다.
  3. 또한 표에서 모든 정보를 검색할 수 있습니다. 예를 들어 특정 네임스페이스에 있는 Discovered 클러스터 만 표시하려면 해당 네임스페이스를 검색합니다.
  4. 이제 클러스터 가져오기를 클릭하여 관리 클러스터를 생성할 수 있습니다.

1.8.3. CLI를 사용하여 Discovery 활성화
링크 복사

CLI를 사용하여 검색을 활성화하여 OpenShift Cluster Manager에서 사용할 수 있는 클러스터를 찾습니다.

필요한 액세스: 관리자

사전 요구 사항

  • OpenShift Cluster Manager에 연결할 자격 증명을 생성합니다.

1.8.3.1. 검색 설정 및 프로세스
링크 복사

참고: DiscoveryConfig 라는 이름은 discovery 이고 선택한 인증 정보와 동일한 네임스페이스에서 생성해야 합니다. 다음 DiscoveryConfig 샘플을 참조하십시오. 

apiVersion: discovery.open-cluster-management.io/v1
kind: DiscoveryConfig
metadata:
  name: discovery
  namespace: <NAMESPACE_NAME>
spec:
  credential: <SECRET_NAME>
  filters:
    lastActive: 7
    openshiftVersions:
    - "4.x"
Copy to Clipboard Toggle word wrap
  1. SECRET_NAME 을 이전에 설정한 인증 정보로 교체합니다.
  2. NAMESPACE_NAME 을 SECRET_NAME 의 네임스페이스로 바꿉니다.
  3. 검색할 클러스터의 마지막 활동 이후 최대 시간을 입력합니다. 예를 들어 lastActive: 7 에서는 지난 7일 동안 활성 상태인 클러스터가 검색됩니다.
  4. 검색할 OpenShift Container Platform 클러스터 버전을 입력하여 문자열 목록으로 검색합니다. 참고: openshiftVersions 목록의 모든 항목은 메이저 및 마이너 버전을 지정합니다. 예를 들어 4.x를 지정하면 4.x.1,4.x.2 와 같은 모든 에라타 릴리스가 포함됩니다.

1.8.3.2. 검색된 클러스터 보기
링크 복사

oc get discoveredclusters -n <namespace >를 실행하여 검색된 클러스터를 확인합니다. 여기서 namespace 는 검색 인증 정보가 존재하는 네임스페이스입니다.

오브젝트는 검색 컨트롤러에서 생성합니다. 이러한 DiscoveredClusters 는 DiscoveryConfig 검색된clusters.discovery.open-cluster-management.io API에 지정된 필터 및 자격 증명을 사용하여 OpenShift Cluster Manager에 있는 클러스터를 나타냅니다. name 값은 클러스터 외부 ID입니다. 

apiVersion: discovery.open-cluster-management.io/v1
kind: DiscoveredCluster
metadata:
  name: <cluster-external-id>
  namespace: <NAMESPACE_NAME>
spec:
  activity_timestamp: "2022-04-19T21:06:14Z"
  cloudProvider: vsphere
  console: https://console-openshift-console.apps.qe1-vmware-pkt.dev02.red-chesterfield.com
  creation_timestamp: "2022-04-19T16:29:53Z"
  credential:
    apiVersion: v1
    kind: Secret
    name: <SECRET_NAME>
    namespace: <NAMESPACE_NAME>
  display_name: qe1-vmware-pkt.dev02.red-chesterfield.com
  name: <cluster-external-id>
  openshiftVersion: 4.x
  status: Stale
Copy to Clipboard Toggle word wrap

1.8.4. 관리를 위해 검색된 클러스터 활성화
링크 복사

개별 클러스터를 수동으로 가져오지 않고 Discovery-Operator 를 사용하여 지원되는 클러스터를 허브 클러스터로 자동으로 가져옵니다.

필수 액세스: 클러스터 관리자

사전 요구 사항

  • Discovery는 기본적으로 활성화되어 있습니다. 기본 설정을 변경한 경우 Discovery를 활성화해야 합니다.
  • AWS 명령줄 인터페이스에서 Red Hat OpenShift Service를 설정해야 합니다. AWS CLI에서 Red Hat OpenShift Service 시작하기 설명서를 참조하십시오.

다음 절차는 Discovery-Operator 를 사용하여 AWS에서 검색된 Red Hat OpenShift Service 및 호스팅된 컨트롤 플레인 클러스터를 자동으로 가져오는 방법의 예입니다. 콘솔 또는 명령줄 인터페이스에서 가져올 수 있습니다.

  • 콘솔에서 가져옵니다. 콘솔에서 리소스를 수정하고 importAsManagedCluster 필드를 true 로 설정해야 합니다.

    1. 콘솔에서 hub 클러스터에 로그인합니다.
    2. 탐색 메뉴에서 Search 를 선택합니다.
    3. 검색 모음에서 "DiscoveredCluster" 쿼리를 입력합니다.
    4. DiscoveredCluster 리소스 결과가 표시됩니다.

    5. DiscoveredCluster 리소스로 이동하여 importAsManagedCluster 를 true 로 설정합니다. importAsManagedCluster 가 true 로 설정되고 < 4.x.z >가 지원되는 OpenShift Container Platform 버전인 다음 예제를 참조하십시오. 

      apiVersion: discovery.open-cluster-management.io/v1
kind: DiscoveredCluster
metadata:
  name: 28c17977-fc73-4050-b5cc-a5aa2d1d6892
  namespace: discovery
spec:
  openshiftVersion: <4.x.z>
  isManagedCluster: false
  cloudProvider: aws
  name: 28c17977-fc73-4050-b5cc-a5aa2d1d6892
  displayName: rosa-dc
  status: Active
  importAsManagedCluster: true
      1 
      
  type: <supported-type>
      2
      Copy to Clipboard Toggle word wrap
      1
      필드를 true 로 설정하면 Discovery-Operator 에서 DiscoveredCluster 리소스를 가져오고 ManagedCluster 리소스를 생성하고 Red Hat Advanced Cluster Management가 설치된 경우 KlusterletAddOnConfig 리소스를 생성합니다. 자동 가져오기를 위해 Secret 리소스도 생성합니다.
      2
      ROSA 또는 MultiClusterEngineHCP 를 매개변수 값으로 사용해야 합니다.
    6. DiscoveredCluster 리소스를 가져오려면 클러스터 페이지로 이동합니다. 클러스터 목록 탭에서 클러스터 가져오기 상태를 확인합니다.

    7. 자동 다시 가져오기를 방지하기 위해 Discovery의 관리 클러스터를 분리하려면 Detach 클러스터 옵션을 선택합니다. Discovery-Operator 는 다음 주석 discovery.open-cluster-management.io/previously-auto-imported: 'true' 를 추가합니다.

      DiscoveredCluster 리소스는 다음 YAML과 유사할 수 있습니다. 

      apiVersion: discovery.open-cluster-management.io/v1
kind: DiscoveredCluster
metadata:
  annotations:
    discovery.open-cluster-management.io/previously-auto-imported: 'true'
      Copy to Clipboard Toggle word wrap

    8. DiscoveredCluster 리소스가 자동으로 다시 가져오기되지 않았는지 확인하려면 Discovery-Operator 로그에서 다음 메시지를 확인합니다. 여기서 "rosa-dc" 가 검색된 클러스터입니다. 

      2024-06-12T14:11:43.366Z INFO reconcile	Skipped automatic import for DiscoveredCluster due to
existing 'discovery.open-cluster-management.io/previously-auto-imported' annotation {"Name": "rosa-dc"}
      Copy to Clipboard Toggle word wrap

    참고: DiscoveredCluster 리소스를 자동으로 다시 가져오려면 이전에 언급한 주석을 제거해야 합니다.

  • 명령줄 인터페이스에서 가져옵니다.

    1. 명령줄 인터페이스에서 DiscoveredCluster 리소스를 자동으로 가져오려면 다음을 수행합니다. 로그인 후 다음 명령을 사용하여 importAsManagedCluster paramater를 true 로 설정합니다. &lt ;name&gt; 및 < namespace >를 사용자 이름과 네임스페이스로 바꿉니다. 

      oc patch discoveredcluster <name> -n <namespace> --type='json' -p='[{"op": "replace", "path": "/spec/importAsManagedCluster", "value": true}]'
      Copy to Clipboard Toggle word wrap

    2. 다음 명령을 실행하여 클러스터를 관리 클러스터로 가져왔는지 확인합니다. 

      oc get managedcluster <name>
      Copy to Clipboard Toggle word wrap
    3. AWS 클러스터 ID의 Red Hat OpenShift Service에 대한 설명을 보려면 AWS 명령줄 인터페이스의 Red Hat OpenShift Service에서 다음 명령을 실행합니다. 
    rosa describe cluster --cluster=<cluster-name> | grep -o ^ID:.*
    Copy to Clipboard Toggle word wrap

중요: 다른 Kubernetes 공급자의 경우 이러한 인프라 공급자 DiscoveredCluster 리소스를 수동으로 가져와야 합니다. Kubernetes 구성을 다른 유형의 DiscoveredCluster 리소스에 직접 적용합니다. DiscoveredCluster 리소스에서 importAsManagedCluster 필드를 활성화하면 Discovery webhook로 인해 가져오지 않습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat