ambiguous-pointer commented on issue #1646:
URL: https://github.com/apache/dubbo-admin/issues/1646#issuecomment-6877573171
## 解决方案思路
先定清楚 **Go 版本的发布产物形态**,再改 Makefile 与 workflow。Java 版是 `dubbo-admin` +
`dubboctl` + `dubbo-cp` 三个 assembly,Go 重写把它们合并成了单个 `dubbo-admin`
二进制(`app/dubbo-admin/cmd/run.go`),workflow 还没跟上。
### 第 1 步:定形态(需要先拍板)
两种走向:
- **A(推荐):只出一个 `dubbo-admin` 二进制**。`dubboctl` / `dubbo-cp` 的能力以子命令形式并入
`dubbo-admin`(如 `dubbo-admin ctl` / `dubbo-admin cp`)。发布资产变成单一
tarball/zip,结构最简单,也和当前代码实际产物一致。
- **B:保留三个产物**。那就需要三个独立的 `main` 包或三个构建 target,且每个都要有真实实现——当前 Go 代码里**没有**
`dubboctl` / `dubbo-cp` 的实现,工作量远大于 A。
无论选哪种,**结论都是「产物不再是 `dubboctl` / `dubbo-cp`」**,所以 workflow 必须改。
### 第 2 步:补 Makefile 的 build target
`Makefile` 新增:
```make
GIT_VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null ||
echo dev)
LDFLAGS := -X main.Version=$(GIT_VERSION)
.PHONY: build
build:
mkdir -p bin
CGO_ENABLED=0 GOOS=$(GOOS) GOARCH=$(GOARCH) \
go build -ldflags "$(LDFLAGS)" -o bin/dubbo-admin
./app/dubbo-admin
```
如果选 A 并保留子命令形态,则再拆出 `build-dubboctl` / `build-dubbo-cp` 两个 target 分别产出
`bin/dubboctl` / `bin/dubbo-cp`,**但必须确认这两个二进制真的存在**——不能只是把 workflow 的名字对上。
顺带补上 `scripts/resourcegen` 生成代码头部里写的 `make generate` 目标(当前 Makefile 同样没有它)。
### 第 3 步:改 release.yaml 的 Build binary 步骤
```yaml
- name: Build binary
env:
GOOS: ${{ matrix.goos }}
GOARCH: ${{ matrix.goarch }}
GIT_VERSION: ${{ github.ref_name }}
run: |
mkdir -p build/
make build-dubbo-admin GOOS=${GOOS} GOARCH=${GOARCH}
GIT_VERSION=${GIT_VERSION}
cp README.md LICENSE build/
mv bin/dubbo-admin* build/
ls -ln build/
```
`mv bin/dubboctl*` / `mv bin/dubbo-cp*` 这两行必须删掉——它们的通配符在新形态下匹配不到任何文件。
windows 的重命名步骤也要跟着改:
```yaml
- name: Rename windows
if: matrix.goos == 'windows'
run: |
mv build/dubbo-admin build/dubbo-admin.exe
```
### 第 4 步:补上镜像构建(当前完全没有)
`ci.yml` 里没有 Docker 构建/推送步骤,所以镜像发布链路**没有任何自动化**。建议在 `ci.yml` 里加一个 job:
- 基于 `Dockerfile` 构建镜像;
- 在 `develop` 上只做构建验证(不推送),在 tag 上推送镜像到发布仓库;
- 与 release.yaml 的二进制产物分开,避免两个链路互相阻塞。
仓库已有 `Dockerfile` 与 `compose` 相关资产可以复用。
### 第 5 步:验证
这类问题只有真正跑一次才暴露,所以验证必须是**实跑**,不能靠看代码:
1. 在测试 tag(例如 `v0.0.0-rc1`)上触发 release workflow,确认 `Build binary` 步骤通过;
2. 检查产出的 tarball/zip 内容确实是 `dubbo-admin`(而不是空包或残留的 Java 时代文件名);
3. 下载产物在目标平台上跑一次 `--version` / `--help`,确认二进制可执行。
### 关联
本 Issue 来自 Java vs Go 业务能力对齐审计(`docs/java-go-business-parity.md`),是其中 8
处已验证缺陷的第 8 条。同批报告里另外 5 处业务能力缺陷(`/service/interfaces` nil handler
panic、`/instance/search` 忽略 `appName`、`QosPort` 无写入点、`/instance/metrics-list`
无前端调用方、`/service/distribution` 忽略 `side`)属于独立问题,需要各自开 Issue 跟踪。
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]