如何在Golang工程中集成Drone作为轻量级自托管自动化构建器-Golang-PHP中文网

根本原因是drone默认不设置gopath且克隆路径不在$gopath/src下，同时未启用go111module=on，导致go build沿gopath查找失败；解决方式是统一配置go111module=on、go mod download，并正确设置workspace路径以匹配模块结构。

如何在golang工程中集成drone作为轻量级自托管自动化构建器

Drone 能直接替代 Jenkins 做 Golang 工程的 CI/CD，但必须用对 Runner 类型、.drone.yml 结构和 GOPATH 配置，否则 go build 会报找不到包或 go test 失败。

为什么 Golang 项目在 Drone 中常出现 `cannot find package` 错误

根本原因不是代码问题，而是 Drone 默认不自动设置 GOPATH 或模块路径。Golang 1.11+ 虽支持 module，但 Drone 的 golang 镜像（如 golang:1.21）默认仍以 GOPATH 模式运行，且工作目录不是 $GOPATH/src 下的合法路径。

Drone 克隆代码到 /drone/src/xxx，但该路径不在 $GOPATH/src 内 → go build 找不到本地依赖
未显式启用 Go modules（GO111MODULE=on）→ 仍尝试走 GOPATH 查找
多模块项目（含 replace 或 require ./submodule）时，路径解析更易出错

解决方式不是改镜像，而是统一用 GO111MODULE=on + 显式 go mod download：

pipeline:
  test:
    image: golang:1.21
    commands:
      - export GO111MODULE=on
      - go mod download
      - go test -v ./...

`.drone.yml` 中 workspace 配置对 Golang 构建的实际影响

workspace 不是可选项，而是 Golang 项目稳定构建的关键开关。它控制源码挂载位置和跨步骤共享路径，直接影响 go build 输出、go install 二进制存放、以及 go run 调试是否可用。

不配 workspace：每次 step 都在全新容器中，go build -o bin/app 生成的文件在 step 结束后即销毁
配了但 path 错误（如写成 path: src/github.com/user/repo）：Drone 会把代码克隆到该子路径，但 go mod init 初始化的 module 名可能不匹配，导致 import 解析失败
推荐配置（适配标准 Go module 结构）：

workspace:
  base: /go
  path: src/github.com/your-org/your-repo
<p>pipeline:
build:
image: golang:1.21
commands:</p>

export GO111MODULE=on
go build -o bin/your-app .
这样 /go/src/github.com/your-org/your-repo 就是合法 GOPATH 路径，同时兼容 module 模式。

Golang Spf13 Viper
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

如何让 Drone Runner 正确执行 `go install` 并保留二进制

go install 默认把可执行文件放到 $GOPATH/bin，而 Drone 容器退出后该目录就没了。若想复用构建产物（比如后续 step 用 your-app --version），必须显式指定 -o 或改 GOBIN。

错误写法（产物丢失）：go install ./cmd/your-app
正确写法（输出到 workspace 可共享路径）：go build -o bin/your-app ./cmd/your-app
或统一设置 GOBIN（需确保 bin/ 目录存在）：

- mkdir -p bin
- export GOBIN=$PWD/bin
- go install ./cmd/your-app

注意：Drone 的 volume 挂载只在单个 pipeline 内有效，跨 pipeline（如从 build 到 deploy）仍需用 docker build 打包或 rsync 推送。

Golang 构建后如何安全地部署到远程服务器（不用 Docker）

很多 Golang 项目最终只需一个静态二进制，直接 rsync 部署最轻量。但 Drone 默认不带 rsync 或 SSH key，必须手动注入。

用 plugins/rsync 插件最稳妥（官方维护，支持密钥加密）：

deploy:
  image: plugins/rsync
  settings:
    host: your-server.com
    user: deploy
    port: 22
    source: bin/your-app
    target: /opt/your-app/bin/
    secrets: [ ssh_key ]

自己写脚本也行，但必须用 from_secret 注入密钥，不能硬编码：

- echo "$$SSH_KEY" > /tmp/id_rsa
- chmod 600 /tmp/id_rsa
- rsync -avz -e "ssh -i /tmp/id_rsa -o StrictHostKeyChecking=no" bin/your-app deploy@your-server.com:/opt/your-app/bin/

这里 $$SSH_KEY 是 Drone secret，需提前通过 UI 或 CLI 添加，且变量名大小写敏感、不能含下划线。

真正容易被忽略的是：Golang 二进制的 CGO_ENABLED 默认为 1，如果目标服务器没装 libc 或 musl，rsync 过去会直接报 not found —— 记得加 CGO_ENABLED=0 编译，尤其是部署到 Alpine 容器或极简 Linux 环境时。