> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/configuracoes/integracao-com-o-jira/visao-geral-da-integracao-com-o-jira.md).
# Visão geral da integração com o Jira
{% hint style="warning" %}
#### Escrito para a interface antiga
Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo.
{% endhint %}
##  Visão geral
O DevOps se integra à conta Jira da sua equipe para atualizar automaticamente os status das histórias quando você implanta uma branch em uma organização. Isso mantém os status do fluxo de trabalho do Jira alinhados com o seu processo de lançamento. Com a integração, você pode controlar quais implantações em organizações mapeiam para quais status do Jira e quais histórias se relacionam com quais branches.
### Como funciona a Integração Jira do DevOps?
Para começar com a Integração Jira, conecte sua conta Jira ao DevOps. Depois de conectado, adicione seus projetos Jira à integração. Em seguida, configure **Mapeamentos de status** para definir para qual status do Jira uma história é atualizada quando você implanta uma branch em uma organização específica. Por exemplo, mapeie sua organização Development para **Em andamento**, sua organização Testing para **Em revisão**, e sua organização Production para **Concluído**. Para instruções sobre como concluir estas etapas, consulte os artigos a seguir.
* [Adicionando uma integração com o Jira](/devops/devops-pt-br/configuracoes/integracao-com-o-jira/adicionando-uma-integracao-com-o-jira.md)
* [Adicionando projetos a uma integração com o Jira](/devops/devops-pt-br/configuracoes/integracao-com-o-jira/adicionando-projetos-a-uma-integracao-com-o-jira.md)
* [Configurando um projeto do Jira](/devops/devops-pt-br/configuracoes/integracao-com-o-jira/configurando-um-projeto-do-jira.md)
Para controlar quais histórias são atualizadas durante a implantação, adicione-as à lista de **Histórias Relacionadas** da branch. Quando você implanta essa branch, o DevOps atualiza automaticamente todas as histórias Jira relacionadas com base no **Mapeamento de Status** para essa organização, garantindo que os status das histórias reflitam com precisão o progresso da entrega sem atualizações manuais. Para instruções sobre como adicionar histórias a uma branch, consulte o artigo a seguir.
* [Adicionando histórias do Jira a uma branch](/devops/devops-pt-br/configuracoes/integracao-com-o-jira/adicionando-historias-do-jira-a-uma-branch.md)
{% hint style="info" %}
#### Melhores práticas
* Use nomes distintos para as integrações ao conectar várias instâncias do Jira.
* Crie mapeamentos de status separados para cada ambiente (Dev, QA, Prod) para corresponder ao seu fluxo de trabalho do Jira.
* Alinhe os status do fluxo de trabalho do Jira com o seu processo de lançamento. Por exemplo: Em andamento → Em revisão → Concluído.
* Salve sua configuração após cada alteração de mapeamento para garantir que as implantações acionem as atualizações corretas.
{% endhint %}
#### Exemplo de Integração Jira
O diagrama abaixo ilustra como a integração Jira funciona usando uma configuração e um fluxo de trabalho de exemplo. Veja a explicação das **Configuração** e **Fluxo de trabalho** seções abaixo.
* **Configuração**
* Mapeamento de Status
* **Dev** org mapeada para **Em andamento**
* **Test** org mapeada para **Em revisão**
* **Prod** org mapeada para **Concluído**
* Histórias Relacionadas à Branch
* **DO-1 Feature** e **DO-3 Bug2** as histórias estão relacionadas à **NewVersion** ramificação
* Projeto Jira
* Lista todas as histórias neste projeto Jira de exemplo.
* **Fluxo de trabalho**
* Mostra o que acontece quando a **NewVersion** branch for implantada na **Dev** org.
* Mostra o que acontece quando a **NewVersion** branch for implantada na **Test** org.
* Mostra o que acontece quando a **NewVersion** branch for implantada na **Prod** org.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/devops/devops-pt-br/configuracoes/integracao-com-o-jira/visao-geral-da-integracao-com-o-jira.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
