clickclack は何をしますか?
ClickClack 製品のランタイム運用、デプロイ、ホステッドアプリのチェック、およびドメイン関連の質問に使用します。
概要
- リポジトリ:
~/Projects/clickclack/https://github.com/openclaw/clickclack - 製品: OpenClaw/コミュニティ/エージェントワークフロー向けのセルフホスト可能な Slack スタイルのチャットアプリ。
- サーフェス:
https://clickclack.chat製品サイトhttps://app.clickclack.chatホステッドアプリhttps://docs.clickclack.chatdocs/からの GitHub Pages ドキュメント
本番環境
- Hetzner:
clickclack-prod-01 - IPv4:
157.90.237.80 - IPv6:
2a01:4f8:1c1c:fb96::/64 - SSH:
[email protected] - ラベル:
app=clickclack,env=prod - OS: Ubuntu 24.04, Caddy + Docker
- ホスト上のソース:
/opt/clickclack-src(クリーンエクスポート、git チェックアウトではない) - 以前のソース:
/opt/clickclack-src.prevとタイムスタンプ付きの古いプレビューディレクトリ - データ:
/var/lib/clickclackが/app/dataにバインドマウント - コンテナ:
clickclack、ポート127.0.0.1:8080->8080 - Caddy:
/etc/caddy/Caddyfileがclickclack.chat, app.clickclack.chatを127.0.0.1:8080にプロキシ;wwwは apex にリダイレクト。 - DNS の真実:
~/Projects/manager/DOMAINS.mdと~/Projects/manager/DNS.md
デプロイ
黄金のパス:
- ローカルリフレッシュ:
cd ~/Projects/clickclackgit status --short --branchgit fetch originmainブランチで上流がない場合:git merge --ff-only origin/main
- デプロイされた差分を決定:
- 最後にデプロイされたコミットは、プル前の古いローカル
HEADである可能性があります。存在する場合は/opt/clickclack-src/.deploy-commitを確認。 git log --oneline <old>..HEADgit diff --stat <old>..HEAD
- 最後にデプロイされたコミットは、プル前の古いローカル
- クリーンな HEAD のみをアーカイブ:
- 追跡されていないローカルファイルを rsync しない。
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"
- シークレットを表示せずに環境変数を保存:
docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
- マイグレーション前にバックアップ:
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
- ビルド:
docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
- コンテナを置き換え:
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
- ソースディレクトリをローテーション:
- 古い
/opt/clickclack-src.prevをタイムスタンプ付きバックアップに移動。 /opt/clickclack-srcを/opt/clickclack-src.prevに移動。/opt/clickclack-src.nextを/opt/clickclack-srcに移動。
- 古い
検証
- ホスト:
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
- 公開:
curl -I https://clickclack.chatcurl -I https://app.clickclack.chatcurl -I https://docs.clickclack.chat
ガードレール
- OAuth シークレットやマジックトークンを出力しないでください。
- ローカル SSH ホストキーの状態が古い場合は、使い捨ての
UserKnownHostsFileを使用します。最初にhcloud server describe clickclack-prod-01でサーバー ID を確認します。 clickclack serveは起動時にマイグレーションを実行します。コンテナを置き換える前に常に SQLite をバックアップしてください。- ダーティなワーキングツリーではなく、クリーンな git アーカイブからデプロイを維持します。