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

# 步驟 1：建立技術指南
<a name="gettingstarted-cookbooks-create-cookbook"></a>

**重要**  
 AWS OpsWorks Stacks 此服務已於 2024 年 5 月 26 日終止，並已針對新客戶和現有客戶停用。我們強烈建議客戶盡快將其工作負載遷移至其他解決方案。如果您對遷移有任何疑問，請透過 [AWS re：Post](https://repost.aws/) 或透過 [AWS Premium Support](https://aws.amazon.com/support) 聯絡 AWS 支援 團隊。

從建立技術指南開始。此技術指南對開始作用不大，但它會作為本演練其餘部分的基礎。

**注意**  
此步驟示範如何手動建立技術指南。您可以透過使用 Chef 開發套件 ([Chef DK](https://docs.chef.io/#chef-dk-title)) 在您的本機工作站上執行 [https://docs.chef.io/ctl_chef.html#chef-generate-cookbook](https://docs.chef.io/ctl_chef.html#chef-generate-cookbook) 命令，來更快速的建立技術指南。但是，此命令會建立數個您在本演練中不需要的資料夾及檔案。

**建立技術指南**

1. 在您的本機工作站上，建立名為 `opsworks_cookbook_demo` 的目錄。您可以使用不同的名稱，但請務必在本演練的後續部分一律將 `opsworks_cookbook_demo` 取代為您選擇的名稱。

1. 在 `opsworks_cookbook_demo` 目錄中，使用文字編輯器建立一個名為 `metadata.rb` 的檔案。新增以下程式碼來指定技術指南的名稱。如需 `metadata.rb` 的詳細資訊，請參閱 Chef 網站上的 [metadata.rb](https://docs.chef.io/config_rb_metadata.html)。

   ```
   name "opsworks_cookbook_demo"
   ```

1. 在 `opsworks_cookbook_demo` 目錄中，建立名為 `recipes` 的子目錄。此子目錄包含所有您為本演練的技術指南建立的配方。

1. 在 `recipes` 目錄中，建立名為 `default.rb` 的檔案。此檔案包含具有與檔案名稱相同的配方，但不帶有副檔名：`default`。將下列單行程式碼新增至 `default.rb` 檔案。此程式碼為一個單行配方，會在配方執行時於日誌中顯示簡易訊息：

   ```
   Chef::Log.info("********** Hello, World! **********")
   ```

1. 在終端機或命令提示中，使用 **tar** 命令建立名為 `opsworks_cookbook_demo.tar.gz` 的檔案，其中包含 `opsworks_cookbook_demo` 目錄及其內容。例如：

   ```
   tar -czvf opsworks_cookbook_demo.tar.gz opsworks_cookbook_demo/
   ```

   您可以使用不同的檔案名稱，但請務必在本演練的後續部分一律將 `opsworks_cookbook_demo.tar.gz` 取代為您選擇的名稱。
**注意**  
當您在 Windows 上建立 `tar` 檔案時，最上層目錄必須為技術指南的父系目錄。此演練已在 Linux 上使用 `tar`套件提供的**tar**命令進行測試，並在 Windows 上使用 [Git Bash](https://git-for-windows.github.io/) 提供的**tar**命令進行測試。使用其他命令或程式建立壓縮 TAR (.tar.gz) 檔案可能無法正常運作。

1. 建立 S3 儲存貯體，或使用現有的儲存貯體。如需詳細資訊，請參閱[建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html)。

1. 將 `opsworks_cookbook_demo.tar.gz` 檔案上傳至 S3 儲存貯體。如需詳細資訊，請參閱[將物件新增至儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PuttingAnObjectInABucket.html)。

您現在已有您可以在本演練中使用的技術指南。

在[下一個步驟](gettingstarted-cookbooks-create-stack.md)中，您會建立 Stacks OpsWorks 堆疊，以供稍後用來上傳技術指南和執行技術指南的配方。