nsbp-cli 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nsbp-cli",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "description": "CLI tool for creating NSBP (Node React SSR by Webpack) projects",
5
5
  "main": "index.js",
6
6
  "files": [
@@ -53,4 +53,4 @@ logs
53
53
  cli
54
54
 
55
55
  # Serena
56
- .serena
56
+ .serena
@@ -62,4 +62,4 @@ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
62
62
  ENTRYPOINT ["dumb-init", "--"]
63
63
 
64
64
  # Start application
65
- CMD ["node", "./scripts/start.js"]
65
+ CMD ["node", "./scripts/start.js"]
@@ -6,7 +6,7 @@ FROM node:20-alpine
6
6
  RUN apk add --no-cache dumb-init
7
7
 
8
8
  # Create non-root user
9
- RUN addgroup -u 1001 -S nodejs && \
9
+ RUN addgroup -g 1001 -S nodejs && \
10
10
  adduser -S nodejs -u 1001
11
11
 
12
12
  # Set working directory
@@ -49,4 +49,4 @@ EXPOSE 3001
49
49
  ENTRYPOINT ["/entrypoint.sh"]
50
50
 
51
51
  # Start development server
52
- CMD ["dumb-init", "--", "npm", "run", "dev"]
52
+ CMD ["dumb-init", "--", "npm", "run", "dev"]
@@ -1,4 +1,4 @@
1
- .PHONY: help build dev prod down clean logs restart
1
+ .PHONY: help build dev prod down clean logs restart publish-cli
2
2
 
3
3
  help: ## Show this help message
4
4
  @echo 'Usage: make [target]'
@@ -51,4 +51,16 @@ shell-dev: ## Open shell in development container
51
51
  docker-compose -f docker-compose.dev.yml exec app sh
52
52
 
53
53
  test: ## Run tests (if configured)
54
- docker-compose exec app npm test
54
+ docker-compose exec app npm test
55
+
56
+ publish-cli: ## Publish CLI to npm registry
57
+ @echo "🚀 Starting CLI publish process..."
58
+ cd cli && npm run update
59
+ @echo "📦 Template updated, committing changes..."
60
+ git add .
61
+ git diff --quiet && git diff --cached --quiet || git commit -m "chore: update cli template"
62
+ cd cli && npm version patch
63
+ cd cli && npm publish
64
+ @echo "📤 Pushing to git repository..."
65
+ git push --follow-tags
66
+ @echo "✅ CLI published successfully!"
@@ -1,6 +1,6 @@
1
1
  # 开发
2
2
  - npm run dev (开发运行)
3
- - npm run build (生产编译)
3
+ - npm run build (生产编译)
4
4
  - npm start (生产运行)
5
5
 
6
6
  客户端渲染
@@ -10,4 +10,128 @@ http://localhost:3001/
10
10
  http://localhost:3001/?seo=1
11
11
 
12
12
  服务端渲染不成功,改为客户端渲染
13
- http://localhost:3001/?seo=1&from=link
13
+ http://localhost:3001/?seo=1&from=link
14
+
15
+ ## Docker 部署
16
+
17
+ **权限问题已修复!** 详细说明见下面的开发环境说明。
18
+
19
+ ### 生产环境
20
+
21
+ 使用 Makefile (推荐):
22
+
23
+ ```bash
24
+ # 构建并启动
25
+ make prod
26
+
27
+ # 或分步执行
28
+ make build
29
+ make prod
30
+
31
+ # 查看日志
32
+ make logs
33
+
34
+ # 重启
35
+ make restart
36
+
37
+ # 进入容器
38
+ make shell
39
+
40
+ # 停止
41
+ make down
42
+
43
+ # 完全清理(删除镜像和卷)
44
+ make clean
45
+ ```
46
+
47
+ 或直接使用 Docker Compose:
48
+
49
+ ```bash
50
+ # 构建镜像
51
+ docker-compose build
52
+
53
+ # 启动服务(后台运行)
54
+ docker-compose up -d
55
+
56
+ # 查看日志
57
+ docker-compose logs -f
58
+
59
+ # 停止服务
60
+ docker-compose down
61
+ ```
62
+
63
+ 访问: http://localhost:3001
64
+
65
+ ### 开发环境
66
+
67
+ ⚠️ **重要提示**:
68
+ 1. 首次启动开发环境需要等待构建完成,期间可能看到 `Cannot find module` 错误,这是正常的
69
+ 2. 开发环境使用 volume 挂载,遇到权限问题时会自动修复
70
+ 3. 如果遇到权限错误(EACCES),容器会自动修复权限(通过 entrypoint.sh)
71
+
72
+ ```bash
73
+ # 启动开发环境(带热重载)
74
+ make dev
75
+
76
+ # 查看日志
77
+ make logs-dev
78
+
79
+ # 进入容器
80
+ make shell-dev
81
+
82
+ # 重启开发环境
83
+ make restart-dev
84
+
85
+ # 重新构建并启动
86
+ make rebuild-dev
87
+ ```
88
+
89
+ 或直接使用 Docker Compose:
90
+
91
+ ```bash
92
+ # 构建并启动开发环境
93
+ docker-compose -f docker-compose.dev.yml up --build
94
+
95
+ # 后台运行
96
+ docker-compose -f docker-compose.dev.yml up -d --build
97
+
98
+ # 查看日志
99
+ docker-compose -f docker-compose.dev.yml logs -f
100
+
101
+ # 停止
102
+ docker-compose -f docker-compose.dev.yml down
103
+ ```
104
+
105
+ ### Docker 命令速查
106
+
107
+ ```bash
108
+ # 查看所有可用命令
109
+ make help
110
+
111
+ # 生产环境
112
+ make build # 构建镜像
113
+ make prod # 启动生产环境
114
+ make logs # 查看日志
115
+ make restart # 重启容器
116
+ make shell # 进入容器
117
+ make down # 停止容器
118
+
119
+ # 开发环境
120
+ make build-dev # 构建开发镜像
121
+ make dev # 启动开发环境
122
+ make logs-dev # 查看开发日志
123
+ make restart-dev # 重启开发容器
124
+ make shell-dev # 进入开发容器
125
+
126
+ # 通用命令
127
+ make clean # 清理所有资源(镜像、卷等)
128
+ make rebuild # 重新构建并启动生产环境
129
+ make rebuild-dev # 重新构建并启动开发环境
130
+ ```
131
+
132
+ ### 环境变量
133
+
134
+ 可在 `docker-compose.yml` 或 `docker-compose.dev.yml` 中配置环境变量:
135
+
136
+ - `NODE_ENV`: 运行环境 (production/development)
137
+ - `PORT`: 服务端口 (默认 3001)
@@ -34,4 +34,4 @@ volumes:
34
34
 
35
35
  networks:
36
36
  nsbp-network:
37
- driver: bridge
37
+ driver: bridge
@@ -21,4 +21,4 @@ services:
21
21
 
22
22
  networks:
23
23
  nsbp-network:
24
- driver: bridge
24
+ driver: bridge
@@ -0,0 +1,77 @@
1
+ #!/bin/bash
2
+
3
+ # 开发环境验证脚本
4
+
5
+ echo "========================================="
6
+ echo "Docker 开发环境验证"
7
+ echo "========================================="
8
+ echo ""
9
+
10
+ GREEN='\033[0;32m'
11
+ RED='\033[0;31m'
12
+ NC='\033[0m'
13
+
14
+ # 检查容器状态
15
+ echo "1. 检查容器状态..."
16
+ if docker ps | grep -q "nsbp-app-dev"; then
17
+ echo -e "${GREEN}✅ 容器正在运行${NC}"
18
+ else
19
+ echo -e "${RED}❌ 容器未运行${NC}"
20
+ echo ""
21
+ echo "启动命令:"
22
+ echo " make dev"
23
+ echo " docker-compose -f docker-compose.dev.yml up -d --build"
24
+ exit 1
25
+ fi
26
+
27
+ echo ""
28
+ echo "2. 检查服务是否可访问..."
29
+ HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:3001)
30
+ if [ "$HTTP_CODE" = "200" ]; then
31
+ echo -e "${GREEN}✅ 服务可访问 (HTTP $HTTP_CODE)${NC}"
32
+ else
33
+ echo -e "${RED}❌ 服务不可访问 (HTTP $HTTP_CODE)${NC}"
34
+ fi
35
+
36
+ echo ""
37
+ echo "3. 检查权限错误..."
38
+ if docker-compose -f docker-compose.dev.yml logs 2>&1 | grep -q "EACCES"; then
39
+ echo -e "${RED}❌ 发现权限错误${NC}"
40
+ echo ""
41
+ echo "最近的权限错误:"
42
+ docker-compose -f docker-compose.dev.yml logs | grep "EACCES" | tail -3
43
+ else
44
+ echo -e "${GREEN}✅ 未发现权限错误${NC}"
45
+ fi
46
+
47
+ echo ""
48
+ echo "4. 检查构建状态..."
49
+ if docker-compose -f docker-compose.dev.yml logs 2>&1 | grep -q "compiled successfully"; then
50
+ echo -e "${GREEN}✅ 构建完成${NC}"
51
+ else
52
+ echo -e "${YELLOW}⚠️ 构建中或未开始${NC}"
53
+ fi
54
+
55
+ echo ""
56
+ echo "5. 检查服务器监听..."
57
+ if docker-compose -f docker-compose.dev.yml logs 2>&1 | grep -q "listening"; then
58
+ echo -e "${GREEN}✅ 服务器正在监听${NC}"
59
+ else
60
+ echo -e "${YELLOW}⚠️ 服务器尚未启动监听${NC}"
61
+ fi
62
+
63
+ echo ""
64
+ echo "========================================="
65
+ echo -e "${GREEN}验证完成!${NC}"
66
+ echo "========================================="
67
+ echo ""
68
+ echo "访问应用:"
69
+ echo " http://localhost:3001"
70
+ echo ""
71
+ echo "查看日志:"
72
+ echo " docker-compose -f docker-compose.dev.yml logs -f"
73
+ echo ""
74
+ echo "停止服务:"
75
+ echo " make down"
76
+ echo " docker-compose -f docker-compose.dev.yml down"
77
+ echo ""
@@ -347,7 +347,7 @@ export const getPhotoMenu = (req: any, res: any) => {
347
347
  <QuickStartGrid>
348
348
  <QuickStartCard>
349
349
  <QuickStartTitle>1️⃣ 创建项目</QuickStartTitle>
350
- <QuickStartCode>$ npx nsbp create my-app</QuickStartCode>
350
+ <QuickStartCode>$ npx nsbp-cli create my-app</QuickStartCode>
351
351
  <QuickStartDescription>
352
352
  使用 CLI 工具创建新项目
353
353
  </QuickStartDescription>