Migrate for Anthos のインストール

このトピックでは、Migrate for Anthos を処理クラスタにインストールする方法について説明します。

処理クラスタは、Migrate for Anthos コンポーネントがインストールされた Google Kubernetes Engine(GKE)または Anthos クラスタであり、本番環境クラスタにデプロイする前に VM を移行する際に使用できます。

このトピックのステップを使用して、migctl コマンドライン ツールまたは Google Cloud Console で、作成済みの GKE クラスタに必要な Migrate for Anthos コンポーネントをインストールします。

移行した VM をイメージとして本番環境クラスタにデプロイし、処理クラスタが新しい移行を実行するうえで不要になったと判断した場合に、処理クラスタを削除できます。

migctl について

Migrate for Anthos には、Google Cloud Console のサポートのほかに、migctl コマンドライン ツールが用意されています。このツールは、移行プロセスのさまざまな部分で使用できます。

  • Google Cloud で Google Kubernetes Engine(GKE)または Anthos を処理クラスタとして使用する場合は、Cloud Shellmigctl を実行します。

  • 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 で connect コマンドを実行します。

    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.7.0/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.7.0/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 コンポーネントをインストールします。

  7. 最後の Cloud Shell コマンドを実行して、インストールのステータスをモニタリングします。

    インストールが完了する前に、次のようなメッセージが表示されることがあります。メッセージが表示された場合は、インストールが完了するまで数分待ってから migctl doctor を再度実行してください。

    migctl doctor
    [!] Deployment
       Validation checks failed.
    

    次の出力例のチェックマークは、Migrate for Anthos が正常にデプロイされたことを示します。

    migctl doctor
    [✓] Deployment
    [✓] Docker registry
    [✓] Artifacts repo
    [!] Source Status
  8. インストールが正常に完了したら [Done] を選択します。

インストール オプション

さまざまなサイズと構成のクラスタを作成できます。たとえば、複数のノードプールを持つクラスタを作成し、その後、移行処理、ワークロードの実行、その他のオペレーションにそれぞれ別のノードプールを使用できます。

デフォルトでは、Migrate for Anthos はすべてのクラスタノードにインストールされます。Migrate for Anthos によって使用されるノードを制御するには、--node-selectors オプションと --tolerations オプションを使用して migctl setup install コマンドに実行します。

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

    ラベルと値のペアのカンマ区切りのリストを指定します。これにより、Migrate for Anthos で使用するノードが決まります。ラベルの詳細については、ラベルの作成と管理をご覧ください。

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

    ノード taint をまとめて指定する effect に関連する Key-Value ペアのカンマ区切りのリストを指定します。toleration とは、Key-Value と effect で指定されたノード taint で Pod を実行できることを意味します。

    EFFECT または VALUE を省略すると、toleration では、KEY,VALUE(任意の EFFECT の場合)または KEY(任意の VALUE:EFFECT の場合)の taint を一致させます。

    Node Taints の詳細については、Node Taints によるスケジューリングの制御をご覧ください。

次のステップ