Commit 77d40f0a authored by BO ZHANG's avatar BO ZHANG 🏀
Browse files

docs: 更新构建和部署说明以简化使用流程

parent e2b2dbf1
Loading
Loading
Loading
Loading
+1 −0
Original line number Diff line number Diff line
@@ -10,6 +10,7 @@ help:
	@echo "Repo-level wrapper. Commands are executed in $(SUBDIR)/"
	@echo ""
	@echo "Common usage:"
	@echo "  make build BUILD_NUMBER=100000 HARBOR_PROJECT=harbor.csst.nao:10443/csst/"
	@echo "  make build IMAGE_TAG=test HARBOR_PROJECT=harbor.csst.nao:10443/csst/"
	@echo "  make ansible-update ENV=p368"
	@echo ""
+11 −4
Original line number Diff line number Diff line
@@ -8,17 +8,24 @@
- **构建/打包/推送镜像**使用 `make`
- **部署/升级/启停集群**使用 `make ansible-*`(内部调用 Ansible Playbook)

从源码构建并更新集群(推荐只设置 `BUILD_NUMBER` 作为统一版本号,默认也会作为镜像 tag):

```bash
# 0) 建议:先一次性设定环境变量(后续命令更简洁)
export ENV=p368
export IMAGE_TAG=test
export BUILD_NUMBER=100000
export HARBOR_PROJECT=harbor.csst.nao:10443/csst/

# 1) 构建镜像
make build
make ansible-update
```

仅部署“已经构建好的镜像”(Harbor 中已存在对应 tag):只需要 `ENV` + 镜像 tag(推荐直接复用 `BUILD_NUMBER`;也可显式设置 `IMAGE_TAG` 覆盖),以及可选的 `HARBOR_PROJECT`

```bash
export ENV=csu
export BUILD_NUMBER=100000
export HARBOR_PROJECT=csu-harbor.csst.nao:10443/csst/

# 2) 更新集群(等价于 ansible-playbook ansible/update.yml ...)
make ansible-update
```

+1 −1
Original line number Diff line number Diff line

# 镜像版本和构建相关
IMAGE_TAG ?= latest
IMAGE_TAG ?= $(if $(strip $(BUILD_NUMBER)),$(BUILD_NUMBER),latest)
BUILD_NUMBER ?= $(IMAGE_TAG)
HARBOR_PROJECT ?= 
SKIP_JS9 ?= 1