[Beta]{class="badge positive"}
使用Canary部署來驗證程式碼 canary-deployments
針對AEM Cloud Service實作，Cloud Manager中的Canary部署可讓您在將實際使用者流量路由到即時生產基礎結構的發佈層級上驗證新程式碼。 您將新版本與目前穩定版本一起部署，並透過專用請求標題觸及它。 在您確認新版本成功運作後，您可以將它升級至所有流量（這在3小時的視窗後自動發生）或將其回覆。
開發和測試環境仍然是測試程式碼發行的主要位置；Canary部署是驗證發行是否如您預期運作的其他機會。 例如，如果AEM生產環境與外部服務的生產端點整合，而且未在較低的AEM環境中明確驗證，則此功能會很有用。
Canary部署是用於內部驗證，而不是用於將真實使用者流量從舊版本轉移到新版本；真實使用者流量永遠不會自動路由到Canary執行個體。
Canary部署程式 how-canary-deployments-work
當您執行已啟用Canary部署的完整棧疊管道時，Cloud Manager會為新組建啟動一組單獨的Canary執行個體，同時您的穩定執行個體會繼續為使用者服務。 此程式會遵循下列步驟：
- 您執行完整棧疊部署管道、中繼或生產環境，該管道已啟用Canary部署。
請參閱執行管道和啟用Canary部署。 - 在部署步驟中，Cloud Manager會啟動執行新版程式碼的Canary執行個體。
- 您現有的穩定執行個體會繼續提供即時流量。
- 您可以新增Canary請求標題，有選擇地存取新版本。 請參閱存取Canary版本。
- 在驗證期間，您可以將Canary版本升級至所有流量，或將其取消。 請參閱驗證和升級或取消。
啟用Canary部署 enable-canary-deployments
您可在完整棧疊管道上啟用Canary部署。 只有 階段 和 生產 環境才支援Canary部署。 請注意，設定為同時部署到中繼和生產環境的管道只會在生產環境中執行Canary部署，如下所示。
依據管道型別的Canary部署行為
Canary部署的執行位置取決於管道型別。
若要啟用Canary部署：
-
在Cloud Manager中，新增管道或編輯將完整棧疊計畫碼部署到中繼或生產環境的現有管道。
-
在 編輯生產管道 對話方塊中，按一下 Source程式碼 索引標籤。
-
在 管道 區段的 生產部署選項 標題下，按一下Canary部署（測試版）。
-
按一下 更新 以完成管道啟用。
在驗證期間，只有包含Canary標題的請求會存取新部署的版本。 所有其他請求會繼續產生穩定版本。
存取Canary版本 access-the-canary-release
Cloud Manager啟動Canary執行個體後，您可以新增HTTP標題至請求來使用新版本。 穩定版本會繼續處理沒有標題的請求。
若要傳送要求給Canary版本，請包括以下標題：
X-Aem-Canary: true
驗證和提升或取消 validate-and-promote-or-cancel
當Canary執行處理準備就緒時，會開啟驗證視窗，以便您測試新版本。 Cloud Manager會在 部署到生產 區段中顯示提升到生產和取消部署選項。
宣傳Canary發行版本 promote-the-canary-release
若要將所有即時流量路由到新版本，請按一下提升到生產環境。 當您推廣Canary版本時：
- Canary版本成為新的穩定版本。
- Cloud Manager會將所有即時流量路由到新版本。
- 復原功能已無法使用。
取消Canary部署 cancel-the-canary-deployment
如果您在驗證期間發現問題，請按一下[取消部署]。 當您取消Canary部署時：
- Cloud Manager會停止canary發行版本，並移除canary執行個體。
- 先前的穩定版本會繼續提供流量。
- 取消只能在驗證期間使用。
範圍和限制 scope-and-limitations
使用Canary部署時，請考量下列範圍和限制：
- Canary部署僅適用於發佈階層。 在Canary驗證期間，製作層級會維持在穩定版本。
- 您的變更必須回溯相容，以便Canary發佈執行個體能提供您現有的內容結構。
- 在您提升Canary版本後，版本中的可變內容變更將會套用。 在驗證期間，這些變更在Canary執行個體上無法使用。