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 você pode fazer o seguinte:

Neste documento, descrevemos 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. Conclua 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

Revisar os papéis e as permissões necessários

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

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

Permissões necessárias

As seguintes permissões 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

Talvez você também consiga receber essas permissões com papéis personalizados ou outros papéis predefinidos.

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

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

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

Para usar esses métodos com a Google Cloud CLI, conforme descrito neste documento, você precisa instalar e inicializar a CLI 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 seu 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 para a conta de serviço.
    • SA_DISPLAY_NAME: o nome de exibição da conta de serviço

  2. Para conceder à conta de serviço as permissões necessárias, 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 da coleta e autenticação de dados para a Central de migração for concluída, continue exportando os dados coletados para a Central.

  • Para exportar os dados coletados da estação de trabalho para a Central de migração, 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ê tiver configurado a autenticação na Central de migração usando uma chave de conta de serviço, será necessário fornecer o caminho para o arquivo de chave JSON usando a sinalização --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.

    Opcionalmente, se você quiser esperar até que a Central de migração termine de processar os recursos e verificar se todo o trabalho foi realizado, use a sinalização --wait com o comando export.

Após a conclusão da exportação, o discovery client imprime um link que pode ser acessado para ver seus recursos na Central de migração.

A seguir