feat(server): 添加系统重启功能支持
添加后台任务支持用于处理系统重启请求,实现延迟进程终止机制, 允许系统安全地重启并在重启后自动恢复服务。 feat(frontend): 实现前端系统重启控制面板 在状态页面添加重启对话框组件,提供用户友好的重启确认界面, 包含重启状态监控和错误处理功能,确保用户可以安全重启系统。 docs(deployment): 更新部署指南添加URL协议要求说明 详细说明NANO_AUTHZ_URL和NANO_DEPLOY_URL环境变量必须包含 http://协议前缀的要求,添加常见错误示例和容器重建步骤, 帮助用户避免注册页面502错误问题。
This commit is contained in:
163
部署指南.md
163
部署指南.md
@ -149,6 +149,47 @@ export NANO_DEPLOY_URL='http://nano-deploy-control:8090'
|
||||
|
||||
如果这里不填,新用户注册时虽然页面可能能走到一半,但自动创建 `app-instance` 时大概率失败,因为实例配置里需要 `APP_INSTANCE_API_KEY`。
|
||||
|
||||
`NANO_AUTHZ_URL` 和 `NANO_DEPLOY_URL` 也不能留空,而且必须带协议头。
|
||||
|
||||
正确写法:
|
||||
|
||||
```text
|
||||
http://nano-authz-service:19090
|
||||
http://nano-deploy-control:8090
|
||||
```
|
||||
|
||||
错误写法:
|
||||
|
||||
```text
|
||||
nano-authz-service:19090
|
||||
nano-deploy-control:8090
|
||||
172.19.207.13:19090
|
||||
172.19.207.13:8090
|
||||
```
|
||||
|
||||
如果这里漏了 `http://`,注册页很容易直接报:
|
||||
|
||||
```text
|
||||
502: Request URL is missing an 'http://' or 'https://' protocol.
|
||||
```
|
||||
|
||||
还有一个很容易忽略的点:
|
||||
|
||||
- 你在 shell 里重新 `export NANO_DEPLOY_URL=...`
|
||||
- 不会自动修改已经在运行中的 `nano-authz-service` 和 `nano-auth-portal`
|
||||
|
||||
也就是说:
|
||||
|
||||
- 变量改对了
|
||||
- 但容器没重建
|
||||
|
||||
注册页还是会继续报同一个 502。
|
||||
|
||||
改完变量以后,至少要重建这些容器:
|
||||
|
||||
- `nano-authz-service`
|
||||
- `nano-auth-portal`
|
||||
|
||||
---
|
||||
|
||||
## 3. 创建运行目录
|
||||
@ -271,6 +312,26 @@ http://127.0.0.1:19090
|
||||
http://nano-authz-service:19090
|
||||
```
|
||||
|
||||
`DEPLOY_API_BASE_URL` 也一样,不能空,不能只写 `host:port`。
|
||||
|
||||
这里如果传成空字符串,或者写成:
|
||||
|
||||
```text
|
||||
nano-deploy-control:8090
|
||||
```
|
||||
|
||||
注册页会在 `authz-service -> deploy-control` 这一步直接报:
|
||||
|
||||
```text
|
||||
502: Request URL is missing an 'http://' or 'https://' protocol.
|
||||
```
|
||||
|
||||
启动完可以立刻确认:
|
||||
|
||||
```bash
|
||||
docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_ISSUER|DEPLOY_API_BASE_URL)='
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 启动 `deploy-control`
|
||||
@ -344,6 +405,14 @@ docker run -d \
|
||||
|
||||
这个页面就是用户看到的登录/注册入口。
|
||||
|
||||
虽然注册入口主要依赖 `AUTHZ_API_BASE_URL`,这里还是建议把 `DEPLOY_API_BASE_URL` 一起带上并确认非空,避免后面运行态调用 deploy-control 时再踩同一个坑。
|
||||
|
||||
启动完可以确认:
|
||||
|
||||
```bash
|
||||
docker inspect nano-auth-portal --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_API_BASE_URL|DEPLOY_API_BASE_URL)='
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. 做健康检查
|
||||
@ -487,6 +556,75 @@ cd "$PROJECT_ROOT/app-instance"
|
||||
docker ps --format 'table {{.Names}}\t{{.Status}}' | grep app-instance
|
||||
```
|
||||
|
||||
如果注册页弹出:
|
||||
|
||||
```text
|
||||
502: Request URL is missing an 'http://' or 'https://' protocol.
|
||||
```
|
||||
|
||||
优先查这两条:
|
||||
|
||||
```bash
|
||||
docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_ISSUER|DEPLOY_API_BASE_URL)='
|
||||
docker inspect nano-auth-portal --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_API_BASE_URL|DEPLOY_API_BASE_URL)='
|
||||
```
|
||||
|
||||
重点看:
|
||||
|
||||
- `nano-authz-service` 里的 `DEPLOY_API_BASE_URL`
|
||||
- `nano-auth-portal` 里的 `AUTHZ_API_BASE_URL`
|
||||
|
||||
它们都必须是完整 URL,不能是空字符串,也不能是裸 `host:port`。
|
||||
|
||||
如果你已经改过 `export NANO_DEPLOY_URL=...`,但这里查出来还是空,说明你只是改了当前 shell 变量,没有把容器重建掉。
|
||||
|
||||
这时直接按下面重建:
|
||||
|
||||
```bash
|
||||
export NANO_AUTHZ_URL='http://nano-authz-service:19090'
|
||||
export NANO_DEPLOY_URL='http://nano-deploy-control:8090'
|
||||
|
||||
export NANO_DEPLOY_TOKEN="$(docker inspect nano-deploy-control --format '{{range .Config.Env}}{{println .}}{{end}}' | sed -n 's/^DEPLOY_CONTROL_API_TOKEN=//p')"
|
||||
export NANO_AUTHZ_INTERNAL_TOKEN="$(docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | sed -n 's/^AUTHZ_INTERNAL_TOKEN=//p')"
|
||||
|
||||
docker rm -f nano-authz-service >/dev/null 2>&1 || true
|
||||
docker run -d \
|
||||
--name nano-authz-service \
|
||||
--restart unless-stopped \
|
||||
--network "$NANO_NET" \
|
||||
-p 19090:19090 \
|
||||
-v "$PROJECT_ROOT/authz-service/runtime/data:/var/lib/authz-service/data" \
|
||||
-e AUTHZ_ISSUER="$NANO_AUTHZ_URL" \
|
||||
-e AUTHZ_INTERNAL_TOKEN="$NANO_AUTHZ_INTERNAL_TOKEN" \
|
||||
-e DEPLOY_API_BASE_URL="$NANO_DEPLOY_URL" \
|
||||
-e DEPLOY_API_TOKEN="$NANO_DEPLOY_TOKEN" \
|
||||
nano/authz-service:latest
|
||||
|
||||
docker rm -f nano-auth-portal >/dev/null 2>&1 || true
|
||||
docker run -d \
|
||||
--name nano-auth-portal \
|
||||
--restart unless-stopped \
|
||||
--network "$NANO_NET" \
|
||||
-p 3081:3081 \
|
||||
-e AUTHZ_API_BASE_URL="$NANO_AUTHZ_URL" \
|
||||
-e DEPLOY_API_BASE_URL="$NANO_DEPLOY_URL" \
|
||||
-e DEPLOY_API_TOKEN="$NANO_DEPLOY_TOKEN" \
|
||||
nano/auth-portal:latest
|
||||
```
|
||||
|
||||
重建后再确认:
|
||||
|
||||
```bash
|
||||
docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_ISSUER|DEPLOY_API_BASE_URL)='
|
||||
docker inspect nano-auth-portal --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_API_BASE_URL|DEPLOY_API_BASE_URL)='
|
||||
```
|
||||
|
||||
你必须看到:
|
||||
|
||||
```text
|
||||
DEPLOY_API_BASE_URL=http://nano-deploy-control:8090
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 15. 最常见的坑
|
||||
@ -539,7 +677,28 @@ http://nano-authz-service:19090
|
||||
- `APP_INSTANCE_DIR="$PROJECT_ROOT/app-instance"`
|
||||
- `ROUTER_PROXY_DIR="$PROJECT_ROOT/router-proxy"`
|
||||
|
||||
### 5. `nip.io` 解析失败
|
||||
### 5. `NANO_DEPLOY_URL` 或 `NANO_AUTHZ_URL` 没带 `http://`
|
||||
|
||||
典型现象:
|
||||
|
||||
- 注册页直接弹:
|
||||
- `502: Request URL is missing an 'http://' or 'https://' protocol.`
|
||||
|
||||
原因:
|
||||
|
||||
- `authz-service` 用 `DEPLOY_API_BASE_URL` 去调 `deploy-control`
|
||||
- `auth-portal` 用 `AUTHZ_API_BASE_URL` 去调 `authz-service`
|
||||
- 这些值如果是空,或者写成 `nano-deploy-control:8090` 这种不带协议的字符串,请求会直接失败
|
||||
- 就算你后来在 shell 里改对了,如果没重建相关容器,老的错误值仍然会继续生效
|
||||
|
||||
正确写法:
|
||||
|
||||
```text
|
||||
http://nano-authz-service:19090
|
||||
http://nano-deploy-control:8090
|
||||
```
|
||||
|
||||
### 6. `nip.io` 解析失败
|
||||
|
||||
如果实例跳转地址打不开,先试:
|
||||
|
||||
@ -549,7 +708,7 @@ ping 127.0.0.1.nip.io
|
||||
|
||||
如果你本地网络把 `nip.io` 拦了,这套子域名测试方式就会失效。
|
||||
|
||||
### 6. 端口被占用
|
||||
### 7. 端口被占用
|
||||
|
||||
默认会用到这些端口:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user