En esta página se describe cómo usar MConnect para generar paneles de control de Looker Studio a partir de los datos que ha recogido con Google Cloud Migration Center y CAST.
Para empezar a usar MConnect, mira el tutorial.
Información general
MConnect es una interfaz de línea de comandos que te ayuda a combinar información de Migration Center y del análisis de código estático de las aplicaciones realizado por CAST Software. A continuación, exporta los datos a BigQuery y a Looker Studio para realizar análisis de datos avanzados.
Ayuda a modernizar las aplicaciones comparando varias dimensiones de la transformación, como el nivel de esfuerzo, el nivel de preparación del código y el impacto en los recursos informáticos.
Antes de empezar
Antes de usar MConnect, sigue estos pasos:
- Crea una cuenta de Google y una cuenta de Google Cloud .
- Crea un Google Cloud proyecto y habilita las APIs de
BigQuery
y
Migration Center.
- Para obtener información sobre Migration Center, consulta el artículo Empezar a usar Migration Center.
- En el caso de BigQuery, consulta Primeros pasos con BigQuery.
- Instala Google Cloud CLI en tu máquina local.
- Crea un informe de CAST Highlight
llamado
analysisResults.csv
.
Precios
Es posible que se te facture por BigQuery, Looker Studio y CAST, según sus respectivos precios.
Generar un panel de control con tus datos
En las siguientes secciones se explica cómo generar un panel de control de Looker Studio para sus datos de CAST.
Configurar la herramienta
Para poder usar MConnect, sigue estos pasos:
Si usas Linux, descarga el último archivo binario. Para otras plataformas de SO, clona el repositorio
migrationcenter-utils
y compila MConnect en tu máquina local.Autentícate en Google Cloud CLI:
gcloud init gcloud auth application-default login
Comprueba que la cuenta que utilizas tiene los permisos necesarios para crear y eliminar grupos en Migration Center, así como para crear y eliminar tablas en BigQuery en el proyecto que quieras usar.
Subir los recursos al Centro de Migración
Suba los recursos relacionados con las aplicaciones de su informe de CAST a Migration Center. Si ya has realizado una detección de inventario de tu infraestructura, puedes saltarte este paso.
Para obtener más información, consulta el artículo Iniciar un descubrimiento de recursos.
Crear grupos en Migration Center
Usa las aplicaciones identificadas en tu informe de CAST para crear grupos en Migration Center. En tu máquina local, ejecuta el siguiente comando:
mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
Haz los cambios siguientes:
ANALYSIS_PATH
: la ruta al archivo de tu informe de CAST.PROJECT_ID
: el ID de tu proyecto.REGION
: la región que usas en Migration Center. Solo se admitenus-central1
yeurope-west1
.
Después de crear los grupos, puede filtrarlos en Migration Center
con la etiqueta mconnect
.
Asignar recursos a grupos
En Migration Center, asigna tus recursos a los grupos de aplicaciones correspondientes. Puede hacerlo en la interfaz de usuario del Centro de Migración o con la API.
Exportar datos de informes de CAST y de Migration Center a BigQuery
Para exportar los datos de tu informe de CAST a BigQuery, sigue estos pasos:
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
El comando realiza las siguientes acciones:
- Crea una base de datos en BigQuery llamada
mcCast
. - Crea una tabla en BigQuery llamada
castResults
y la rellena con los datos del informe de CAST. - Exporta los datos de Migration Center a BigQuery
creando tres tablas llamadas
assets
,groups
ypreference_sets
.
Crear vistas en BigQuery
A partir de los datos que ha subido a BigQuery, cree las vistas correspondientes:
mconnect create-views --project=PROJECT_ID --dataset=mcCast
El comando crea tres vistas:
migrationcenterinfra_vw
castreadiness_vw
mccastreadinesscombined_vw
El resultado de este comando proporciona un enlace a un informe de Looker Studio que usa la vista mccastreadinesscombined_vw
.
Configurar el informe de Looker Studio
Puedes configurar el informe de Looker Studio generado de dos formas, tal como se describe en las siguientes secciones.
Usar el enlace proporcionado
- Copia el enlace obtenido en el paso anterior en tu navegador web.
- Haz clic en Guardar y compartir y, a continuación, en Confirmar y guardar.
Copiar los datos manualmente
Si el enlace proporcionado no funciona, puedes configurar manualmente el informe de Looker Studio con tus datos:
- En Looker Studio, abre el informe Centro de Migración/Análisis de CAST.
- Haz clic en Más opciones.
- Haz clic en Crear una copia > Copiar informe.
- En el nuevo informe, haga clic en Recursos > Gestionar las fuentes de datos añadidas.
- En la fuente de datos llamada
McCastReadinessCombined_vw
, haga clic en Editar. - Proporcione el ID de proyecto y el ID de conjunto de datos que ha usado en el paso anterior y elija
mccastreadinesscombined_vw
. - Haz clic en Volver a conectar y, a continuación, en Aplicar.
- Haga clic en Hecho y actualice la página.
De esta forma, se crea un informe llamado Migration Center / CAST Analysis
con tus datos.
Referencia de MConnect
En las siguientes secciones se indican los comandos de MConnect disponibles y sus marcas.
mconnect
Uso: mconnect [command] [args] [flags]
Comandos disponibles
create-groups
- Crea un grupo para cada aplicación de CAST en Migration Center y le añade la etiqueta "mconnect".
create-views
- Crea tres vistas en BigQuery con Migration Center y datos de CAST.
export
- Exporta datos de CAST a BigQuery.
help
- Ayuda sobre cualquier comando.
Banderas
-h, --help
- Ayuda para mconnect
-t, --toggle
- Mensaje de ayuda para activar o desactivar.
-v, --version
- Versión para mconnect.
create-groups
Crea un grupo para cada aplicación CAST en Migration Center y le añade la etiqueta "mconnect".
Uso: mconnect create-groups path project region [flags]
Ejemplos
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
Banderas
-h, --help
- Ayuda para crear grupos
-i, --ignore-existing-groups
- Continúa si mconnect intenta crear un grupo que ya existe en Migration Center. Si se le asigna el valor "true", la etiqueta "mconnect" también se añadirá a todos los grupos que ya existan.
--path
- Ruta del archivo CSV que contiene el informe de CAST (
analysisResults.csv
). (Obligatorio) --project
- El ID del proyecto en el que se crearán los grupos de Migration Center. Asegúrate de usar el mismo ID de proyecto en todos los comandos. (Obligatorio)
--region
- La región de Migration Center en la que se crearán los grupos. (Obligatorio)
Exportación
Exporta informes de CAST y datos de Migration Center a BigQuery. De forma predeterminada, se asumirá que el proyecto y la región utilizados para Migration Center y BigQuery son los mismos.
Uso: mconnect export path project region dataset [flags]
Ejemplos
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
Banderas
--dataset
- El ID del conjunto de datos al que se exportarán los datos. Si el conjunto de datos no existe, se creará. Si no se especifica, el nombre predeterminado será "mcCast". Asegúrate de usar el mismo conjunto de datos en todos los comandos.
-f, --force
- Fuerza la exportación de los datos aunque existan las tablas de destino. La operación eliminará todo el contenido de las tablas originales.
-h, --help
- Ayuda para la exportación.
--path
- Ruta del archivo CSV del informe de CAST (
analysisResults.csv
). (Obligatorio) --project
- El ID del proyecto de BigQuery al que se exportarán los datos. (Obligatorio)
--region
- La región de BigQuery en la que se crearán el conjunto de datos y las tablas. (Obligatorio)
Banderas ocultas
--mc-project
- El ID del proyecto de Migration Center que se usa para exportar sus datos a BigQuery.
--mc-region
- Región del Centro de Migración desde la que se exportarán los datos.
create-views
Crea tres vistas en BigQuery con Migration Center y datos de CAST.
Proporciona un enlace a un informe de Looker Studio con la vista mccastreadinesscombined_vw
.
Uso: mconnect create-views project dataset [flags]
Vistas creadas
migrationcenterinfra_vw
: muestra datos de recursos agrupados del Centro de Migración.castreadiness_vw
: muestra los datos del archivo de análisis de CAST.mccastreadinesscombined_vw
: combina las dos vistas anteriores. Esta vista también se usa en la plantilla de Looker Studio.
Ejemplos
mconnect create-views --project=my-project-id --dataset=dataset-id
mconnect create-views --project=my-project-id --dataset=dataset-id --force=true
Banderas
--dataset
- ID del conjunto de datos de BigQuery en el que se crearán las vistas. Asegúrate de usar el mismo conjunto de datos que en el comando de exportación. (Obligatorio)
-f, --force
- Fuerza la creación de vistas aunque solo exista una de las vistas de destino. La operación sustituirá todo el contenido de las vistas antiguas.
-h, --help
- Ayuda para crear vistas.
--project
- El ID del proyecto de BigQuery en el que se crearán las vistas. (Obligatorio)