Execute automações a partir do prompt de comando

Embora seja recomendável executar trabalhos de automação por meio da interface da web, você pode executar scripts de automação manualmente a partir de uma linha de comando no servidor de automação. Isso fornece opções adicionais nas quais as organizações não podem ou não querem usar a combinação de AWS CMF Credentials Manager, AWS Secrets Manager e AWS Systems Manager no ambiente, ou se os AWS usuários do Cloud Migration Factory on precisarem fornecer códigos de acesso únicos de autenticação multifator (MFA) para fazer login no Cloud Migration Factory. AWS

Quando os scripts são executados na linha de comando, o histórico e os registros de tarefas não estão disponíveis na visualização Trabalhos na interface da web. A saída do log será direcionada somente para a saída da linha de comando. Os scripts ainda podem acessar o Cloud Migration Factory AWS APIs para ler e atualizar registros e outras funções disponíveis por meio doAPIs.

Recomendamos armazenar scripts na biblioteca de scripts ou em outro local central para garantir que você esteja acessando e usando a versão mais recente do script ou a versão atualmente aprovada para uso.

Executar manualmente um pacote de automação

Esta seção descreve as etapas para baixar um pacote do Cloud Migration Factory AWS e executá-lo manualmente no servidor de automação. Também é possível seguir o processo para outros locais de origem do script substituindo as etapas 1 e 2 pelas etapas de download específicas da fonte.

1. Se os scripts estiverem armazenados no Cloud Migration Factory em AWS, siga as etapas descritas em Baixar pacotes de scripts para obter o arquivo zip do pacote de automação.

2. Copie o arquivo zip para um local no servidor de automação, comoc:\migrations\scripts, e descompacte o conteúdo.

3. Copie o FactoryEndpoints.json arquivo para cada pasta de script descompactada. Configure o arquivo com os API endpoints específicos para a instância do Cloud Migration Factory que contém os servidores ou outros registros que esse trabalho de automação referenciará. Consulte Criação do FactoryEndpoints .json para obter mais informações sobre como criar esse arquivo.

4. Na linha de comando, verifique se você está no diretório raiz do pacote descompactado e execute o seguinte comando:

python [package master script file] [script arguments]

arquivo de script mestre do pacote — isso pode ser obtido Package-Structure.yml abaixo da MasterFileName chave.

argumentos do script — as informações sobre os argumentos são fornecidas Package-Structure.yml abaixo da Arguments chave.

5. Os scripts solicitarão as credenciais necessárias para o Cloud Migration Factory AWS APIs e o servidor remoto. Todas as credenciais inseridas manualmente são armazenadas em cache na memória durante esse processo para evitar a inserção das mesmas credenciais novamente. Se você inserir argumentos de script para acessar segredos armazenados usando o recurso Credentials Manager, será necessário acessar o AWS Secrets Manager e os segredos associados. Se a recuperação secreta falhar por algum motivo, o script solicitará as credenciais do usuário.

Criação do FactoryEndpoints .json

Recomendamos criar esse arquivo uma vez ao implantar o Cloud Migration Factory na AWS solução, pois o conteúdo não muda após a implantação inicial e é armazenado em um local central no servidor de automação. Esse arquivo fornece os scripts de automação com o Cloud Migration Factory em AWS API endpoints e outros parâmetros importantes. Veja um exemplo do conteúdo de um arquivo:

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

nota

A maioria das informações necessárias para compor esse arquivo para uma instância implantada do Cloud Migration Factory na AWS está disponível na guia AWS CloudFormation Saídas da pilha implantada, exceto o UserPoolClientId. Obtenha esse valor realizando as seguinte etapas:

1. Acesse o console do Amazon Cognito.

2. Abra a configuração do grupo de usuários.

3. Selecione Integração do aplicativo, que fornecerá a configuração do cliente do aplicativo.

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

Substituir <LoginApi-value>, <UserApi-value>, <Region-value> e <UserPoolId-value> com os valores correspondentes que você recuperou do console de AWS CloudFormation saídas. Não adicione uma barra (/) ao final doURLs.

O arquivo tem uma DefaultUser chave opcional. Você pode definir o valor dessa chave como o ID de usuário padrão a ser usado para acessar a Cloud Migration Factory na AWS instância para evitar a necessidade de inseri-la sempre. Quando solicitada a ID de usuário do Cloud Migration Factory, você pode inserir uma ID de usuário ou usar o valor padrão pressionando a tecla enter. Você só pode fazer isso quando os scripts são executados manualmente.