Exportar dados para a Central de migração

Depois de coletar os dados sobre seus recursos, exporte-os para a Central de migração, onde é possível fazer o seguinte:

Este documento descreve como exportar os dados para a Central de migração para uma avaliação on-line usando a CLI do discovery client da Central de migração.

Antes de começar

  1. Siga as etapas para descobrir recursos na sua infraestrutura.
  2. No console do Google Cloud, ative a Central de migração.
  3. Ative a API Cloud Resource Manager.

    Ativar a API

Analisar as funções e permissões necessárias

Para receber as permissões necessárias para exportar os dados coletados para a Migration Center, peça ao administrador para conceder a você o papel do IAM de administrador da Migration Center (migrationcenter.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para exportar os dados coletados para o Migration Center. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para exportar os dados coletados para a Central de migração:

  • resourcemanager.projects.get
  • migrationcenter.sources.create
  • migrationcenter.sources.get
  • migrationcenter.assets.reportFrames

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Configurar a autenticação para a Central de migração

Para exportar os dados coletados para a Central de migração, primeiro é necessário configurar a autenticação com um dos seguintes métodos:

  • Usar uma conta pessoal.
  • Usando uma conta de serviço.

Para usar esses métodos com a Google Cloud CLI, conforme descrito neste documento, é necessário instalar e inicializar a CLI do gcloud.

Configurar a autenticação usando uma conta pessoal

  • Forneça suas credenciais de usuário ao Application Default Credentials (ADC):

    gcloud --project PROJECT_ID auth application-default login
    

    Substitua PROJECT_ID pelo nome ou ID do projeto.

Configurar a autenticação usando uma conta de serviço

  1. Se você tiver as permissões necessárias, crie uma conta de serviço:

    gcloud iam service-accounts create SA_NAME \
        --description='SA_DESCRIPTION' \
        --display-name='SA_DISPLAY_NAME'
    

    Substitua:

    • SA_NAME: o nome que você quer para a conta de serviço
    • SA_DESCRIPTION: uma descrição opcional da conta de serviço.
    • SA_DISPLAY_NAME: o nome de exibição da conta de serviço
  2. Para conceder as permissões necessárias à conta de serviço, atribua o papel migrationcenter.admin:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member='serviceAccount:SA_NAME@PROJECT_ID.iam.gserviceaccount.com' \
        --role='roles/migrationcenter.admin'
    

    Substitua PROJECT_ID pelo nome do projeto.

  3. Crie uma chave de conta de serviço:

    gcloud iam service-accounts keys create ~/sa-private-key.json \
     --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com \
     --billing-project PROJECT_ID
    

    A chave é salva no caminho especificado: ~/sa-private-key.json.

  4. Copie o arquivo de chave para a máquina em que você quer executar a CLI mcdc.

Limitações

Exportar os dados coletados

Depois que a configuração de coleta de dados e autenticação para a Central de migração for concluída, você poderá exportar os dados coletados para a Central de migração.

  • Para exportar os dados coletados da estação de trabalho para o Migration Center, execute o seguinte comando:

    Linux

    ./mcdc export mc --project PROJECT_ID

    Windows

    mcdc.exe export mc --project PROJECT_ID

    Substitua PROJECT_ID pelo nome do projeto.

  • Se você configurou a autenticação no Migration Center usando uma chave de conta de serviço, informe o caminho para o arquivo de chave JSON usando a flag --sa-key:

    Linux

    ./mcdc export mc --project PROJECT_ID --json-key PATH_TO_JSON_KEY

    Windows

    mcdc.exe export mc --project PROJECT_ID --json-key PATH_TO_JSON_KEY

    Substitua PATH_TO_JSON_KEY pelo caminho para o arquivo de chave JSON.

    Como alternativa, se você quiser esperar que o Migration Center termine de processar os recursos e verificar se todo o trabalho foi concluído, use a flag --wait com o comando export.

Depois que a exportação for concluída, o discovery client vai mostrar um link que você pode seguir para conferir seus recursos na Central de migração.

A seguir