ClickClack은(는) 무엇을 하나요?
ClickClack 제품/런타임 운영, 배포, 호스팅 앱 확인, 도메인 질문에 사용합니다.
개요
- 저장소:
~/Projects/clickclack/https://github.com/openclaw/clickclack - 제품: OpenClaw/커뮤니티/에이전트 워크플로우를 위한 자체 호스팅 가능한 Slack 스타일 채팅
- Surface:
https://clickclack.chat제품 사이트https://app.clickclack.chat호스팅 앱https://docs.clickclack.chatGitHub Pages 문서 (docs/)
프로덕션
- 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(bind-mounted to/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
- 배포 델타 확인:
- 마지막 배포는 pull 전의 이전 로컬
HEAD일 수 있음;/opt/clickclack-src/.deploy-commit파일이 있으면 확인 git log --oneline <old>..HEADgit diff --stat <old>..HEAD
- 마지막 배포는 pull 전의 이전 로컬
- 클린 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 archive에서 배포하십시오.