DevOps开发者必备技能之:面向8人以下小型团队的 Gitea DevOps 最小化实践指南

DevOps开发者必备技能之:面向8人以下小型团队的 Gitea DevOps 最小化实践指南

在小型团队(一般8人以下)中,引入庞大的 DevOps 工具链(如 GitLab + Jenkins + Kubernetes)往往会导致“工具维护成本高于业务开发成本”。对于小团队而言,轻量、够用、易维护才是核心诉求。

以下将基于 Debian 13 操作系统,以 Gitea 最新稳定版 为核心,为你梳理一套完整的 DevOps 最小化 SOP(标准作业程序)。我们将从选型、安装、分支规范,一直走到 PHP 和 Golang 项目的自动化 SSH 部署,全程不依赖 Docker,回归最纯粹的 Git + SSH 部署模式。


一、 为什么选择 Gitea?(选型分析)

对于8人以下的小型团队,Gitea 是当之无愧的“性价比之王”:

  1. 极致轻量:单个二进制文件,内存占用极低,在 1核2G 的廉价 VPS 上即可流畅运行。
  2. 功能够用:支持 Issues、Milestones、Wiki、PR 审查,满足日常研发管理。
  3. 原生 CI/CD:内置 Gitea Actions(兼容 GitHub Actions 语法),无需额外搭建 Jenkins,直接在代码仓库内完成流水线配置。
  4. 部署极简:无需复杂的容器编排,直接 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
# 创建 gitea 用户
sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git

# 下载并安装 Gitea (请根据官网替换为最新版本号)
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 开启分支保护:

  1. 禁止直接 Push:所有分支必须通过 Pull Request (PR) 合并。
  2. 合并策略:推荐使用 Squash and merge(压缩合并),保持主干提交历史整洁。
  3. 流转 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
# 下载 runner
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

# 注册 runner (在 Gitea 后台 -> 站点管理 -> Runner -> 创建新Runner 获取 token)
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: 目标服务器 IP
  • SERVER_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 # 使用本地 runner
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 }}/

# 重启 PHP-FPM 使配置生效
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

# 重启服务 (假设不同环境使用不同的 systemd service 名称,如 go-app-dev)
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
# 核心:根据推送的分支,动态映射到 Gitea 的 Environment
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

# 验证生成结果 (注意:secrets 会被自动脱敏显示为 ***)
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

# 1. 同步代码 (排除 .env,因为 .env 是动态生成的)
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 }}/

# 2. 单独同步动态生成的 .env 文件到目标服务器
rsync -avz -e "ssh -i ~/.ssh/id_ed25519" .env ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }}:/var/www/php-${{ github.ref_name }}/.env

# 3. 确保目标服务器上 .env 的权限安全 (仅限 web 用户可读)
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"

# 4. 重启服务
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 $

DevOps开发者必备技能之:面向8人以下小型团队的 Gitea DevOps 最小化实践指南

https://www.wdft.com/d2b2292d.html

Author

Jaco Liu

Posted on

2026-11-19

Updated on

2026-11-19

Licensed under