在小型团队(一般8人以下)中,引入庞大的 DevOps 工具链(如 GitLab + Jenkins + Kubernetes)往往会导致“工具维护成本高于业务开发成本”。对于小团队而言,轻量、够用、易维护才是核心诉求。
以下将基于 Debian 13 操作系统,以 Gitea 最新稳定版 为核心,为你梳理一套完整的 DevOps 最小化 SOP(标准作业程序)。我们将从选型、安装、分支规范,一直走到 PHP 和 Golang 项目的自动化 SSH 部署,全程不依赖 Docker,回归最纯粹的 Git + SSH 部署模式。
一、 为什么选择 Gitea?(选型分析)
对于8人以下的小型团队,Gitea 是当之无愧的“性价比之王”:
- 极致轻量:单个二进制文件,内存占用极低,在 1核2G 的廉价 VPS 上即可流畅运行。
- 功能够用:支持 Issues、Milestones、Wiki、PR 审查,满足日常研发管理。
- 原生 CI/CD:内置 Gitea Actions(兼容 GitHub Actions 语法),无需额外搭建 Jenkins,直接在代码仓库内完成流水线配置。
- 部署极简:无需复杂的容器编排,直接 SSH 部署到目标服务器,对小团队的前后端项目极其友好。
二、 基础设施准备与 Gitea 部署 (Debian 13)
1. 系统更新与基础依赖
1 2
| sudo apt update && sudo apt upgrade -y sudo apt install -y git nginx sqlite3 wget
|
2. 安装 Gitea 最新稳定版
前往 Gitea 官网获取最新稳定版(如 1.23.x 或 1.24.x)的二进制文件。
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git
wget -O /tmp/gitea https://dl.gitea.com/gitea/1.23/gitea-1.23.0-linux-amd64 sudo mv /tmp/gitea /usr/local/bin/gitea sudo chmod +x /usr/local/bin/gitea
sudo mkdir -p /var/lib/gitea/{custom,data,log} sudo chown -R git:git /var/lib/gitea/ sudo mkdir -p /etc/gitea sudo chown -R root:git /etc/gitea sudo chmod 770 /etc/gitea
|
3. 配置 Systemd 服务
创建 /etc/systemd/system/gitea.service:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
| [Unit] Description=Gitea (Git with a cup of tea) After=syslog.target After=network.target
[Service] Type=simple User=git Group=git WorkingDirectory=/var/lib/gitea/ ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini Restart=always Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
[Install] WantedBy=multi-user.target
|
启动服务:
1 2
| sudo systemctl daemon-reload sudo systemctl enable --now gitea
|
4. 配置 Nginx 反向代理与 HTTPS
创建 /etc/nginx/sites-available/gitea:
1 2 3 4 5 6 7 8 9 10 11 12
| server { listen 80; server_name git.yourdomain.com;
location / { proxy_pass http://127.0.0.1:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }
|
启用站点并使用 Certbot 申请 Let’s Encrypt 证书(略去具体 certbot 命令,确保开启 HTTPS 以保障 Actions 通信安全)。
5. 启用 Gitea Actions
在初始化 Gitea Web 界面后,编辑 /etc/gitea/app.ini,添加以下配置以开启 Actions:
1 2
| [actions] ENABLED = true
|
重启 Gitea:sudo systemctl restart gitea。
三、 小型团队 DevOps 最小化 SOP 与分支规范
对于小团队,我们采用简化版 GitFlow,严格映射三套环境。
1. 分支与环境映射
| 分支名称 | 对应环境 | 触发部署 | 说明 |
|---|
dev | 开发环境 (Dev) | 合并入 dev 时 | 开发人员日常联调、功能开发。 |
test | 测试环境 (Test) | 合并入 test 时 | QA 介入测试,验收功能。 |
prod | 生产环境 (Prod) | 合并入 prod 时 | 正式发布,面向最终用户。 |
2. 提交规范 (Conventional Commits)
强制要求 Commit Message 遵循规范,便于后续生成 Changelog:
feat: 新增用户登录功能fix: 修复订单金额计算错误docs: 更新 API 文档
3. 分支保护与 PR 流程 (SOP)
在 Gitea 仓库设置中,为 dev、test、prod 开启分支保护:
- 禁止直接 Push:所有分支必须通过 Pull Request (PR) 合并。
- 合并策略:推荐使用
Squash and merge(压缩合并),保持主干提交历史整洁。 - 流转 SOP:
- 开发从
dev 切出 feature/xxx 分支,开发完成后 PR 到 dev。 dev 验证通过后,由 Tech Lead 发起 PR 将 dev 合并到 test。test 验收通过后,发起 PR 将 test 合并到 prod,触发生产部署。
四、 配置 Gitea Actions Runner 与 SSH 免密
为了实现“无需 Docker,直接 SSH 部署”,我们需要在 Gitea 服务器上安装 Runner,并配置到目标服务器的 SSH 免密登录。
1. 安装 act_runner
1 2 3 4 5 6 7
| wget -O /tmp/act_runner https://dl.gitea.com/act_runner/0.2.11/act_runner-0.2.11-linux-amd64 sudo mv /tmp/act_runner /usr/local/bin/act_runner sudo chmod +x /usr/local/bin/act_runner
sudo act_runner register --instance http://127.0.0.1:3000 --token <YOUR_TOKEN> --name local-runner
|
配置 Runner 使用 host 模式(不依赖 Docker),编辑 ~/.act_runner/config.yaml,将 container 相关配置注释或禁用,确保命令直接在宿主机执行。
2. 配置 SSH 密钥与 Secrets
在 Gitea 服务器上生成 SSH 密钥,并将公钥添加到目标部署服务器的 ~/.ssh/authorized_keys 中。
1
| ssh-keygen -t ed25519 -C "gitea-deploy" -f /home/git/.ssh/id_ed25519 -N ""
|
在 Gitea 仓库的 Settings -> Secrets and variables -> Actions 中,添加以下 Secrets:
SERVER_IP: 目标服务器 IPSERVER_USER: 目标服务器用户名 (如 deploy)SSH_PRIVATE_KEY: 刚才生成的私钥内容 (cat /home/git/.ssh/id_ed25519)
五、 实战一:PHP 项目从提交到部署
1. 项目结构
1 2 3 4 5
| php-app/ ├── index.php └── .gitea/ └── workflows/ └── deploy.yml
|
index.php:
1 2 3
| <?php echo "Hello from PHP DevOps Pipeline!"; ?>
|
2. Gitea Actions Workflow (纯 SSH/Rsync)
在 .gitea/workflows/deploy.yml 中配置流水线。我们使用原生的 rsync 和 ssh,不引入任何第三方 Action,做到极致轻量。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
| name: Deploy PHP App
on: push: branches: - dev - test - prod
jobs: deploy: runs-on: ubuntu-latest steps: - name: Checkout Code uses: actions/checkout@v4
- name: Set Environment Variables id: env_setup run: | if [[ "${{ github.ref }}" == "refs/heads/dev" ]]; then echo "DEPLOY_PATH=/var/www/php-dev" >> $GITHUB_ENV echo "PHP_FPM=php8.2-fpm" >> $GITHUB_ENV elif [[ "${{ github.ref }}" == "refs/heads/test" ]]; then echo "DEPLOY_PATH=/var/www/php-test" >> $GITHUB_ENV echo "PHP_FPM=php8.2-fpm" >> $GITHUB_ENV else echo "DEPLOY_PATH=/var/www/php-prod" >> $GITHUB_ENV echo "PHP_FPM=php8.2-fpm" >> $GITHUB_ENV fi
- name: Deploy via SSH and Rsync run: | # 配置 SSH 密钥 mkdir -p ~/.ssh echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_ed25519 chmod 600 ~/.ssh/id_ed25519 ssh-keyscan -H ${{ secrets.SERVER_IP }} >> ~/.ssh/known_hosts rsync -avz --delete --exclude='.git' -e "ssh -i ~/.ssh/id_ed25519" ./ ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }}:${{ env.DEPLOY_PATH }}/ ssh -i ~/.ssh/id_ed25519 ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} "sudo systemctl reload ${{ env.PHP_FPM }}"
|
六、 实战二:Golang 项目从提交到部署
1. 极简 Web 代码
main.go:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| package main
import ( "fmt" "net/http" )
func main() { http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { fmt.Fprintln(w, "hello Jaco Liu") }) fmt.Println("Server starting on :8080...") http.ListenAndServe(":8080", nil) }
|
2. 目标服务器 Systemd 配置
在目标服务器上创建 /etc/systemd/system/go-app.service:
1 2 3 4 5 6 7 8 9 10 11 12 13
| [Unit] Description=Go Hello Jaco Liu App After=network.target
[Service] Type=simple User=deploy WorkingDirectory=/opt/go-app ExecStart=/opt/go-app/main Restart=on-failure
[Install] WantedBy=multi-user.target
|
3. Gitea Actions Workflow (编译 + SSH 部署)
.gitea/workflows/deploy.yml:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
| name: Deploy Go App
on: push: branches: - dev - test - prod
jobs: build-and-deploy: runs-on: ubuntu-latest steps: - name: Checkout Code uses: actions/checkout@v4
- name: Setup Go uses: actions/setup-go@v5 with: go-version: '1.22'
- name: Build Binary run: | go mod tidy CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o main .
- name: Deploy via SSH run: | mkdir -p ~/.ssh echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_ed25519 chmod 600 ~/.ssh/id_ed25519 ssh-keyscan -H ${{ secrets.SERVER_IP }} >> ~/.ssh/known_hosts if [[ "${{ github.ref }}" == "refs/heads/dev" ]]; then REMOTE_DIR="/opt/go-app-dev" elif [[ "${{ github.ref }}" == "refs/heads/test" ]]; then REMOTE_DIR="/opt/go-app-test" else REMOTE_DIR="/opt/go-app-prod" fi ssh -i ~/.ssh/id_ed25519 ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} "mkdir -p $REMOTE_DIR" rsync -avz -e "ssh -i ~/.ssh/id_ed25519" main ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }}:$REMOTE_DIR/main SERVICE_NAME="go-app-$(echo ${{ github.ref }} | awk -F'/' '{print $3}')" ssh -i ~/.ssh/id_ed25519 ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} "sudo systemctl restart $SERVICE_NAME"
|
七、关于项目环境变量的配置和管理
在上一篇文章中,我们完成了 Gitea 的基础搭建与最基础的 SSH 部署流水线。但在实际研发中,“代码与配置分离” 是 DevOps 的铁律。
对于 8 人以下的小型团队,最容易踩的坑就是:为了图方便,把数据库密码、第三方 API Key 直接硬编码在代码里,或者在每次部署到 dev/test/prod 时,手动去服务器上修改配置文件。这不仅带来了极大的安全隐患,也导致了部署效率低下和人为错误。
本文将作为进阶补充,深入探讨在 Gitea 体系下,如何优雅、安全地管理多环境的部署配置与变量。
1. Gitea 的解决方案:Secrets 与 Variables 体系
Gitea(特别是 1.20 版本之后)引入了非常完善的 Environments(环境) 概念,配合 Secrets(机密) 和 Variables(变量),完美契合了小型团队对 dev/test/prod 三套环境的隔离需求。
1.1. 核心概念区分
| 类型 | 适用场景 | 在 Workflow 中的表现 | 示例 |
|---|
| Secrets (机密) | 敏感信息,绝对不可明文出现在代码或日志中。 | ${{ secrets.MY_SECRET }} (Gitea 会自动在日志中打码 ***) | DB 密码、OSS 密钥、SSH 私钥、微信支付 Key |
| Variables (变量) | 非敏感的配置项,不同环境值不同,明文可见。 | ${{ vars.MY_VAR }} | API 基础域名、前端 CDN 地址、环境标识符 |
1.2 利用 Environments (环境) 实现精细化隔离
在 Gitea 仓库的 Settings -> Environments 中,你可以创建 dev、test、prod 三个环境。
核心优势:你可以为每个环境配置独立的 Secrets 和 Variables。
- Dev 环境:配置测试库密码、测试域名。
- Prod 环境:配置生产库密码、正式域名。甚至可以配置部署保护规则(例如:部署到 prod 必须经过 Tech Lead 审批)。
2. 实战:Workflow 中的多环境配置注入
让我们改造上一篇中的 .gitea/workflows/deploy.yml,将配置管理融入其中。
2.1 在 Gitea 后台配置数据
假设我们有一个 PHP 项目,需要配置数据库和 API 地址。
- Environments -> dev:
- Secrets:
DB_PASSWORD = dev_pass_123 - Variables:
API_BASE_URL = https://dev-api.example.com
- Environments -> prod:
- Secrets:
DB_PASSWORD = Pr0d_Str0ng_P@ss! - Variables:
API_BASE_URL = https://api.example.com
2.2 改造 Workflow 文件
通过指定 environment,Gitea Actions 会自动加载对应环境的 Secrets 和 Variables。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
| name: Deploy PHP App with Config
on: push: branches: - dev - test - prod
jobs: deploy: runs-on: ubuntu-latest environment: ${{ github.ref_name }} steps: - name: Checkout Code uses: actions/checkout@v4
- name: Prepare Environment File (.env) run: | # 在 CI 运行器本地生成 .env 文件 # 注意:这里使用了 vars (明文) 和 secrets (密文) cat <<EOF > .env APP_ENV=${{ github.ref_name }} API_BASE_URL=${{ vars.API_BASE_URL }} DB_HOST=127.0.0.1 DB_USER=myapp DB_PASSWORD=${{ secrets.DB_PASSWORD }} EOF echo "--- Generated .env ---" cat .env
- name: Deploy via SSH run: | mkdir -p ~/.ssh echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_ed25519 chmod 600 ~/.ssh/id_ed25519 rsync -avz --delete --exclude='.git' --exclude='.env' -e "ssh -i ~/.ssh/id_ed25519" ./ ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }}:/var/www/php-${{ github.ref_name }}/ rsync -avz -e "ssh -i ~/.ssh/id_ed25519" .env ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }}:/var/www/php-${{ github.ref_name }}/.env ssh -i ~/.ssh/id_ed25519 ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} "chmod 600 /var/www/php-${{ github.ref_name }}/.env && chown www-data:www-data /var/www/php-${{ github.ref_name }}/.env" ssh -i ~/.ssh/id_ed25519 ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} "sudo systemctl reload php8.2-fpm"
|
3. Golang 项目的配置落地方案
对于 Golang 项目,通常不使用 .env 文件,而是直接读取系统环境变量,或者使用 godotenv 等库。在 SSH 部署场景下,我们有两种优雅的做法:
方案 A:在目标服务器生成 .env (推荐,与 PHP 保持一致)
Go 代码中使用 github.com/joho/godotenv 库加载 .env。Workflow 的部署步骤与上述 PHP 完全一致,将 .env 文件 rsync 过去即可。
方案 B:通过 SSH 注入 Systemd 环境变量 (更纯粹的 Go 做法)
如果不使用 .env,Go 代码直接 os.Getenv("API_BASE_URL")。我们可以通过 SSH 动态修改目标服务器的 Systemd 配置文件。
在目标服务器准备一个模板 /etc/systemd/system/go-app@.service(使用 @ 支持多实例):
1 2 3
| [Service]
EnvironmentFile=/opt/go-app-%i/env.conf
|
在 Gitea Workflow 中:
1 2 3 4 5 6 7 8 9 10 11 12
| - name: Inject Env to Target Server run: | # 通过 SSH 直接在目标服务器生成 env.conf ssh -i ~/.ssh/id_ed25519 ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} << 'ENDSSH' cat <<EOF > /opt/go-app-${{ github.ref_name }}/env.conf APP_ENV=${{ github.ref_name }} API_BASE_URL=${{ vars.API_BASE_URL }} DB_PASSWORD=${{ secrets.DB_PASSWORD }} EOF systemctl daemon-reload systemctl restart go-app@${{ github.ref_name }} ENDSSH
|
注:这里使用了 SSH 的 Here-Doc 语法,直接在目标服务器执行命令,避免了在 CI 本地生成文件再传输的繁琐。
4. 小型团队配置管理的“避坑指南” (注意事项)
在落地上述方案时,小团队务必遵守以下纪律,否则 DevOps 将变成“DevOops”:
4.1 严防死守 .gitignore
这是最重要的一条! 必须在项目根目录的 .gitignore 中严格排除所有配置文件:
1 2 3 4 5
| # 绝对禁止提交 .env *.pem *.key config.local.php
|
建议:在仓库中保留一个 .env.example 或 config.example.php,里面只写 Key 不写 Value,作为新成员入职的配置模板。
4.2 警惕 CI 日志中的“无意泄露”
虽然 Gitea 会自动对 Secrets 进行脱敏(显示为 ***),但以下操作仍会导致泄露:
- 错误示范:
echo $DB_PASSWORD | base64 (Base64 不是加密,Gitea 无法识别脱敏)。 - 错误示范:将 Secrets 写入文件后,使用
cat 打印到标准输出。 - 正确做法:永远不要尝试打印 Secrets。如果必须调试,使用 `echo “Password length is $