cloud-cli-proxy/Makefile at main · ZaneL1u/cloud-cli-proxy · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
-include .env
export

DEV_COMPOSE := docker compose -f deploy/compose/control-plane.dev.yml

.PHONY: dev dev-api dev-web db test test-go test-smoke build build-cli install-cli clean gateway-image up up-build up-rebuild up-api down logs release

# ── Development ──────────────────────────────────────────────

dev: ## Start backend + frontend (auto-starts PostgreSQL if needed)
	@echo "Starting control-plane + admin frontend..."
	@echo "  API  → http://$(CONTROL_PLANE_ADDR)"
	@echo "  Web  → http://localhost:5173"
	@echo "  Agent → embedded (in-process)"
	@echo ""
	@mkdir -p .data
	@# Auto-start PostgreSQL if not running
	@nc -z 127.0.0.1 $(POSTGRES_PORT) > /dev/null 2>&1 || \
		{ echo "PostgreSQL not running, starting it now..."; $(MAKE) db; }
	@# On macOS / Windows, ensure gateway sidecar image exists (ContainerProxyProvider needs it)
	@if [ "$$(uname -s)" != "Linux" ]; then \
		if ! docker images $(GATEWAY_IMAGE) --format '{{.Repository}}:{{.Tag}}' 2>/dev/null | grep -qF '$(GATEWAY_IMAGE)'; then \
			echo "Non-Linux host: gateway image not found, building $(GATEWAY_IMAGE)..."; \
			$(MAKE) gateway-image; \
		fi; \
	fi
	@trap 'kill $$CP_PID $$VITE_PID 2>/dev/null; wait' INT EXIT; \
		bash scripts/dev-backend.sh & CP_PID=$$!; \
		cd web/admin && pnpm dev & VITE_PID=$$!; \
		wait

dev-api: ## Start backend only with hot reload (auto-starts PostgreSQL)
	@mkdir -p .data
	@nc -z 127.0.0.1 $(POSTGRES_PORT) > /dev/null 2>&1 || \
		{ echo "PostgreSQL not running, starting it now..."; $(MAKE) db; }
	@bash scripts/dev-backend.sh

dev-web: ## Start frontend only
	cd web/admin && pnpm dev

dev-all: dev ## Alias for 'make dev' (PostgreSQL is auto-started)

# ── Database ─────────────────────────────────────────────────

db: ## Start PostgreSQL via Docker Compose
	$(DEV_COMPOSE) up -d postgres
	@echo "Waiting for PostgreSQL on port $(POSTGRES_PORT)..."
	@until pg_isready -h 127.0.0.1 -p $(POSTGRES_PORT) -U $(POSTGRES_USER) -d $(POSTGRES_DB) > /dev/null 2>&1 || $(DEV_COMPOSE) exec -T postgres pg_isready -U $(POSTGRES_USER) -d $(POSTGRES_DB) > /dev/null 2>&1; do sleep 1; done
	@echo "PostgreSQL ready."

db-stop: ## Stop PostgreSQL
	$(DEV_COMPOSE) down

db-reset: ## Reset database (destroy volume and restart)
	$(DEV_COMPOSE) down -v
	$(MAKE) db

# ── Testing ──────────────────────────────────────────────────

test: test-go test-smoke ## Run all tests

test-go: ## Run Go tests
	go test ./... -count=1

test-smoke: ## Run BATS bootstrap smoke tests
	pnpm exec bats tests/smoke/

# ── Images ────────────────────────────────────────────────────

MANAGED_USER_TAG := $(shell grep '^image_name:' deploy/docker/managed-user/image.lock | cut -d' ' -f2)
GATEWAY_IMAGE    := cloud-cli-proxy-sing-gateway:local

user-image: ## Build managed-user image (cloud desktop)
	docker build -t $(MANAGED_USER_TAG) -f deploy/docker/managed-user/Dockerfile .
	@echo "Built: $(MANAGED_USER_TAG)"

gateway-image: ## Build sing-box + iptables sidecar (required for macOS/Windows host-agent egress)
	docker build -t $(GATEWAY_IMAGE) -f deploy/docker/sing-box-gateway/Dockerfile .
	@echo "Built: $(GATEWAY_IMAGE)"

# ── Build ────────────────────────────────────────────────────

build: ## Build all artifacts
	go build -o bin/control-plane ./cmd/control-plane
	GOOS=linux GOARCH=amd64 go build -o bin/host-agent ./cmd/host-agent
	go build -ldflags "-s -w" -trimpath -o bin/cloud-claude ./cmd/cloud-claude
	cd web/admin && pnpm build

build-api: ## Build Go backend only
	go build -o bin/control-plane ./cmd/control-plane

build-cli: ## Build cloud-claude CLI
	go build -ldflags "-s -w" -trimpath -o bin/cloud-claude ./cmd/cloud-claude

build-web: ## Build frontend only
	cd web/admin && pnpm build

install-cli: ## Install cloud-claude to /usr/local/bin
	go build -ldflags "-s -w" -trimpath -o /usr/local/bin/cloud-claude ./cmd/cloud-claude

# ── Production ───────────────────────────────────────────────

up: ## Start production stack (prefer prebuilt latest images)
	docker compose pull --policy always
	docker compose up -d

up-build: ## Start production stack from local source build
	docker compose -f docker-compose.yml -f docker-compose.build.yaml --profile build-only build
	docker compose -f docker-compose.yml -f docker-compose.build.yaml up -d --force-recreate

up-rebuild: ## Rebuild from scratch (no cache) and start
	docker compose -f docker-compose.yml -f docker-compose.build.yaml --profile build-only build --no-cache
	docker compose -f docker-compose.yml -f docker-compose.build.yaml up -d --force-recreate

up-api: ## Rebuild and restart control-plane only (fastest for backend changes)
	docker compose -f docker-compose.yml -f docker-compose.build.yaml build control-plane
	docker compose -f docker-compose.yml -f docker-compose.build.yaml up -d --force-recreate --no-deps control-plane

down: ## Stop production stack
	docker compose down

logs: ## Tail production logs
	docker compose logs -f

release: ## Create and push release tag (usage make release VERSION=1.5.0)
	@test -n "$(VERSION)" || (echo "VERSION is required. Example: make release VERSION=1.5.0" && exit 1)
	@test -z "$$(git status --porcelain)" || (echo "Working tree is dirty. Commit/stash changes before release." && exit 1)
	git tag v$(VERSION)
	git push origin v$(VERSION)

# ── Setup ────────────────────────────────────────────────────

setup: ## First-time setup: install deps, copy .env
	cd web/admin && pnpm install
	@test -f .env || cp .env.example .env
	@echo "Done. Edit .env if needed, then run: make dev"
	@echo ""
	@echo "常用命令:"
	@echo "  make dev         一键启动 PostgreSQL + 后端 + 前端（推荐）"
	@echo "  make dev-api     只启动后端（自动启动 PostgreSQL）"
	@echo "  make dev-web     只启动前端"
	@echo "  make db          只启动 PostgreSQL"
	@echo "  make gateway-image  构建网关 sidecar 镜像（非 Linux 首次需执行）"

# ── Utilities ────────────────────────────────────────────────

clean: ## Remove build artifacts
	rm -rf bin/ web/admin/dist/

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*## ' Makefile | sed 's/:.*## /: /' | awk 'BEGIN {FS = ": "}; {printf "  \033[36m%-12s\033[0m %s\n", $$1, $$2}'

.DEFAULT_GOAL := help

# ── Phase 34 Plan 03: cloud-claude doctor M14 终验闸门 ────────────────
# (ROADMAP §Phase 34 SC#3 / Plan 03 Task 3.7)

.PHONY: cloud-claude
cloud-claude: ## Build cloud-claude binary at repo root (used by ci-doctor-grep)
	go build -o ./cloud-claude ./cmd/cloud-claude

.PHONY: ci-doctor-grep
ci-doctor-grep: cloud-claude ## Run scripts/ci-doctor-grep.sh against built cloud-claude
	bash scripts/ci-doctor-grep.sh ./cloud-claude

.PHONY: ci-gate
ci-gate: ## CI gate: short go test + ci-doctor-grep + uat dry-run
	go test ./... -count=1 -short
	$(MAKE) ci-doctor-grep
	bash tests/scripts/uat-v31-promotion.sh --dry-run