O que clickclack faz?
Use para operações de produto/runtime do ClickClack, deploys, verificações de aplicativos hospedados e questões de domínio.
O que é
- Repo:
~/Projects/clickclack/https://github.com/openclaw/clickclack - Produto: chat estilo Slack auto-hospedável para workflows comunitários e de agentes do OpenClaw.
- Superfícies:
https://clickclack.chatsite do produtohttps://app.clickclack.chatapp hospedadohttps://docs.clickclack.chatdocumentação GitHub Pages a partir dedocs/
Produção
- Hetzner:
clickclack-prod-01 - IPv4:
157.90.237.80 - IPv6:
2a01:4f8:1c1c:fb96::/64 - SSH:
[email protected] - Labels:
app=clickclack,env=prod - OS: Ubuntu 24.04, Caddy + Docker
- Código fonte no host:
/opt/clickclack-src(exportação limpa, não um checkout git) - Código fonte anterior:
/opt/clickclack-src.prevmais diretórios anteriores com timestamp - Dados:
/var/lib/clickclackmontado como bind em/app/data - Container:
clickclack, porta127.0.0.1:8080->8080 - Caddy:
/etc/caddy/Caddyfilefaz proxy declickclack.chat, app.clickclack.chatpara127.0.0.1:8080;wwwredireciona para apex. - Fonte da verdade DNS:
~/Projects/manager/DOMAINS.mde~/Projects/manager/DNS.md
Deploy
Caminho dourado:
- Refresh local:
cd ~/Projects/clickclackgit status --short --branchgit fetch origin- Se estiver em
mainsem upstream:git merge --ff-only origin/main
- Decidir delta do deploy:
- O último deploy conhecido pode ser o
HEADlocal antigo antes do pull; verificar/opt/clickclack-src/.deploy-commitse existir. git log --oneline <old>..HEADgit diff --stat <old>..HEAD
- O último deploy conhecido pode ser o
- Arquivar apenas HEAD limpo:
- Não rsync arquivos locais não rastreados.
short=$(git rev-parse --short=12 HEAD)git archive --format=tar HEAD | ssh [email protected] "rm -rf /opt/clickclack-src.next && mkdir -p /opt/clickclack-src.next && tar -C /opt/clickclack-src.next -xf - && printf '%s\n' '$short' > /opt/clickclack-src.next/.deploy-commit"
- Preservar env sem imprimir segredos:
docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
- Backup antes de migrações:
mkdir -p /var/lib/clickclack/backupschown 1000:1000 /var/lib/clickclack/backupsdocker exec clickclack clickclack backup --data /app/data --out /app/data/backups/clickclack-before-$(date -u +%Y%m%dT%H%M%SZ).db
- Build:
docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
- Substituir container:
docker stop clickclack && docker rm clickclackdocker run -d --name clickclack --restart unless-stopped --env-file /root/clickclack.env.current -p 127.0.0.1:8080:8080 -v /var/lib/clickclack:/app/data clickclack:latest serve --addr :8080 --data /app/data
- Rotacionar diretórios fonte:
- Mover antigo
/opt/clickclack-src.prevpara backup com timestamp. - Mover
/opt/clickclack-srcpara/opt/clickclack-src.prev. - Mover
/opt/clickclack-src.nextpara/opt/clickclack-src.
- Mover antigo
Verificar
- Host:
docker ps --filter name=clickclackdocker inspect clickclack --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'cat /opt/clickclack-src/.deploy-commitcurl -fsS http://127.0.0.1:8080/ >/tmp/clickclack-root.htmlcurl -fsS http://127.0.0.1:8080/app >/tmp/clickclack-app.html
- Público:
curl -I https://clickclack.chatcurl -I https://app.clickclack.chatcurl -I https://docs.clickclack.chat
Guardrails
- Não imprimir segredos OAuth ou tokens mágicos.
- Usar um
UserKnownHostsFiledescartável se o estado da chave de host SSH local estiver desatualizado; confirmar identidade do servidor comhcloud server describe clickclack-prod-01primeiro. clickclack serveexecuta migrações na inicialização; sempre fazer backup do SQLite antes de substituir o container.- Manter deploys a partir de arquivos git limpos, não de árvores de trabalho sujas.