devstation docs

Conceitos

Os termos centrais do DevStation em linguagem de produto.

Topology

A topologia é o mapa do ambiente. Ela é a fonte de verdade para provisionamento, deploy e recriação.

Cluster

Um cluster agrupa nodes do mesmo provider. Hoje o provider suportado é Proxmox.

Node

Um node é a máquina física ou virtual de base que hospeda instances.

Instance

Uma instance é uma VM descrita na topologia. Ela combina role, definition, template e environment.

Template

Um template é a imagem base de uma VM, como Ubuntu 22.04, Debian 12 ou Alpine.

Definition

Uma definition descreve tamanho e recursos: CPU, memória, disco e rede.

Environment

Um environment representa o contexto da instance: homelab, dev, staging ou experiments.

Role

Uma role define o papel da máquina. No ciclo de deploy, a role aponta para a stack que prepara a VM.

Vault

O vault é o cofre local cifrado para senhas, chaves SSH, tokens e credenciais de provider.