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

# 安裝自訂技術指南
<a name="workingcookbook-installingcustom-enable"></a>

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

若要使堆疊安裝及使用自訂技術指南，您必須設定堆疊，啟用自訂技術指南 (若還未設定的話)。您接著必須提供儲存庫 URL 和任何相關資訊 (例如密碼)。

**重要**  
將堆疊設定為支援自訂技術指南之後， OpsWorks Stacks 會在啟動時在所有新執行個體上自動安裝技術指南。不過，您必須執行更新自訂技術指南堆疊命令，明確指示 OpsWorks Stacks 在任何現有的執行個體上安裝新的或更新的技術指南。 [****](workingstacks-commands.md)如需詳細資訊，請參閱[更新自訂技術指南](workingcookbook-installingcustom-enable-update.md)。在您於堆疊上啟用 **Use custom Chef cookbooks (使用自訂 Chef 技術指南)** 前，請確認您執行的自訂和社群技術指南支援您堆疊使用的 Chef 版本。

**若要為自訂技術指南設定堆疊**

1. 在您的堆疊頁面上，按一下 **Stack Settings (堆疊設定)** 顯示其 **Settings (設定)** 頁面，按一下 **Edit (編輯)** 以編輯設定。

1. 將 **Use custom Chef cookbooks (使用自訂 Chef 技術指南)** 切換為 **Yes (是)**。  
![\[編輯堆疊設定頁面\]](http://docs.aws.amazon.com/zh_tw/opsworks/latest/userguide/images/stack_settings_edit.png)

1. 設定您的自訂技術指南。

當您完成後，按一下 **Save (儲存)** 以儲存更新的堆疊。

## 指定自訂技術指南儲存庫
<a name="workingcookbook-installingcustom-enable-repo"></a>

Linux 堆疊可以從下列任何儲存庫類型安裝自訂技術指南：
+ HTTP 或 Amazon S3 封存。

  它們可以是公有或私有，但 Amazon S3 通常是私有封存的偏好選項。
+ Git 和 Subversion 儲存庫提供來源控制和具有多個版本的能力。

Windows 堆疊可以從 Amazon S3 封存和 Git 儲存庫安裝自訂技術指南。

所有儲存庫類型都有以下必要欄位。
+ **儲存庫類型** – 儲存庫類型
+ **儲存庫 URL** – 儲存庫 URL

OpsWorks Stacks 支援公有託管的 Git 儲存庫網站，例如 [GitHub](https://github.com/) 或 [Bitbucket](https://bitbucket.org)，以及私有託管的 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 封存
<a name="workingcookbook-installingcustom-enable-repo-http"></a>

針對 **Repository type (儲存庫類型)** 選取 **Http Archive (Http 封存)** 會顯示兩個額外設定，若封存受到密碼保護，您便必須完成這些設定。
+ **使用者名稱** – 您的使用者名稱
+ **密碼** – 您的密碼

### Amazon S3 封存
<a name="workingcookbook-installingcustom-enable-repo-s3"></a>

選取 **S3 Archive** for **Repository 類型**會顯示下列額外的選用設定。 OpsWorks 無論您使用 Stacks API 或主控台， Stacks 都可以使用 Amazon EC2 角色 （主機作業系統管理員身分驗證） OpsWorks 存取您的儲存庫。
+ **存取金鑰 ID** – AWS 存取金鑰 ID，例如 AKIAIOSFODNN7EXAMPLE。
+ **私密存取金鑰** – 對應的 AWS 私密存取金鑰，例如 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY。

### Git 儲存庫
<a name="workingcookbook-installingcustom-enable-repo-git"></a>

在 **Source Control (來源控制)** 下方選取 **Git** 會顯示下列額外選擇性設定：

**Repository SSH key (儲存庫 SSH 金鑰)**  
您必須指定部署 SSH 金鑰才能存取私有 Git 儲存庫。針對 Git 子模組，指定的金鑰必須要能存取這些子模組。如需詳細資訊，請參閱[使用 Git 儲存庫 SSH 金鑰](workingapps-deploykeys.md)。  
部署的 SSH 金鑰不需要密碼； OpsWorks Stacks 無法傳遞密碼。

**Branch/Revision (分支/修訂)**  
如果儲存庫有多個分支， OpsWorks Stacks 預設會下載主分支。若要指定特定分支，請輸入分支名稱、SHA1 雜湊或標籤名稱。若要指定特定的遞交，請輸入完整 40 個八進位碼的遞交 ID。

### Subversion 儲存庫
<a name="workingcookbook-installingcustom-enable-repo-svn"></a>

在 **Source Control (來源控制)** 下方選取 **Subversion** 會顯示下列額外選擇性設定：
+ **使用者名稱** – 私有儲存庫的使用者名稱。
+ **密碼** – 您的密碼，適用於私有儲存庫。
+ **Revision**–【選用】 如果您有多個修訂，則為修訂名稱。

  若要指定分支或標籤，您必須修改儲存庫 URL，例如：**http://repository\$1domain/repos/myapp/branches/my-apps-branch** 或 **http://repository\$1domain\$1name/repos/calc/myapp/my-apps-tag**。