Cette page explique comment utiliser MConnect pour générer des tableaux de bord Looker Studio à partir des données que vous avez collectées avec Google Cloud Migration Center et CAST.
Pour commencer à utiliser MConnect, regardez le tutoriel.
Présentation
MConnect est une interface de ligne de commande qui vous aide à fusionner les informations du Centre de migration et de l'analyse statique du code des applications effectuée par CAST Software. Il exporte ensuite les données vers BigQuery et Looker Studio pour une analyse avancée des données.
Il aide à moderniser les applications en comparant différentes dimensions de la transformation, telles que le niveau d'effort, le niveau de préparation du code et l'impact sur les ressources de calcul.
Avant de commencer
Avant d'utiliser MConnect, procédez comme suit :
- Créez un compte Google et un compte Google Cloud .
- Créez un projet Google Cloud et activez les API BigQuery et Migration Center.
- Pour Migration Center, consultez Premiers pas avec Migration Center.
- Pour BigQuery, consultez Premiers pas avec BigQuery.
- Installez la Google Cloud CLI sur votre machine locale.
- Créez un rapport CAST Highlight nommé
analysisResults.csv.
Tarifs
Vous pouvez être facturé pour BigQuery, Looker Studio et CAST, selon leurs tarifs respectifs.
Générer un tableau de bord pour vos données
Les sections suivantes expliquent comment générer un tableau de bord Looker Studio pour vos données CAST.
Configurer l'outil
Avant de pouvoir utiliser MConnect, procédez comme suit :
Si vous utilisez Linux, téléchargez le dernier fichier binaire. Pour les autres plates-formes d'OS, clonez le dépôt
migrationcenter-utilset créez MConnect sur votre ordinateur local.Authentifiez-vous sur Google Cloud CLI :
gcloud init gcloud auth application-default loginAssurez-vous que le compte que vous utilisez dispose des autorisations nécessaires pour créer et supprimer des groupes dans le Centre de migration, et pour créer et supprimer des tables dans BigQuery dans le projet que vous souhaitez utiliser.
Importer les composants dans Migration Center
Importez les composants liés aux applications de votre rapport CAST dans Migration Center. Si vous avez déjà effectué une découverte de l'inventaire pour votre infrastructure, vous pouvez ignorer cette étape.
Pour en savoir plus, consultez Démarrer la découverte des composants.
Créer des groupes dans le Centre de migration
Utilisez les applications identifiées dans votre rapport CAST pour créer des groupes dans Migration Center. Sur votre machine locale, exécutez la commande suivante :
mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
Remplacez les éléments suivants :
ANALYSIS_PATH: chemin d'accès à votre fichier de rapport CAST.PROJECT_ID: ID de votre projet.REGION: région que vous utilisez pour Migration Center. Seulsus-central1eteurope-west1sont acceptés.
Une fois les groupes créés, vous pouvez les filtrer dans Migration Center à l'aide du libellé mconnect.
Attribuer des composants à des groupes
Dans Migration Center, attribuez vos composants à leurs groupes d'applications correspondants. Vous pouvez effectuer cette opération dans l'interface utilisateur Migration Center ou avec l'API.
Exporter les données du rapport CAST et du Centre de migration vers BigQuery
Exportez les données de votre rapport CAST vers BigQuery :
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
La commande effectue les actions suivantes :
- Il crée une base de données
mcCastdans BigQuery. - Il crée une table dans BigQuery appelée
castResultset la remplit avec les données du rapport CAST. - Il exporte vos données Migration Center vers BigQuery en créant trois tables appelées
assets,groupsetpreference_sets.
Créer des vues dans BigQuery
À partir des données que vous avez importées dans BigQuery, créez les vues correspondantes :
mconnect create-views --project=PROJECT_ID --dataset=mcCast
La commande crée trois vues :
migrationcenterinfra_vwcastreadiness_vwmccastreadinesscombined_vw
Le résultat de cette commande fournit un lien vers un rapport Looker Studio utilisant la vue mccastreadinesscombined_vw.
Configurer le rapport Looker Studio
Vous pouvez configurer le rapport Looker Studio généré de deux manières, comme décrit dans les sections suivantes.
Utiliser le lien fourni
- Copiez le lien obtenu à l'étape précédente dans votre navigateur Web.
- Cliquez sur Enregistrer et partager, puis sur Confirmer et enregistrer.
Copier manuellement les données
Si le lien fourni ne fonctionne pas, vous pouvez configurer manuellement le rapport Looker Studio à l'aide de vos données :
- Dans Looker Studio, ouvrez le rapport Centre de migration / Analyse CAST.
- Cliquez sur Plus d'options.
- Cliquez sur Créer une copie > Copier le rapport.
- Dans le nouveau rapport, cliquez sur Ressources > Gérer les nouvelles sources de données.
- À l'aide de la source de données nommée
McCastReadinessCombined_vw, cliquez sur Modifier. - Indiquez l'ID du projet et l'ID de l'ensemble de données utilisés à l'étape précédente, puis sélectionnez
mccastreadinesscombined_vw. - Cliquez sur Reconnect (Reconnecter), puis sur Apply (Appliquer).
- Cliquez sur OK, puis actualisez la page.
Un rapport intitulé Migration Center / CAST Analysis est créé à partir de vos données.
Documentation de référence sur MConnect
Les sections suivantes présentent les commandes MConnect disponibles et leurs options.
mconnect
Utilisation : mconnect [command] [args] [flags]
Commandes disponibles
create-groups- Crée un groupe pour chaque application CAST dans Migration Center et y ajoute un libellé "mconnect".
create-views- Crée trois vues dans BigQuery à l'aide de Migration Center et des données CAST.
export- Exporte les données CAST vers BigQuery.
help- Affiche des informations d'aide sur les commandes.
Options
-h, --help- Aide pour mconnect.
-t, --toggle- Message d'aide pour le bouton bascule.
-v, --version
Version - pour mconnect.
create-groups
Crée un groupe pour chaque application CAST dans Migration Center et y ajoute le libellé "mconnect".
Utilisation : mconnect create-groups path project region [flags]
Exemples
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
Options
-h, --help- Aide pour create-groups.
-i, --ignore-existing-groups- Continuez si mconnect tente de créer un groupe qui existe déjà dans Migration Center. Si la valeur est définie sur "true", le libellé "mconnect" sera également ajouté à tous les groupes existants.
--path- Chemin d'accès au fichier CSV contenant le rapport CAST (
analysisResults.csv). (Obligatoire) --project- ID du projet dans lequel créer les groupes Migration Center. Veillez à utiliser le même ID de projet pour chaque commande. (Obligatoire)
--region- : région du Centre de migration dans laquelle les groupes seront créés. (Obligatoire)
export
Exporte les données des rapports CAST et du Centre de migration vers BigQuery. Par défaut, le projet et la région utilisés pour Migration Center et BigQuery sont supposés être les mêmes.
Utilisation : mconnect export path project region dataset [flags]
Exemples
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
Options
--dataset- ID de l'ensemble de données dans lequel exporter les données. Si l'ensemble de données n'existe pas, il sera créé. Si aucun nom n'est spécifié, le nom par défaut est "mcCast". Veillez à utiliser le même ensemble de données pour chaque commande.
-f, --force- Force l'exportation des données même si les tables de destination existent. Cette opération supprimera tout le contenu des tables d'origine.
-h, --help- Aide sur l'exportation
--path- Chemin d'accès au fichier CSV du rapport CAST (
analysisResults.csv). (Obligatoire) --project- ID du projet BigQuery vers lequel exporter les données. (Obligatoire)
--region- Région BigQuery dans laquelle l'ensemble de données et les tables seront créés. (Obligatoire)
Options masquées
--mc-project- ID du projet Migration Center utilisé pour exporter ses données vers BigQuery.
--mc-region- Région Migration Center à partir de laquelle exporter les données.
create-views
Crée trois vues dans BigQuery à l'aide de Migration Center et des données CAST.
Fournit un lien vers un rapport Looker Studio à l'aide de la vue mccastreadinesscombined_vw.
Utilisation : mconnect create-views project dataset [flags]
Vues créées
migrationcenterinfra_vw: affiche les données d'éléments groupées de Migration Center.castreadiness_vw: affiche les données du fichier d'analyse CAST.mccastreadinesscombined_vw: combine les deux vues précédentes. Cette vue est également utilisée dans le modèle Looker Studio.
Exemples
mconnect create-views --project=my-project-id --dataset=dataset-id
mconnect create-views --project=my-project-id --dataset=dataset-id --force=true
Options
--dataset- ID de l'ensemble de données BigQuery dans lequel créer les vues. Veillez à utiliser le même ensemble de données que dans la commande d'exportation. (Obligatoire)
-f, --force- Force la création de vues même si une seule des vues de destination existe. L'opération remplacera tout le contenu des anciennes vues existantes.
-h, --help- Aide pour create-views.
--project- ID du projet BigQuery dans lequel créer les vues. (Obligatoire)