---
title: Releases
slug: ubLz-releases
docTags: 
createdAt: 2026-08-15T03:12:26.269Z
---

:::BlockQuote
Crie versões planejadas, associe features e acompanhe resultado, escopo e entrega no detalhe da release.
:::

:::hint{type="info"}
**Pré-requisito:**

Cadastre ao menos um Produto de software. O produto é o primeiro campo obrigatório do formulário e a versão deve ser única dentro dele.
:::

***

Releases são unidades versionadas de entrega do produto. A lista resume situação, versão, data planejada ou realizada e desvio; os indicadores mostram entregas do trimestre, itens em andamento, atrasos e releases sem produto. Uma release sem produto pode existir apenas como legado e fica na fila de backfill até ser classificada.

Ao abrir uma release, o cabeçalho mostra versão, situação, produto/programa, data planejada, entrega realizada, desvio e quantidade de features. As abas Visão geral, Features, Fases e tarefas e DevOps separam o planejamento, o conteúdo da entrega, o escopo operacional e as execuções de pipeline.

***

### Passo a passo

::::WorkflowBlock
:::WorkflowBlockItem
**Abrir a lista de releases**

Na barra lateral do Workspace, clique em Releases. Confira os indicadores e a mensagem de apoio: o desvio compara a data real de entrega com a data planejada, e uma release sem produto não entra nos indicadores por produto. Use a busca por nome, código, versão ou produto e os filtros de situação e produto para encontrar a entrega desejada.
:::

:::WorkflowBlockItem
**Iniciar uma release**

Clique em Nova release. O formulário começa pelo campo Produto de software, que é obrigatório. Se nenhum produto estiver selecionado, o botão Criar release permanece desabilitado. Selecione o produto que receberá a versão; trocar o produto durante uma edição move a release inteira, não apenas suas features.
:::

:::WorkflowBlockItem
**Informar título e versão**

Preencha Título da release com o nome da entrega e informe a Versão, por exemplo 2026.4.1. A versão é única dentro do produto: o Agility verifica o par produto/versão enquanto você digita e novamente na submissão. Se houver conflito, o campo recebe a mensagem com o produto e a versão ocupados e o salvamento fica bloqueado.
:::

:::WorkflowBlockItem
**Planejar a entrega**

Em Data planejada, selecione a data prevista. Em Tipo, escolha Funcionalidade para uma entrega de capacidade ou Correção para uma versão voltada à correção. Na criação, Situação é exibida como Planejada; a data real não é solicitada aqui, pois só existe quando a situação passa para Entregue.
:::

:::WorkflowBlockItem
**Registrar o resultado esperado**

Use Resultado esperado para descrever o efeito que a entrega deve produzir, como o cidadão receber avisos de andamento sem abrir o portal. Esse texto aparece na Visão geral junto do estado esperado. Revise Produto, Título, Versão, data, tipo e resultado e clique em Criar release.
:::

:::WorkflowBlockItem
**Abrir o detalhe**

Após salvar, clique no nome da release na tabela. O cabeçalho oferece Mudar situação e Editar, além dos cartões de data planejada, entrega realizada, desvio e Features na release. As abas são rotas próprias: podem ser compartilhadas e preservam a release que está sendo analisada.
:::

:::WorkflowBlockItem
**Conferir a Visão geral**

Na aba Visão geral, leia o painel Resultado e benefício. O resultado esperado é o texto informado na criação. O resultado realizado e o benefício realizado permanecem pendentes até a transição para Entregue; o selo informa se cada item está informado ou pendente.
:::

:::WorkflowBlockItem
**Vincular uma feature existente**

Abra a aba Features e clique em Vincular feature. O diálogo identifica a release pelo código, título e versão e carrega as features do Workspace que ainda não possuem release. Escolha uma opção no campo Feature; o resumo mostra código, situação, se é habilitador e que ela ainda está sem release. Clique em Vincular feature e aguarde a tabela ser recarregada.
:::

:::WorkflowBlockItem
**Criar feature diretamente na release**

Se nenhuma feature sem release estiver disponível, clique em Nova feature. O formulário de item SAFe abre com a release atual já selecionada; informe os campos da feature, selecione épico quando aplicável e salve. A nova feature passa a aparecer na tabela da aba Features sem precisar de um segundo vínculo.
:::

:::WorkflowBlockItem
**Ler as features vinculadas**

A tabela de Features mostra título e código, situação, épico, WSJF, histórias e o marcador Enabler. O rodapé resume total de features, quantidade de habilitadores e WSJF somado. Uma feature de produto diferente da release é identificada na linha, o que permite revisar o vínculo antes de entregar.
:::

:::WorkflowBlockItem
**Alterar a situação e concluir a entrega**

Clique em Mudar situação no cabeçalho. Escolha a nova situação entre as transições permitidas. Para Entregue, informe Data de entrega, Resultado realizado e Benefício realizado; o diálogo calcula o desvio a partir das datas e registra os valores na Visão geral. A entrega só fica disponível quando existe execução de pipeline com sucesso em Produção.
:::

:::WorkflowBlockItem
**Entender o backfill**

Se o indicador Sem produto vinculado for maior que zero, abra Pendências de vínculo no indicador ou no atalho da lista. A tela existe para classificar releases legadas cujo product\_id era nulo: a sugestão automática aparece quando todas as features apontam para o mesmo produto, enquanto casos com produtos concorrentes exigem Decisão manual. Use Confirmar para uma sugestão, Escolher para selecionar o produto, ou inspecione o detalhe pelo chevron antes de decidir.
:::

:::WorkflowBlockItem
**Aplicar sugestões em lote**

Quando houver sugestões automáticas, o botão Aplicar sugestões abre uma confirmação em lote. Revise a quantidade antes de confirmar; nada é gravado apenas por aparecer como sugestão. A fila registra Resolvidas hoje e, quando pendências chega a zero, informa que todas as releases têm produto e que o vínculo pode se tornar obrigatório no cadastro.
:::
::::

:::hint{type="success"}
:FontAwesome[]{icon="fa-solid fa-check"} **Verificação**

- A release aparece na lista com o produto correto, versão, situação Planejada e data planejada.
- O cabeçalho do detalhe mostra os cartões de planejamento, entrega, desvio e total de features.
- Uma feature vinculada aparece na aba Features com situação, épico, WSJF, histórias e Enabler.
- Após concluir a entrega, resultado e benefício realizados deixam de ser pendentes e a data real alimenta o desvio.
- A fila de backfill mostra a release como resolvida após confirmar uma sugestão ou escolher um produto.
:::

:::hint{type="warning"}
:FontAwesome[]{icon="fa-solid fa-triangle-exclamation"} **Erros comuns**

**Versão já existente no produto**

O campo Versão informa que o par já existe e desabilita o botão principal. Escolha outra versão ou selecione outro produto; a checagem é refeita nas duas mudanças.

**Feature não aparece no diálogo de vínculo**

Vincular feature lista somente features já cadastradas sem release. Se a lista estiver vazia, use Nova feature para criar uma com a release atual ou verifique se a feature já está vinculada a outra entrega.

**Entregue indisponível**

A transição para Entregue é bloqueada quando não há execução de pipeline com sucesso em Produção. Registre ou execute o deploy na aba DevOps, aguarde o sucesso e volte a Mudar situação.

**Release sem produto na fila**

Releases legadas podem aparecer com Sem produto vinculado. Abra o detalhe para revisar features e escopo; depois use Confirmar ou Escolher na fila de backfill. O chevron apenas inspeciona, não grava o vínculo.
:::

