当我使用 CloudFormation 预置 Amazon EC2 实例时,如何确保部署 CodeDeploy 代理?
我正在使用 AWS CloudFormation 预置我的基础设施和 AWS CodeDeploy 资源。如何确保在我的 Amazon Elastic Compute Cloud (Amazon EC2) 实例上安装并运行 CodeDeploy 代理?
简短描述
如果您创建以下任一资源作为 CodeDeploy 部署的目标,请使用 cfn-init 和 cfn-signal 帮助程序脚本:
- AWS::EC2::Instance
- AWS::AutoScaling::AutoScalingGroup
在您预置基础设施部署之前,可以使用帮助程序脚本,通过 CodeDeploy 代理完全预置目标实例。
解决方法
要使用 cfn-init 和 cfn-signal 帮助程序脚本部署 CodeDeploy 代理,请完成以下步骤以正确配置 AWS CloudFormation 模板。
1. 在代码编辑器中,创建 JSON 或 YAML 文件,以便为您的资源使用 AWS CloudFormation 模板。
2. 对于 Metadata 密钥,使用 AWS::CloudFormation::Init 类型,以便为您的实例或启动配置包含元数据。
使用 AWS::CloudFormation::Init 类型的元数据密钥示例
"SampleLinuxInstance" : { "Type" : "AWS::EC2::Instance", "Metadata" : { "AWS::CloudFormation::Init" : { "config" : { "packages" : { "yum" : { "ruby" : [] } }, "files" : { "/home/ec2-user/install" : { "source" : {"Fn::Join" : ["", ["https://aws-codedeploy-", {"Ref" : "AWS::Region"}, ".s3.amazonaws.com/latest/install"]]}, "mode" : "000755" } }, "commands" : { "00-install-agent" : { "command" : "./install auto", "cwd" : "/home/ec2-user/" }, "01-cfn-signal" : { "command" : {"Fn::Join" : ["", ["/opt/aws/bin/cfn-signal -e 0 --stack ", { "Ref": "AWS::StackName" }, " --resource SampleLinuxInstance --region ", { "Ref" : "AWS::Region" }]]} } } } } }, "Properties" : { ... } }
注意: AWS::CloudFormation::Init 类型包括 CodeDeploy 代理的安装步骤。它还包含在您完成以下步骤后向 CloudFormation 堆栈返回信号的命令。
3. 设置 UserData 属性以调用 cfn-init 脚本。
调用 cfn-init 脚本的 UserData 属性示例
"Properties" : { "InstanceType" : "t2.micro", "ImageId" : {"Ref" : "AMI"}, "IamInstanceProfile" : {"Ref" : "SampleInstanceProfile"}, "KeyName" : {"Ref" : "SSHKey"}, "UserData" : {"Fn::Base64" : { "Fn::Join" : ["", [ "#!/bin/bash\n", "yum -y update\n", "yum -y install cfn-bootstrap\n", "/opt/aws/bin/cfn-init -v", " --stack ", { "Ref" : "AWS::StackName" }, " --resource SampleLinuxInstance", " --region ", { "Ref" : "AWS::Region" }, "\n" ]] }}, "Tags" : [ { "Key" : {"Ref" : "InstanceTagKey"}, "Value" : {"Ref" : "InstanceTagValue"} } ] }
4. 对于实例资源,配置 CreationPolicy 属性以执行以下操作: 要求 Amazon EC2 实例或 Amazon EC2 Auto Scaling 组在指定时段内发送成功信号到 CloudFormation。
CreationPolicy 属性示例,该属性要求 Amazon EC2 实例在指定时间段内发送成功信号到 CloudFormation
"SampleLinuxInstance" : { "Type" : "AWS::EC2::Instance", "CreationPolicy" : { "ResourceSignal" : { "Count" : "1", "Timeout" : "PT5M" } },
5. 要为 Amazon EC2 实例或 Amazon EC2 Auto Scaling 组上的部署组资源创建显式依赖关系,使用 DependsOn 属性。
为部署组资源创建显式依赖关系的 DependsOn 属性示例
"SampleLinuxCDDeploymentGroup" : { "Type" : "AWS::CodeDeploy::DeploymentGroup", "DependsOn" : "SampleLinuxInstance", "Properties" : { "ApplicationName" : {"Ref" : "SampleCDApp"}, "ServiceRoleArn" : {"Ref" : "ServiceRole"}, "Ec2TagFilters" : [ { "Key" : {"Ref" : "InstanceTagKey"}, "Value" : {"Ref" : "InstanceTagValue"}, "Type" : "KEY_AND_VALUE" } ], "Deployment" : { "Revision" : { "RevisionType" : "S3", "S3Location" : { "Bucket" : {"Ref" : "BucketName"}, "BundleType" : {"Ref" : "BundleType"}, "Key" : {"Ref" : "BundleKey"} } } } } }
6. 要完成 CloudFormation 模板,将任何其他附加资源、属性或您的环境所需的输出包括在内。
7. 使用已完成的模板创建 CloudFormation 堆栈。
相关信息
适用于 CodeDeploy 的 AWS CloudFormation 模板参考
为 CodeDeploy 创建 Amazon EC2 实例(AWS CloudFormation 模板)
如何使用启动配置自动将 CodeDeploy 代理安装在运行 Amazon Linux 或 Ubuntu 的 EC2 实例上?
相关内容
- AWS 官方已更新 2 年前
- AWS 官方已更新 1 年前
- AWS 官方已更新 2 年前