

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将 Atlassian Jira 扩展程序用于 AWS AppConfig
<a name="working-with-appconfig-extensions-about-jira"></a>

通过与 Atlassian Jira 集成，每当你对指定的[功能标记](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 账户 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 集成时，需要为用户指定凭据。具体而言，您需要在 **Jira 应用程序的AWS AppConfig 中**输入用户的访问密钥 ID 和私有密钥。此用户授予 Jira 与 AWS AppConfig之通信的权限。 AWS AppConfig 曾经使用这些凭证在 AWS AppConfig 和 Jira 之间建立关联。不存储凭据。您可以通过卸载 for Jira 应用程序来移除关联。 AWS AppConfig 

用户帐户需要包含以下操作的权限策略：
+ `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. 在导航窗格中，选择 **策略**，然后选择 **创建策略**。

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>

使用以下步骤为 Atlassian J AWS AppConfig ira 集成创建用户。创建用户后，您可以复制访问密钥 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. 选择**创建用户**。系统显示用户的访问密钥 ID 和密钥。下载 .csv 文件或将这些凭据复制到单独的位置。您将在配置集成时指定这些凭据。

## 配置 AWS AppConfig Jira 集成应用程序
<a name="working-with-appconfig-extensions-about-jira-configure"></a>

使用以下步骤在 for Jira 应用程序中 AWS AppConfig 配置所需的选项。完成此过程后，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 控制台中，选择**管理应用**，然后**为 Jira 选择AWS AppConfig **。

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 区域。

## 删除 Jira 应用程序和数据 AWS AppConfig
<a name="working-with-appconfig-extensions-about-jira-delete"></a>

如果您不想再使用带有 AWS AppConfig 功能标志的 Jira 集成，可以在 Atlassian AWS AppConfig 控制台中删除 Jira 应用程序。删除集成应用程序将执行以下操作：
+ 删除您的 Jira 实例与之间的关联 AWS AppConfig
+ 从中删除你的 Jira 实例详细信息 AWS AppConfig

**删除 f AWS AppConfig or Jira 应用程序**

1. 在 Atlassian 控制台中，选择**管理**应用程序。

1. **为 Jira 选择AWS AppConfig **。

1. 选择**卸载**。