Nesta página, descrevemos como usar o MConnect para gerar painéis do Looker Studio com dados coletados pelo Google Cloud Migration Center e pelo CAST.
Assista o tutorial para começar a usar o MConnect.
Visão geral
O MConnect é uma interface de linha de comando que ajuda a mesclar informações da Central de Migração e da análise estática de código de aplicativos realizada pela CAST Software. Em seguida, ele exporta os dados para o BigQuery e o Looker Studio para análise avançada.
Ele ajuda a modernizar aplicativos comparando várias dimensões da transformação, como nível de esforço, nível de prontidão do código e impacto nos recursos de computação.
Antes de começar
Antes de usar o MConnect, faça o seguinte:
- Crie uma Conta do Google e uma conta do Google Cloud .
- Crie um Google Cloud projeto e ative as APIs BigQuery e Migration Center.
- Para a Central de migração, consulte Começar a usar a Central de migração.
- Para o BigQuery, consulte Como começar a usar o BigQuery.
- Instale a Google Cloud CLI na sua máquina local.
- Crie um relatório de Destaque da CAST
chamado
analysisResults.csv.
Preços
Você pode receber cobranças do BigQuery, do Looker Studio e do CAST, de acordo com os preços respectivos.
Gerar um painel para seus dados
As seções a seguir explicam como gerar um painel do Looker Studio para seus dados do CAST.
Configurar a ferramenta
Antes de usar o MConnect, faça o seguinte:
Se você usa o Linux, faça o download do binário mais recente. Para outras plataformas de SO, clone o repositório
migrationcenter-utilse crie o MConnect na sua máquina local.Faça a autenticação na Google Cloud CLI:
gcloud init gcloud auth application-default loginVerifique se a conta que você está usando tem as permissões necessárias para criar e excluir grupos no Migration Center e para criar e excluir tabelas no BigQuery no projeto que você quer usar.
Fazer upload dos recursos para o Migration Center
Faça upload dos recursos relacionados aos aplicativos no seu relatório do CAST para a Central de migração. Se você já fez uma descoberta de inventário para sua infraestrutura, pule esta etapa.
Para mais informações, consulte Iniciar uma descoberta de recursos.
Criar grupos na Central de migração
Use os aplicativos identificados no relatório do CAST para criar grupos na Central de migração. Na máquina local, execute o comando a seguir:
mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
Substitua:
ANALYSIS_PATH: o caminho para o arquivo de relatório do CAST.PROJECT_ID: o ID do seu projeto.REGION: a região que você está usando para o Migration Center. Somenteus-central1eeurope-west1são aceitos.
Depois de criar os grupos, é possível filtrá-los no Migration Center usando o rótulo mconnect.
Atribuir recursos a grupos
No Migration Center, atribua seus recursos aos grupos de aplicativos correspondentes. É possível fazer isso na interface do Migration Center ou com a API.
Exportar relatórios do CAST e dados do Migration Center para o BigQuery
Exporte os dados do seu relatório do CAST para o BigQuery:
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
O comando realiza as seguintes ações:
- Ele cria um novo banco de dados no BigQuery chamado
mcCast. - Ela cria uma nova tabela no BigQuery chamada
castResultse a preenche com os dados do relatório do CAST. - Ele exporta os dados da Central de migração para o BigQuery
criando três tabelas chamadas
assets,groupsepreference_sets.
Criar visualizações no BigQuery
Com base nos dados enviados para o BigQuery, crie as visualizações correspondentes:
mconnect create-views --project=PROJECT_ID --dataset=mcCast
O comando cria três visualizações:
migrationcenterinfra_vwcastreadiness_vwmccastreadinesscombined_vw
A saída desse comando fornece um link para um relatório do Looker Studio usando a visualização mccastreadinesscombined_vw.
Configurar o relatório do Looker Studio
Você pode configurar o relatório gerado do Looker Studio de duas maneiras, conforme descrito nas seções a seguir.
Usando o link fornecido
- Copie o link obtido na etapa anterior para seu navegador da Web.
- Clique em Salvar e compartilhar e em Confirmar e salvar.
Copiar os dados manualmente
Se o link fornecido estiver corrompido, configure manualmente o relatório do Looker Studio usando seus dados:
- No Looker Studio, abra o relatório Central de migração / Análise do CAST.
- Clique em Mais opções.
- Clique em Fazer uma cópia > Copiar relatório.
- No novo relatório, clique em Recursos > Gerenciar fontes de dados adicionadas.
- Usando a fonte de dados chamada
McCastReadinessCombined_vw, clique em Editar. - Forneça o ID do projeto e do conjunto de dados usados na etapa anterior e escolha
mccastreadinesscombined_vw. - Clique em Reconectar e em Aplicar.
- Clique em Concluído e atualize a página.
Isso cria um relatório chamado Migration Center / CAST Analysis usando seus dados.
Referência do MConnect
As seções a seguir fornecem os comandos do MConnect disponíveis e as respectivas flags.
mconnect
Uso: mconnect [command] [args] [flags]
Comandos disponíveis
create-groups- Cria um grupo para cada aplicativo CAST no Migration Center e adiciona um rótulo "mconnect" a ele.
create-views- Cria três visualizações no BigQuery usando o Migration Center e dados do CAST.
export- Exporta dados do CAST para o BigQuery.
help- Ajuda sobre qualquer comando.
Flags
-h, --help- Ajuda para mconnect.
-t, --toggle- Mensagem de ajuda para alternância.
-v, --version- Versão do mconnect.
create-groups
Cria um grupo para cada aplicativo CAST no Migration Center e adiciona o rótulo "mconnect" a ele.
Uso: mconnect create-groups path project region [flags]
Exemplos
mconnect create-groups --path=path/to/cast/analysisResults.csv --project=my-mc-project-id --region=my-region1
mconnect create-groups --path=path/to/cast/analysisResults.csv --project=my-mc-project-id --region=my-region1 --ignore-existing-groups=true
Flags
-h, --help- Ajuda para create-groups .
-i, --ignore-existing-groups- Continue se o mconnect estiver tentando criar um grupo que já existe no Migration Center. Se definido como "true", o rótulo "mconnect" também será adicionado a todos os grupos já existentes.
--path- O caminho do arquivo CSV que contém o relatório do CAST (
analysisResults.csv). (Obrigatório) --project- O ID do projeto em que os grupos do Migration Center serão criados. Use o mesmo ID do projeto em todos os comandos. (Obrigatório)
--region- A região do Migration Center em que os grupos serão criados. (Obrigatório)
export
Exporta o relatório do CAST e os dados do Migration Center para o BigQuery. Por padrão, vamos presumir que o projeto e a região usados para o Migration Center e o BigQuery são os mesmos.
Uso: mconnect export path project region dataset [flags]
Exemplos
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 # the default dataset will be set to 'mcCast'.
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id --force=true
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id --mc-project=my-mc-project-id --mc-region=my-mc-region
Flags
--dataset- O ID do conjunto de dados para exportar os dados. Se o conjunto de dados não existir, ele será criado. Se não for especificado, o nome padrão será "mcCast". Use o mesmo conjunto de dados para todos os comandos.
-f, --force- Força a exportação dos dados mesmo que as tabelas de destino existam. A operação vai excluir todo o conteúdo das tabelas originais.
-h, --help- Ajuda para exportação.
--path- O caminho do arquivo CSV do relatório da CAST (
analysisResults.csv). (Obrigatório) --project- O ID do projeto do BigQuery para exportar os dados. (Obrigatório)
--region- A região do BigQuery em que o conjunto de dados e as tabelas serão criados. (Obrigatório)
Flags ocultas
--mc-project- O ID do projeto do Migration Center usado para exportar os dados para o BigQuery.
--mc-region- A região da Central de migração de onde os dados serão exportados.
create-views
Cria três visualizações no BigQuery usando o Migration Center e dados de CAST.
Fornece um link para um relatório do Looker Studio usando a visualização mccastreadinesscombined_vw.
Uso: mconnect create-views project dataset [flags]
Visualizações criadas
migrationcenterinfra_vw: mostra dados agrupados de recursos da Central de migração.castreadiness_vw: mostra dados do arquivo de análise da CAST.mccastreadinesscombined_vw: combina as duas visualizações anteriores. Essa visualização também é usada no modelo do Looker Studio.
Exemplos
mconnect create-views --project=my-project-id --dataset=dataset-id
mconnect create-views --project=my-project-id --dataset=dataset-id --force=true
Flags
--dataset- O ID do conjunto de dados do BigQuery em que as visualizações serão criadas. Use o mesmo conjunto de dados do comando de exportação. (Obrigatório)
-f, --force- Força a criação de visualizações mesmo que apenas uma das visualizações de destino exista. A operação vai substituir todo o conteúdo nas visualizações antigas.
-h, --help- Ajuda para create-views .
--project- O ID do projeto do BigQuery em que as visualizações serão criadas. (Obrigatório)