# Conector da AWS Well-Architected Tool para Jira
<a name="jira"></a>

 Você pode usar o Conector da AWS Well-Architected Tool para Jira se quiser vincular sua conta do Jira ao AWS Well-Architected Tool e sincronizar itens de melhoria das workloads com projetos do Jira para ajudar a criar um mecanismo de circuito fechado na implementação de aprimoramentos. 

 O conector oferece sincronização automática e manual. Para ter mais detalhes, consulte [Configuring the connector](configuring-jira.md). 

 O conector pode ser configurado no nível da conta e no nível da workload, com a opção de substituir suas configurações no nível da conta por workload. No nível da workload, você também pode optar por excluir totalmente uma workload da sincronização. 

 Você pode optar por sincronizar os itens de melhoria com o projeto WA padrão do Jira ou especificar uma chave de projeto existente para sincronizar. No nível da workload, você pode sincronizar cada uma com um projeto exclusivo do Jira, se necessário. 

**nota**  
 O conector só é compatível com projetos scrum e kanban no Jira. 

 Quando os itens de melhoria são sincronizados com o Jira, eles são organizados da seguinte forma: 
+  **Projeto:** WA (ou projeto existente que você especificar) 
+  **Epic:** workload 
+  **Tarefa:** pergunta 
+  **Subtarefa:** práticas recomendadas 
+  **Rótulo:** pilar 

 Depois de configurar a sincronização da conta do Jira na página **Configurações**, você pode [configurar o conector do Jira](configuring-jira.md) e [sincronizar itens de melhoria com sua conta do Jira](syncing-workload.md). 

# Configurar o conector
<a name="setting-up-jira"></a>

**Como instalar o conector**
**nota**  
 Todas as etapas a seguir são executadas na sua conta do Jira, não na sua Conta da AWS. 

1.  Faça login na sua conta do Jira. 

1.  Na barra de navegação superior, escolha **Apps** e selecione **Explore more apps**. 

1. Na página **Discover apps and integrations for Jira**, insira AWS Well-Architected. Em seguida, escolha **AWS Well-Architected Tool Conector for Jira**.

1. Na página do aplicativo, escolha **Get app**.

1.  No painel **Add to Jira**, escolha **Get it now**. 

1.  Após a instalação do aplicativo, para concluir a configuração, escolha **Configure**. 

1.  Na página **AWS Well-Architected Tool Configuration**, escolha **Connect a new Conta da AWS**. 

1.  Insira a sua **AccessKeyId** e a **chave secreta**. Opcional: insira seu **token de sessão**. Depois, escolha **Connect**. 
**nota**  
 Sua conta deve ter a permissão `wellarchitected:ConfigureIntegration`. Essas permissões são necessárias para adicionar as Contas da AWS ao Jira.   
 Várias Contas da AWS podem ser conectadas ao AWS WA Tool. 
**nota**  
 Como prática recomendada de segurança, é altamente recomendável usar credenciais de curto prazo do IAM. Para ter detalhes sobre como criar um **AccessKeyId** e uma **chave secreta** para sua Conta da AWS, consulte [Gerenciar chaves de acesso (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey) e, para ter detalhes sobre o uso de credenciais de curto prazo, consulte [Solicitar credenciais de segurança temporárias](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html). 

1.  Em **Regions**, selecione as Regiões da AWS que você deseja conectar. Depois, escolha **Connect**. 

 

 **Configuração do projeto do Jira** 

 Ao usar projetos personalizados, verifique se a configuração de seu projeto tem os seguintes tipos de problema: 
+  **Scrum:** épico, história, subtarefa 
+  **Kanban:** épico, tarefa, subtarefa 

 Para ter detalhes sobre como gerenciar tipos de problema, consulte [Atlassian Support \$1 Add, edit, and delete an issue type](https://support.atlassian.com/jira-cloud-administration/docs/add-edit-and-delete-an-issue-type/). 

 

**Como verificar o status do conector no AWS Well-Architected Tool**

1.  Faça login na sua Conta da AWS e navegue até o AWS Well-Architected Tool. 

1.  Selecione **Configurações** no painel de navegação à esquerda. 

1.  Na seção **Sincronização de contas no Jira**, em **Status da conexão do aplicativo Jira**, verifique o status **Configurado**. 

 O conector agora está instalado e pronto para ser configurado. Para definir as configurações de sincronização do Jira no nível da conta e da workload, consulte [Configuring the connector](configuring-jira.md). 

# Configurar o conector do
<a name="configuring-jira"></a>

 Com o Conector da AWS Well-Architected Tool para Jira, você pode configurar a sincronização do Jira no nível da conta e da workload ou em ambos. Você pode definir as configurações do Jira no nível da workload, independentemente das configurações no nível da conta, ou substituir as configurações no nível da conta em determinada workload para especificar o respectivo comportamento de sincronização. Você também pode definir as configurações do Jira ao [definir uma workload](define-workload.md). 

 O conector oferece dois métodos de sincronização: **automática** e **manual**. Em ambos os métodos de sincronização, as alterações feitas no AWS WA Tool são refletidas em seu projeto do Jira, e as alterações feitas no Jira são sincronizadas novamente com o AWS WA Tool. 

**Importante**  
 Ao usar a sincronização automática, você concorda que o AWS WA Tool modifique a workload em resposta a alterações no Jira.   
 Se você tiver informações confidenciais que não deseja sincronizar com o Jira, não as insira no campo **Observações** em suas workloads. 
+  **Sincronização automática:** o conector atualiza automaticamente seu projeto do Jira e sua workload sempre que uma pergunta é atualizada, além de selecionar ou desmarcar a seleção de uma prática recomendada e responder a uma pergunta. 
+  **Sincronização manual:** você deve escolher **Sincronizar com o Jira** no painel da workload quando quiser sincronizar itens de melhoria entre o Jira e o AWS WA Tool. Você também pode escolher quais perguntas e pilares específicos deseja sincronizar. Para ter mais detalhes, consulte [Sincronizar uma workload](syncing-workload.md). 

**Como configurar o conector no nível da conta**

1.  Selecione **Configurações** no painel de navegação à esquerda. 

1.  No painel **Sincronização de contas do Jira**, escolha **Editar**. 

1.  Em **Tipo de sincronização**, escolha uma das seguintes opções: 

   1.  Para sincronizar automaticamente as workloads quando as alterações forem feitas, selecione **Automático**. 

   1.  Para escolher manualmente quando sincronizar workloads, selecione **Manual**. 

1.  Por padrão, o conector cria um projeto **WA** do Jira. Para especificar sua própria chave do projeto do Jira, faça o seguinte: 

   1.  Selecione **Substituir chave do projeto no Jira padrão**. 

   1.  Insira sua **chave do projeto do Jira**. 
**nota**  
 A **chave do projeto do Jira** especificada é usada para todas as workloads, a menos que você altere o projeto no nível da workload. 

1.  Escolha **Salvar configurações**. 

**Como configurar o conector no nível da workload**

1.  Selecione **Cargas de trabalho** no painel de navegação à esquerda e escolha o nome da workload que você deseja configurar. 

1.  Escolha **Properties** (Propriedades). 

1.  No painel do **Jira**, escolha **Editar**. 

1.  Para definir as configurações do Jira da workload, selecione **Substituir as configurações no nível da conta**. 
**nota**  
 A opção **Substituir as configurações do nível da conta** deve estar selecionada para que as configurações específicas da workload sejam aplicadas. 

1.  Em **Substituição de sincronização**, selecione uma das seguintes opções: 

   1.  Para excluir a workload da sincronização do Jira, selecione **Não sincronizar workload**. 

   1.  Para escolher manualmente quando sincronizar a workload, selecione **Sincronizar workload (manual)**. 

   1.  Para sincronizar as alterações da workload automaticamente, selecione **Sincronizar workload (automático)**. 

1.  (Opcional) Em **Chave do projeto no Jira**, insira a chave do projeto com a qual sincronizar a workload. Essa chave do projeto pode ser diferente da chave do projeto no nível da conta. 

    Se você não especificar uma chave de projeto, o conector criará um projeto **WA** do Jira. 

1.  Escolha **Salvar**. 

 Para ter detalhes sobre como realizar uma sincronização manual, consulte [Sincronizar uma workload](syncing-workload.md). 

# Sincronizar uma workload
<a name="syncing-workload"></a>

 No caso da sincronização automática, o conector sincroniza automaticamente os itens de melhoria quando você atualiza uma workload (por exemplo, ao responder uma pergunta ou selecionar uma nova prática recomendada). 

 Tanto na sincronização manual quanto na automática, todas as alterações feitas no Jira (como responder a uma pergunta ou concluir uma prática recomendada) são sincronizadas novamente com o AWS Well-Architected Tool. 

**Como sincronizar manualmente uma workload**

1.  Quando estiver tudo pronto para sincronizar a workload com o Jira, selecione **Cargas de trabalho** no painel de navegação à esquerda. Em seguida, selecione a workload que deseja sincronizar. 

1.  Na visão geral da workload, escolha **Sincronizar com o Jira**. 

1.  Selecione a lente que deseja sincronizar. 

1.  Em **Perguntas para sincronizar com o Jira**, selecione as perguntas ou os pilares completos que você deseja sincronizar com o projeto do Jira. 

   1.  Com relação a qualquer pergunta que você queira remover, selecione o ícone **X** ao lado do título da pergunta. 

1.  Escolha **Sincronizar**. 

# Desinstalar o conector
<a name="uninstalling-jira"></a>

 Para desinstalar totalmente o Conector da AWS Well-Architected Tool para Jira, execute as seguintes tarefas: 
+  Desative a sincronização do Jira em qualquer workload que substitua as configurações de sincronização no nível da conta. 
+  Desative a sincronização do Jira no nível da conta. 
+  Desvincule sua Conta da AWS no Jira. 
+  Desinstale o conector da sua conta do Jira. 

**Como desativar o conector no nível da conta**
**nota**  
 As seguintes etapas executadas em sua Conta da AWS: 

1.  Selecione **Configurações** no painel de navegação à esquerda. 

1.  Na seção **Sincronização de contas no Jira**, escolha **Editar**. 

1.  Desmarque a opção **Ativar a sincronização de contas no Jira**. 

1.  Escolha **Salvar configurações**. 

**Como desvincular uma Conta da AWS**
**nota**  
 Todas as etapas a seguir são executadas na sua conta do Jira, não na sua Conta da AWS. 

1.  Faça login na sua conta do Jira. 

1.  Na barra de navegação superior, escolha **Apps** e selecione **Manage your apps**. 

1.  Escolha a seta suspensa ao lado de **AWS Well-Architected Tool Connector for Jira** e selecione **Configure**. 

1.  No painel de configuração do AWS Well-Architected Tool, para desvincular uma Conta da AWS, escolha **X** em **Actions**. 

**Como desinstalar o conector**
**nota**  
 Todas as etapas a seguir são executadas na sua conta do Jira, não na sua Conta da AWS.   
 Antes de desinstalá-lo, recomendamos verificar se todos as Contas da AWS conectadas estão desvinculadas na configuração do conector. 

1.  Faça login na sua conta do Jira. 

1.  Na barra de navegação superior, escolha **Apps** e selecione **Manage your apps**. 

1.  Escolha a seta suspensa ao lado de **AWS Well-Architected Tool Connector for Jira**. 

1.  Escolha **Uninstall** e selecione **Uninstall app**.