本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

實作 Chef 11.10 堆疊的配方

Chef 11.10 堆疊與 Chef 11.4 堆疊相比有下列優點：

技術指南安裝與優先順序

安裝 AWS OpsWorks Stacks 技術指南的程序對 Chef 11.10 堆疊的運作方式與舊版 Chef 略有不同。對於 Chef 11.10 堆疊，在 AWS OpsWorks Stacks 安裝內建、自訂和 Berkshelf 技術指南之後，它會以下列順序將它們合併到通用目錄：

AWS OpsWorks 當 Stacks 執行此合併時，它會複製目錄的完整內容，包括配方。若有任何重複項目，則會套用下列規則：

為了示範此程序運作的方式，請考慮以下案例，其中三個技術指南目錄都包含名為 mycookbook 的技術指南：

合併的技術指南包含以下內容：

使用 Chef 搜尋

您可以在您的配方中使用 Chef search 方法來查詢堆疊資料。您使用與 Chef 伺服器相同的語法，但 AWS OpsWorks Stacks 會從本機節點物件取得資料，而不是查詢 Chef 伺服器。此資料包括：

堆疊組態和部署屬性包含配方通常透過搜尋取得的大部分資訊，包括堆疊中每個線上執行個體的主機名稱和 IP 地址等資料。 AWS OpsWorks 堆疊會為每個生命週期事件更新這些屬性，以確保它們準確反映目前的堆疊狀態。這表示您通常可以在您的堆疊中使用搜尋依存的社群配方，而無須修改。search 方法仍然會傳回適當的資料，只是該資料會來自堆疊組態及部署屬性，而非伺服器。

Stacks AWS OpsWorks 搜尋的主要限制是僅處理本機節點物件中的資料，特別是堆疊組態和部署屬性。因此，下列資料類型可能無法透過 search 取得：

下列配方摘要會示範如何使用 search 取得 PHP layer 執行個體的私有 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。

您會透過使用自訂 JSON 建立資料包，來將一或多個屬性新增至 [:opsworks][:data_bags] 屬性。以下範例示範在自訂 JSON 中建立資料包的一般格式。

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

您通常會指定堆疊的自訂 JSON，針對每個接下來的生命週期事件，於每個執行個體上安裝自訂屬性。您也可以在您部署應用程式時指定自訂 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 Stacks 作業系統。

若要使用 Berkshelf，您必須明確啟用它，如安裝自訂技術指南中所說明。然後，在您的技術指南儲存庫根目錄中包含一個 Berksfile 檔案，指定要安裝的技術指南。

若要在 Berksfile 中指定外部技術指南來源，請在檔案的頂端包含一個來源屬性，指定預設儲存庫 URL。Berkshelf 會在來源 URL 中尋找技術指南，除非您明確指定儲存庫。然後，在每個您希望安裝的技術指南中包含一行文字，格式如下：

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 堆疊berks install會在每次執行 Chef 時執行，因此您的 Berkshelf 技術指南會根據下列規則，針對每個生命週期事件更新：

您也可以透過執行更新自訂技術指南堆疊命令來更新您的 Berkshelf 技術指南，該命令會同時更新 Berkshelf 技術指南和您的自訂技術指南。