Gitea 本地化方案

📋 方案概述

解决白天网络阻塞导致的 CI/CD 慢问题，通过三个阶段实现完全本地化：

阶段	目标	预期提升	优先级
P0	Actions 本地化	消除 GitHub 访问	🔴 立即执行
P1	Docker-in-Docker + Harbor	3-5x 构建速度	🟠 核心优化
P2	弹性扩容	2-10 副本自动伸缩	🟢 可选

🚀 快速开始

前置条件

# 1. 确保服务运行
docker ps | grep gitea          # Gitea 容器
kubectl get pods -n gitea-runner  # Runner Pod

# 2. 确保 Harbor 可访问
curl -k https://harbor.omniverseai.net/api/v2.0/health

# 3. 生成 Gitea Token（用于镜像 Actions）
# 访问: http://192.168.1.83:33000/user/settings/applications
# 权限: repo, admin:org
export GITEA_TOKEN="your-token-here"

一键部署

cd /Users/brunogao/work/codes/tools/macos/gitea/gitea-localization

# 方式 1: 全部部署（推荐）
./deploy-localization.sh all

# 方式 2: 分阶段部署
./deploy-localization.sh p0    # Actions 本地化
./deploy-localization.sh p1    # DinD + Harbor
./deploy-localization.sh p2    # 弹性扩容

# 验证部署
./verify-localization.sh

📦 方案详解

P0: Actions 本地化

目标: 让 uses: actions/checkout@v4 从本地 Gitea 拉取，不访问 GitHub

实施步骤:

1. 更新 Gitea 配置

   # 自动添加到 app.ini
   [actions]
   DEFAULT_ACTIONS_URL = self
   

2. 镜像核心 Actions

   export GITEA_TOKEN="your-token"
   ./02-mirror-actions.sh
   

   镜像列表:

   • actions/checkout
   • actions/cache
   • actions/upload-artifact
   • actions/download-artifact
   • actions/setup-node
   • actions/setup-python
   • docker/build-push-action

3. 验证

   # 访问 http://192.168.1.83:33000/actions
   # 应该看到 actions 组织和镜像仓库
   

效果: workflow 中的 uses: 不再访问 GitHub

---

P1: Docker-in-Docker + Harbor

目标: 构建镜像时从 Harbor 拉取基础镜像，缓存持久化

核心改进:

1. DinD Sidecar 模式

   # 之前: 直接挂载宿主机 docker.sock（不隔离）
   - hostPath:
       path: /var/run/docker.sock
   
   # 之后: 独立的 dind 容器（隔离 + 可配置）
   - name: dind
     image: docker:24-dind
     volumeMounts:
     - name: dind-daemon-config
       mountPath: /etc/docker/daemon.json
   

2. Registry Mirror 配置

   {
     "registry-mirrors": ["https://harbor.omniverseai.net"],
     "insecure-registries": ["harbor.omniverseai.net"],
     "max-concurrent-downloads": 6,
     "features": { "buildkit": true }
   }
   

3. 持久化缓存

   # 之前: emptyDir（Pod 重启即丢失）
   - name: runner-cache
     emptyDir: {}
   
   # 之后: PVC（持久化）
   - name: runner-cache
     persistentVolumeClaim:
       claimName: runner-cache-pvc  # 50Gi
   - name: runner-toolcache
     persistentVolumeClaim:
       claimName: runner-toolcache-pvc  # 20Gi
   

部署:

./deploy-localization.sh p1

验证:

# 1. 检查 dind 容器
kubectl get pods -n gitea-runner -o jsonpath='{.items[0].spec.containers[*].name}'
# 输出应包含: dind runner

# 2. 检查 registry mirror
POD=$(kubectl get pods -n gitea-runner -l app=gitea-runner -o jsonpath='{.items[0].metadata.name}')
kubectl exec -n gitea-runner $POD -c dind -- docker info | grep -A 2 "Registry Mirrors"
# 输出应包含: harbor.omniverseai.net

# 3. 测试拉取镜像
kubectl exec -n gitea-runner $POD -c dind -- docker pull python:3.11
# 应该从 Harbor 拉取（速度快）

效果:

• 基础镜像命中率 >90%
• 工具链缓存持久化
• 白天构建速度提升 3-5x

---

P2: 弹性扩容

目标: 根据负载自动扩缩容 runner（2-10 副本）

HPA 配置:

minReplicas: 2
maxReplicas: 10
metrics:
- type: Resource
  resource:
    name: cpu
    target:
      averageUtilization: 70

部署:

# 1. 确保 metrics-server 已安装
kubectl get deployment metrics-server -n kube-system

# 2. 部署 HPA
./deploy-localization.sh p2

# 3. 监控扩缩容
kubectl get hpa -n gitea-runner -w

可选: KEDA（基于队列长度）

# 安装 KEDA
kubectl apply -f https://github.com/kedacore/keda/releases/download/v2.12.0/keda-2.12.0.yaml

# 应用 ScaledObject（已包含在 05-runner-hpa.yaml）
kubectl apply -f 05-runner-hpa.yaml

---

🧪 测试验证

创建测试仓库

# 1. 在 Gitea 创建测试仓库
# http://192.168.1.83:33000/repo/create

# 2. 添加 workflow
mkdir -p .gitea/workflows
cp 06-workflow-template.yaml .gitea/workflows/build.yaml

# 3. 推送代码
git add .
git commit -m "test: add workflow"
git push

观察日志

# Runner 日志
kubectl logs -n gitea-runner -l app=gitea-runner -c runner -f

# DinD 日志
kubectl logs -n gitea-runner -l app=gitea-runner -c dind -f

# 查看 Actions 执行
# http://192.168.1.83:33000/<org>/<repo>/actions

性能对比

指标	优化前	优化后	提升
Actions 拉取	30-60s	<1s	30-60x
基础镜像拉取	2-5min	10-30s	4-10x
工具链下载	每次 1-2min	首次后 <5s	12-24x
总构建时间	5-10min	1-2min	3-5x

---

🔧 故障排查

问题 1: Actions 仍从 GitHub 拉取

症状: workflow 日志显示 Downloading actions from github.com

解决:

# 1. 检查配置
docker exec gitea grep DEFAULT_ACTIONS_URL /data/gitea/conf/app.ini

# 2. 如果没有，手动添加
docker exec gitea sh -c 'echo "[actions]" >> /data/gitea/conf/app.ini'
docker exec gitea sh -c 'echo "DEFAULT_ACTIONS_URL = self" >> /data/gitea/conf/app.ini'

# 3. 重启 Gitea
docker restart gitea

问题 2: 镜像拉取仍然慢

症状: docker pull 仍然超时

解决:

# 1. 检查 dind daemon 配置
POD=$(kubectl get pods -n gitea-runner -l app=gitea-runner -o jsonpath='{.items[0].metadata.name}')
kubectl exec -n gitea-runner $POD -c dind -- cat /etc/docker/daemon.json

# 2. 检查 Harbor 连接
kubectl exec -n gitea-runner $POD -c dind -- docker info | grep -A 5 "Registry Mirrors"

# 3. 手动测试拉取
kubectl exec -n gitea-runner $POD -c dind -- docker pull harbor.omniverseai.net/library/python:3.11

问题 3: PVC 无法绑定

症状: kubectl get pvc 显示 Pending

解决:

# 1. 检查 StorageClass
kubectl get storageclass

# 2. 如果没有 local-path，安装
kubectl apply -f https://raw.githubusercontent.com/rancher/local-path-provisioner/master/deploy/local-path-storage.yaml

# 3. 或修改 PVC 使用其他 StorageClass
kubectl edit pvc runner-cache-pvc -n gitea-runner
# 修改 storageClassName

问题 4: Runner 无法连接 dind

症状: Runner 日志显示 Cannot connect to Docker daemon

解决:

# 1. 检查 dind 容器状态
kubectl get pods -n gitea-runner -o jsonpath='{.items[0].status.containerStatuses[*].name}'

# 2. 检查 DOCKER_HOST 环境变量
kubectl get deployment gitea-runner -n gitea-runner -o yaml | grep DOCKER_HOST
# 应该是: tcp://localhost:2375

# 3. 检查 dind 端口
kubectl exec -n gitea-runner $POD -c dind -- netstat -tlnp | grep 2375

---

📊 监控和维护

日常监控

# 1. Runner 状态
kubectl get pods -n gitea-runner
kubectl top pods -n gitea-runner

# 2. PVC 使用率
kubectl exec -n gitea-runner $POD -c dind -- df -h /var/lib/docker
kubectl exec -n gitea-runner $POD -c runner -- df -h /data/cache

# 3. HPA 状态
kubectl get hpa -n gitea-runner

定期清理

# 1. 清理 dind 缓存（每周）
kubectl exec -n gitea-runner $POD -c dind -- docker system prune -af --volumes

# 2. 清理旧的 runner 数据（每月）
kubectl exec -n gitea-runner $POD -c runner -- find /data/runner -type d -mtime +30 -exec rm -rf {} +

备份

# 备份 PVC 数据
kubectl exec -n gitea-runner $POD -c runner -- tar czf /tmp/cache-backup.tar.gz /data/cache
kubectl cp gitea-runner/$POD:/tmp/cache-backup.tar.gz ./cache-backup-$(date +%Y%m%d).tar.gz -c runner

---

📚 参考资料

• Gitea Actions 文档
• Docker-in-Docker 最佳实践
• Harbor 镜像代理
• Kubernetes HPA

---

🆘 支持

遇到问题？

1. 运行验证脚本: ./verify-localization.sh
2. 查看日志: kubectl logs -n gitea-runner -l app=gitea-runner --all-containers
3. 检查配置: kubectl get all,pvc,cm -n gitea-runner

---

生成时间: 2025-12-31 版本: 1.0.0 维护者: DevOps Team