

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

# 使用適用於 的 Atlassian Jira 擴充功能 AWS AppConfig
<a name="working-with-appconfig-extensions-about-jira"></a>

透過與 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 整合的許可
<a name="working-with-appconfig-extensions-about-jira-permissions"></a>

當您設定與 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 許可政策
<a name="working-with-appconfig-extensions-about-jira-permissions-policy"></a>

使用下列程序建立允許 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 整合的使用者
<a name="working-with-appconfig-extensions-about-jira-permissions-user"></a>

使用下列程序來建立 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 整合應用程式
<a name="working-with-appconfig-extensions-about-jira-configure"></a>

使用下列程序在 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 應用程式的 和資料
<a name="working-with-appconfig-extensions-about-jira-delete"></a>

如果您不想再將 Jira 整合與 AWS AppConfig 功能旗標搭配使用，您可以在 Atlassian 主控台中刪除 AWS AppConfig 適用於 Jira 應用程式的 。刪除整合應用程式會執行下列動作：
+ 刪除 Jira 執行個體與 之間的關聯 AWS AppConfig
+ 從 刪除您的 Jira 執行個體詳細資訊 AWS AppConfig

**刪除 AWS AppConfig for Jira 應用程式**

1. 在 Atlassian 主控台中，選擇**管理應用程式**。

1. 選擇**AWS AppConfig 適用於 Jira** 的 。

1. 選擇**解除安裝**。