Führen Sie Automatisierungen von der Befehlszeile aus

Wir empfehlen zwar, Automatisierungsjobs über die Weboberfläche auszuführen, Sie können Automatisierungsskripts jedoch manuell über eine Befehlszeile auf dem Automatisierungsserver ausführen. Dies bietet zusätzliche Optionen, wenn Unternehmen die Kombination aus AWS CMF Credentials Manager, AWS Secrets Manager und AWS Systems Manager nicht in der Umgebung verwenden können oder wollen oder wenn Benutzer von Cloud Migration Factory on AWS einmalige Zugangscodes für die Multi-Faktor-Authentifizierung (MFA) angeben müssen, um sich bei Cloud Migration Factory auf AWS anzumelden.

Wenn Skripts über die Befehlszeile ausgeführt werden, sind der Auftragsverlauf und die Protokolle in der Ansicht Jobs auf der Weboberfläche nicht verfügbar. Die Protokollausgabe wird nur an die Befehlszeilenausgabe weitergeleitet. Die Skripts können weiterhin auf die Cloud Migration Factory auf AWS zugreifen, um Datensätze APIs zu lesen und zu aktualisieren, sowie auf andere Funktionen, die über die verfügbar sind APIs.

Wir empfehlen, Skripts in der Skriptbibliothek oder an einem anderen zentralen Ort zu speichern, um sicherzustellen, dass Sie auf die neueste Version des Skripts zugreifen und diese verwenden, oder die Version, deren Verwendung derzeit genehmigt ist.

Manuelles Ausführen eines Automatisierungspakets

In diesem Abschnitt werden die Schritte beschrieben, um ein Paket von Cloud Migration Factory auf AWS herunterzuladen und es manuell auf dem Automatisierungsserver auszuführen. Sie können den Vorgang auch für andere Skriptquellenspeicherorte verfolgen, indem Sie die Schritte 1 und 2 durch die quellenspezifischen Download-Schritte ersetzen.

1. Wenn Skripts in Cloud Migration Factory auf AWS gespeichert sind, befolgen Sie die unter Skriptpakete herunterladen beschriebenen Schritte, um die ZIP-Datei für das Automatisierungspaket abzurufen.

2. Kopieren Sie die ZIP-Datei an einen Speicherort auf dem Automatisierungsserver, z. B.c:\migrations\scripts, und entpacken Sie den Inhalt.

3. Kopieren Sie die FactoryEndpoints.json Datei in jeden der entpackten Skriptordner. Konfigurieren Sie die Datei mit den spezifischen API-Endpunkten für die Cloud Migration Factory-Instanz, die die Server oder andere Datensätze enthält, auf die dieser Automatisierungsjob verweist. Weitere Informationen zur Erstellung dieser Datei finden Sie unter Erstellung der FactoryEndpoints .json-Datei.

4. Stellen Sie in der Befehlszeile sicher, dass Sie sich im Stammverzeichnis des entpackten Pakets befinden, und führen Sie den folgenden Befehl aus:

python [package master script file] [script arguments]

Paket-Master-Skriptdatei — diese finden Sie Package-Structure.yml unter dem MasterFileName Schlüssel.

Skriptargumente — Informationen zu den Argumenten finden Sie Package-Structure.yml unter dem Arguments Schlüssel.

1. Die Skripts fordern Anmeldeinformationen an, die für Cloud Migration Factory auf AWS APIs und den Remote-Server erforderlich sind. Alle manuell eingegebenen Anmeldeinformationen werden für die Dauer dieses Vorgangs im Speicher zwischengespeichert, um zu vermeiden, dass dieselben Anmeldeinformationen erneut eingegeben werden. Wenn Sie Skriptargumente eingeben, um auf Geheimnisse zuzugreifen, die mit der Credentials Manager-Funktion gespeichert wurden, ist der Zugriff auf AWS Secrets Manager und die zugehörigen Geheimnisse erforderlich. Wenn das Abrufen von Geheimnissen aus irgendeinem Grund fehlschlägt, fordert das Skript zur Eingabe von Benutzeranmeldedaten auf.

Erstellung der Datei .json FactoryEndpoints

Wir empfehlen, diese Datei einmal bei der Bereitstellung der Cloud Migration Factory auf der AWS-Lösung zu erstellen, da sich der Inhalt nach der ersten Bereitstellung nicht ändert und an einem zentralen Ort auf dem Automatisierungsserver gespeichert wird. Diese Datei enthält die Automatisierungsskripte mit der Cloud Migration Factory auf AWS-API-Endpunkten und anderen wichtigen Parametern. Ein Beispiel für den Standardinhalt der Datei finden Sie hier:

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

Anmerkung

Die meisten Informationen, die zum Erstellen dieser Datei für eine bereitgestellte AWS Cloud Migration Factory-Instanz erforderlich sind, sind auf der Registerkarte CloudFormation AWS-Ausgaben des bereitgestellten Stacks verfügbar, mit Ausnahme derUserPoolClientId. Ermitteln Sie diesen Wert, indem Sie die folgenden Schritte ausführen:

1. Navigieren Sie zur Amazon-Cognito-Konsole.

2. Öffnen Sie die Benutzerpool-Konfiguration.

3. Wählen Sie App-Integration aus, um die App-Client-Konfiguration bereitzustellen.

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

Ersetzen Sie<LoginApi-value>, <UserApi-value><Region-value>, und <UserPoolId-value> durch die entsprechenden Werte, die Sie von der AWS CloudFormation Outputs-Konsole abgerufen haben. Fügen Sie am Ende von keinen Schrägstrich (/) hinzu. URLs

Die Datei hat einen optionalen DefaultUser Schlüssel. Sie können den Wert für diesen Schlüssel auf die Standardbenutzer-ID festlegen, die für den Zugriff auf die Cloud Migration Factory on AWS-Instanz verwendet wird, um zu vermeiden, dass Sie ihn jedes Mal eingeben müssen. Wenn Sie zur Eingabe der Cloud Migration Factory-Benutzer-ID aufgefordert werden, können Sie entweder eine Benutzer-ID eingeben oder den Standardwert verwenden, indem Sie die Eingabetaste drücken. Dies ist nur möglich, wenn die Skripts manuell ausgeführt werden.