Tags

O que é uma tag

Uma tag é um nome para uma versão do seu projeto, como prod ou 2026-q4. Ela aponta para um commit, e você pode movê-la depois. Execuções e agendamentos podem seguir uma tag em vez de uma branch, então "sempre executar o que está em produção" não exige manter uma branch só para isso, nem copiar o id de um commit.

Uma tag não pode ter o mesmo nome de uma branch.

Marque uma versão

O diálogo também lista suas tags. O menu … de uma tag tem Mover tag, para apontá-la para outra branch, e Excluir tag. A linha de uma branch mostra as tags que apontam hoje para o commit mais recente dela.

Digitar o nome de uma tag que já existe a move: o diálogo avisa e o botão passa a dizer Mover tag. Mover uma tag muda o que tudo que a segue executa daí em diante, então mova prod só quando for isso que você quer.

Pela linha de comando:

harumi tags list
harumi tags set prod                      # a branch em que você está (faça push antes)
harumi tags set prod --to release-2       # outra branch
harumi tags set prod --to 3f2a9c1e        # um commit
harumi tags rm prod

Veja harumi tags para todas as flags. Tags são tags git comuns, então git fetch harumi --tags --force as traz para um clone (--force porque uma tag movida difere da que você já tem).

Execute uma tag

No diálogo Opções de execução (a seta ao lado de Executar), abra a lista Branch ou tag. As tags ficam abaixo das branches. Escolha uma e clique em Executar.

harumi run --tag prod --watch

A execução registra a tag e o commit para o qual ela apontava quando começou. Mover a tag depois não muda uma execução que já foi iniciada, e ela continua mostrando os dois, por exemplo prod @ 3f2a9c1e. As execuções vindas de uma tag têm um ícone de tag nas listas de execuções, no histórico de execução e no seletor de execução do dashboard.

Agende uma tag

No diálogo Agendar uma execução (o botão Agendamento), escolha uma tag na mesma lista Branch ou tag. Um agendamento segue uma branch ou uma tag, nunca as duas.

harumi schedules add --cron "0 9 * * *" --git-tag prod

Um agendamento que segue uma tag consulta a tag a cada disparo, então executa o que prod aponta naquele momento e lê o harumi.toml desse commit. É a forma de executar o que está em produção num horário fixo sem editar o agendamento a cada release.

• Excluir uma tag que um agendamento segue é recusado. Altere ou remova o agendamento antes.
• Se a tag não existir mais quando o agendamento disparar, essa execução falha e diz o motivo.

Compare tags

Clique em Atualizar comparação na página de comparação: o diálogo Executar uma nova comparação lista as tags depois das branches, e você pode marcá-las como branches. Veja Comparar versões. Uma tag é consultada uma vez, quando a comparação começa, então todas as execuções da comparação usam um commit fixo mesmo que a tag se mova nesse meio-tempo.

Na página de comparação, uma execução vinda de uma tag é sinalizada quando a tag se moveu desde então ("mudou desde esta execução") ou foi excluída ("não existe mais"), e o diálogo Executar uma nova comparação abre com as tags de onde vieram as execuções comparadas já marcadas.

Bom saber

• Definir uma tag exige a mesma permissão de criar uma branch. Ler tags, e executar uma, exige a mesma permissão de executar uma branch.
• Links de compartilhamento só executam branches nomeadas; não executam tags.
• A API com chave de API informa a tag de uma execução (git_tag), mas não consegue iniciar uma execução a partir de uma tag. Veja a referência da API.