本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 AWS 撰寫的延伸模組 AWS AppConfig 包含下列 AWS 撰寫的延伸。這些擴充功能可協助您將 AWS AppConfig 工作流程與其他 服務整合。您可以在 中使用這些擴充功能 AWS CLI AWS Tools for PowerShell， AWS 管理主控台 或直接從 或 SDK 呼叫擴充功能 [API 動作](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_Operations.html)。 **** | 延伸 | Description | | --- | --- | | [AWS AppConfig 部署事件到 EventBridge](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-eventbridge.html) | 部署組態時，此延伸項目會將事件傳送至 EventBridge 預設事件匯流排。 | | [AWS AppConfig 部署事件到 Amazon Simple Notification Service (Amazon SNS)](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-sns.html) | 此延伸模組會將訊息傳送至您在部署組態時指定的 Amazon SNS 主題。 | | [AWS AppConfig 部署事件到 Amazon Simple Queue Service (Amazon SQS)](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-sqs.html) | 部署組態時，此擴充功能會將訊息排入 Amazon SQS 佇列。 | | [整合擴充功能—Atlassian Jira](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-jira.html) | 此擴充功能 AWS AppConfig 可讓您在每次變更[功能旗標](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-feature-flags)時建立和更新問題。 | # 將 AWS AppConfig 部署事件用於 Amazon EventBridge 延伸模組 `AWS AppConfig deployment events to Amazon EventBridge` 延伸模組是 AWS 撰寫的延伸模組，可協助您監控 AWS AppConfig 組態部署工作流程並對其採取行動。延伸項目會在部署組態時，將事件通知傳送至 EventBridge 預設事件匯流排。將延伸項目關聯至其中一個 AWS AppConfig 應用程式、環境或組態設定檔後， 會在每次組態部署開始、結束和復原後，將事件通知 AWS AppConfig 傳送至事件匯流排。 如果您想要進一步控制哪些動作點傳送 EventBridge 通知，您可以建立自訂延伸，並為 URI 欄位輸入 EventBridge 預設事件匯流排 Amazon Resource Name (ARN)。如需建立擴充功能的資訊，請參閱 [逐步解說：建立自訂 AWS AppConfig 擴充功能](working-with-appconfig-extensions-creating-custom.md)。 **重要** 此延伸模組僅支援 EventBridge 預設事件匯流排。 ## 使用 延伸模組 若要使用`AWS AppConfig deployment events to Amazon EventBridge`延伸模組，請先建立延伸模組關聯，將延伸模組連接至您的其中一個 AWS AppConfig 資源。您可以使用 AWS AppConfig 主控台或 [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html) API 動作來建立關聯。建立關聯時，您可以指定 AWS AppConfig 應用程式、環境或組態描述檔的 ARN。如果您將延伸項目與應用程式或環境建立關聯，則會針對指定應用程式或環境中包含的任何組態設定檔傳送事件通知。 建立關聯之後，當部署指定 AWS AppConfig 資源的組態時， 會 AWS AppConfig 叫用延伸模組，並根據延伸模組中指定的動作點傳送通知。 **注意** 下列動作點會叫用此延伸項目： `ON_DEPLOYMENT_START` `ON_DEPLOYMENT_COMPLETE` `ON_DEPLOYMENT_ROLLED_BACK` 您無法自訂此延伸模組的動作點。若要叫用不同的動作點，您可以建立自己的延伸。如需詳細資訊，請參閱[逐步解說：建立自訂 AWS AppConfig 擴充功能](working-with-appconfig-extensions-creating-custom.md)。 使用下列程序，透過主控台 AWS Systems Manager 或 建立 AWS AppConfig 延伸關聯 AWS CLI。 **建立延伸關聯 （主控台）** 1. 在 https：//[https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/) 開啟 AWS Systems Manager 主控台。 1. 在導覽窗格中，選擇 **AWS AppConfig**。 1. 在**延伸項目**索引標籤上，選擇**新增至資源**。 1. 在**延伸資源詳細資訊**區段中，針對**資源類型**選擇 AWS AppConfig 資源類型。根據您選擇的資源， 會 AWS AppConfig 提示您選擇其他資源。 1. 選擇**建立與資源的關聯**。 以下是呼叫延伸模組時傳送至 EventBridge 的範例事件。 ``` { "version":"0", "id":"c53dbd72-c1a0-2302-9ed6-c076e9128277", "detail-type":"On Deployment Complete", "source":"aws.appconfig", "account":"111122223333", "time":"2022-07-09T01:44:15Z", "region":"us-east-1", "resources":[ "arn:aws:appconfig:us-east-1:111122223333:extensionassociation/z763ff5" ], "detail":{ "InvocationId":"5tfjcig", "Parameters":{ }, "Type":"OnDeploymentComplete", "Application":{ "Id":"ba8toh7", "Name":"MyApp" }, "Environment":{ "Id":"pgil2o7", "Name":"MyEnv" }, "ConfigurationProfile":{ "Id":"ga3tqep", "Name":"MyConfigProfile" }, "DeploymentNumber":1, "ConfigurationVersion":"1" } } ``` # 使用 AWS AppConfig 部署事件至 Amazon SNS 延伸模組 `AWS AppConfig deployment events to Amazon SNS` 延伸模組是 AWS 撰寫的延伸模組，可協助您監控 AWS AppConfig 組態部署工作流程並對其採取行動。延伸項目會在部署組態時，將訊息發佈至 Amazon SNS 主題。將延伸項目與其中一個 AWS AppConfig 應用程式、環境或組態描述檔建立關聯之後， 會在每次組態部署開始、結束和復原之後，將訊息 AWS AppConfig 發佈至主題。 如果您想要進一步控制哪些動作點傳送 Amazon SNS 通知，您可以建立自訂擴充功能，並為 URI 欄位輸入 Amazon SNS 主題 Amazon Resource Name (ARN)。如需建立擴充功能的資訊，請參閱 [逐步解說：建立自訂 AWS AppConfig 擴充功能](working-with-appconfig-extensions-creating-custom.md)。 ## 使用 延伸模組 本節說明如何使用 `AWS AppConfig deployment events to Amazon SNS`延伸模組。 **步驟 1：設定 AWS AppConfig 將訊息發佈至主題** 將存取控制政策新增至授予 (`appconfig.amazonaws.com`) 發佈許可的 Amazon SNS 主題 AWS AppConfig ()`sns:Publish`。如需詳細資訊，請參閱 [Amazon SNS 存取控制的範例案例](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html)。 **步驟 2：建立延伸模組關聯** 建立延伸模組關聯，將延伸模組連接至您的其中一個 AWS AppConfig 資源。您可以使用 AWS AppConfig 主控台或 [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html) API 動作來建立關聯。建立關聯時，您可以指定 AWS AppConfig 應用程式、環境或組態描述檔的 ARN。如果您將延伸項目與應用程式或環境建立關聯，則會針對指定應用程式或環境中包含的任何組態設定檔傳送通知。建立關聯時，您必須輸入 參數的值`topicArn`，其中包含您要使用的 Amazon SNS 主題的 ARN。 建立關聯之後，當指定 AWS AppConfig 資源的組態部署時， 會 AWS AppConfig 叫用延伸模組，並根據延伸模組中指定的動作點傳送通知。 **注意** 下列動作點會叫用此擴充功能： `ON_DEPLOYMENT_START` `ON_DEPLOYMENT_COMPLETE` `ON_DEPLOYMENT_ROLLED_BACK` 您無法自訂此延伸模組的動作點。若要叫用不同的動作點，您可以建立自己的擴充功能。如需詳細資訊，請參閱[逐步解說：建立自訂 AWS AppConfig 擴充功能](working-with-appconfig-extensions-creating-custom.md)。 使用以下程序，使用 AWS Systems Manager 主控台或 建立 AWS AppConfig 延伸關聯 AWS CLI。 **建立延伸關聯 （主控台）** 1. 在 https：//[https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/) 開啟 AWS Systems Manager 主控台。 1. 在導覽窗格中，選擇 **AWS AppConfig**。 1. 在**延伸項目**索引標籤上，選擇**新增至資源**。 1. 在**延伸資源詳細資訊**區段中，針對**資源類型**選擇 AWS AppConfig 資源類型。根據您選擇的資源， 會 AWS AppConfig 提示您選擇其他資源。 1. 選擇**建立與資源的關聯**。 以下是呼叫延伸模組時傳送至 Amazon SNS 主題的訊息範例。 ``` { "Type": "Notification", "MessageId": "ae9d702f-9a66-51b3-8586-2b17932a9f28", "TopicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic", "Message": { "InvocationId": "7itcaxp", "Parameters": { "topicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic" }, "Application": { "Id": "1a2b3c4d", "Name": MyApp }, "Environment": { "Id": "1a2b3c4d", "Name": MyEnv }, "ConfigurationProfile": { "Id": "1a2b3c4d", "Name": "MyConfigProfile" }, "Description": null, "DeploymentNumber": "3", "ConfigurationVersion": "1", "Type": "OnDeploymentComplete" }, "Timestamp": "2022-06-30T20:26:52.067Z", "SignatureVersion": "1", "Signature": "<...>", "SigningCertURL": "<...>", "UnsubscribeURL": "<...>", "MessageAttributes": { "MessageType": { "Type": "String", "Value": "OnDeploymentStart" } } } ``` # 將 AWS AppConfig 部署事件用於 Amazon SQS 延伸模組 `AWS AppConfig deployment events to Amazon SQS` 延伸模組是 AWS 撰寫的延伸模組，可協助您監控 AWS AppConfig 組態部署工作流程並對其採取行動。每次部署組態時，延伸模組都會將訊息排入 Amazon Simple Queue Service (Amazon SQS) 佇列。將延伸項目與其中一個 AWS AppConfig 應用程式、環境或組態設定檔建立關聯後， 會在每次組態部署開始、結束和轉返之後，將訊息 AWS AppConfig 排入佇列中。 如果您想要進一步控制哪些動作點傳送 Amazon SQS 通知，您可以建立自訂擴充功能，並為 URI 欄位輸入 Amazon SQS 佇列 Amazon Resource Name (ARN)。如需建立擴充功能的資訊，請參閱 [逐步解說：建立自訂 AWS AppConfig 擴充功能](working-with-appconfig-extensions-creating-custom.md)。 ## 使用 延伸模組 本節說明如何使用 `AWS AppConfig deployment events to Amazon SQS`延伸模組。 **步驟 1：設定 AWS AppConfig 將訊息排入佇列** 將 Amazon SQS 政策新增至授予 (`appconfig.amazonaws.com`) 傳送訊息許可的 Amazon SQS 佇列 AWS AppConfig ()`sqs:SendMessage`。如需詳細資訊，請參閱 [Amazon SQS 政策的基本範例](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-basic-examples-of-sqs-policies.html)。 **步驟 2：建立延伸模組關聯** 建立延伸模組關聯，將延伸模組連接至您的其中一個 AWS AppConfig 資源。您可以使用 AWS AppConfig 主控台或 [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html) API 動作來建立關聯。建立關聯時，您可以指定 AWS AppConfig 應用程式、環境或組態描述檔的 ARN。如果您將延伸項目與應用程式或環境建立關聯，則會針對指定應用程式或環境中包含的任何組態設定檔傳送通知。建立關聯時，您必須輸入`Here`參數，其中包含您要使用的 Amazon SQS 佇列 ARN。 建立關聯之後，當建立或部署指定 AWS AppConfig 資源的組態時， 會 AWS AppConfig 叫用延伸模組，並根據延伸模組中指定的動作點傳送通知。 **注意** 下列動作點會叫用此擴充功能： `ON_DEPLOYMENT_START` `ON_DEPLOYMENT_COMPLETE` `ON_DEPLOYMENT_ROLLED_BACK` 您無法自訂此延伸模組的動作點。若要叫用不同的動作點，您可以建立自己的擴充功能。如需詳細資訊，請參閱[逐步解說：建立自訂 AWS AppConfig 擴充功能](working-with-appconfig-extensions-creating-custom.md)。 使用以下程序，使用 AWS Systems Manager 主控台或 建立 AWS AppConfig 延伸關聯 AWS CLI。 **建立延伸關聯 （主控台）** 1. 在 https：//[https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/) 開啟 AWS Systems Manager 主控台。 1. 在導覽窗格中，選擇 **AWS AppConfig**。 1. 在**延伸項目**索引標籤上，選擇**新增至資源**。 1. 在**延伸資源詳細資訊**區段中，針對**資源類型**選擇 AWS AppConfig 資源類型。根據您選擇的資源， 會 AWS AppConfig 提示您選擇其他資源。 1. 選擇**建立與資源的關聯**。 以下是呼叫延伸模組時傳送至 Amazon SQS 佇列的訊息範例。 ``` { "InvocationId":"7itcaxp", "Parameters":{ "queueArn":"arn:aws:sqs:us-east-1:111122223333:MySQSQueue" }, "Application":{ "Id":"1a2b3c4d", "Name":MyApp }, "Environment":{ "Id":"1a2b3c4d", "Name":MyEnv }, "ConfigurationProfile":{ "Id":"1a2b3c4d", "Name":"MyConfigProfile" }, "Description":null, "DeploymentNumber":"3", "ConfigurationVersion":"1", "Type":"OnDeploymentComplete" } ``` # 使用適用於 的 Atlassian Jira 擴充功能 AWS AppConfig 透過與 Atlassian Jira 整合，每當您 AWS 帳戶 為指定的 變更 中的[功能旗標](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-feature-flags)時， AWS AppConfig 都可以在 Atlassian 主控台中建立和更新問題 AWS 區域。每個 Jira 問題都包含旗標名稱、應用程式 ID、組態設定檔 ID 和旗標值。在您更新、儲存和部署旗標變更之後，Jira 會使用變更的詳細資訊來更新現有的問題。 **注意** Jira 會在您建立或更新功能旗標時更新問題。當您從父層級旗標刪除子層級旗標屬性時，Jira 也會更新問題。當您刪除父層級旗標時，Jira 不會記錄資訊。 若要設定整合，您必須執行下列動作： + [設定 AWS AppConfig Jira 整合的許可](#working-with-appconfig-extensions-about-jira-permissions) + [設定 AWS AppConfig Jira 整合應用程式](#working-with-appconfig-extensions-about-jira-configure) ## 設定 AWS AppConfig Jira 整合的許可 當您設定與 Jira 的 AWS AppConfig 整合時，您可以指定使用者的登入資料。具體而言，您會在 **AWS AppConfig Jira** 應用程式的 中輸入使用者的存取金鑰 ID 和私密金鑰。此使用者提供 Jira 與 通訊的許可 AWS AppConfig。 AWS AppConfig 會使用這些登入資料一次，在 和 Jira 之間 AWS AppConfig 建立關聯。登入資料不會儲存。您可以解除安裝 AWS AppConfig for Jira 應用程式來移除關聯。 使用者帳戶需要包含下列動作的許可政策： + `appconfig:CreateExtensionAssociation` + `appconfig:GetConfigurationProfile` + `appconfig:ListApplications` + `appconfig:ListConfigurationProfiles` + `appconfig:ListExtensionAssociations` + `sts:GetCallerIdentity` 完成下列任務，以建立 IAM 許可政策和 AWS AppConfig 和 Jira 整合的使用者： **工作** + [任務 1：為 AWS AppConfig 和 Jira 整合建立 IAM 許可政策](#working-with-appconfig-extensions-about-jira-permissions-policy) + [任務 2：建立 AWS AppConfig 和 Jira 整合的使用者](#working-with-appconfig-extensions-about-jira-permissions-user) ### 任務 1：為 AWS AppConfig 和 Jira 整合建立 IAM 許可政策 使用下列程序建立允許 Atlassian Jira 與 通訊的 IAM 許可政策 AWS AppConfig。我們建議您建立新的政策，並將此政策連接至新的 IAM 角色。將必要的許可新增至現有的 IAM 政策和角色違反最低權限原則，不建議這麼做。 **為 AWS AppConfig 和 Jira 整合建立 IAM 政策** 1. 在 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 中開啟 IAM 主控台。 1. 在導覽窗格中，選擇 **Policies (政策)**，然後選擇 **Create policy (建立政策)**。 1. 在**建立政策**頁面上，選擇 **JSON** 索引標籤，並以下列政策取代預設內容。在下列政策中，將 *Region*、*account\$1ID*、*application\$1ID* 和 *configuration\$1profile\$1ID* 取代為來自您的 AWS AppConfig 特徵標記環境的資訊。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "appconfig:CreateExtensionAssociation", "appconfig:ListExtensionAssociations", "appconfig:GetConfigurationProfile" ], "Resource": [ "arn:aws:appconfig:us-east-1:111122223333:application/application_ID", "arn:aws:appconfig:us-east-1:111122223333:application/application_ID/configurationprofile/configuration_profile_ID" ] }, { "Effect": "Allow", "Action": [ "appconfig:ListApplications" ], "Resource": [ "arn:aws:appconfig:us-east-1:111122223333:*" ] }, { "Effect": "Allow", "Action": [ "appconfig:ListConfigurationProfiles" ], "Resource": [ "arn:aws:appconfig:us-east-1:111122223333:application/application_ID" ] }, { "Effect": "Allow", "Action": "sts:GetCallerIdentity", "Resource": "*" } ] } ``` ------ 1. 選擇下**一步：標籤**。 1. (選用) 新增一個或多個標籤鍵值組來組織、追蹤或控制存取此政策，然後選擇 **Next: Review** (下一步：檢閱)。 1. 在 **Review policy** (檢閱政策) 頁面，在 **Name** (名稱) 方塊中輸入名稱 (如 **AppConfigJiraPolicy**)，接著輸入選用描述。 1. 選擇**建立政策**。 ### 任務 2：建立 AWS AppConfig 和 Jira 整合的使用者 使用下列程序來建立 AWS AppConfig 和 Atlassian Jira 整合的使用者。建立使用者之後，您可以複製存取金鑰 ID 和私密金鑰，您將在完成整合時指定此金鑰。 **建立 AWS AppConfig 和 Jira 整合的使用者** 1. 前往 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 1. 在導覽窗格中，選擇 **Users** (使用者)，然後選擇 **Add users** (新增使用者)。 1. 在**使用者名稱**欄位中，輸入名稱，例如 **AppConfigJiraUser**。 1. 針對**選取 AWS 憑證類型**，選擇**存取金鑰 - 程式設計存取**。 1. 選擇**下一步：許可**。 1. 在**設定許可**頁面下，選擇**直接連接現有政策**。搜尋並選取您在 中建立之政策的核取方塊[任務 1：為 AWS AppConfig 和 Jira 整合建立 IAM 許可政策](#working-with-appconfig-extensions-about-jira-permissions-policy)，然後選擇**下一步：標籤**。 1. 在**新增標籤 （選用）** 頁面上，新增一或多個標籤鍵值對，以組織、追蹤或控制此使用者的存取。選擇下**一步：檢閱**。 1. 在**檢閱**頁面上，驗證使用者詳細資訊。 1. 選擇 **Create user** (建立使用者)。系統會顯示使用者的存取金鑰 ID 和私密金鑰。您可以下載 .csv 檔案，或將這些登入資料複製到不同的位置。您將在設定整合時指定這些登入資料。 ## 設定 AWS AppConfig Jira 整合應用程式 使用下列程序在 AWS AppConfig for Jira 應用程式中設定必要的選項。完成此程序後，Jira 會為 AWS 帳戶 指定 的 中的每個功能旗標建立新的問題 AWS 區域。如果您在 中變更功能旗標 AWS AppConfig，Jira 會在現有問題中記錄詳細資訊。 **注意** AWS AppConfig 功能旗標可以包含多個子層級旗標屬性。Jira 為每個父層級功能旗標建立一個問題。如果您變更子層級旗標屬性，您可以在父層級旗標的 Jira 問題中檢視該變更的詳細資訊。 **設定整合** 1. 登入 [Atlassian Marketplace](https://marketplace.atlassian.com/)。 1. **AWS AppConfig** 在搜尋欄位中輸入 ，然後按 **Enter** 鍵。 1. 在 Jira 執行個體上安裝應用程式。 1. 在 Atlassian 主控台中，選擇**管理應用程式**，然後選擇 **AWS AppConfig Jira 的** 。 1. 選擇**設定**。 1. 在**組態詳細資訊**下，選擇 **Jira 專案**，然後選擇您要與 AWS AppConfig 功能旗標建立關聯的專案。 1. 選擇 **AWS 區域**，然後選擇 AWS AppConfig 功能旗標所在的區域。 1. 在**應用程式 ID** 欄位中，輸入包含您的功能旗標的應用程式名稱 AWS AppConfig 。 1. 在**組態設定檔 ID** 欄位中，輸入功能旗標的 AWS AppConfig 組態設定檔名稱。 1. 在**存取金鑰 ID** 和**私密金鑰**欄位中，輸入您在 中複製的登入資料[任務 2：建立 AWS AppConfig 和 Jira 整合的使用者](#working-with-appconfig-extensions-about-jira-permissions-user)。您也可以選擇性地指定工作階段字符。 1. 選擇**提交**。 1. 在 Atlassian 主控台中，選擇**專案**，然後選擇您為 AWS AppConfig 整合選取的專案。**問題**頁面會顯示指定 AWS 帳戶 和 中每個特徵標記的問題 AWS 區域。 ## 刪除 AWS AppConfig 適用於 Jira 應用程式的 和資料 如果您不想再將 Jira 整合與 AWS AppConfig 功能旗標搭配使用，您可以在 Atlassian 主控台中刪除 AWS AppConfig 適用於 Jira 應用程式的 。刪除整合應用程式會執行下列動作： + 刪除 Jira 執行個體與 之間的關聯 AWS AppConfig + 從 刪除您的 Jira 執行個體詳細資訊 AWS AppConfig **刪除 AWS AppConfig for Jira 應用程式** 1. 在 Atlassian 主控台中，選擇**管理應用程式**。 1. 選擇**AWS AppConfig 適用於 Jira** 的 。 1. 選擇**解除安裝**。