从命令提示符运行自动化 - Cloud Migration Factory on AWS
手动运行自动化包 FactoryEndpoints.json 的创建

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

从命令提示符运行自动化

尽管我们建议通过 Web 界面运行自动化作业，但您可以通过自动化服务器上的命令行手动运行自动化脚本。这为组织不能或不想在环境中使用 AWS CMF凭证管理器、S AWS ecrets Manager 和 S AWS ystems Manager 的组合提供了其他选项，或者如果 AWS 用户需要提供多因素身份验证 (MFA) 一次性访问代码才能登录到云迁移工厂。 AWS

从命令行运行脚本时，无法从 Web 界面的作业视图中查看作业历史记录和日志。日志输出将仅定向到命令行输出。这些脚本仍然可以访问云迁移工厂 AWS APIs以读取和更新记录，以及通过提供的其他功能APIs。

我们建议将脚本存储在脚本库或其他中心位置，以确保您访问和使用的是最新版本的脚本或当前已批准使用的版本。

手动运行自动化包

本节介绍从云迁移工厂下载软件包 AWS 并在自动化服务器上手动运行该软件包的步骤。您也可以按照其他脚本源位置的流程进行操作，方法是将步骤 1 和 2 替换为特定于源的下载步骤。

  1. 如果脚本存储在 Cloud Migration Factory 中 AWS，请按照下载脚本包中介绍的步骤获取自动化包 zip 文件。

  2. 将 zip 文件复制到自动化服务器上的某个位置（例如 c:\migrations\scripts），然后解压其内容。

  3. 将 FactoryEndpoints.json 文件复制到每个解压缩的脚本文件夹。使用包含服务器的云迁移工厂实例的特定API端点或此自动化作业将引用的其他记录配置文件。有关如何创建此文件的更多信息，请参阅创建 FactoryEndpoints .json。

  4. 在命令行中，确保您位于解压缩包的根目录中，然后运行以下命令：

python [package master script file] [script arguments]

package master script file：可以从 MasterFileName 键下的 Package-Structure.yml 中获取。

script arguments：Arguments 键下的 Package-Structure.yml 中提供了有关参数的信息。

  1. 这些脚本将请求远程服务器上的 Cloud Migration F AWS APIs actory 所需的凭据。在此过程中，任何手动输入的凭证都会缓存在内存中，以避免再次输入相同的凭证。如果您输入脚本参数来访问使用凭据管理器功能存储的密钥，则需要访问 S AWS ecrets Manager 和关联的密钥。如果由于任何原因导致检索密钥失败，脚本将提示输入用户凭证。

FactoryEndpoints.json 的创建

我们建议在AWS解决方案上部署 Cloud Migration Factory 时创建一次此文件，因为内容在初始部署后不会更改，并且存储在自动化服务器的中心位置。该文件为自动化脚本提供了AWSAPI端点上的云迁移工厂和其他关键参数。下方显示的是文件的默认内容示例：

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

为已部署的 AWS Cloud Migration Factory 实例编写该文件所需的大部分信息都可以从已部署堆栈的 AWS CloudFormation 输出选项卡中获取，但 UserPoolClientId 除外。通过完成以下步骤获取此值：

  1. 导航到 Amazon Cognito 控制台。

  2. 打开用户群体配置。

  3. 选择应用程序集成，它将提供应用程序客户端配置。

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

Replace（替换） <LoginApi-value>, <UserApi-value>, <Region-value>，以及 <UserPoolId-value> 使用您从 Outputs 控制台检索到 AWS CloudFormation 的相应值。不要在末尾添加正斜杠 (/)。URLs

该文件有一个可选 DefaultUser 键。您可以将此密钥的值设置为默认用户 ID，用于在 AWS 实例上访问云迁移工厂，从而避免每次都必须输入。当系统提示您输入 Cloud Migration Factory 用户 ID 时，您可以输入用户 ID，也可以按 Enter 键使用默认值。只有在手动运行脚本时才能执行此操作。