github-featured/yuan-lab-llm--clawmanager

Files

T

Stark-Han 1dc492a481 feat(team): add custom templates, Hermes Lite workers, and refreshed multilingual guides (#187 )

* feat(team): add custom templates and Hermes Lite workers

* docs: reorganize multilingual product guides

* ci: generate self-hosted star history

* ci: verify published star history charts

* docs: update WeChat community QR code

* docs: document DeepSeek Harness across user guides

2026-08-19 18:30:41 +08:00

3.3 KiB

Raw Permalink Blame History

← README로 돌아가기

배포 가이드

ClawManager는 Kubernetes Native 플랫폼입니다. Distribution과 Storage에 맞는 Profile을 선택하세요.

Profile

환경	Manifest	Storage
k3s Single Node	`k3s/single-node`	Label된 Node HostPath
k3s Cluster	`k3s/cluster`	CSI RWO + RWX
Kubernetes Single Node	`k8s/single-node`	Label된 Node HostPath
Kubernetes Cluster	`k8s/cluster`	CSI RWO + RWX

하나의 완전한 Profile만 사용합니다. Longhorn 이름은 예시이며 같은 AccessMode의 StorageClass로 바꿀 수 있습니다. Manifest를 섞거나 Multi-Node에 임시 /tmp HostPath를 사용하지 마세요.

구성과 절차

Profile은 ClawManager, MySQL, MinIO, Skill Scanner, Team Redis, Workspace Service, OpenClaw/Hermes/OpenCode/DeepSeek Harness Lite Pool을 실행합니다. Lite Instance는 Runtime Pod를 공유합니다.

Secret, Image, StorageClass, 외부 Access 확인.
Single Node Label 또는 Cluster RWO/RWX CSI 확인.
한 Profile 적용 후 Pod Ready와 PVC Bound 대기.
일반 Model 설정 후 AI Gateway와 Security 확인.
공개할 Runtime별 Test Instance 생성.

새 MySQL은 clawmanager-mysql-init로 초기화되며 기존 Volume은 First-Start Script를 다시 실행하지 않습니다. 영구 Data에 emptyDir를 사용하지 마세요.

DeepSeek Harness Runtime

Lite는 공유 deepseek-harness-runtime Pool에서 격리된 dsh web Process를 실행하고 <workspace>/home/.dsh에 상태를 유지합니다.
Pro는 Port 3001의 전용 Webtop Deployment를 사용하며 내부 dsh web은 Loopback Port 3080, 영구 Home은 /config/.dsh입니다.
두 모드 모두 ClawManager가 AI Gateway URL, Instance Credential, Model List를 주입하며 Skill과 Workspace File을 지원합니다.
Lite에는 전용 Origin Template이 필요합니다. 예: CLAWMANAGER_DEEPSEEK_HARNESS_PUBLIC_URL_TEMPLATE=https://deepseek-harness-{instance_id}.clawmanager.test:39443/. {instance_id}는 필수입니다.

Image Source는 AgentsRuntime의 deepseek-harness/에 있습니다. Offline 환경에서는 Lite Origin용 Wildcard DNS와 인증서를 준비하세요.

Storage와 ARM64

Single-Node HostPath는 고정 Node/Affinity가 필요합니다. Multi-Node는 실제 RWO/RWX CSI가 필요하며 local-path는 Cluster RWX가 아닙니다. Cluster Profile에서 암묵적 HostPath Fallback을 사용하지 마세요.

ClawManager와 Skill Scanner는 linux/arm64를 지원하지만 MySQL, Redis, MinIO/Workspace, 모든 Runtime Image도 확인해야 합니다. Mixed Architecture에서는 호환 Tag와 Node Selector/Affinity를 사용하고 SSD, 충분한 Memory, 고정 Tag를 권장합니다. amd64와 같은 PVC, Desktop, Model, Skill 검수를 수행하세요.

검수

Pod/PVC, Web, Model, Security, AI Gateway, 필요한 Runtime을 확인합니다. PVC Pending이면 StorageClass, PVC, Pod, Event, Describe를 수집한 뒤 처리하세요. 사용자 매뉴얼도 참고하세요.

3.3 KiB Raw Permalink Blame History