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

为 Chef 11.10 堆栈实施配方

相对于 Chef 11.4 堆栈，Chef 11.10 堆栈提供以下优势：

说明书安装和优先顺序

Chef 11.10 AWS OpsWorks 堆栈的安装 Stacks 食谱的过程与早期的 Chef 版本略有不同。对于 Chef 11.10 堆栈，在 AWS OpsWorks Stacks 安装内置、自定义和 Berkshelf 食谱后，它会按以下顺序将它们合并到公共目录中：

当 AWS OpsWorks Stacks 执行此合并时，它会复制目录的全部内容，包括配方。如果有重复项，则将依照以下规则处理：

为了说明此过程的原理，请想一想以下场景，其中所有这三个说明书目标都包括名为 mycookbook 的说明书：

合并的说明书包含以下内容：

使用 Chef 搜索

您可以在您的配方中使用 Chef search 方法来查询堆栈数据。你使用与 Chef 服务器相同的语法，但是 AWS OpsWorks Stacks 从本地节点对象获取数据，而不是查询 Chef 服务器。这些数据包括：

堆栈配置和部署属性包含配方通常通过搜索获得的大部分信息，包括堆栈中每个在线实例的主机名和 IP 地址等数据。 AWS OpsWorks 堆栈会为每个生命周期事件更新这些属性，从而确保它们准确反映当前堆栈状态。这意味着，您可以经常在您的堆栈中使用与搜索相关的社区配方，而无需修改。搜索方法仍返回适当的数据；但这些数据来自堆栈配置和部署属性，而不是服务器。

AWS OpsWorks Stacks 搜索的主要局限性在于，它只能处理本地节点对象中的数据，尤其是堆栈配置和部署属性。因此，可能无法通过搜索获得以下类型的数据：

以下配方摘录显示了如何使用搜索来获取PHP图层实例的私有 IP 地址。

appserver = search(:node, "role:php-app").first
Chef::Log.info("The private IP is '#{appserver[:private_ip]}'")

使用数据包

您可以在您的配方中使用 Chef data_bag_item 方法来查询数据包中的信息。您使用与将为 Chef 服务器使用的语法相同的语法，但 AWS OpsWorks Stacks 从实例的堆栈配置和部署属性中获取数据。但是， AWS OpsWorks Stacks 目前不支持 Chef 环境，因此请node.chef_environment务必返回_default。

您可以使用 custom JSON 向属性添加一个或多个属性来创建数据袋。[:opsworks][:data_bags]以下示例显示了在 custom 中创建数据袋的一般格式JSON。

{
  "opsworks": {
    "data_bags": {
      "bag_name1": {
        "item_name1: {
          "key1" : “value1”,
          "key2" : “value2”,
          ...
        }
      },
      "bag_name2": {
        "item_name1": {
          "key1" : “value1”,
          "key2" : “value2”,
          ...
        }
      },
      ...
    }
  }
}

您通常JSON为堆栈指定 cu stom，它会在每个后续生命周期事件的每个实例上安装自定义属性。您也可以在部署应用程序JSON时指定自定义，但这些属性仅针对该部署安装，并且可能仅安装到一组选定的实例中。有关更多信息，请参阅 部署应用程序。

以下自定义JSON示例创建名为的数据包myapp。它包含一个项目 mysql 以及两个密钥值对。

{ "opsworks": {
    "data_bags": {
      "myapp": {
        "mysql": { 
          "username": "default-user",
          "password": "default-pass"
        }
      }
    }
  }
}

要使用您的配方中的数据，您可以调用 data_bag_item 并向其传递数据包和值名称，如以下摘录所示。

mything = data_bag_item("myapp", "mysql")
Chef::Log.info("The username is '#{mything['username']}' ")

要修改数据包中的数据，只需修改自定义JSON，它就会安装在堆栈的实例上，以备下一个生命周期事件使用。

使用 Berkshelf

对于 Chef 0.9 和 Chef 11.4 堆栈，您仅可以安装一个自定义说明书存储库。对于 Chef 11.10 堆栈，您可以使用 Berkshelf 管理您的说明书及其依赖项，这使您可以从多个存储库中安装说明书。（有关更多信息，请参阅 本地打包说明书依赖项。） 特别是，使用 Berkshelf，您可以直接从其存储库安装与 AWS OpsWorks Stacks 兼容的社区食谱，而不必将它们复制到您的自定义食谱存储库中。哪个版本的 Berkshelf 受支持，取决于操作系统。有关更多信息，请参阅 AWS OpsWorks 堆栈操作系统。

要使用 Berkshelf，您必须明确启用它，如安装自定义说明书中所述。然后，将一个 Berksfile 文件放入您的说明书存储库的根目录 (指明要安装哪些说明书)。

要在 Berksfile 中指定外部食谱来源，请在文件顶部添加一个用于指定默认存储库的 source 属性。URLURLs除非您明确指定存储库，否则 Berkshelf 将在源代码中查找食谱。然后为您希望安装的每个说明书添加一行，格式如下：

cookbook 'cookbook_name', ['>= cookbook_version'], [cookbook_options]

cookbook 后面的字段指定特定的说明书。

下面是 Berksfile 的一个示例，介绍了指定说明书的不同方法。有关如何创建 Berksfile 的更多信息，请参阅 Berkshelf。

source "https://supermarket.chef.io"

cookbook 'apt'
cookbook 'bluepill', '>= 2.3.1'
cookbook 'ark', git: 'git://github.com/opscode-cookbooks/ark.git'
cookbook 'build-essential', '>= 1.4.2', git: 'git://github.com/opscode-cookbooks/build-essential.git', tag: 'v1.4.2'

此文件安装以下说明书：

除了 Berksfile，自定义说明书存储库还可以包含自定义说明书。在这种情况下， AWS OpsWorks Stacks 会安装两套食谱，这意味着一个实例可以有多达三个食谱存储库。

在安装过程中，内置食谱和您的自定义食谱会安装在每个实例上，除非您手动运行 “更新自定义食谱” 堆栈命令，否则不会随后进行更新。 AWS OpsWorks Stacks 在berks install每次 Chef 运行时都会运行，因此您的 Berkshelf 食谱会根据以下规则针对每个生命周期事件进行更新：

您还可以通过以下方法更新您的 Berkshelf 说明书：运行 Update Custom Cookbooks 堆栈命令，这会同时更新 Berkshelf 说明书和您的自定义说明书。