Bumpy CLI

O Bumpy CLI ajuda a atualizar as versões dos jobs mantidos em arquivos version de um pipeline. Com ele, você pode incrementar ou decrementar major, minor ou patch de um job específico ou de todos os jobs de um ambiente.

Requisitos

• Python 3.12 ou superior;
• um projeto com a estrutura de pastas descrita abaixo.

Instalação

Como o Bumpy é uma ferramenta de linha de comando, recomendamos instalá-lo com pipx, que mantem as dependencias isoladas:

pipx install bumpy-cli

Também é possível instalar no ambiente Python ativo:

python -m pip install bumpy-cli

Confirme a instalacao e veja os comandos disponiveis:

bumpy --help

Prepare o projeto

Execute os comandos a partir da raiz do projeto que contem a pasta pipeline. Cada job precisa ter um arquivo version com tres numeros separados por ponto:

pipeline/
├── prd-marketplace/
│   └── meu-cron/
│       └── version
└── uat/
    └── meu-cron/
        └── version

Por exemplo, o arquivo pipeline/prd-marketplace/meu-cron/version pode conter:

1.2.3

Uso

Atualizar um job

Por padrão, os comandos atuam no ambiente prd-marketplace:

bumpy job up meu-cron patch

Esse comando altera 1.2.3 para 1.2.4. Para atualizar outro segmento:

bumpy job up meu-cron minor
bumpy job up meu-cron major

Use down para decrementar o segmento. O valor não pode ficar abaixo de zero:

bumpy job down meu-cron patch

Para atuar no ambiente uat, adicione --uat:

bumpy job up meu-cron patch --uat

Atualizar todos os jobs de um ambiente

Os comandos all atualizam todos os jobs dentro do ambiente selecionado:

bumpy all up patch
bumpy all down minor
bumpy all up major --uat

Cada pasta de job do ambiente precisa conter um arquivo version válido.

Ajuda

Consulte a ajuda geral ou a de um grupo de comandos:

bumpy --help
bumpy job --help
bumpy all --help

Desenvolvimento

O código-fonte, as instruções para contribuir e a documentação do projeto estão no repositorio no GitHub.