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 AWS Benutzer von Cloud Migration Factory on einmalige Zugangscodes für die Multi-Faktor-Authentifizierung (MFA) bereitstellen müssen, um sich bei Cloud Migration Factory anzumelden. AWS

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

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, für die die Verwendung derzeit genehmigt ist.

Manuelles Ausführen eines Automatisierungspakets

In diesem Abschnitt werden die Schritte beschrieben, um ein Paket von Cloud Migration Factory herunterzuladen AWS 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 on gespeichert sind AWS, folgen Sie den Schritten unter Skriptpakete herunterladen, um die ZIP-Datei für das Automatisierungspaket zu erhalten.

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.

5. Die Skripts fordern Anmeldeinformationen an, die für Cloud Migration Factory auf AWS APIs und dem Remoteserver 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 Secrets zuzugreifen, die mit der Credentials Manager-Funktion gespeichert wurden, ist Zugriff auf AWS Secrets Manager und die zugehörigen Secrets 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:

{
 "UserApiUrl":
"https://cmfuserapi.execute-api.us-east-1.amazonaws.com",
"Region": "us-east-1",
"UserPoolId": "us-east-1_AbCdEfG",
"UserPoolClientId": "123456abcdef7890ghijk",
"LoginApiUrl":
"https://cmfloginapi.execute-api.us-east-1.amazonaws.com"
}

Anmerkung

Die meisten Informationen, die zum Erstellen dieser Datei für eine bereitgestellte AWS Cloud Migration Factory-Instanz erforderlich sind, sind auf der Registerkarte AWS CloudFormation Outputs des bereitgestellten Stacks verfügbar, mit Ausnahme vonUserPoolClientId. 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.

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

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

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 verwendet wird, AWS 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.