O que é o uncloud?
uncloud é uma ferramenta leve de clustering e orquestração de containers criada por Pasha Sviderski que permite implantar e gerenciar aplicações web em VMs de nuvem e bare metal com overhead mínimo de gerenciamento de cluster. Ele preenche a lacuna entre a simplicidade do Docker e o poder do Kubernetes, fornecendo simplicidade do Docker com poder multi-máquina.
⚡ Principais Recursos do uncloud
🌐 Implantação Multi-Máquina
Implante em VMs de nuvem, servidores dedicados e bare metal. Combine diferentes provedores em um ambiente de computação unificado.
🐳 Compatível com Docker Compose
Use o formato Docker Compose familiar para definir serviços. Sem necessidade de aprender novas linguagens de configuração ou YAML complexo.
🔒 Rede Privada Sem Configuração
Mesh WireGuard automático com descoberta de peers e travessia NAT. Containers recebem IPs únicos para comunicação direta entre máquinas.
🎯 Sem Plano de Controle
Design totalmente descentralizado elimina pontos únicos de falha. Cada máquina mantém o estado sincronizado do cluster através de comunicação peer-to-peer.
🔍 Descoberta de Serviços
Servidor DNS integrado resolve nomes de serviços para IPs de containers. Balanceamento de carga automático e ingress com HTTPS via Caddy.
📦 Armazenamento Persistente
Execute serviços stateful com volumes Docker gerenciados entre máquinas. Persistência de dados sem orquestração de armazenamento complexa.
apt upgrade mantém você sempre na versão mais recente.
📦 Instalação via deb.griffo.io
Passo 1: Adicionar repositório
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Existe um espelho grátis para sempre. deb-free.griffo.io distribui pacotes grátis para sempre — sem conta, sem assinatura, no máximo 2 meses atrás do upstream, correções de segurança imediatas. Hoje ele traz cliamp, Ghostty, lazydocker, Oh My Posh e Zed; Uncloud não está entre elas, então o repositório acima é a única forma de instalar hoje — peça e ela pode ser adicionada.
🧩 Sobre a opção extrepo. extrepo é a ferramenta do próprio Debian para repositórios externos: ela escreve o arquivo de sources e instala a chave de assinatura para você, conferindo a chave contra metadados assinados antes de usá-la. Este repositório está registrado nela como griffo, e o espelho gratuito para sempre como griffo-free, então no Debian (bookworm, trixie, forky e sid) os comandos acima são toda a configuração.
O extrepo configura apenas o arquivo de sources e a chave: as credenciais de uma assinatura continuam indo em /etc/apt/auth.conf.d/deb.griffo.io.conf. O Ubuntu não é coberto, porque o extrepo publica metadados só para as suítes do Debian: lá, use os comandos com sudo ou como root.
Passo 2: Instalar uncloud
# Install latest uncloud
sudo apt install uncloud
# Verificar instalação
uc --version# Install latest uncloud
apt install uncloud
# Verificar instalação
uc --version🎯 Exemplos de uso básico
Inicializar seu primeiro cluster:
# Initialize cluster on first machine
uc machine init root@your-server-ip
# Add more machines to cluster
uc machine add --name server2 root@second-server-ip
# List cluster machines
uc machine lsImplantar aplicações:
# Deploy from Docker image with HTTPS
uc run -p app.example.com:8000/https image/my-app
# Deploy from Docker Compose file
uc compose up -f compose.yaml
# Scale service across machines
uc scale my-app 3
# List running services
uc lsGerenciar implantações:
# Update service with new image
uc update my-app image/my-app:v2
# View service logs
uc logs my-app
# Remove service
uc rm my-app
# Clean up cluster
uc machine rm server2🚀 Por que escolher deb.griffo.io?
- Debian oficial: Não disponível nos repositórios oficiais
- Script de Instalação: Atualizações manuais e gerenciamento de dependências
- Binário Manual: Sem gerenciamento de pacotes ou atualizações automáticas
- deb.griffo.io: Versão mais recente com atualizações automáticas
- ✅ Recursos Mais Recentes: Obtenha as novas melhorias de orquestração e rede
- ✅ Sem Configuração Manual: Binários pré-compilados com todas as dependências
- ✅ Atualizações Automáticas: Pacotes atualizados em horas após os lançamentos upstream
- ✅ Pacote Completo: Inclui todos os componentes e scripts necessários
- ✅ Multi-Distribuição: Funciona no Bookworm, Trixie e Sid
- ✅ Manutenção Fácil: Comandos apt padrão para atualizações
📦 Repositório de construção de pacotes
Os pacotes Debian são construídos e mantidos automaticamente neste repositório do GitHub:
- 🌬️ uncloud-debian - Latest release builds
🔗 Pacotes relacionados
Também disponível no deb.griffo.io:
- unregistry - Transferência direta de imagens Docker (mesmo autor)
- lazydocker - Interface de terminal para gerenciamento Docker
- fzf Fuzzy Finder - Busca avançada de comandos