En esta página, se describe cómo usar MConnect para generar paneles de Looker Studio con los datos que recopilaste con Google Cloud Migration Center y CAST.
Mira el instructivo para comenzar a usar MConnect.
Descripció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 que realiza CAST Software. Luego, exporta los datos a BigQuery y a Looker Studio para realizar un análisis de datos avanzado.
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 de los recursos de procesamiento.
Antes de comenzar
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 el Centro de migraciones, consulta Comienza a usar el Centro de migraciones.
- Para BigQuery, consulta Cómo comenzar a usar 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 BigQuery, Looker Studio y CAST, según sus respectivos precios.
Genera un panel para tus datos
En las siguientes secciones, se explica cómo generar un panel de Looker Studio para tus datos de CAST.
Configura la herramienta
Antes de poder usar MConnect, sigue estos pasos:
Si usas Linux, descarga el archivo binario más reciente. Para otras plataformas de SO, clona el repositorio
migrationcenter-utils
y compila MConnect en tu máquina local.Autentica en la CLI de Google Cloud:
gcloud init gcloud auth application-default login
Asegúrate de que la cuenta que usas tenga los permisos necesarios para crear y borrar grupos en Migration Center, y para crear y borrar tablas en BigQuery en el proyecto que deseas usar.
Sube los recursos a Migration Center
Sube los recursos relacionados con las aplicaciones de tu informe de CAST a Migration Center. Si ya realizaste un descubrimiento de inventario para tu infraestructura, puedes omitir este paso.
Para obtener más información, consulta Cómo iniciar un descubrimiento de recursos.
Cómo crear grupos en el Centro de migraciones
Usa las aplicaciones identificadas en tu informe de CAST para crear grupos en Migration Center. En la máquina local, ejecuta el siguiente comando:
mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
Reemplaza lo siguiente:
ANALYSIS_PATH
: Es la ruta de acceso al archivo de informe de CAST.PROJECT_ID
: Es el ID del proyectoREGION
: Es la región que usas para el centro de migración. Solo se admitenus-central1
yeurope-west1
.
Después de crear los grupos, puedes filtrarlos en el Centro de migración con la etiqueta mconnect
.
Cómo asignar recursos a grupos
En Migration Center, asigna tus recursos a sus grupos de aplicaciones correspondientes. Puedes hacerlo en la IU de Migration Center o con la API.
Exporta datos del informe de CAST y del Centro de migración a BigQuery
Exporta los datos de tu informe de CAST a BigQuery:
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
El comando realiza las siguientes acciones:
- Crea una base de datos nueva en BigQuery llamada
mcCast
. - Crea una tabla nueva en BigQuery llamada
castResults
y la completa con los datos del informe de CAST. - Para ello, crea tres tablas llamadas
assets
,groups
ypreference_sets
, que exportan tus datos de Migration Center a BigQuery.
Crea vistas en BigQuery
A partir de los datos que subiste a BigQuery, crea 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 vínculo a un informe de Looker Studio con la vista mccastreadinesscombined_vw
.
Configura el informe de Looker Studio
Puedes configurar el informe de Looker Studio generado de dos maneras, como se describe en las siguientes secciones.
Con el vínculo proporcionado
- Copia el vínculo que obtuviste en el paso anterior en tu navegador web.
- Haz clic en Guardar y compartir y, luego, en Confirmar y guardar.
Cómo copiar los datos de forma manual
Si el vínculo proporcionado no funciona, puedes configurar el informe de Looker Studio de forma manual con tus datos:
- En Looker Studio, abre el informe Migration Center / CAST Analysis.
- Haz clic en Más opciones.
- Haz clic en Crear una copia > Copiar informe.
- En el informe nuevo, haz clic en Recursos > Administrar fuentes de datos agregadas.
- En la fuente de datos llamada
McCastReadinessCombined_vw
, haz clic en Editar. - Proporciona el ID del proyecto y el ID del conjunto de datos que usaste en el paso anterior y elige
mccastreadinesscombined_vw
. - Haz clic en Reconnect y, luego, en Apply.
- Haz clic en Listo y actualiza la página.
Esto creará un informe nuevo llamado Migration Center / CAST Analysis
con tus datos.
Referencia de MConnect
En las siguientes secciones, se proporcionan 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 agrega una etiqueta "mconnect".
create-views
- Crea tres vistas en BigQuery con datos de CAST y el Centro de migración.
export
- Exporta datos de CAST a BigQuery.
help
- Ayuda sobre cualquier comando.
Marcas
-h, --help
- Ayuda para mconnect.
-t, --toggle
- Mensaje de ayuda para el botón de activación.
-v, --version
- Versión para mconnect.
create-groups
Crea un grupo para cada aplicación de CAST en Migration Center y le agrega 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
Marcas
-h, --help
- Ayuda para create-groups.
-i, --ignore-existing-groups
- Continúa si mconnect intenta crear un grupo que ya existe en el centro de migración. Si se establece como "true", la etiqueta "mconnect" también se agregará a todos los grupos que ya existan.
--path
- Es la ruta de acceso del archivo CSV que contiene el informe de CAST (
analysisResults.csv
). (Obligatorio) --project
- Es el ID del proyecto en el que se crearán los grupos de Migration Center. Asegúrate de usar el mismo ID del proyecto para cada comando. (Obligatorio)
--region
- La región de Migration Center en la que se crearán los grupos. (Obligatorio)
export
Exporta datos del informe de CAST y del Centro de migración a BigQuery. De forma predeterminada, se supondrá que el proyecto y la región que se usan para el Centro de migración 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
Marcas
--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 para cada comando.
-f, --force
- Forzar la exportación de los datos, incluso si existen las tablas de destino La operación borrará todo el contenido de las tablas originales.
-h, --help
- Ayuda para la exportación.
--path
- La ruta de acceso 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)
Marcas ocultas
--mc-project
- El ID del proyecto de Migration Center que se usó para exportar sus datos a BigQuery.
--mc-region
- La región de Migration Center desde la que se exportarán los datos.
create-views
Crea tres vistas en BigQuery con datos de Migration Center y CAST.
Proporciona un vínculo 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 de Migration Center.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
Marcas
--dataset
- El 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
- Forzar la creación de vistas, incluso si solo existe una de las vistas de destino La operación reemplazará todo el contenido de las vistas existentes anteriores.
-h, --help
- Ayuda para create-views.
--project
- El ID del proyecto de BigQuery en el que se crearán las vistas. (Obligatorio)