Migrate for Anthos 설치

이 주제에서는 처리 클러스터에 Migrate for Anthos를 설치하는 방법을 설명합니다.

처리 클러스터는 Migrate for Anthos 구성요소가 설치된 Google Kubernetes Engine(GKE) 또는 Anthos 클러스터이며 프로덕션 클러스터에 배포하기 전에 VM을 마이그레이션하는 데 사용됩니다.

이 주제에서 안내하는 단계에 따라 migctl 명령줄 도구 또는 Google Cloud Console을 사용해 필수 Migrate for Anthos 구성요소를 이미 만든 GKE 클러스터에 설치합니다.

마이그레이션된 VM을 프로덕션 클러스터에 이미지로 배포한 후에는 처리 클러스터가 더 이상 새 마이그레이션을 수행하는 데 필요하지 않다고 추정하여 처리 클러스터를 삭제할 수 있습니다.

migctl 정보

Migrate for Anthos에는 Google Cloud Console 지원 기능과 더불어 마이그레이션의 모든 파트를 수행하는 데 사용할 수 있는 migctl 명령줄 도구가 포함되어 있습니다.

  • Google Cloud에서 Google Kubernetes Engine(GKE) 또는 Anthos 처리 클러스터를 사용할 경우 Cloud Shell에서 migctl을 실행합니다.

  • GKE On-Prem 처리 클러스터를 사용할 때 관리 워크스테이션에 migctl을 설치하고 실행할 수 있습니다.

시작하기 전에

Migrate for Anthos 설치

Google Cloud용 migctl

migctl 명령어를 사용하여 Migrate for Anthos를 설치하고 마이그레이션에 필요한 기본사항으로 구성합니다.

  1. Container Registry 및 Cloud Storage에 액세스하기 위한 서비스 계정을 만들었는지 확인하고 서비스 계정 구성의 설명대로 JSON 키 파일을 다운로드합니다.

  2. Cloud Console에서 GKE 메뉴로 이동합니다.

    GKE 메뉴로 이동

  3. 클러스터 목록에서 처리 클러스터로 사용할 클러스터를 찾아 연결 버튼을 클릭합니다.

  4. 클러스터에 연결 대화상자의 명령줄 액세스 밑에서 Cloud Shell에서 실행을 클릭하여 Cloud Shell에서 연결 명령어를 실행합니다.

    gcloud container clusters get-credentials my-cluster --zone us-central1-c --project my-project
    
  5. Cloud Shell에서 migctl setup install 명령어를 실행하고 설치 서비스 계정을 지정하여 처리 클러스터에서 Migrate for Anthos 구성요소를 설정합니다.

    migctl setup install --json-key=m4a-install.json
    
  6. migctl doctor 명령어를 실행하여 Migrate for Anthos 설치를 확인합니다.

    설치가 완료되기 전에 다음과 같은 메시지가 표시될 수 있습니다. 그러면 설치가 완료될 때까지 몇 분 정도 기다렸다가 migctl doctor를 실행합니다.

    migctl doctor
    [!] Deployment
        Validation checks failed.
    

    다음 출력 예시에서 체크표시는 Migrate for Anthos가 성공적으로 배포되었고 필요한 데이터 저장소가 구성되었음을 나타냅니다.

    migctl doctor
    [✓] Deployment
    [✓] Docker registry
    [✓] Artifacts repo
    [!] Source Status
    

    Docker 레지스트리 또는 아티팩트 저장소와 연관된 오류가 있으면 데이터 저장소 정의를 참조하세요.

VMware용 migctl

  1. 기본 프로젝트 ID를 설정합니다.
    gcloud config set project project-id
  2. 관리 워크스테이션에 migctl을 배포합니다.
    wget https://anthos-migrate-release.storage.googleapis.com/v1.6.2/linux/amd64/migctl
    sudo cp migctl /usr/local/bin/
    sudo chmod +x /usr/local/bin/migctl
    . <(migctl completion bash)
  3. migctl setup install 명령어를 실행하여 처리 클러스터에서 Migrate for Anthos 구성요소를 설정합니다.
    migctl setup install --gkeop
  4. migctl doctor 명령어를 실행하여 Migrate for Anthos 설치를 확인합니다. 설치가 완료되기 전에 다음과 같은 메시지가 표시될 수 있습니다. 그러면 설치가 완료될 때까지 몇 분 정도 기다렸다가 migctl doctor를 실행합니다.
    migctl doctor
      [!] Deployment
          Validation checks failed.
    다음 출력 예시에서 체크표시는 Migrate for Anthos가 성공적으로 배포되었지만 필요한 데이터 저장소를 아직 구성하지 않았음을 나타냅니다.
    migctl doctor
      [✓] Deployment
      [!] Docker registry
      [!] Artifacts repo
      [!] Source Status
  5. 데이터 저장소 정의에 설명된 대로 클러스터에 필요한 데이터 저장소를 구성합니다.
  6. 필요한 경우 HTTPS 프록시 구성에 설명된 대로 아웃바운드 인터넷 액세스를 위한 HTTPS 프록시를 구성하세요.

AWS용 migctl

이 절차에서는 클러스터에서 migctl을 실행해야 합니다. 워크스테이션의 클러스터 연결 상태에 따라 배스천 호스트에 터널을 열어야 할 수 있습니다. 자세한 내용은 관리 서비스에 연결을 참조하세요.

  1. 기본 프로젝트 ID를 설정합니다.
    gcloud config set project project-id
  2. 관리 워크스테이션에 migctl을 배포합니다.
    wget https://anthos-migrate-release.storage.googleapis.com/v1.6.2/linux/amd64/migctl
    sudo cp migctl /usr/local/bin/
    sudo chmod +x /usr/local/bin/migctl
    . <(migctl completion bash)
  3. migctl setup install 명령어를 실행하여 처리 클러스터에서 Migrate for Anthos 구성요소를 설정합니다.
    migctl setup install --gke-on-aws
  4. migctl doctor 명령어를 실행하여 Migrate for Anthos 설치를 확인합니다. 설치가 완료되기 전에 다음과 같은 메시지가 표시될 수 있습니다. 그러면 설치가 완료될 때까지 몇 분 정도 기다렸다가 migctl doctor를 실행합니다.
    migctl doctor
      [!] Deployment
          Validation checks failed.
    다음 출력 예시에서 체크표시는 Migrate for Anthos가 성공적으로 배포되었지만 필요한 데이터 저장소를 아직 구성하지 않았음을 나타냅니다.
    migctl doctor
      [✓] Deployment
      [!] Docker registry
      [!] Artifacts repo
      [!] Source Status
  5. 데이터 저장소 정의에 설명된 대로 클러스터에 필요한 데이터 저장소를 구성합니다.
  6. 필요한 경우 HTTPS 프록시 구성에 설명된 대로 아웃바운드 인터넷 액세스를 위한 HTTPS 프록시를 구성하세요.

Console

Google Cloud Console은 필요한 설치 명령어를 생성하고 Cloud Shell에서 이를 실행하여 설치 프로세스를 지원해 줍니다.

  1. Cloud Console에서 Migrate for Anthos 페이지를 엽니다.

    Migrate for Anthos 페이지로 이동

  2. 클러스터 처리 탭을 클릭하여 사용 가능한 클러스터가 포함된 테이블을 표시합니다.

  3. 처리 클러스터 추가를 클릭합니다.

  4. 마이그레이션할 워크로드 유형을 Linux 또는 Windows로 선택한 후 다음을 선택합니다.

  5. 드롭다운 목록에서 클러스터를 선택한 후 다음을 선택합니다.

  6. Cloud Shell에서 각 명령어를 실행하여 Container Registry 및 Cloud Storage 액세스용 서비스 계정을 만들고 Migrate for Anthos 구성요소를 설치합니다.

    Cloud Shell을 승인하라는 메시지가 표시됩니다.
  7. 마지막 Cloud Shell 명령어를 사용하여 설치 상태를 모니터링합니다.

    설치가 완료되기 전에 다음과 같은 메시지가 표시될 수 있습니다. 이 경우 설치가 완료될 때까지 몇 분 정도 기다린 후 migctl doctor를 다시 실행합니다.

    migctl doctor
    [!] Deployment
       Validation checks failed.
    

    다음 출력 예시에서 체크표시는 Migrate for Anthos가 성공적으로 배포되었음을 나타냅니다.

    migctl doctor
    [✓] Deployment
    [✓] Docker registry
    [✓] Artifacts repo
    [!] Source Status
  8. 설치가 완료되면 완료를 선택합니다.

설치 옵션

다양한 크기 및 구성으로 클러스터를 만들 수 있습니다. 예를 들어 여러 노드 풀이 있는 클러스터가 있을 수 있습니다. 그런 다음 마이그레이션을 처리하는 데 노드 풀 1개, 워크로드를 실행하는 데 노드 풀 1개, 기타 작업을 위한 다른 노드 풀을 사용합니다.

기본적으로 Migrate for Anthos는 모든 클러스터 노드에 설치됩니다. Migrate for Anthos에서 사용되는 노드를 제어하려면 migctl setup install 명령어에 --node-selectors--tolerations 옵션을 사용하면 됩니다.

  • --node-selectors LABEL1=VALUE1,LABEL2=VALUE2,...

    Migrate for Anthos에서 사용되는 노드를 결정하는 라벨 값 쌍의 쉼표로 구분된 목록을 지정합니다. 라벨 사용에 대한 자세한 내용은 라벨 만들기 및 관리를 참조하세요.

  • --tolerations KEY1=VALUE1:EFFECT1,KEY2=VALUE2:EFFECT2,...

    노드 taint를 함께 지정하는 효과와 연결된 쉼표로 구분된 목록 키-값 쌍을 지정합니다. toleration은 키-값과 효과로 지정된 노드 taint에서 pod를 실행할 수 있음을 의미합니다.

    EFFECT 또는 VALUE를 생략할 경우 toleration은 KEY,VALUE(모든 EFFECT의 경우) 또는 KEY(모든 VALUE:EFFECT의 경우)로 taint를 일치시킵니다.

    노드 taint에 대한 자세한 내용은 노드 taint로 예약 관리를 참조하세요.

다음 단계