Exécuter des automatisations à partir d'une invite de commande

Bien que nous vous recommandions d'exécuter des tâches d'automatisation via l'interface Web, vous pouvez exécuter des scripts d'automatisation manuellement à partir d'une ligne de commande sur le serveur d'automatisation. Cela fournit des options supplémentaires lorsque les entreprises ne peuvent ou ne veulent pas utiliser la combinaison de AWS CMF Credentials Manager, AWS Secrets Manager et AWS Systems Manager dans l'environnement, ou si les AWS utilisateurs de Cloud Migration Factory doivent fournir des codes d'accès uniques à authentification multifactorielle (MFA) pour se connecter à Cloud Migration Factory. AWS

Lorsque les scripts sont exécutés depuis la ligne de commande, l'historique des tâches et les journaux ne sont pas disponibles dans la vue Tâches de l'interface Web. La sortie du journal sera uniquement dirigée vers la sortie de la ligne de commande. Les scripts peuvent toujours accéder à Cloud Migration Factory AWS APIs pour lire et mettre à jour les enregistrements, ainsi qu'aux autres fonctions disponibles via leAPIs.

Nous vous recommandons de stocker les scripts dans la bibliothèque de scripts ou dans un autre emplacement central pour vous assurer que vous accédez à la dernière version du script ou à la version dont l'utilisation est actuellement approuvée et que vous l'utilisez.

Exécution manuelle d'un package d'automatisation

Cette section décrit les étapes à suivre pour télécharger un package depuis Cloud Migration Factory AWS et l'exécuter manuellement sur le serveur d'automatisation. Vous pouvez également suivre le processus pour les autres emplacements de source de script en remplaçant les étapes 1 et 2 par les étapes de téléchargement spécifiques à la source.

1. Si les scripts sont stockés dans Cloud Migration Factory sur AWS, suivez les étapes décrites dans Télécharger les packages de scripts pour obtenir le fichier zip du package d'automatisation.

2. Copiez le fichier zip vers un emplacement sur le serveur d'automatisation, par exemplec:\migrations\scripts, et décompressez le contenu.

3. Copiez le FactoryEndpoints.json fichier dans chacun des dossiers de scripts décompressés. Configurez le fichier avec les API points de terminaison spécifiques pour l'instance Cloud Migration Factory qui contient les serveurs ou les autres enregistrements auxquels cette tâche d'automatisation fera référence. Reportez-vous à la section Création du fichier FactoryEndpoints .json pour plus d'informations sur la création de ce fichier.

4. Sur la ligne de commande, assurez-vous que vous vous trouvez dans le répertoire racine du package décompressé, puis exécutez la commande suivante :

python [package master script file] [script arguments]

fichier de script principal du package — celui-ci peut être obtenu à partir du Package-Structure.yml dessous de la MasterFileName clé.

arguments du script : les informations relatives aux arguments sont fournies Package-Structure.yml sous la Arguments clé.

5. Les scripts demanderont les informations d'identification requises pour Cloud Migration Factory sur AWS APIs et sur le serveur distant. Toutes les informations d'identification saisies manuellement sont mises en cache dans la mémoire pendant toute la durée de ce processus afin d'éviter de saisir à nouveau les mêmes informations d'identification. Si vous entrez des arguments de script pour accéder aux secrets stockés à l'aide de la fonctionnalité Credentials Manager, l'accès à AWS Secrets Manager et aux secrets associés est requis. Si la récupération du secret échoue pour une raison quelconque, le script demandera les informations d'identification de l'utilisateur.

Création du FactoryEndpoints fichier .json

Nous vous recommandons de créer ce fichier une seule fois lors du déploiement de Cloud Migration Factory sur AWS une solution, car le contenu ne change pas après le déploiement initial, et de le stocker dans un emplacement central sur le serveur d'automatisation. Ce fichier fournit les scripts d'automatisation avec Cloud Migration Factory sur les AWS API points de terminaison et d'autres paramètres clés. Voici un exemple du contenu par défaut du fichier :

{
 "UserApi": "cmfuserapi",
 "VpceId": "",
 "ToolsApi": "cmftoolsapi",
 "Region": "us-east-1",
 "UserPoolId": "us-east-1_AbCdEfG",
 "UserPoolClientId": "123456abcdef7890ghijk",
 "LoginApi": "cmfloginapi"
}

Note

La plupart des informations requises pour composer ce fichier pour une instance AWS Cloud Migration Factory déployée sont disponibles dans l'onglet AWS CloudFormation Sorties de la pile déployée, à l'exception duUserPoolClientId. Obtenez cette valeur en suivant les étapes suivantes :

1. Accédez à la console Amazon Cognito.

2. Ouvrez la configuration du groupe d'utilisateurs.

3. Sélectionnez Intégration des applications, qui fournira la configuration du client de l'application.

{
 "UserApi": <UserApi-value>,
 "Region": <Region-value>,
 "UserPoolId": <UserPoolId-value>,
 "UserPoolClientId": <Amazon-Cognito-user-pool-app-clients-console>,
 "LoginApi: <LoginApi-value>
}

Remplacez <LoginApi-value>, <UserApi-value>, <Region-value>, et <UserPoolId-value> avec les valeurs correspondantes que vous avez récupérées depuis la console AWS CloudFormation Outputs. N'ajoutez pas de barre oblique (/) à la fin duURLs.

Le fichier possède une DefaultUser clé facultative. Vous pouvez définir la valeur de cette clé sur l'ID utilisateur par défaut à utiliser pour accéder à Cloud Migration Factory sur AWS instance afin d'éviter d'avoir à la saisir à chaque fois. Lorsque vous êtes invité à saisir l'ID utilisateur de Cloud Migration Factory, vous pouvez saisir un ID utilisateur ou utiliser la valeur par défaut en appuyant sur la touche Entrée. Vous ne pouvez le faire que lorsque les scripts sont exécutés manuellement.