Skip to content

Gitea Workflows 工作流使用指南

约 395 字大约 1 分钟

指南git自动化

2025-08-08

一、Workflows 概念

工作流(Workflows)是 Gitea 或 GitHub 提供的自动化工具,用于在代码提交等事件触发后,执行一系列预设操作(如打包、部署、测试等)。其执行状态和操作面板可在 Gitea 或 GitHub 平台的 Actions 菜单中查看。

以 Gitea 为例,配置工作流的常规步骤:

  1. 在仓库根目录创建配置文件夹:Gitea 使用 .gitea 文件夹,GitHub 使用 .github 文件夹
  2. 在上述文件夹中创建 workflows 子文件夹(注意正确拼写:workflows,而非 workflwos
  3. workflows 文件夹下编写 YAML 格式的配置文件,定义执行步骤和命令(语法类似 Docker Compose 的声明式风格)

二、私有 Gitea 部署工作流环境

部署环境(服务均基于 Docker 容器)

  1. Git 环境:服务器需安装 Git,用于代码拉取和版本控制
  2. Gitea 服务:已部署的 Gitea 容器(需确保版本支持 Actions 功能,建议 v1.19+)
  3. Act Runner 服务
    • 作用:作为工作流的执行引擎,负责运行 Gitea 下发的工作流任务
    • 镜像:官方推荐 gitea/act_runner
    • 要求:需与 Gitea 服务网络互通,并完成注册关联
  4. 网络要求
    • 建议服务器可访问外网,以便快速拉取依赖包(如 npm、maven 等)
    • 若无法访问外网,需提前配置私有镜像仓库(如 Nexus、Harbor),避免依赖拉取失败