Que fait clickclack ?
Utilisez ceci pour les opérations et déploiements du produit ClickClack, les vérifications de l'application hébergée et les questions relatives aux domaines.
Quoi
- Dépôt :
~/Projects/clickclack/https://github.com/openclaw/clickclack - Produit : chat auto-hébergé de type Slack pour les workflows d'agents et la communauté OpenClaw.
- Surfaces :
https://clickclack.chatsite produithttps://app.clickclack.chatapplication hébergéehttps://docs.clickclack.chatdocumentation GitHub Pages depuisdocs/
Prod
- 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
- Source sur l'hôte :
/opt/clickclack-src(export propre, pas un checkout git) - Source précédente :
/opt/clickclack-src.prevplus d'anciens répertoires prev horodatés - Données :
/var/lib/clickclackmonté via bind sur/app/data - Conteneur :
clickclack, port127.0.0.1:8080->8080 - Caddy :
/etc/caddy/Caddyfileproxyclickclack.chat, app.clickclack.chatvers127.0.0.1:8080;wwwredirige vers l'apex. - Vérité DNS :
~/Projects/manager/DOMAINS.mdet~/Projects/manager/DNS.md
Déploiement
Chemin doré :
- Rafraîchissement local :
cd ~/Projects/clickclackgit status --short --branchgit fetch origin- Si sur
mainsans amont :git merge --ff-only origin/main
- Décider du delta déployé :
- Le dernier déploiement connu peut être l'ancien
HEADlocal avant le pull ; vérifier/opt/clickclack-src/.deploy-commits'il existe. git log --oneline <ancien>..HEADgit diff --stat <ancien>..HEAD
- Le dernier déploiement connu peut être l'ancien
- Archiver uniquement le HEAD propre :
- Ne pas rsync les fichiers locaux non suivis.
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"
- Préserver les variables d'environnement sans imprimer les secrets :
docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
- Sauvegarder avant les migrations :
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
- Construction :
docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
- Remplacer le conteneur :
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
- Rotation des répertoires source :
- Déplacer l'ancien
/opt/clickclack-src.prevvers une sauvegarde horodatée. - Déplacer
/opt/clickclack-srcvers/opt/clickclack-src.prev. - Déplacer
/opt/clickclack-src.nextvers/opt/clickclack-src.
- Déplacer l'ancien
Vérification
- Hôte :
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
- Public :
curl -I https://clickclack.chatcurl -I https://app.clickclack.chatcurl -I https://docs.clickclack.chat
Garde-fous
- N'imprimez pas les secrets OAuth ni les jetons magiques.
- Utilisez un
UserKnownHostsFilejetable si l'état de la clé d'hôte SSH locale est obsolète ; confirmez d'abord l'identité du serveur avechcloud server describe clickclack-prod-01. clickclack serveexécute les migrations au démarrage ; sauvegardez toujours la base de données SQLite avant de remplacer le conteneur.- Effectuez les déploiements à partir d'archives Git propres, pas d'arbres de travail sales.