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 de Migration Center et de l'analyse de code statique 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 Google Cloud projet et activez les API BigQuery et Migration Center.
- Pour le centre de migration, consultez la page Premiers pas avec le centre de migration.
- Pour BigQuery, consultez la page Premiers pas avec BigQuery.
- Installez Google Cloud CLI sur votre machine locale.
- Créez un rapport Principals points forts de CAST nommé
analysisResults.csv
.
Tarifs
BigQuery, Looker Studio et CAST peuvent vous être facturés, 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 binaire. Pour les autres plates-formes d'OS, clonez le dépôt
migrationcenter-utils
et créez MConnect sur votre ordinateur local.Authentifiez-vous sur Google Cloud CLI :
gcloud init gcloud auth application-default login
Assurez-vous que le compte que vous utilisez dispose des autorisations nécessaires pour créer et supprimer des groupes dans Migration Center, 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 associé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 la section Démarrer une découverte d'éléments.
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 au fichier de rapport CAST.PROJECT_ID
: ID de votre projet.REGION
: région que vous utilisez pour Migration Center. Seulsus-central1
eteurope-west1
sont 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 aux groupes d'applications correspondants. Vous pouvez le faire dans l'interface utilisateur du centre de migration ou avec l'API.
Exporter le rapport CAST et les données du Migration Center vers BigQuery
Exporter 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 nommée
mcCast
dans BigQuery. - Il crée une table nommée
castResults
dans BigQuery et 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
,groups
etpreference_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_vw
castreadiness_vw
mccastreadinesscombined_vw
La sortie de cette commande fournit un lien vers un rapport Looker Studio à l'aide de 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.
En utilisant 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 est incorrect, vous pouvez configurer manuellement le rapport Looker Studio à l'aide de vos données:
- Dans Looker Studio, ouvrez le rapport Migration Center/CAST Analysis (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.
- Utilisez la source de données
McCastReadinessCombined_vw
, puis 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 Reconnecter, puis sur Appliquer.
- Cliquez sur OK, puis actualisez la page.
Un rapport nommé Migration Center / CAST Analysis
est créé à l'aide de vos données.
Documentation de référence sur MConnect
Les sections suivantes fournissent 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
- Aide sur une commande.
Options
-h, --help
- Aide pour mconnect.
-t, --toggle
- Message d'aide pour le bouton d'activation/de désactivation.
-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]
Examples
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 elle 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. Assurez-vous d'utiliser le même ID de projet pour chaque commande. (Obligatoire)
--region
- Région du Migration Center dans laquelle les groupes seront créés. (Obligatoire)
export
Exporte les données du rapport CAST et du Migration Center vers BigQuery. Par défaut, on suppose que le projet et la région utilisés pour Migration Center et BigQuery sont les mêmes.
Utilisation: mconnect export path project region dataset [flags]
Examples
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 aucune valeur n'est spécifiée, le nom par défaut est "mcCast". Assurez-vous d'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. L'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 de 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 des données du Migration Center et de 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 du 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 de Looker Studio.
Examples
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. Cette opération remplacera tous les contenus des anciennes vues existantes.
-h, --help
- Aide pour create-views.
--project
- ID du projet BigQuery dans lequel créer les vues. (Obligatoire)