●status:pre-alpha
version:v0.1.0
lang: EN PT
[ topology-first / open source / multi-provider ]

Sua topologia, descrita uma vez. Reconstruída sempre que precisar.

DevStation é o cockpit open source para criar, preparar e recriar ambientes de homelab e desenvolvimento a partir de uma topologia clara. Multi-provider por design, com suporte hoje a Proxmox.

$ curl -fsSL https://devstation.tech/install | sh
Ver no GitHub↗
devstation@homelab ~ $ devstation
sessão 04:12
Etapas

A topologia é a fonte de verdade.
Descreva, provisione, registre serviços e faça deploy.

step 01
describe
Descreva clusters, nodes, VMs, templates, definitions, environments, roles, stations e vaults.
topology.describe()
step 02
provision
O DevStation aplica a topologia, cria as VMs no provider escolhido e acompanha o estado real.
provider.apply()
step 03
deploy
Registre services em uma station e use blueprints para instalar Docker, K3s, Portainer, Jenkins, ArgoCD e afins.
station.deploy()
↺ ajuste a topologia · recomece
Filosofia

Princípios que orientam o que entra e o que fica de fora.

01
Topology-first
A topologia vem antes do provider, da interface e de qualquer ferramenta sob o capô.
02
Multi-provider por design
A mesma topologia deve rodar contra o provider escolhido. Proxmox hoje; outros entram pelo mesmo modelo.
03
Provisionamento legível, não caixa-preta
Você não precisa conhecer cada ferramenta possível para começar. Planos, decisões e passos continuam visíveis.
04
Automação com controle
Nada é mágica. O CLI é opinativo; o usuário continua dono da infraestrutura.
05
Aberto desde a fundação
Open source não é uma decisão futura. É a base do produto.
06
Comece simples, cresça flexível
A primeira topologia cabe em poucos minutos. A décima segue o mesmo modelo.
Blueprints + stations

Receitas declarativas para começar, stations para orquestrar.

Blueprints são receitas YAML para instalar e operar capacidades em VMs. Services são usos dessas receitas dentro de uma station, que ordena dependências, resolve secrets no vault e executa o deploy.

Catálogo de blueprints
Blueprints vivem em blueprints/<nome>/blueprint.yaml. Podem ser standalone, com VMs próprias, ou hosted sobre outro service.
Services como instâncias
Ao registrar um service, você escolhe blueprint, vault, inputs e VMs ou host. O estado fica dentro da station.
Deploy orquestrado
Stations deployam um subconjunto de services em ordem topológica; services hosted esperam o host estar pronto.
catalog blueprints oficiais: docker · k3s · argocd · portainer · infisical · jenkins
extend community-ready: compartilhe YAMLs · adapte receitas · publique catálogos
$ devstation
blueprints/k3s/blueprint.yaml
station homelab-core -> services: k3s-prod, argocd
Roadmap

Sóbrio sobre o presente, claro sobre o futuro.

Agora pronto
▣ Modelagem de topologia via TUI
▣ Vault local cifrado
▣ Consulta em tempo real via API do Proxmox
▣ Provisionamento Proxmox via Terraform
▣ Stations, services e deploy por blueprints
▣ Release Linux inicial
Próximo próximo
▢ Portabilidade macOS e Windows
▢ Self-update e installer público
▢ Core RPC para múltiplas UIs
▢ Operações Proxmox além do provisionamento
Horizonte depois
· Novos providers
· Catálogo e registry de blueprints da comunidade
· Times pequenos e laboratórios internos
· Marketplace ou SaaS opcional
Próximo passo

continue pela documentação.

A CLI está em pre-alpha. Em vez de esconder isso atrás de comandos prematuros, o melhor caminho é entender o modelo, o provider atual e o roadmap.

01 Entenda o modelo Conceitos explica topology, stations, services, blueprints e como a topologia vira ambiente útil. ler conceitos ↗ 02 Veja Proxmox O suporte atual mostra como credenciais, topologia e provisionamento inicial se conectam pela TUI. ver provider ↗ 03 Acompanhe o roadmap Cross-OS, Core RPC, self-update e catálogo da comunidade são as próximas frentes. ver roadmap ↗