67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# Forgejo Actions Runner
|
||
|
||
**Forgejo Actions Runner** 是 Forgejo 的官方运行器组件，用于执行 CI/CD 工作流中的各类任务。它与 Forgejo Actions 系统集成，支持本地或远程运行任务，帮助用户构建自动化 DevOps 流程。
|
||
|
||
适合希望**完全自托管** CI/CD 流水线的个人或组织部署使用。
|
||
|
||
## ✨ 特性
|
||
|
||
- 与 Forgejo Actions 完全集成
|
||
- 支持自定义容器或直接在主机运行
|
||
- 多 Runner 支持并行执行
|
||
- 支持 amd64 / arm64 等架构
|
||
- 简单易用，部署轻量
|
||
|
||
## ⚙️ 快速开始（Docker 部署）
|
||
|
||
### 1. 启动 Forgejo 主服务（略）
|
||
|
||
确保 Forgejo 主程序已部署并启用了 Actions 功能。
|
||
|
||
### 2. 运行 Action Runner 容器
|
||
|
||
```bash
|
||
docker run -d --name forgejo-runner \
|
||
-v /var/run/docker.sock:/var/run/docker.sock \
|
||
-v /opt/runner:/data \
|
||
codeberg.org/forgejo/runner:latest
|
||
```
|
||
|
||
### 3. 初始化注册
|
||
|
||
首次运行后，进入容器进行注册：
|
||
|
||
```bash
|
||
docker exec -it forgejo-runner forgejo-runner register
|
||
```
|
||
|
||
你需要提供：
|
||
|
||
- **Forgejo 实例 URL**（例如 `https://git.example.com`）
|
||
- **Runner Token**（从仓库或组织设置中获取）
|
||
- **运行模式**（Docker / shell 等）
|
||
- **标签**（可选，便于任务调度）
|
||
|
||
## 🔄 自动启动示例（Docker Compose）
|
||
|
||
```yaml
|
||
version: '3'
|
||
services:
|
||
forgejo-runner:
|
||
image: codeberg.org/forgejo/runner:latest
|
||
container_name: forgejo-runner
|
||
volumes:
|
||
- /var/run/docker.sock:/var/run/docker.sock
|
||
- ./runner-data:/data
|
||
restart: unless-stopped
|
||
```
|
||
|
||
## 📘 文档与资源
|
||
|
||
- 项目主页：https://forgejo.org/docs/latest/admin/actions/
|
||
- 源码仓库：https://code.forgejo.org/forgejo/runner
|
||
|
||
## 🧑🤝🧑 关于 Forgejo Runner
|
||
|
||
Forgejo Runner 是社区主导的 CI 执行器，致力于提供安全、可控、可扩展的构建环境。它是 Forgejo 构建完整 DevOps 生态的重要组成部分。
|