GitLab CI/CD自动化部署Golang项目

最近在尝试用GitLab CI/CD自动化部署Golang项目，但在配置过程中遇到一些问题想请教大家：

如何正确配置.gitlab-ci.yml文件来编译和部署Golang项目？
在Docker容器中运行Golang项目时，如何设置合适的基础镜像和构建步骤？
测试阶段应该包含哪些必要的检查？单元测试和集成测试该如何配置？
部署到不同环境(开发/测试/生产)时，如何管理不同的环境变量和配置？
有什么推荐的优化技巧可以加快CI/CD管道的执行速度？

希望能得到有实际GitLab CI/CD部署Golang项目经验的朋友的指导，谢谢！

bupafengyu 1楼

好的，兄弟，要搞GitLab CI/CD来自动部署你的Go项目，这事儿不难。给你整一个最核心的.gitlab-ci.yml配置文件，照着改就行。

1. 配置文件示例：

# 定义流水线阶段
stages:
  - test
  - build
  - deploy

# 全局变量，比如你的Go版本
variables:
  GO_VERSION: "1.21"

# 在构建之前运行的脚本，比如设置Go环境
before_script:
  - apt-get update -qq
  - apt-get install -y git
  - curl -sL https://dl.google.com/go/go$GO_VERSION.linux-amd64.tar.gz | tar -C /usr/local -xz
  - export PATH=/usr/local/go/bin:$PATH

# 阶段1：测试
test:
  stage: test
  script:
    - go test -v ./... # 运行所有测试

# 阶段2：构建Linux二进制文件
build:
  stage: build
  script:
    - go build -o myapp # 编译生成可执行文件 'myapp'
  artifacts:
    paths:
      - myapp # 将编译产物传递给后续阶段
    expire_in: 1 hour # 产物保留1小时

# 阶段3：部署（示例：通过SSH部署到服务器）
deploy:
  stage: deploy
  script:
    - echo "开始部署到服务器..."
    - 'which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )'
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add - # 使用SSH私钥
    - mkdir -p ~/.ssh
    - chmod 700 ~/.ssh
    - ssh-keyscan your-server-ip >> ~/.ssh/known_hosts
    - scp myapp user@your-server-ip:/path/to/deploy/ # 传输文件
    - ssh user@your-server-ip "cd /path/to/deploy/ && ./myapp &" # 远程启动应用
  only:
    - main # 只有main分支的提交才会触发部署

2. 关键点说明：

SSH私钥：你需要把服务器的SSH私钥（无密码的）存为GitLab的CI/CD变量，变量名设为 SSH_PRIVATE_KEY。这是安全连接服务器的关键。
服务器信息：把脚本里的 your-server-ip、user 和 /path/to/deploy/ 换成你实际的服务器信息。
流程：一推代码，GitLab就会自动跑测试 -> 编译 -> 部署。稳得很。

搞定这些，你的Go项目就能实现基本的自动化部署了。快去试试吧！

更多关于GitLab CI/CD自动化部署Golang项目的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html

nodeper 2楼

以下是使用 GitLab CI/CD 自动化部署 Golang 项目的步骤和示例配置：

1. 创建 `.gitlab-ci.yml` 文件

在项目根目录创建此文件，定义 CI/CD 流水线。

2. 示例配置

stages:
  - test
  - build
  - deploy

# 测试阶段
test:
  stage: test
  image: golang:1.19  # 使用官方 Go 镜像
  script:
    - go test ./...    # 运行所有测试
  only:
    - main            # 仅 main 分支触发

# 构建阶段
build:
  stage: build
  image: golang:1.19
  script:
    - go build -o myapp  # 编译生成二进制文件
  artifacts:
    paths:
      - myapp           # 保存构建产物
  only:
    - main

# 部署阶段（示例：SSH 部署）
deploy:
  stage: deploy
  image: alpine
  before_script:
    - apk add --no-cache openssh-client  # 安装 SSH 客户端
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -  # 添加 SSH 私钥
    - mkdir -p ~/.ssh
    - chmod 700 ~/.ssh
  script:
    - scp -o StrictHostKeyChecking=no myapp user@server:/app/  # 传输文件
    - ssh -o StrictHostKeyChecking=no user@server "systemctl restart myapp"  # 重启服务
  only:
    - main

3. 关键配置说明

环境变量：在 GitLab 项目的 Settings > CI/CD > Variables 中设置：
- SSH_PRIVATE_KEY：服务器 SSH 私钥。
依赖管理：Go 模块需提前配置 go.mod。
多阶段：测试、构建、部署分离，确保流程清晰。

4. 优化建议

使用 Docker 镜像 提升构建速度（如自定义包含依赖的镜像）。
添加 缓存配置 避免重复下载依赖：
```
cache:
  paths:
    - go/pkg/mod
```
部署时可集成 Kubernetes 或 云平台工具（如 AWS CodeDeploy）。

5. 验证流程

提交代码到 main 分支后，GitLab 将自动触发流水线，在 CI/CD > Pipelines 中查看状态。