The Releases tab turns your git tags into a version history you can read: every tagged deployment, in order, with its commit, its author, its status and a link straight to the tag in your repository.

Lançamentos no Orbit

A aba Releases converte as suas etiquetas git num histórico de versões legível: cada implementação etiquetada, por ordem, com o seu commit, o seu autor, o seu estado e uma ligação direta à etiqueta no seu repositório.

Onde está a aba Releases

Abra Orbit, clique no projeto e escolha Releases no grupo Deployments na fita de abas do projeto. A página tem o título Releases e descreve-se como implementações baseadas em etiquetas: um lançamento é criado quando uma etiqueta git corresponde ao seu padrão de etiqueta.

A aba vizinha Deployments lista todas as construções, etiquetadas ou não. Releases é a vista filtrada: apenas as que marcou como uma versão.

Definir o Padrão de Etiqueta

Os lançamentos começam com um padrão. Abra Settings, encontre o cartão Git tag deploys e introduza um glob tal como v* ou release-*. Se deixar vazio, desativa completamente as implementações por etiqueta, razão pela qual o espaço reservado do campo diz v* (disabled).

Com um padrão definido, fazer push de uma etiqueta correspondente implementa em produção e regista o resultado como um lançamento. Sem um, a aba Releases mostra um estado vazio pedindo-lhe para fazer push de uma etiqueta e definir um padrão em Settings.

Um padrão de etiqueta dá-lhe um segundo caminho explícito para produção, além de pushes para o ramo de produção. As equipas que querem que as implementações sejam um ato deliberado em vez de um efeito colateral da fusão desligam frequentemente a auto-implementação de ramo e conduzem a produção apenas a partir de etiquetas.

Cortar um Lançamento

O fluxo inteiro do seu lado são dois comandos git:

git tag -a v1.4.0 -m "Checkout flow rebuild"
git push origin v1.4.0

O Orbit recebe a etiqueta, compara-a com o seu padrão, implementa o commit etiquetado em produção e regista um lançamento. Aparece nesta aba com um distintivo Building e passa para Deployed quando chega, ou Failed se a construção teve erro.

Use etiquetas anotadas em vez de etiquetas leves. Uma etiqueta anotada carrega uma mensagem, um autor e uma data, tudo isto acaba no lançamento.

Etiquetar uma Implementação Existente

Não tem de fazer push de uma etiqueta git para obter um lançamento. Qualquer implementação pode ser etiquetada a partir da sua página de detalhe, e uma etiqueta que se pareça com um número de versão é captada aqui.

Uma etiqueta com forma de versão é uma como 1.4, 1.4.0, v1.4.0 ou v2.0.0-rc1. Qualquer outra coisa permanece como uma etiqueta de implementação simples e não cria uma entrada de lançamento.

Esta é a válvula de escape para o caso em que um lançamento saiu antes de ter configurado o padrão, ou em que um hotfix foi implementado manualmente e quer que esteja no histórico de versões mesmo assim.

Ler um Lançamento

Cada linha de lançamento mostra:

A etiqueta, como o título do lançamento.
O commit e a sua mensagem.
O autor, mostrado como by name.
O ambiente para o qual foi, codificado por cor consoante o tipo.
Um distintivo de estado: Deployed, Building ou Failed.
Uma ligação View on para a etiqueta no seu repositório.
Uma ligação para a implementação subjacente.

A ligação View on aponta para o local certo por fornecedor: a página de lançamentos no GitHub, a página de etiqueta no GitLab, ou a origem nessa etiqueta no Bitbucket.

Notas de Lançamento

Se publicar um lançamento no seu repositório para uma etiqueta, as notas são puxadas e anexadas à implementação, de modo que a aba Releases contém o mesmo texto que escreveu no seu repositório em vez de o obrigar a manter duas cópias.

Isto torna o repositório o único lugar para escrever notas de lançamento. Escreva uma vez, onde os seus contribuintes já estão, e aparecem aqui.

Um Lançamento Por Etiqueta

A lista é desduplicada por etiqueta: se uma etiqueta foi implementada mais de uma vez, por exemplo porque a primeira construção falhou e tentou novamente, apenas a implementação mais recente para essa etiqueta é mostrada.

O contador no topo dá o total, e a lista cobre uma janela generosa de implementações recentes etiquetadas em vez de todo o histórico do projeto.

Usar Lançamentos Bem

Etiquete no merge, não no ramo. Etiquete o commit que está realmente no seu ramo de produção. Etiquetar um commit de ramo de funcionalidade que não foi fundido produz um lançamento que não corresponde a nada em main.

Use versões semânticas. Ordenam-se corretamente, são reconhecidas como tendo forma de versão, e todos já sabem como lê-las.

Nunca mova uma etiqueta. Re-apontar uma etiqueta existente para um novo commit significa que o lançamento nesta lista e a etiqueta no seu repositório agora discordam sobre o que foi enviado. Corte uma nova versão de patch em vez disso.

Um push de etiqueta implementa diretamente em produção se corresponder ao seu padrão. Isto não contorna mais nada: bloqueios de implementação, requisitos de aprovação e janelas de congelamento ainda se aplicam conforme configurado. Mas significa que uma etiqueta feita push por erro é uma implementação em produção, não um rascunho. Veja Deploying Your Project para as portas disponíveis.

Reverter um Lançamento

Os lançamentos são implementações, de modo que reverter um é o fluxo de reversão normal: abra a implementação e restaure a anterior bem-sucedida. Veja Rolling Back a Deployment.

Depois, corte uma nova etiqueta para a correção em vez de eliminar a má. O lançamento falhado permanecendo visível no histórico é informação útil, não desordem.

Resolução de Problemas

Uma etiqueta foi feita push mas nenhum lançamento apareceu. Verifique o padrão em Settings, depois verifique se a etiqueta realmente chegou ao remoto. git push origin v1.4.0 faz push de uma etiqueta; git push sozinho não faz push de nenhuma.

O lançamento mostra Failed. A construção falhou, exatamente como faria para um push de ramo. Abra a implementação e leia o registo: Reading Build Logs.

A ligação View on está em falta. O projeto não tem um repositório conectado, de modo que não há para onde fazer ligação. Conecte um: veja Connecting a GitHub Repository.

Uma implementação etiquetada manualmente não está listada. A etiqueta não tem forma de versão. Renomeie-a para algo como v1.4.0.

As notas de lançamento estão vazias. As notas são puxadas de um lançamento publicado no seu repositório. Uma etiqueta simples sem objeto de lançamento não tem notas para puxar.

Por Onde Começar

Deploying Your Project para o ciclo de implementação completo e as suas portas.
Rolling Back a Deployment quando um lançamento corre mal.
Orbit Timeline Annotations para registar o que um lançamento mudou.

Lançamentos do Orbit