本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
建立自訂 AWS AppConfig 擴充功能
擴充功能會定義它在工作流程期間執行的一或多個動 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_*
動作點期間遇到錯誤,服務會忽略錯誤並繼續工作流程。
下列範例擴充功能會定義呼叫動PRE_CREATE_HOSTED_CONFIGURATION_VERSION
作點的動作。在Uri
欄位中,動作會指定本逐步解說稍早建立之 MyS3ConfigurationBackUpExtension
Lambda 函數的 Amazon 資源名稱 (ARN)。此動作也會指定 AWS Identity and Access Management (IAM) 假設在本逐步解說稍早ARN建立的角色。
範例 AWS AppConfig 擴充
{ "Name": "MySampleExtension", "Description": "A sample extension that backs up configurations to an S3 bucket.", "Actions": { "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [ { "Name": "PreCreateHostedConfigVersionActionForS3Backup", "Uri": "arn:aws:lambda:
aws-region
:111122223333:function:MyS3ConfigurationBackUpExtension", "RoleArn": "arn:aws:iam::111122223333:role/ExtensionsTestRole" } ] }, "Parameters" : { "S3_BUCKET": { "Required": false } } }
注意
若要在建立擴充功能時檢視要求語法和欄位說明,請參閱AWS AppConfig API參考資料中的CreateExtension主題。
若要建立擴充功能 (主控台)
在https://console.aws.amazon.com/systems-manager/應用程序配置/
打開 AWS Systems Manager 控制台。 -
在導覽窗格中,選擇 AWS AppConfig。
-
在 [擴充功能] 索引標籤上選擇 [建立擴充
-
在擴充功能名稱中,輸入唯一的名稱。對於本穿越的目的,請輸入
MyS3ConfigurationBackUpExtension
。您可以選擇性地輸入說明。 -
在「動作」區段中,選擇「新增動作」。
-
在「動作名稱」 中,輸入唯一的名稱。對於本穿越的目的,請輸入
PreCreateHostedConfigVersionActionForS3Backup
。此名稱描述動作和延伸用途所使用的動作點。 -
在「動作點」清單中,選擇「PRECREATE_ _ HOSTED _ CONFIGURATION _」VERSION。
-
對於 Uri,請選擇 Lambda 函數,然後在 Lambda 函數清單中選擇函數。如果您沒有看到您的函數,請確認您與建立函數的 AWS 區域 位置相同。
-
對於「IAM角色」,請選擇您先前在本逐步解說中建立的角色。
-
在「擴充功能參數 (選用)」區段中,選擇「新增參數」。
-
在「參數名稱」 中,輸入名稱。對於本穿越的目的,請輸入
S3_BUCKET
。 -
重複步驟 5-11,為動作點建立第二個
PRE_START_DEPLOYMENT
動作。 -
選擇建立擴充功能。