Esegui le automazioni dal prompt dei comandi

Sebbene sia consigliabile eseguire i lavori di automazione tramite l'interfaccia Web, è possibile eseguire gli script di automazione manualmente da una riga di comando sul server di automazione. Ciò fornisce opzioni aggiuntive laddove le organizzazioni non possono o non vogliono utilizzare la combinazione di AWS CMF Credentials Manager, AWS Secrets Manager e AWS Systems Manager nell'ambiente, o se Cloud Migration Factory su AWS gli utenti devono fornire codici di accesso monouso per l'autenticazione a più fattori (MFA) per accedere a Cloud Migration Factory. AWS

Quando gli script vengono eseguiti dalla riga di comando, la cronologia e i log dei processi non sono disponibili nella vista Jobs dell'interfaccia web. L'output del registro verrà indirizzato solo all'output della riga di comando. Gli script possono comunque accedere a Cloud Migration Factory sulle AWS API per leggere e aggiornare i record e altre funzioni disponibili tramite le API.

Ti consigliamo di archiviare gli script nella libreria di script o in un'altra posizione centrale per assicurarti di accedere e utilizzare la versione più recente dello script o la versione attualmente approvata per l'uso.

Esecuzione manuale di un pacchetto di automazione

Questa sezione descrive i passaggi per scaricare un pacchetto da Cloud Migration Factory AWS ed eseguirlo manualmente sul server di automazione. Puoi anche seguire la procedura per altre posizioni di origine degli script sostituendo i passaggi 1 e 2 con i passaggi di download specifici della fonte.

1. Se gli script sono archiviati in Cloud Migration Factory on AWS, segui i passaggi descritti in Scaricare i pacchetti di script per ottenere il file zip del pacchetto di automazione.

2. Copia il file zip in una posizione sul server di automazione, ad esempioc:\migrations\scripts, e decomprimi il contenuto.

3. Copia il FactoryEndpoints.json file in ciascuna cartella di script decompressa. Configura il file con gli endpoint API specifici per l'istanza di Cloud Migration Factory che contiene i server o altri record a cui farà riferimento questo job di automazione. Per ulteriori informazioni su come creare questo file, consulta Creazione del FactoryEndpoints file.json.

4. Dalla riga di comando, assicurati di trovarti nella directory principale del pacchetto decompresso ed esegui il comando seguente:

python [package master script file] [script arguments]

file di script principale del pacchetto: può essere ottenuto da Package-Structure.yml sotto la MasterFileName chiave.

argomenti dello script: le informazioni sugli argomenti sono fornite Package-Structure.yml sotto la Arguments chiave.

5. Gli script richiederanno le credenziali necessarie per Cloud Migration Factory sulle AWS API e sul server remoto. Tutte le credenziali inserite manualmente vengono memorizzate nella cache per tutta la durata di questo processo per evitare di reinserire le stesse credenziali. Se si immettono argomenti di script per accedere ai segreti archiviati utilizzando la funzionalità Credentials Manager, è necessario accedere a AWS Secrets Manager e ai segreti associati. Se il recupero dei segreti fallisce per qualsiasi motivo, lo script richiederà le credenziali dell'utente.

Creazione del file.json FactoryEndpoints

Consigliamo di creare questo file una sola volta durante la distribuzione di Cloud Migration Factory sulla soluzione AWS, poiché il contenuto non cambia dopo la distribuzione iniziale e viene archiviato in una posizione centrale sul server di automazione. Questo file fornisce gli script di automazione con Cloud Migration Factory sugli endpoint delle API AWS e altri parametri chiave. Di seguito viene mostrato un esempio del contenuto predefinito del file:

{
 "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"
}

Nota

La maggior parte delle informazioni necessarie per comporre questo file per un'istanza di AWS Cloud Migration Factory distribuita è disponibile nella scheda AWS CloudFormation Output dello stack distribuito, ad eccezione di. UserPoolClientId Ottieni questo valore completando i seguenti passaggi:

1. Passa alla console di Amazon Cognito.

2. Aprire la configurazione del pool di utenti.

3. Seleziona l'integrazione dell'app, che fornirà la configurazione del client dell'app.

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

Sostituisci < LoginApi -value>, < UserApi -value> <Region-value>e < UserPoolId -value> con i valori corrispondenti recuperati dalla console Outputs. AWS CloudFormation Non aggiungete una barra (/) alla fine degli URL.

Il file ha una chiave opzionaleDefaultUser. È possibile impostare il valore di questa chiave sull'ID utente predefinito da utilizzare per accedere a Cloud Migration Factory su AWS istanza per evitare di doverla inserire ogni volta. Quando viene richiesto l'ID utente di Cloud Migration Factory, è possibile inserire un ID utente o utilizzare il valore predefinito premendo il tasto invio. È possibile farlo solo quando gli script vengono eseguiti manualmente.