AWS CodeDeploy

User Guide (API 版本 2014-10-06)

AWS 文档 » AWS CodeDeploy » User Guide » 使用适用于 AWS CodeDeploy 的实例 » 使用适用于 AWS CodeDeploy 的本地实例 » 将本地实例注册到 AWS CodeDeploy » 使用注册命令 (IAM 用户 ARN) 注册本地实例

使用注册命令 (IAM 用户 ARN) 注册本地实例

本部分介绍如何以最少的工作量使用 AWS CodeDeploy 配置本地实例并注册和标记该实例。当您处理一个或少量的本地实例时，register 命令非常有用。仅当您使用 IAM 用户 ARN 对实例进行身份验证时，才能使用 register 命令。使用 IAM 会话 ARN 进行身份验证时，不能使用 register 命令。

在使用 register 命令时，您可以让 AWS CodeDeploy 执行以下操作：

步骤 1：在本地实例上安装和配置 AWS CLI

1. 在本地实例上安装 AWS CLI。按照 AWS 命令行界面用户指南中使用 AWS 命令行界面进行设置的说明执行操作。

   注意

   可用于本地实例的 AWS CodeDeploy 命令在 AWS CLI 版本 1.7.19 和更高版本中提供。如果您已安装了 AWS CLI，请调用 aws --version 来检查其版本。

2. 在本地实例上配置 AWS CLI。按照 AWS 命令行界面用户指南中的配置 AWS 命令行界面的说明执行操作。

   重要

   在您配置 AWS CLI（例如，通过调用 aws configure 命令）时，请确保指定 IAM 用户的私有密钥 ID 和秘密访问密钥，并且除了在配置本地实例的先决条件中指定的权限之外，该用户还必须至少具有以下 AWS 访问权限。这使得在本地实例上下载和安装 AWS CodeDeploy 代理成为可能。访问权限应与以下示例类似：

   {
     "Version": "2012-10-17",
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*",
           "iam:CreateAccessKey",
           "iam:CreateUser",
           "iam:DeleteAccessKey",
           "iam:DeleteUser",
           "iam:DeleteUserPolicy",
           "iam:ListAccessKeys",
           "iam:ListUserPolicies",
           "iam:PutUserPolicy",
           "iam:GetUser",
           "tag:GetTags",
           "tag:GetResources"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "arn:aws-cn:-cn:s3:::aws-codedeploy-cn-north-1/*",
           "arn:aws-cn:-cn:s3:::aws-codedeploy-cn-northwest-1/*"
         ]
       }     
     ]
   }

步骤 2：调用注册命令

在这一步中，我们假设您从本地实例本身注册该本地实例。您还可以从安装和配置了 AWS CLI 的单独设备或实例上注册本地实例，如先前的步骤中所述。

使用 AWS CLI 调用 register 命令，在命令中指定：

例如：

aws deploy register --instance-name AssetTag12010298EX --iam-user-arn arn:aws-cn:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem --tags Key=Name,Value=CodeDeployDemo-OnPrem --region us-west-2

register 命令执行以下操作：

如果此命令遇到错误，则将显示错误消息，说明您可以如何手动完成剩余步骤。否则将显示成功消息，说明如何调用 install 命令，如接下来的步骤中所列。

步骤 3：调用安装命令

从本地实例，使用 AWS CLI 调用 install 命令，在命令中指定：

例如：

aws deploy install --override-config --config-file /tmp/codedeploy.onpremises.yml --region us-west-2 --agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi

install 命令执行以下操作：

步骤 4：将应用程序修订部署到本地实例

现在，您已准备好将应用程序修订部署到已注册和标记的本地实例。

将应用程序修订部署到本地实例的方法类似于将应用程序修订部署到 Amazon EC2 实例。有关说明，请参阅 使用 AWS CodeDeploy 创建部署。这些说明链接到各种先决条件，包括创建应用程序、创建部署组和准备应用程序修订。如果您希望部署简单的示例应用程序修订，可以创建教程：使用 AWS CodeDeploy 将应用程序部署到本地实例（Windows Server、Ubuntu Server 或 Red Hat Enterprise Linux）的步骤 2：创建示例应用程序修订中所述的修订。

步骤 5：跟踪对本地实例的部署

将应用程序修订部署到已注册和标记的本地实例之后，您可以跟踪部署进度。

跟踪对本地实例的部署的方法与跟踪对 Amazon EC2 实例的部署的方法类似。有关说明，请参阅使用 AWS CodeDeploy 查看部署详细信息。

有关更多选项，请参阅在 AWS CodeDeploy 中管理本地实例操作。

本页内容：

• 步骤 1：在本地实例上安装和配置 AWS CLI
• 步骤 2：调用注册命令
• 步骤 3：调用安装命令
• 步骤 4：将应用程序修订部署到本地实例
• 步骤 5：跟踪对本地实例的部署