Esta página descreve como usar o MConnect para gerar painéis de controlo do Looker Studio a partir de dados que recolheu com o Migration Center do Google Cloud e o CAST.
Comece a usar o MConnect vendo o tutorial.
Vista geral
O MConnect é uma interface de linha de comandos que ajuda a unir informações do Migration Center e da análise de código estático de aplicações realizada pelo CAST Software. Em seguida, exporta os dados para o BigQuery e para o Looker Studio para uma análise de dados avançada.
Ajuda a modernizar as aplicações comparando várias dimensões da transformação, como o nível de esforço, o nível de prontidão do código e o impacto dos recursos de computação.
Antes de começar
Antes de usar o MConnect, siga estes passos:
- Crie uma Conta Google e uma conta do Google Cloud .
- Crie um Google Cloud projeto e ative a API
BigQuery
e a API
Migration Center.
- Para o Migration Center, consulte o artigo Introdução ao Migration Center.
- Para o BigQuery, consulte o artigo Comece a usar o BigQuery.
- Instale a CLI Google Cloud na sua máquina local.
- Crie um relatório de destaque do CAST
denominado
analysisResults.csv
.
Preços
Pode receber faturas do BigQuery, Looker Studio e CAST, de acordo com os respetivos preços.
Gere um painel de controlo para os seus dados
As secções seguintes explicam como gerar um painel de controlo do Looker Studio para os seus dados do CAST.
Configure a ferramenta
Antes de poder usar o MConnect, siga estes passos:
Se usar o Linux, transfira o ficheiro binário mais recente. Para outras plataformas de SO, clone o repositório
migrationcenter-utils
e crie o MConnect na sua máquina local.Autentique-se na CLI do Google Cloud:
gcloud init gcloud auth application-default login
Certifique-se de que a conta que está a usar tem as autorizações necessárias para criar e eliminar grupos no Migration Center, bem como para criar e eliminar tabelas no BigQuery no projeto que quer usar.
Carregue os recursos para o Centro de migração
Carregue os recursos relacionados com as aplicações no seu relatório CAST para o Migration Center. Se já fez uma deteção de inventário para a sua infraestrutura, pode ignorar este passo.
Para mais informações, consulte o artigo Inicie uma deteção de recursos.
Crie grupos no Centro de Migração
Use as aplicações identificadas no seu relatório CAST para criar grupos no Migration Center. Na sua máquina local, execute o seguinte comando:
mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
Substitua o seguinte:
ANALYSIS_PATH
: o caminho para o ficheiro do relatório CAST.PROJECT_ID
: o ID do seu projeto.REGION
: a região que está a usar para o Migration Center. Apenas são suportadosus-central1
eeurope-west1
.
Depois de criar os grupos, pode filtrá-los no Centro de Migração
usando a etiqueta mconnect
.
Atribua recursos a grupos
No Migration Center, atribua os seus recursos aos grupos de aplicações correspondentes. Pode fazê-lo na IU do Centro de Migração ou com a API.
Exporte o relatório do CAST e os dados do Migration Center para o BigQuery
Exporte os dados do relatório CAST para o BigQuery:
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
O comando realiza as seguintes ações:
- Cria uma nova base de dados no BigQuery denominada
mcCast
. - Cria uma nova tabela no BigQuery denominada
castResults
e preenche-a com os dados do relatório CAST. - Exporta os seus dados do Migration Center para o BigQuery
criando três tabelas denominadas
assets
,groups
epreference_sets
.
Crie visualizações no BigQuery
A partir dos dados que carregou para o BigQuery, crie as visualizações correspondentes:
mconnect create-views --project=PROJECT_ID --dataset=mcCast
O comando cria três vistas:
migrationcenterinfra_vw
castreadiness_vw
mccastreadinesscombined_vw
O resultado deste comando fornece um link para um relatório do Looker Studio
que usa a visualização mccastreadinesscombined_vw
.
Configure o relatório do Looker Studio
Pode configurar o relatório do Looker Studio gerado de duas formas, conforme descrito nas secções seguintes.
Usando o link fornecido
- Copie o link obtido no passo anterior para o navegador de Internet.
- Clique em Guardar e partilhar e, de seguida, em Reconhecer e guardar.
Copiar os dados manualmente
Se o link fornecido estiver danificado, pode configurar manualmente o relatório do Looker Studio com os seus dados:
- No Looker Studio, abra o relatório Centro de migração / Análise CAST.
- Clique em Mais opções.
- Clique em Fazer uma cópia > Copiar relatório.
- No novo relatório, clique em Recursos > Gerir origens de dados adicionadas.
- Usando a origem de dados denominada
McCastReadinessCombined_vw
, clique em Editar. - Indique o ID do projeto e o ID do conjunto de dados usados no passo anterior e escolha
mccastreadinesscombined_vw
. - Clique em Voltar a associar e, de seguida, em Aplicar.
- Clique em Concluído e atualize a página.
Esta ação cria um novo relatório denominado Migration Center / CAST Analysis
com os seus dados.
Referência do MConnect
As secções seguintes indicam os comandos MConnect disponíveis e as respetivas flags.
mconnect
Utilização: mconnect [command] [args] [flags]
Comandos disponíveis
create-groups
- Cria um grupo para cada aplicação CAST no Migration Center e adiciona-lhe uma etiqueta "mconnect".
create-views
- Cria três vistas no BigQuery através do Migration Center e dos dados de transmissão.
export
- Exporta dados do CAST para o BigQuery.
help
- Ajuda sobre qualquer comando.
Bandeiras
-h, --help
- Ajuda para o mconnect.
-t, --toggle
- Mensagem de ajuda para o botão.
-v, --version
- Versão para mconnect.
create-groups
Cria um grupo para cada aplicação CAST no Migration Center e adiciona-lhe a etiqueta "mconnect".
Utilização: 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
Bandeiras
-h, --help
- Ajuda para create-groups.
-i, --ignore-existing-groups
- Continue se o mconnect estiver a tentar criar um grupo que já existe no Migration Center. Se estiver definida como "true", a etiqueta "mconnect" também é adicionada a todos os grupos já existentes.
--path
- O caminho do ficheiro CSV que contém o relatório da CAST (
analysisResults.csv
). (Obrigatório) --project
- O ID do projeto no qual criar os grupos do Migration Center. Certifique-se de que usa o mesmo ID do projeto para todos os comandos. (Obrigatório)
--region
- A região do Centro de migração na qual os grupos vão ser criados. (Obrigatório)
exportar
Exporta o relatório CAST e os dados do Migration Center para o BigQuery. Por predefinição, assume-se que o projeto e a região usados para o Migration Center e o BigQuery são os mesmos.
Utilização: 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
Bandeiras
--dataset
- O ID do conjunto de dados para o qual os dados vão ser exportados. Se o conjunto de dados não existir, é criado. Se não for especificado, o nome predefinido é "mcCast". Certifique-se de que usa o mesmo conjunto de dados para todos os comandos.
-f, --force
- Forçar a exportação dos dados, mesmo que as tabelas de destino existam. A operação elimina todo o conteúdo das tabelas originais.
-h, --help
- Ajuda para exportação.
--path
- O caminho do ficheiro CSV do relatório CAST (
analysisResults.csv
). (Obrigatório) --project
- O ID do projeto do BigQuery para o qual os dados vão ser exportados. (Obrigatório)
--region
- A região do BigQuery na qual o conjunto de dados e as tabelas vão ser criados. (Obrigatório)
Bandeiras ocultas
--mc-project
- O ID do projeto do Migration Center usado para exportar os respetivos dados para o BigQuery.
--mc-region
- A região do Migration Center a partir da qual exportar os dados.
create-views
Cria três vistas no BigQuery através do Migration Center e dos dados da CAST.
Fornece um link para um relatório do Looker Studio que usa a visualização mccastreadinesscombined_vw
.
Utilização: mconnect create-views project dataset [flags]
Vistas criadas
migrationcenterinfra_vw
: mostra dados de recursos agrupados do Migration Center.castreadiness_vw
: mostra dados do ficheiro de análise CAST.mccastreadinesscombined_vw
: combina as duas vistas anteriores. Esta vista 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
Bandeiras
--dataset
- O ID do conjunto de dados do BigQuery no qual criar as vistas. Certifique-se de que usa o mesmo conjunto de dados que no comando de exportação. (Obrigatório)
-f, --force
- Forçar a criação de visualizações de propriedade, mesmo que só exista uma das visualizações de propriedade de destino. A operação substitui todo o conteúdo nas vistas existentes antigas.
-h, --help
- Ajuda para create-views.
--project
- O ID do projeto do BigQuery no qual criar as visualizações. (Obrigatório)