AWS CloudFormation
用户指南 (API 版本 2010-05-15)

CloudFormation 帮助程序脚本参考

AWS CloudFormation 提供以下 Python 帮助程序脚本,可用于在作为堆栈的一部分创建的 Amazon EC2 实例上安装软件和启动服务:

  • cfn-init:用于检索和解释资源元数据、安装软件包、创建文件和启动服务。

  • cfn-signal:用于发送 CreationPolicy 或 WaitCondition 信号,因此您能够在先决条件资源或应用程序准备就绪时同步堆栈中的其他资源。

  • cfn-get-metadata:用于检索资源的元数据或特定密钥的路径。

  • cfn-hup:用于检查元数据更新,并在检测到更改时,执行自定义挂钩。

您可以从您的模板中直接调用脚本。该脚本可与在同一模板中定义的资源元数据共同运行。脚本可在堆栈创建过程中的 Amazon EC2 实例上运行。

注意

脚本并非以默认方式执行的。您必须在模板中包含对执行特定帮助程序脚本的调用操作。

Amazon Linux AMI 映像

可在 Amazon Linux AMI 映像上预先安装 AWS CloudFormation 帮助程序脚本。

  • 在最新的 Amazon Linux AMI 版本上,在 /opt/aws/bin 中安装脚本。

  • 在以前的 Amazon Linux AMI 版本上,包含这些脚本的 aws-cfn-bootstrap 软件包位于 Yum 存储库中。

下载其他平台的程序包

对于 Amazon Linux AMI 映像和 Microsoft Windows (2008 或更高版本) 以外的 Linux/Unix 分配,您可以下载 aws-cfn-bootstrap 程序包。

帮助程序脚本的权限

默认情况下,帮助程序脚本不需要凭证,因此您不需要使用 --access-key--secret-key--role--credential-file 选项。但是,如果不指定凭证,则 AWS CloudFormation 会检查堆栈成员并将调用范围限制为实例所属的堆栈。

如果您选择指定一个选项,我们建议您仅指定以下选项之一:

  • --role

  • --credential-file

  • --access-key 以及 --secret-key

如果您指定了一个选项,请记住各种帮助程序脚本需要的权限:

有关在 IAM 策略中使用 AWS CloudFormation 特定的操作和条件上下文键的更多信息,请参阅使用 AWS Identity and Access Management 控制访问

使用最新版本

帮助程序脚本将定期进行更新。如果您使用帮助程序脚本,请确保您的已启动实例使用的是脚本的最新版本:

  • 在调用脚本之前,将以下命令包含在模板的 UserData 属性中。此命令可确保您获得最新版本:

    yum install -y aws-cfn-bootstrap

  • 如果不包括 yum install 命令并使用 cfn-initcfn-signalcfn-get-metadata 脚本,您需要使用以下命令手动更新每个 Amazon EC2 Linux 实例中的脚本:

    sudo yum install -y aws-cfn-bootstrap

  • 如果不包括 yum install 命令并使用 cfn-hup 脚本,您需要使用以下命令手动更新每个 Amazon EC2 Linux 实例中的脚本:

    sudo yum install -y aws-cfn-bootstrap

    sudo /sbin/service cfn-hup restart

  • 如果您将脚本的源代码与其他版本的 Linux 或其他平台一起使用,并且已创建您自己的证书信任存储,则您还需要使此信任存储保持最新。

有关 aws-cfn-bootstrap 程序包的版本历史记录,请参阅 AWS CloudFormation 帮助程序脚本的发布历史记录