集成Gitea act_runner、Node.js和npm的Docker镜像文档

镜像概述

本Docker镜像整合了Gitea act_runner（Gitea的CI/CD运行器）、Node.js（JavaScript运行时环境）和npm（Node.js包管理器），旨在为Gitea平台提供一站式的CI/CD解决方案，特别适用于JavaScript/Node.js项目的自动化构建、测试和部署流程。

核心功能与特性

• 内置Gitea act_runner：原生支持连接Gitea实例，执行基于Gitea Actions的工作流任务
• 完整Node.js环境：集成Node.js运行时和npm包管理器，无需额外安装即可处理JavaScript项目依赖和执行脚本
• 轻量级设计：基于官方基础镜像优化，体积小巧，启动快速，适合CI/CD环境资源高效利用
• 兼容性良好：兼容Gitea Actions工作流语法，支持常见的JavaScript构建工具（如webpack、babel、jest等）

使用场景与适用范围

• Gitea托管的JavaScript/Node.js项目的自动化构建、单元测试、代码质量检查
• 需要Node.js环境的Gitea Actions工作流执行（如前端项目打包、Node.js后端API测试）
• 个人或团队开发环境中，快速搭建临时CI/CD节点处理JavaScript相关任务
• 小型项目的自动化部署流程（如将Node.js应用部署到服务器或容器平台）

使用方法与配置说明

前提条件

• 已部署Gitea实例（v1.19.0+，支持Actions功能）
• 获取Gitea实例的URL（如[***]）和Runner注册令牌（在Gitea仓库/组织设置→Actions→Runners中创建）
• 安装Docker环境（v20.10+）

拉取镜像

假设镜像名称为gitea-act-node-runner（实际使用时需替换为实际镜像名称或构建路径）：

docker pull your-registry/gitea-act-node-runner:latest

注册与启动Runner

1. 注册Runner到Gitea实例

docker run -it --rm \
  -e GITEA_INSTANCE_URL="[***]" \
  -e REGISTRATION_TOKEN="your-gitea-runner-token" \
  your-registry/gitea-act-node-runner \
  act_runner register \
    --instance "$GITEA_INSTANCE_URL" \
    --token "$REGISTRATION_TOKEN" \
    --name "nodejs-runner-01" \  # Runner名称（自定义）
    --labels "nodejs=true"       # Runner标签（用于工作流选择）

2. 启动Runner守护进程

注册完成后，启动Runner以持续监听Gitea任务：

docker run -d \
  --name gitea-node-runner \
  --restart always \
  your-registry/gitea-act-node-runner \
  act_runner daemon

Docker Compose配置示例

创建docker-compose.yml文件，简化部署与管理：

version: '3.8'

services:
  gitea-node-runner:
    image: your-registry/gitea-act-node-runner:latest
    container_name: gitea-node-runner
    restart: always
    environment:
      - GITEA_INSTANCE_URL=[***]
      # 注册时需手动执行act_runner register命令，令牌不建议长期存储在环境变量中
    volumes:
      - ./runner-data:/data  # 持久化Runner配置和工作数据
    command: act_runner daemon

启动服务：

docker-compose up -d

环境变量说明

验证Runner状态

在Gitea实例的“仓库/组织设置→Actions→Runners”页面，应能看到状态为“活跃”的Runner，标签包含nodejs等自定义标签。此时即可在项目中编写Gitea Actions工作流文件（如.gitea/workflows/nodejs-ci.yml），指定runs-on: [nodejs]以使用该Runner执行任务。