Ejecutar las automatizaciones desde la línea de comandos

Aunque recomendamos ejecutar los trabajos de automatización a través de la interfaz web, puede ejecutar los scripts de automatización manualmente desde la línea de comandos del servidor de automatización. Esto proporciona opciones adicionales cuando las organizaciones no pueden o no quieren usar la combinación de AWS CMF Credentials Manager, AWS Secrets Manager y AWS Systems Manager en el entorno, o si AWS los usuarios de Cloud Migration Factory necesitan proporcionar códigos de acceso únicos de autenticación multifactorial (MFA) para iniciar sesión en Cloud Migration Factory. AWS

Cuando los scripts se ejecutan desde la línea de comandos, el historial de tareas y los registros no están disponibles en la vista de Trabajos de la interfaz web. La salida del registro se dirigirá únicamente a la salida de la línea de comandos. Los scripts aún pueden acceder a Cloud Migration Factory AWS APIs para leer y actualizar los registros y otras funciones disponibles a través de. APIs

Le recomendamos almacenar los scripts en la biblioteca de scripts o en otra ubicación central para asegurarse de que está accediendo y utilizando la última versión del script, o la versión actualmente aprobada para su uso.

Ejecutar manualmente un paquete de automatización

En esta sección se describen los pasos para descargar un paquete de Cloud Migration Factory AWS y ejecutarlo manualmente en el servidor de automatización. También puede seguir el proceso para otras ubicaciones de fuentes de scripts sustituyendo los pasos 1 y 2 por los pasos de descarga específicos de la fuente.

1. Si los scripts están guardados en Cloud Migration Factory AWS, sigue los pasos descritos en Descargar paquetes de scripts para obtener el archivo zip del paquete de automatización.

2. Copie el archivo zip en una ubicación del servidor de automatización, por ejemplo c:\migrations\scripts, y descomprima el contenido.

3. Copie el archivo FactoryEndpoints.json en cada una de las carpetas descomprimidas de scripts. Configura el archivo con los API puntos finales específicos de la instancia de Cloud Migration Factory que contiene los servidores u otros registros a los que haga referencia este trabajo de automatización. Consulta Creación del FactoryEndpoints archivo.json para obtener más información sobre cómo crear este archivo.

4. Desde la línea de comandos, asegúrese de estar en el directorio raíz del paquete descomprimido y ejecute el siguiente comando:

python [package master script file] [script arguments]

archivo de script maestro del paquete: se puede obtener de Package-Structure.yml debajo de la clave MasterFileName.

argumentos del script: información sobre los argumentos que se proporciona en Package-Structure.yml bajo de la clave Arguments.

5. Los scripts solicitarán las credenciales necesarias para Cloud Migration Factory en el servidor remoto AWS APIs y en él. Todas las credenciales que se introduzcan manualmente se almacenan en caché en la memoria durante este proceso para evitar volver a introducir las mismas credenciales. Si introduce argumentos de script para acceder a los secretos almacenados mediante la función Credentials Manager, es necesario acceder a AWS Secrets Manager y a los secretos asociados. Si la recuperación del secreto falla por algún motivo, el script solicitará las credenciales de usuario.

Creación del FactoryEndpoints archivo.json

Recomendamos crear este archivo una vez al implementar Cloud Migration Factory en una AWS solución, ya que el contenido no cambia después de la implementación inicial y se almacena en una ubicación central en el servidor de automatización. Este archivo proporciona los scripts de automatización de Cloud Migration Factory sobre AWS API los puntos finales y otros parámetros clave. A continuación, se muestra un ejemplo del contenido de un archivo:

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

nota

La mayor parte de la información necesaria para crear este archivo para una instancia implementada de Cloud Migration Factory en AWS está disponible en la pestaña Resultados de de AWS CloudFormation de la pila implementada, excepto en UserPoolClientId. Siga los pasos que se indican a continuación para obtener este valor:

1. Vaya a la consola de Amazon Cognito.

2. Abra Configuración del grupo de usuarios.

3. Seleccione Integración de aplicaciones, que proporcionará la configuración del cliente de la aplicación.

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

Reemplazar <LoginApi-value>, <UserApi-value>, <Region-value>, y <UserPoolId-value> con los valores correspondientes que haya obtenido de la consola de AWS CloudFormation salidas. No añada una barra inclinada (/) al final delURLs.

El archivo tiene una clave DefaultUser opcional. Puede establecer el valor de esta clave en el ID de usuario predeterminado que se utilizará para acceder a Cloud Migration Factory, AWS por ejemplo, para evitar tener que introducirlo cada vez. Cuando se le solicite el ID de usuario para Cloud Migration Factory, puede escribir el ID de usuario o usar el valor predeterminado pulsando la tecla Intro. Sólo puede hacerlo cuando los scripts se ejecuten manualmente.