📣 Atualização importante — o acesso muda em 1º de outubro de 2026

A partir de 1º de outubro de 2026 ao meio-dia (horário do Reino Unido), este espelho exigirá autenticação para que o apt continue funcionando.
Uma assinatura anual garante acesso ininterrupto e apoia diretamente a continuidade do projeto. Obrigado! 🙏

🔑 Obter assinatura anual

💬 Dúvidas, problemas ou qualquer coisa sobre este repositório? Junte-se à nossa comunidade do Discord — o melhor lugar para obter ajuda e se conectar com outros usuários.
Apoiou anteriormente via Buy Me a Coffee? Você é incrível! Venha para o nosso Discord e resolveremos uma assinatura vitalícia gratuita para você. 💜

☁️ Instalar a última versão do uncloud no Ubuntu

Orquestração leve de containers conectando Docker e Kubernetes

Última Versão: 0.11.0+ (agosto de 2025)
← Voltar ao início

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 na nuvem e servidores bare metal com sobrecarga mínima de gerenciamento de cluster. Ele preenche a lacuna entre a simplicidade do Docker e o poder do Kubernetes, oferecendo a simplicidade do Docker com o poder multi-máquina.

🎯 O Ponto de Equilíbrio: Plataformas modernas na nuvem como o Heroku oferecem experiências incríveis para desenvolvedores, mas a preços premium. O Kubernetes oferece poder, mas exige conhecimento especializado significativo. O uncloud encontra o meio-termo pragmático - possua sua infraestrutura, mantenha a simplicidade ao crescer, construa com primitivas comprovadas.
⚠️ Status de Desenvolvimento: uncloud está atualmente em desenvolvimento ativo e não está pronto para uso em produção. Os recursos podem mudar significativamente entre versões. Perfeito para experimentação e aprendizado!
🚀 Por que as últimas versões são importantes: o uncloud está evoluindo rapidamente com lançamentos frequentes contendo novos recursos de orquestração, melhorias de desempenho e capacidades multi-máquina aprimoradas. As versões mais recentes incluem melhor rede mesh WireGuard, descoberta de serviços aprimorada e compatibilidade aprimorada com Docker Compose.

⚡ Principais Recursos do uncloud

🌐 Implantação Multi-Máquina

Implante em VMs na nuvem, servidores dedicados e bare metal. Combine diferentes provedores em um ambiente de computação unificado.

🐳 Compatível com Docker Compose

Use o formato familiar do Docker Compose 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 de NAT. Os 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 por meio 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 com estado usando volumes Docker gerenciados entre máquinas. Persistência de dados sem orquestração de armazenamento complexa.

🆕 Novidades no uncloud 0.11.0+

📦 Instalação a partir do debian.griffo.io

Passo 1: Adicionar repositório

sudo install -d -m 0755 /etc/apt/keyrings curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null sudo apt update
install -d -m 0755 /etc/apt/keyrings curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null apt update

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

Inicialize 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 ls

Implante 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 ls

Gerencie 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 o debian.griffo.io?

📊 Comparação de Instalação:
  • Ubuntu 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
  • debian.griffo.io: Última versão (0.11.0+) com atualizações automáticas

📦 Repositório de construção de pacotes

Os pacotes do Ubuntu são construídos e mantidos automaticamente neste repositório do GitHub:

🔗 Pacotes relacionados

Também disponível no debian.griffo.io:

🎯 Perfeito para: Desenvolvedores que querem implantação multi-máquina sem a complexidade do Kubernetes, equipes que precisam de orquestração simples de containers, entusiastas de homelab e qualquer pessoa que busca o ponto de equilíbrio entre Docker e Kubernetes.