从 GitHub 运行 Python 脚本

从 GitHub 运行 Python 脚本

1. 打开Amazon Web Services Systems Manager位于控制台https://console.aws.amazon.com/systems-manager/。

2. 在导航窗格中，选择Run Command。

   -或者-

   如果Amazon Web Services Systems Manager首先打开主页，选择菜单图标（ ）以打开导航窗格，然后选择Run Command。

3. 选择运行命令。

4. 在 Command document (命令文档) 列表中，选择 AWS-RunRemoteScript。

5. 对于命令参数，执行以下操作：

   • 在源类型中，选择 GitHub。

   • 在源信息框中，按以下格式输入访问源所需的信息：

     {
         "owner": "owner_name",
         "repository": "repository_name",
         "getOptions": "branch:branch_name",
         "path": "path_to_document",
         "tokenInfo": "{{ssm-secure:SecureString_parameter_name}}"
     }

     下面的示例下载名为复合脚本。

     {
         "owner": "TestUser1",
         "repository": "SSMTestDocsRepo",
         "getOptions": "branch:myBranch",
         "path": "scripts/python/complex-script",
         "tokenInfo": "{{ssm-secure:myAccessTokenParam}}"
     }

     注意

     仅当您的脚本存储在 master 以外的分支中时，"branch" 才是必需的。

     要使用存储库中特定提交 中的脚本版本，请使用 commitID 和 getOptions，而不是 branch。例如：

     "getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",

   • 适用于命令行中，输入脚本执行的参数。以下是示例。

     mainFile.py argument-1 argument-2

     此示例运行mainFile.py，它之后会运行其他脚本complex-script目录中。

   • （可选）适用于Parameter Directory中，输入实例上要在其中下载和运行脚本的目录的名称。

   • （可选）对于Execution Timeout (执行超时)，指定脚本命令执行失败之前系统要等待的秒数。

6. 在目标部分，通过手动指定标签、选择实例或指定资源组来标识您要对其运行该操作的实例。

   注意

   如果未列出您希望看到的 Amazon EC2 实例，请参阅Amazon EC2 托管实例可用性疑难解答以了解故障排除提示。

7. 对于其他参数：

   • 适用于注释中，输入有关此命令的信息。

   • 对于超时 (秒)，请指定在整个命令执行失败之前系统等待的秒数。

8. 适用于速率控制：

   • 对于并发，请指定要同时运行该命令的实例数或百分比。

     注意

     如果您通过指定应用于托管实例的标签或指定Amazon资源组，但不确定有多少个实例被定向，则可以通过指定百分比来限制可同时运行此文档的实例数量。

   • 对于错误阈值，请指定在一定数量或百分比的实例上失败后何时在其他实例上停止运行该命令。例如，如果您指定三个错误，Systems Manager 将在收到第四个错误时停止发送该命令。仍在处理命令的实例也可能发送错误。

9. （可选）对于 Output options (输出选项)，要将命令输出保存到文件，请选中 Write command output to an S3 bucket (将命令输出写入 S3 存储桶) 框。在框中输入存储桶和前缀（文件夹）名称。

   注意

   授予将数据写入 S3 存储桶的能力的 S3 权限是分配给实例的实例配置文件的权限，而不是执行此任务的 IAM 用户的权限。有关更多信息，请参阅 。为创建 IAM 实例配置文件。此外，如果指定 S3 存储桶位于不同Amazon Web Services 账户，请确保与该实例关联的实例配置文件具有写入该存储桶的必要权限。

10. 在SNS 通知部分，如果需要发送有关命令执行状态的通知，请选中启用 SNS 通知”复选框。

    有关为 Run Command 配置 Amazon SNS 通知的更多信息，请参阅使用 Amazon SNS 通知监控 Systems Manager 状态更改。

11. 选择运行。

1. 安装和配置Amazon命令行界面 (AmazonCLI），如果尚未执行该操作。

   想要了解有关信息，请参阅安装或升级Amazon命令行工具。

2. 运行以下命令可从 GitHub 下载并运行脚本。

   aws ssm send-command --document-name "AWS-RunRemoteScript" --instance-ids "instance-IDs" --parameters '{"sourceType":["GitHub"],"sourceInfo":["{\"owner\":\"owner_name\", \"repository\":\"repository_name\", \"path\": \"path_to_script_or_directory"}"],"commandLine":["commands_to_run"]}'

   以下是示例。

   aws ssm send-command --document-name "AWS-RunRemoteScript" --instance-ids "i-02573cafcfEXAMPLE" --parameters '{"sourceType":["GitHub"],"sourceInfo":["{\"owner\":\"TestUser1\", \"repository\":\"GitHubTestPublic\", \"path\": \"scripts/python/complex-script\"}"],"commandLine":["mainFile.py argument-1 argument-2 "]}'

   此示例下载名为complex-script。这些区域有：commandLine运行条目mainFile.py，它之后会运行其他脚本complex-script目录中。