建立自訂 AWS AppConfig 擴充功能 - AWS AppConfig

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

建立自訂 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主題。

若要建立擴充功能 (主控台)
  1. https://console.aws.amazon.com/systems-manager/應用程序配置/打開 AWS Systems Manager 控制台。

  2. 在導覽窗格中,選擇 AWS AppConfig

  3. 在 [擴充功能] 索引標籤上選擇 [建立擴

  4. 擴充功能名稱中,輸入唯一的名稱。對於本穿越的目的,請輸入MyS3ConfigurationBackUpExtension。您可以選擇性地輸入說明。

  5. 在「動」區段中,選擇「新增動作」。

  6. 在「動作名稱」 中,輸入唯一的名稱。對於本穿越的目的,請輸入PreCreateHostedConfigVersionActionForS3Backup。此名稱描述動作和延伸用途所使用的動作點。

  7. 在「動作點」清單中,選擇「PRECREATE_ _ HOSTED _ CONFIGURATION _」VERSION。

  8. 對於 Uri,請選擇 Lambda 函數,然後在 Lambda 函數清單中選擇函數。如果您沒有看到您的函數,請確認您與建立函數的 AWS 區域 位置相同。

  9. 對於「IAM角色」,請選擇您先前在本逐步解說中建立的角色。

  10. 在「擴充功能參數 (選用)」區段中,選擇「新增參數」。

  11. 在「參數名稱」 中,輸入名稱。對於本穿越的目的,請輸入S3_BUCKET

  12. 重複步驟 5-11,為動作點建立第二個PRE_START_DEPLOYMENT動作。

  13. 選擇建立擴充功能