techlite/version-bump
1.0.2
repeating may hit the cache The result depends only on the inputs, so a second run may come from cache without executing again.Incrementa a versão do projeto e grava no manifesto
task
How to use
oren add techlite/version-bumpLê a versão atual do manifesto, aplica o incremento pedido e grava de volta.
A versão gravada é sempre um semver limpo. Quando o build é de candidata, o identificador composto sai em `candidateTag`, para ser usado como tag de imagem sem sujar a versão do projeto.
Só altera arquivos dentro do workspace — nada é publicado nem enviado.
The step the command writes
- id: version-bump
task: techlite/version-bump@^1.0.2
implementation: techlite/version-bump-alpine
inputs:
change: ...
dependencies:
source: ...What it requires from your environment
This is the floor: every implementation of this task asks for at least this.
| dependency | type | access | privilege |
|---|---|---|---|
sourceProjeto cujo manifesto será atualizado. | directory | read and write | medium |
Inputs
changestringrequired- Incremento a aplicar. Normalmente vem do output de `techlite/analyze-commits`.
candidateboolean- Compõe também um `candidateTag`, com os identificadores habilitados abaixo. Não altera a versão gravada no manifesto. default:
false includeCommitHashboolean- Anexa o hash curto do commit ao `candidateTag`. default:
false includeTimestampboolean- Anexa carimbo de tempo ao `candidateTag`. default:
false authorstring- Identificador anexado ao `candidateTag`.
manifeststring- Arquivo de onde a versão é lida e onde é gravada. Ausente, procura `package.json` e depois `version.json` — o segundo para projetos que não são Node.
buildIncrementinteger- Quanto somar ao contador `build`, quando o manifesto tiver um. É um número sequencial independente do semver, usado por projetos que precisam distinguir builds da mesma versão. default:
0
Outputs
What later steps can reference.
versionstring- Versão resultante, gravada no manifesto. Semver limpo, sem prefixo.
previousVersionstringcandidateTagstring- Versão composta para identificar o artefato, presente apenas quando `candidate` é verdadeiro. Ex: `0.13.0-rc.a1b2c3d.20260806034512.thomas`.
buildstring- Contador de build resultante, quando o manifesto tem um.
changedboolean- Falso quando `change` era `none` e o manifesto não foi tocado.
Implementations
ghcr.io/techlitebr/oren-version-bump-alpine:1.0.2