本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
了解 AWS AppConfig 擴展
本主題介紹 AWS AppConfig 擴充功能概念和術語。這些資訊會在設定和使用 AWS AppConfig 延伸模組所需的每個步驟的前後關聯中討論。
步驟 1:確定您要使用擴展程序執行的操作
您是否要收到 Webhook 的通知,該通知會在 AWS AppConfig 部署完成時向 Slack 傳送訊息? 您是否要在部署組態之前將組態設定檔備份到 Amazon 簡單儲存服務 (Amazon S3) 儲存貯體? 是否要在部署組態之前清除機密資訊的組態資料? 您可以使用擴充功能來執行這些類型的工作等。您可以建立自訂擴充功能,或使用隨附的 AWS 編寫擴充功能。 AWS AppConfig
注意
對於大多數使用案例,若要建立自訂擴充功能,您必須建立 AWS Lambda 函數來執行擴充功能中定義的任何計算和處理。如需詳細資訊,請參閱逐步解說:建立自訂 AWS AppConfig 延伸。
下列 AWS 撰寫的延伸功能可協助您快速整合組態部署與其他服務。您可以在 AWS AppConfig 主控台中使用這些擴充功能,或直接從 AWS CLI AWS Tools for PowerShell、或呼叫擴充功能API動作SDK。
延伸 | 描述 |
---|---|
此擴充功能可讓您的應用程式在本機指派變體給使用者工作階段,而不是呼叫EvaluateFeature作業。如需詳細資訊,請參閱使用 Amazon CloudWatch 顯然擴展。 |
|
此擴充功能會在部署組態時,將事件傳送至 EventBridge 預設事件匯流排。 |
|
此擴充功能會將訊息傳送至您在部署組態時指定的 Amazon SNS 主題。 |
|
此擴充功能會在部署組態時將訊息排入 Amazon SQS 佇列。 |
|
此擴充功能可 AWS AppConfig 讓您在變更功能旗標時建立和更新問題。 |
步驟 2:確定何時要執行擴充功能
擴充功能會定義它在工作流程期間執行的一或多個動 AWS AppConfig 作。例如, AWS 編寫的AWS AppConfig deployment events to Amazon SNS
擴充功能包含傳送通知給 Amazon SNS 主題的動作。當您與之互動 AWS AppConfig 或代表您執行處理程序 AWS AppConfig 時,都會叫用每個動作。這些被稱為行動點。 AWS AppConfig 擴充功能支援下列動作要點:
-
PRE_CREATE_HOSTED_CONFIGURATION_VERSION
-
PRE_START_DEPLOYMENT
-
ON_DEPLOYMENT_START
-
ON_DEPLOYMENT_STEP
-
ON_DEPLOYMENT_BAKING
-
ON_DEPLOYMENT_COMPLETE
-
ON_DEPLOYMENT_ROLLED_BACK
在動作點上設定的延伸PRE_*
動作會在請求驗證後套用,但在 AWS AppConfig 執行與動作點名稱相對應的活動之前。這些動作呼叫會與要求同時處理。如果發出一個以上的請求,動作調用按順序運行。另請注意,PRE_*
動作點會接收並且可以變更組態的內容。 PRE_*
動作點也可以回應錯誤並防止動作發生。
擴充功能也可以使用ON_*
動作點與 AWS AppConfig 工作流程 parallel 執行。 ON_*
動作點是異步調用的。 ON_*
動作點不會收到配置的內容。如果延伸功能在ON_*
動作點期間遇到錯誤,服務會忽略錯誤並繼續工作流程。
步驟 3:建立擴充功能關聯
若要建立擴充功能或設定 AWS 已編寫的擴充功能,您可以定義在使用特定 AWS AppConfig 資源時叫用擴充功能的動作點。例如,您可以選擇在針對特定應用程式啟動組態部署時,執行AWS AppConfig deployment events to Amazon SNS
擴充功能並接收 Amazon SNS 主題的通知。定義哪些動作點叫用特定 AWS AppConfig 資源的擴充功能稱為擴充功能關聯。擴充功能關聯是擴充功能與 AWS AppConfig 資源 (例如應用程式或組態設定檔) 之間的指定關係。
單一 AWS AppConfig 應用程式可以包含多個環境和組態設定檔。如果您將擴充功能與應用程式或環境產生關聯,則會針對與應用程式或環境資源相關的任何工作流程 (如果適用) AWS AppConfig 叫用擴充程式。
例如,假設您有一個名為的 AWS AppConfig 應用程式 MobileApps ,其中包含名為的設定描述檔 AccessList。並假設該 MobileApps 應用程序包括 Beta,集成和生產環境。您可以為 AWS 編寫的 Amazon SNS 通知擴充功能建立擴充功能關聯,並將擴充功能與 MobileApps 應用程式相關聯。只要將應用程式的組態部署到三個環境中的任何一個,就會叫用 Amazon SNS 通知延伸模組。
注意
您不需要建立擴充功能即可使用已 AWS 編寫的擴充功能,但您必須建立擴充功能關聯。
步驟 4:部署設定並確認已執行擴充動作
建立關聯之後,建立託管組態或部署組態時,會 AWS AppConfig 叫用擴充功能並執行指定的動作。呼叫擴充功能時,如果系統在PRE-*
動作點期間遇到錯誤,則會 AWS AppConfig 傳回該錯誤的相關資訊。