Anthos 연결 클러스터 설정

이 페이지에서는 요구사항을 준수하는 Kubernetes 클러스터를 Anthos에 연결하는 방법을 설명합니다. 클러스터를 연결하면 Google Cloud Console에서 Anthos 클러스터와 함께 기존 Kubernetes 클러스터가 표시되며 이 클러스터에 Anthos Config Management를 사용한 구성을 포함하여 Anthos 기능 중 일부를 사용 설정할 수 있습니다.

기본 요건

요구사항을 준수하는 Kubernetes 클러스터를 Anthos에 연결하여 Cloud Console에서 Anthos 클러스터와 함께 표시할 수 있습니다.

기타 지원되는 Anthos 기능 사용을 포함해 Google에서 검증한 클러스터 유형과 버전은 다음과 같습니다.

  • Kubernetes 버전 1.16, 1.17, 1.18의 Amazon Elastic Kubernetes Service(Amazon EKS)
  • Kubernetes 버전 1.16, 1.17, 1.18의 Microsoft Azure Kubernetes Service(Microsoft AKS)
  • Red Hat OpenShift Kubernetes Engine(OKE) 버전 4.4
  • Red Hat OpenShift 컨테이너 플랫폼(OCP) 버전 4.4

자세한 내용은 아래의 Anthos 기능 사용 설정 섹션을 참조하세요.

시작하기 전에

  1. Google 계정으로 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

  3. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. Anthos API를 사용 설정합니다.

    API 사용 설정

  5. Cloud SDK 설치 및 초기화

연결된 클러스터 등록

클러스터가 있는 위치에 관계없이 Connect를 사용하여 프로젝트의 Environ에 Anthos와 함께 사용할 클러스터를 등록해야 합니다. Environ은 Anthos의 일부로 여러 클러스터와 워크로드를 보고 관리하는 통합 방법을 제공합니다. Environ에 대한 자세한 내용과 Environ에서 사용 설정하는 기능은 Environ 가이드에서 확인할 수 있습니다.

모든 클러스터를 한 번에 등록할 필요는 없지만 클러스터가 Cloud Console의 Anthos 클러스터 페이지에 표시되어 모든 Anthos 기능을 사용할 수 있도록 새 클러스터를 만들 때마다 등록해야 합니다. Anthos 요금은 등록된 클러스터에만 적용됩니다.

gcloud 명령줄 도구를 사용하면 직접 Connect Agent 매니페스트를 다운로드하고 적용하는 등 Cloud Console에서 사용할 수 없는 몇 가지 고급 클러스터 등록 옵션이 제공됩니다. 이러한 옵션에 대한 자세한 내용은 Connect 문서의 고급 등록 옵션을 참조하세요.

클러스터를 등록하기 전에 Connect 기본 요건을 확인하여 클러스터를 등록하기 위한 관련 권한이 있고 API를 사전 설정했는지 확인합니다.

Console

클러스터를 등록하려면 다음 안내를 따르세요.

  1. Google Cloud Console에서 Anthos 클러스터 페이지로 이동합니다. 이 페이지에는 등록된 모든 클러스터가 표시됩니다.

    Anthos 클러스터 페이지로 이동

  2. 기존 클러스터 등록을 클릭합니다.

  3. 외부 클러스터 추가를 클릭합니다.

  4. 클러스터 이름 필드에 등록하려는 클러스터의 이름을 입력합니다.

  5. 선택사항: Google Cloud 라벨을 클러스터에 추가합니다.

  6. 등록 명령어 생성을 클릭합니다.

  7. Cloud Shell 또는 서비스 계정 사용자 인증 정보를 저장한 위치에서 페이지에 표시된 gcloud 명령어를 수정하고 실행합니다. 다음 값을 지정해야 합니다.

    • CLUSTER_CONTEXT는 kubeconfig 파일에 나타나는 클러스터의 컨텍스트입니다. kubectl config current-context를 실행하면 명령줄에서 이 값을 가져올 수 있습니다.
    • KUBECONFIG_PATH는 kubeconfig 파일이 저장된 로컬 파일 경로입니다. 환경 변수가 설정되면 기본값은 $KUBECONFIG입니다. 그렇지 않으면 기본값은 $HOME/.kube/config입니다.
    • LOCAL_KEY_PATH는 서비스 계정 키 파일의 경로입니다.

    이 명령어를 실행하면 Connect Agent가 사용자 클러스터에 배포됩니다. Connect Agent가 Google Cloud에 연결되고 클러스터가 등록되면 성공 메시지가 페이지에 표시됩니다.

  8. 라벨 설정을 클릭하거나 라벨을 설정하지 않았으면 건너뛰기를 클릭합니다.

gcloud

다음 명령어를 실행합니다.

 gcloud container hub memberships register MEMBERSHIP_NAME \
   --context=KUBECONFIG_CONTEXT \
   --kubeconfig=KUBECONFIG_PATH \
   --service-account-key-file=SERVICE_ACCOUNT_KEY_PATH

다음을 바꿉니다.

  • MEMBERSHIP_NAME: 허브에 등록되는 클러스터를 고유하게 나타내는 데 사용되는 멤버십 이름입니다.
  • SERVICE_ACCOUNT_KEY_PATH: 기본 요건의 일부로 다운로드한 서비스 계정의 비공개 키 JSON 파일의 로컬 파일 경로입니다. 이 서비스 계정 키는 gke-connect 네임스페이스에 creds-gcp라는 보안 비밀로 저장됩니다.
  • KUBECONFIG_CONTEXT: kubeconfig 파일에 나타나는 것과 같이 등록된 클러스터의 클러스터 컨텍스트입니다. kubectl config current-context를 실행하면 명령줄에서 이 값을 가져올 수 있습니다.
  • KUBECONFIG_PATH: 등록 중인 클러스터의 항목을 포함하는 kubeconfig가 저장된 로컬 파일 경로입니다. 환경 변수가 설정된 경우 기본값은 $KUBECONFIG입니다. 그렇지 않으면 이 기본값은 $HOME/.kube/config입니다.

연결된 클러스터에서 Anthos 기능 사용 설정

클러스터를 등록하면 클러스터에서 애플리케이션에 사용 가능한 Anthos 기능을 사용 설정할 수 있습니다. 이러한 기능은 검증된 클러스터 유형에서만 지원됩니다. 이 유형에서 지원되는 현재 기능 버전은 버전 및 업그레이드 지원에서 확인할 수 있습니다.

다음 가이드에서는 클러스터에서 지원되는 기능을 사용 설정하는 방법을 보여줍니다.

가이드, 참조 자료 등 모든 Anthos 구성요소에 대한 전체 문서 집합은 Anthos 구성요소를 참조하세요.

다음 단계