En esta página, se describe cómo usar MConnect para generar paneles de Looker Studio a partir de los datos que recopilaste con Google Cloud Migration Center y CAST.
Comienza a usar MConnect mirando el instructivo.
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 avanzado de los datos.
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 de procesamiento.
Antes de comenzar
Antes de usar MConnect, realiza los siguientes pasos:
- Crea una Cuenta de Google y una cuenta de Google Cloud .
- Crea un Google Cloud proyecto y habilita las APIs de BigQuery y de Migration Center.
- En el caso del Centro de migraciones, consulta Comienza a usar el Centro de migraciones.
- En el caso de BigQuery, consulta Primeros pasos con BigQuery.
- Instala la CLI de Google Cloud 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 precios respectivos.
Genera un panel para tus datos
En las siguientes secciones, se explica cómo generar un panel de Looker Studio para tus datos del CAST.
Configura la herramienta
Antes de poder usar MConnect, realiza los siguientes pasos:
Si usas Linux, descarga el archivo binario más reciente. Para otras plataformas de SO, clona el repositorio
migrationcenter-utilsy compila MConnect en tu máquina local.Autentica en la CLI de Google Cloud:
gcloud init gcloud auth application-default loginAsegú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 una detección de inventario para tu infraestructura, puedes omitir este paso.
Para obtener más información, consulta Cómo iniciar una detección de recursos.
Crea 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 a tu archivo de informe de CAST.PROJECT_ID: Es el ID del proyectoREGION: Es la región que usas para Migration Center. Solo se admitenus-central1yeurope-west1.
Después de crear los grupos, puedes filtrarlos en Migration Center con la etiqueta mconnect.
Asigna recursos a grupos
En Migration Center, asigna tus recursos a los grupos de aplicaciones correspondientes. Puedes realizar esta acción en la IU de Migration Center o con la API.
Exporta datos de informes de CAST y Migration Center a BigQuery
Para exportar los datos de tu informe de CAST a BigQuery, haz lo siguiente:
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
El comando realiza las siguientes acciones:
- Se crea una nueva base de datos en BigQuery llamada
mcCast. - Se crea una tabla nueva en BigQuery llamada
castResultsy se completa con los datos del informe de CAST. - Exporta tus datos de Migration Center a BigQuery creando tres tablas llamadas
assets,groupsypreference_sets.
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_vwcastreadiness_vwmccastreadinesscombined_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 generado de Looker Studio de dos maneras, como se describe en las siguientes secciones.
Cómo usar 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 Aceptar y guardar.
Copiar los datos de forma manual
Si el vínculo proporcionado no funciona, puedes configurar manualmente el informe de Looker Studio 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.
- Con la fuente de datos llamada
McCastReadinessCombined_vw, haz clic en Editar. - Proporciona el ID del proyecto y el ID del conjunto de datos que se usaron en el paso anterior, y elige
mccastreadinesscombined_vw. - Haz clic en Volver a conectar y, luego, en Aplicar.
- Haz clic en Listo y actualiza la página.
Esto crea 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 Migration Center y datos de CAST.
export- Exporta datos de CAST a BigQuery.
help- Ayuda sobre cualquier comando.
Marcas
-h, --help- Ayuda para mconnect.
-t, --toggle- Mensaje de ayuda para la activación o desactivación.
-v, --version- Versión de 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 Migration Center. Si se establece como "true", también se agregará la etiqueta "mconnect" a cada grupo existente.
--path- 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- Región de Migration Center en la que se crearán los grupos. (Obligatorio)
export
Exporta el informe de CAST y los datos del Centro de migración a BigQuery. De forma predeterminada, se supondrá que el proyecto y la región que se usan 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
Marcas
--dataset- Es 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- Ruta de acceso del archivo CSV del informe de CAST (
analysisResults.csv). (Obligatorio) --project- Es el ID del proyecto de BigQuery al que se exportarán los datos. (Obligatorio)
--region- Región de BigQuery en la que se crearán el conjunto de datos y las tablas. (Obligatorio)
Marcas ocultas
--mc-project- Es el ID del proyecto de Migration Center que se usó para exportar sus datos a BigQuery.
--mc-region- Región del Centro de migraciones desde la que se exportarán los datos.
create-views
Crea tres vistas en BigQuery con Migration Center y datos de CAST.
Proporciona un vínculo a un informe de Looker Studio que usa la vista mccastreadinesscombined_vw.
Uso: mconnect create-views project dataset [flags]
Vistas creadas
migrationcenterinfra_vw: Muestra los datos de los 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
Marcas
--dataset- Es 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- Es el ID del proyecto de BigQuery en el que se crearán las vistas. (Obligatorio)