Ce document décrit la procédure à suivre pour exécuter une découverte d'inventaire dans votre compte Azure à l'aide de la CLI du client de découverte Migration Center.
La CLI mcdc
vous permet de collecter des informations sur vos instances de machine virtuelle (VM) Azure. La CLI mcdc
envoie ensuite ces informations au centre de migration, où vous pouvez poursuivre votre évaluation.
Avant de commencer
- Consultez les conditions requises pour télécharger et exécuter la CLI
mcdc
. - Suivez la procédure pour télécharger la CLI
mcdc
. Migration Center n'est pas compatible avec Azure PowerShell. Utilisez Azure CLI pour exécuter les commandes CLImcdc
.
S'authentifier sur Azure
Pour autoriser la CLI mcdc
à accéder à votre environnement Azure, vous devez configurer l'accès à l'aide de l'une des méthodes suivantes:
Utiliser vos identifiants Azure existants
Pour utiliser vos identifiants Azure existants, exécutez les commandes de la CLI mcdc
directement depuis Azure Cloud Shell.
Si vous exécutez la CLI mcdc
à partir d'Azure Cloud Shell, vous pouvez utiliser vos identifiants existants sans code secret client. Dans ce cas, la CLI mcdc
peut accéder à votre environnement Azure pour découvrir les instances de VM, comme l'autorisent vos identifiants.
Créer un code secret du client pour la CLI mcdc
Pour autoriser la CLI mcdc
à accéder aux ressources Azure, enregistrez la CLI mcdc
en tant qu'application dans votre compte Azure et créez un code secret du client.
Pour créer un code secret du client pour la CLI mcdc
, procédez comme suit:
- Sur le portail Azure, accédez à la page Enregistrement de l'application, puis cliquez sur Nouvel enregistrement.
- Pour ajouter des identifiants client, cliquez sur Ajouter un certificat ou un secret.
- Pour ajouter un code secret du client, cliquez sur + Nouveau code secret du client et saisissez une description et une date d'expiration pour ce code secret du client.
- Cliquez sur Ajouter.
Votre code secret du client est maintenant prêt à être utilisé. Copiez la valeur du code secret du client, car vous en aurez besoin plus tard lorsque vous exécuterez les commandes de la CLI mcdc
.
Créer un rôle personnalisé
Pour vous assurer que la CLI mcdc
dispose des autorisations nécessaires pour accéder à vos ressources Azure, vous devez créer un rôle personnalisé avec les autorisations requises.
Pour créer un rôle personnalisé, procédez comme suit:
- Sur le portail Azure, accédez à la page Abonnements, puis sélectionnez votre abonnement Azure.
- Copiez l'ID d'abonnement en cliquant dessus.
Enregistrez le modèle JSON suivant et remplacez
SUBSCRIPTION_ID
par l'ID d'abonnement que vous avez copié à l'étape 2:{ "properties": { "roleName": "Minimum permissions role", "description": "This role contains the bare minimum of Azure IAM permissions", "assignableScopes": [ "/subscriptions/SUBSCRIPTION_ID" ], "permissions": [ { "actions": [ "Microsoft.Compute/virtualMachines/read", "Microsoft.Compute/disks/read", "Microsoft.Insights/MetricDefinitions/read", "Microsoft.Insights/Metrics/Read", "Microsoft.Network/networkInterfaces/read" ], "notActions": [], "dataActions": [], "notDataActions": [] } ] } }
Pour en savoir plus sur les informations détaillées sur les autorisations, consultez la section Détails des autorisations.
Dans le portail Azure, accédez à la page Contrôle des accès (IAM).
Pour ajouter un rôle personnalisé, cliquez sur + Ajouter.
Cliquez sur Démarrer à partir de JSON, puis sur Sélectionner un fichier pour importer le fichier JSON que vous avez créé à l'étape 3.
Pour examiner les entrées, cliquez sur Examiner + Créer, puis sur Créer pour créer le rôle personnalisé.
Attribuer le rôle personnalisé à la CLI mcdc
Une fois le rôle personnalisé créé, vous devez l'attribuer à l'application CLI mcdc
pour lui accorder les autorisations nécessaires.
Pour attribuer un rôle personnalisé à la CLI mcdc
, procédez comme suit:
- Dans le portail Azure, accédez à la page Contrôle des accès (IAM).
- Cliquez sur + Ajouter, puis sur Ajouter une attribution de rôle.
- Dans le rôle personnalisé que vous avez créé (Créer un rôle personnalisé), saisissez
m2vm
, puis sélectionnez le rôle. - Cliquez sur Suivant.
- Cliquez sur + Sélectionner des membres, recherchez la CLI
mcdc
que vous avez enregistrée dans Enregistrer la CLImcdc
, puis cliquez sur Sélectionner. - Pour examiner et attribuer le rôle personnalisé à votre application, cliquez sur Examiner et attribuer.
Découvrir les instances de VM sur Azure
Pour collecter des informations d'inventaire à partir de vos instances de VM Azure, procédez comme suit:
Dans le terminal de ligne de commande, accédez au répertoire dans lequel vous avez téléchargé la CLI
mcdc
.Exécutez la détection:
Azure Cloud Shell
Pour découvrir les instances de VM à partir d'Azure Cloud Shell à l'aide de vos identifiants Azure existants, exécutez la commande suivante:
Linux
./mcdc discover azure --tenant TENANT_ID
--subscription SUBSCRIPTION_ID
--host-credentialsWindows
mcdc.exe discover azure --tenant TENANT_ID
--subscription SUBSCRIPTION_ID
--host-credentialsCode secret du client
Pour découvrir des instances de VM à partir de n'importe quel ordinateur ayant accès à votre compte Azure à l'aide du code secret du client, exécutez la commande suivante:
Linux
./mcdc discover azure --tenant TENANT_ID
--subscription SUBSCRIPTION_ID
--client CLIENT_ID
--secret CLIENT_SECRET
[--resource-group RESOURCE_GROUP]Windows
mcdc.exe discover azure --tenant TENANT_ID
--subscription SUBSCRIPTION_ID
--client CLIENT_ID
--secret CLIENT_SECRET
[--resource-group RESOURCE_GROUP]Remplacez les éléments suivants :
- TENANT_ID: identifiant unique de votre locataire Azure Active Directory (AAD).
- SUBSCRIPTION_ID: ID de l'abonnement que vous avez créé dans la section Créer un rôle personnalisé.
- CLIENT_ID: ID client que vous avez créé dans la section Enregistrer la CLI
mcdc
. - CLIENT_SECRET: code secret du client que vous avez créé dans la section Enregistrer la CLI
mcdc
. - RESOURCE_GROUP: groupe de ressources Azure contenant les instances de VM que vous souhaitez découvrir. Cette option est facultative.
Le résultat doit ressembler à ce qui suit :
[+] Collecting Azure VM instances...
Collecting region eu-west-1
Collected 73 Azure VM instances
[✓] Collection completed.
Une fois la découverte terminée, exécutez la commande discover ls
pour examiner les données collectées:
Linux
./mcdc discover ls
Windows
mcdc.exe discover ls
Le résultat doit ressembler à ce qui suit :
VM Assets
PLATFORM VM ID NAME COLLECTED DATA OS IP ADDRESSES
4f7bd883-b9cd-42e8-a67d-af3ec82b7f29 abc-rhel9.0-arm AZUREVM Red Hat Enterprise Linux 192.0.2.1
b5bcefcc-5565-4e45-a05a-fac055f73f14 def-rhel9.0-arm AZUREVM Red Hat Enterprise Linux 192.0.2.2
sfbcesdc-8865-4e4t-a0sf-f8sfyjf75723 ghi-ol9.3 AZUREVM Linux/UNIX 192.0.2.3
Étape suivante
- Découvrez comment exécuter une détection d'invités.
- Découvrez comment exporter les données collectées vers Migration Center.