rtk

Helper operacional para Docker Swarm legado — deploy validado, versionamento local e guard interativo.

✓ v0.1.0 Debian 11+ Ubuntu 20.04+ all

Descrição

Instalação

Uso

Changelog

rtk reduz erro em deploys manuais em servidores Docker Swarm legados. Não é governança completa — é o mínimo saudável para ambientes onde CI/CD ainda não foi implantado e o deploy acontece por SSH.

O que ele faz

Deploy validado — valida e renderiza o stack.yml via docker stack config antes de aplicar.
Sempre com -d — docker stack deploy -d é o único modo. Sem aviso de detach.
Versionamento local — salva snapshot do stack.yml original e renderizado a cada deploy em .rtk/deploys/.
Guard interativo — bloqueia uso manual de docker stack deploy em shell interativo e orienta o operador.
Carrega .env — interpola variáveis locais antes de validar e fazer deploy.

Comandos

rtk deploy [--prune] [--watch]
rtk status
rtk ps [--watch]
rtk logs [servico] [--tail N] [-f]
rtk versions
rtk config
rtk doctor

Adicione a chave GPG do repositório

curl -fsSL https://rootkit.echosistema.com.br/releases/extensions/apt/gpg.pub \
  | gpg --dearmor \
  > /etc/apt/trusted.gpg.d/rtk.gpg

Adicione o repositório à lista de fontes

echo "deb https://rootkit.echosistema.com.br/releases/extensions/apt stable main" \
  > /etc/apt/sources.list.d/rtk.list

Instale

apt update && apt install rtk

Ative o guard no shell atual — novos shells carregam automaticamente via /etc/profile.d.

source /etc/profile.d/rtk-docker-guard.sh

Verifique a instalação

rtk doctor

Deploy

cd /srv/stacks/swarm-dashboard
rtk deploy            # valida, versiona e faz deploy
rtk deploy --watch    # deploy + abre watch de services/tasks
rtk deploy --prune    # remove services que saíram do stack.yml

Status e processos

rtk status            # services e tasks da stack
rtk ps                # docker stack ps
rtk ps --watch        # ps em loop via watch

Logs

rtk logs                        # todos os services (sem -f)
rtk logs app --tail 100 -f      # service pelo nome curto
rtk logs minha-stack_app -f     # service pelo nome completo

Histórico e diagnóstico

rtk versions    # lista deploys anteriores
rtk config      # exibe stack.yml renderizado (pós-interpolação)
rtk doctor      # valida pré-requisitos do ambiente

Bypass do guard

RTK_DOCKER_GUARD_DISABLE=1 docker stack deploy -d -c stack.yml nome

Documentação completa: man rtk

0.1.0 — 2026-05-15

Release inicial.
Comandos: deploy, status, ps, logs, versions, config, doctor.
Guard interativo via /etc/profile.d/rtk-docker-guard.sh.
Versionamento local em .rtk/deploys/ com manifest TSV.
Loader conservador de .env sem execução de comandos.
Man page e README incluídos no pacote.

Versão atual

Atualização

apt upgrade rtk

O repositório APT é atualizado a cada release. apt upgrade cuida do resto.

Documentação

man rtk
rtk help

Man page instalada em /usr/share/man/man1/rtk.1.gz.

Autor

echosistema

Uso interno.