安装自定义说明书 - AWS OpsWorks
指定自定义说明书存储库

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

安装自定义说明书

重要

AWS OpsWorks Stacks 不再接受新客户。在 2024 年 5 月 26 日之前，现有客户将能够正常使用 OpsWorks 控制台、API、CLI 和 CloudFormation 资源，届时它们将停产。为准备此过渡，我们建议您 AWS Systems Manager 尽快将堆栈过渡到。有关更多信息，请参阅 AWS OpsWorks Stacks 生命周期终结常见问题解答 和 将 AWS OpsWorks Stacks 应用程序迁移到 AWS Systems Manager 应用程序管理器。

要让堆栈安装和使用自定义说明书，您必须将堆栈配置为启用自定义说明书 (如果尚未配置)。然后，您必须提供存储库 URL 和任何相关信息，如密码。

重要

将堆栈配置为支持自定义食谱后， AWS OpsWorks Stacks 会在启动时自动将您的食谱安装到所有新实例上。但是，您必须通过运行 “更新自定义 Cookbook AWS OpsWorks s 堆栈” 命令明确指示 Stacks 在任何现有实例上安装新的或更新的食谱。有关更多信息，请参阅 更新自定义说明书。在堆栈上启用 Use custom Chef cookbooks (使用自定义 Chef 说明书) 之前，请确保您运行的自定义和社区说明书支持堆栈所使用的 Chef 版本。

为自定义说明书配置堆栈

  1. 在您的堆栈页面上，单击 Stack Settings 以显示其 Settings 页面。单击 Edit 以编辑设置。

  2. 将 Use custom Chef cookbooks 切换为 Yes。

    编辑堆栈设置页面

  3. 配置您的自定义说明书。

完成后，单击 Save 以保存更新后的堆栈。

指定自定义说明书存储库

Linux 堆栈可从以下任意一种存储库类型中安装自定义说明书：

  • HTTP 或 Amazon S3 存档。

    它们可以是公有或私有，但 Amazon S3 通常是私有存档的首选选项。

  • Git 和 Subversion 存储库提供源代码控制，并且让您可以有多个版本。

Windows 堆栈可从 Amazon S3 存档和 Git 存储库中安装自定义说明书。

所有存储库类型均具有以下必填字段。

  • 存储库类型：存储库的类型

  • 存储库 URL：存储库的 URL

AWS OpsWorks Stacks 支持公共托管的 Git 存储库站点，例如GitHub或 Bitbucke t 以及私有托管的 Git 服务器。对于 Git 存储库，您必须使用以下一种 URL 格式，具体取决于存储库是公有还是私有。遵循与 Git 子模块相同的 URL 准则。

对于公有 Git 存储库，请使用 HTTPS 或 Git 只读协议：

  • Git 只读：git://github.com/amazonwebservices/opsworks-example-cookbooks.git。

  • HTTPS：https://github.com/amazonwebservices/opsworks-example-cookbooks.git。

对于私有 Git 存储库，您必须使用 SSH 读/写格式，如下例所示：

  • Github 存储库：git@github.com:project/repository。

  • Git 服务器上的存储库：user@server:project/repository

剩余的设置会因存储库类型而异，以下各节将介绍这些设置。

HTTP 存档

为 Repository type 选择 Http Archive 时将显示两个额外的设置，如果该存档受密码保护，则您必须完成这两个设置。

  • 用户名：您的用户名

  • Password - 您的密码

Amazon S3 归档

为存储库类型选择 S3 存档会显示以下其他可选设置。 AWS OpsWorks 无论您使用堆栈 API 还是控制台，堆栈都可以使用 Amazon EC2 角色（主机操作系统管理员身份验证）访问您的存储库。 AWS OpsWorks

  • 访问密钥 ID - AWS 访问密钥 ID，例如 AKIAIOSFODNN7EXAMPLE。

  • 秘密访问密钥 — 相应的 AWS 秘密访问密钥，例如 wjalr bPxRfi xutnfemi/k7mdeng/ CYEXAMPLEKEY。

Git 存储库

选择 Source Control 下的 Git 会显示以下额外可选设置：

存储库 SSH 密钥

您必须指定一个部署 SSH 密钥来访问私有 Git 存储库。对于 Git 子模块，指定的密钥必须有权访问这些子模块。有关更多信息，请参阅 使用 Git 存储库 SSH 密钥。

重要

部署 SSH 密钥不需要密码； AWS OpsWorks Stacks 无法通过密码。

分支/修订

如果存储库有多个分支， AWS OpsWorks Stacks 会默认下载主分支。要指定特定分支，请输入分支名称、SHA1 哈希或标签名称。要指定特定提交，请输入完整的 40 位十六进制提交 ID。

Subversion 存储库

选择 Source Control 下的 Subversion 会显示以下额外可选设置：

  • 用户名：您的针对私有存储库的用户名称。

  • 密码：您的针对私有存储库的密码。

  • 修订：[可选] 修订名称（如果您有多个修订）。

    要指定分支或标记，您必须修改存储库 URL，例如：http://repository_domain/repos/myapp/branches/my-apps-branch 或 http://repository_domain_name/repos/calc/myapp/my-apps-tag。