uncloud
Ajuda seu agente a gerenciar um cluster Uncloud. Implanta serviços, configura rede e gerencia máquinas e volumes.
O que ela faz
Esta ferramenta ajuda você a gerenciar um grupo de computadores (um cluster Uncloud) que trabalham juntos. Você pode usá-la para instalar novos programas, configurar como eles se conectam à internet, ver o que está acontecendo dentro deles e adicionar ou remover computadores do grupo.
Quando usar
- ✓Quando você está configurando um novo grupo de computadores Uncloud.
- ✓Quando você quer instalar ou atualizar um programa no seu grupo.
- ✓Quando você precisa ver os registros (logs) de um programa ou verificar o status de um computador.
Exemplo do que pedir para a IA
“Como faço para instalar um novo programa chamado 'meu-app' no meu cluster Uncloud?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
O Uncloud usa contêineres (programas empacotados) que rodam em diferentes máquinas. Ele cria uma rede privada entre essas máquinas e usa um programa chamado Caddy para gerenciar o acesso pela internet, garantindo que tudo funcione junto de forma organizada.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add affaan-m/ECC --skill uncloudOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/uncloud/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Gerenciamento de Cluster Uncloud
Referência para a CLI uc — uma plataforma descentralizada de auto-hospedagem usando contêineres Docker, rede mesh WireGuard e proxy reverso Caddy.
Quando Ativar
Use esta habilidade ao trabalhar com clusters Uncloud, especialmente quando:
- Inicializando ou juntando máquinas com
uc machine - Implantando serviços de arquivos Compose com
uc deploy - Publicando portas HTTP, HTTPS, TCP ou UDP através do Uncloud
- Configurando o ingresso do Caddy com
x-caddy,x-portsou--caddyfile - Roteando dispositivos LAN externos através do proxy do cluster
- Inspecionando logs, estado do serviço, volumes, DNS ou posicionamento da máquina
Como Funciona
O Uncloud executa serviços Docker em máquinas pares conectadas por uma rede mesh WireGuard. Cada máquina é um membro igual do cluster; os serviços se comunicam na rede overlay e o Caddy é executado globalmente para encerrar o tráfego público HTTP/HTTPS. Arquivos Compose podem usar extensões Uncloud para ingresso, posicionamento e configuração gerada do Caddy, enquanto a CLI uc lida com distribuição de imagens, agendamento, escalonamento, logs e estado do cluster.
Exemplos
uc machine init user@host --name machine-1
uc service run --name web -p app.example.com:8080/https nginx:latest
uc deploy
Conceitos Principais
- Sem plano de controle central — todas as máquinas são pares iguais conectadas por WireGuard
- Caddy é executado como um serviço global em cada máquina; obtém TLS automaticamente do Let's Encrypt
- Rede overlay — os serviços se comunicam via
10.210.0.0/16por padrão; DNS fornecido dentro da mesh - Caddyfile é autogerado — nunca o edite diretamente; use
x-caddy/--caddyfileem vez disso
Referência Rápida da CLI
Máquinas
| Comando | Propósito |
|---|---|
uc machine init user@host |
Inicializa a primeira máquina / novo cluster |
uc machine add user@host |
Junta a máquina a um cluster existente |
uc machine ls |
Lista máquinas |
uc machine update NAME --public-ip IP |
Atualiza o IP público para ingresso |
uc machine rm NAME |
Remove máquina |
Flags init chave: --name, --network 10.210.0.0/16, --no-caddy, --no-dns, --public-ip auto\|IP\|none
Serviços
| Comando | Propósito |
|---|---|
uc service ls / uc ls |
Lista serviços |
uc service run IMAGE |
Executa um serviço de contêiner único |
uc deploy |
Implanta a partir de compose.yaml |
uc deploy --no-build |
Implanta imagens já enviadas sem reconstruir |
uc deploy --recreate |
Força a recriação do serviço |
uc scale SERVICE N |
Define o número de réplicas |
uc service logs SERVICE |
Visualiza logs |
uc service exec SERVICE |
Entra no contêiner via shell |
uc service inspect SERVICE |
Informações detalhadas |
uc service rm SERVICE |
Remove o serviço (mantém volumes nomeados) |
uc ps |
Todos os contêineres no cluster |
Imagens
uc image push myapp:latest # Push local image to all machines
uc image push myapp:latest -m machine1,machine2 # Push to specific machines
uc images # List images in cluster
Volumes
uc volume ls # All volumes
uc volume ls -m machine1 # On specific machine
uc volume create NAME -m MACHINE
uc volume rm NAME
Caddy
uc caddy config # Show current generated Caddyfile (read-only)
uc caddy deploy # Deploy/upgrade Caddy across cluster
DNS e Contexto
uc dns show # Show reserved *.uncld.dev domain
uc dns reserve # Reserve a new domain
uc ctx ls # List cluster contexts
uc ctx use prod # Switch context
Publicação de Portas
HTTP/HTTPS (via proxy reverso Caddy)
-p [hostname:]container_port[/protocol]
| Exemplo | Significado |
|---|---|
-p 8080/https |
HTTPS com hostname service-name.cluster-domain automático |
-p app.example.com:8080/https |
HTTPS com hostname personalizado |
-p 8080/http |
Apenas HTTP, sem TLS |
TCP/UDP (vinculado ao host, ignora Caddy)
-p [host_ip:]host_port:container_port[/protocol]@host
| Exemplo | Significado |
|---|---|
-p 5432:5432@host |
TCP 5432 em todas as interfaces |
-p 127.0.0.1:5432:5432@host |
TCP 5432 apenas loopback |
-p 53:5353/udp@host |
UDP |
Extensões do Arquivo Compose
O Uncloud adiciona estas extensões sobre o Docker Compose:
x-ports — publica portas com domínios
services:
app:
image: app:latest
x-ports:
- example.com:8000/https
- www.example.com:8000/https
- api.example.com:9000/https
…
Perguntas frequentes
O que é um cluster Uncloud?
É um conjunto de computadores que trabalham juntos, gerenciados pelo Uncloud, para rodar seus programas de forma descentralizada e segura.
O que é o Caddy?
É um programa que gerencia o acesso aos seus serviços pela internet, cuidando de coisas como certificados de segurança (HTTPS) automaticamente.
Como o Uncloud conecta as máquinas?
Ele usa uma tecnologia chamada WireGuard para criar uma rede segura e privada entre todas as máquinas do cluster.
Detalhes
Descrição original do autor
Use when managing an Uncloud cluster — deploying services, configuring Caddy ingress, adding static proxy routes for non-cluster devices, publishing ports, scaling, inspecting logs, or managing machines and volumes with the `uc` CLI.
repo: affaan-m/ECC
Popularidade
- Estrelas no GitHub
- 280 mil
- Posição no ranking
- #304
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
accessibility
Ajuda seu agente a criar interfaces que todos possam usar. Garante que sites e aplicativos funcionem bem para pessoas com deficiência, como cegos ou com mobilidade reduzida.
affaan-m/ECC
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC
Skills parecidas
git-workflow-and-versioning
Organiza o trabalho de código usando o Git. Ajuda a salvar o progresso, gerenciar diferentes versões e evitar conflitos ao trabalhar em equipe.
addyosmani/agent-skills
observability-and-instrumentation
Adiciona ferramentas para monitorar o que o código faz em produção. Ajuda a entender se algo deu errado e por quê, facilitando a correção.
addyosmani/agent-skills
github-pr-workflow
Prepara pull requests no GitHub, garantindo a qualidade do código e a documentação.
paperclipai/paperclip