Gitea Runner Node.js
Gitea Action Runner Node.js 构建环境，基于 gitea_runner_base 添加多版本 Node.js 和包管理器。
基础镜像
timi/gitea_runner_base:latest
包含环境
| 组件 | 版本 |
|---|---|
| Node.js | 18, 20, 22 (LTS) |
| npm | 最新 (随 Node.js) |
| yarn | 最新 |
| pnpm | 最新 |
Node.js 版本说明
| 版本 | 状态 | 说明 |
|---|---|---|
| Node.js 18 | LTS | Hydrogen (维护至 2025-04) |
| Node.js 20 | LTS | Iron (推荐使用，维护至 2026-04) |
| Node.js 22 | Current | 当前活跃版本 |
默认使用 Node.js 20。
构建
# 先构建基础镜像
./rebuild.sh gitea_runner_base
# 再构建 Node.js 镜像
./rebuild.sh gitea_runner_node
切换 Node.js 版本
方式一：使用切换脚本
source use-node 18 # 切换到 Node.js 18
source use-node 20 # 切换到 Node.js 20
source use-node 22 # 切换到 Node.js 22
方式二：使用 n 命令
n use 18 # 切换到 Node.js 18
n use 20 # 切换到 Node.js 20
n use 22 # 切换到 Node.js 22
包管理器选择
镜像内置三种包管理器，可按需选择：
npm install # 使用 npm
yarn install # 使用 yarn
pnpm install # 使用 pnpm
Gitea Action 示例
基础构建
name: Node.js Build
on: [push]
jobs:
build:
runs-on: ubuntu-latest
container:
image: timi/gitea_runner_node:latest
steps:
- uses: actions/checkout@v4
- name: Install dependencies
run: npm install
- name: Build
run: npm run build
- name: Test
run: npm test
多版本测试
name: Multi-version Test
on: [push]
jobs:
test:
runs-on: ubuntu-latest
container:
image: timi/gitea_runner_node:latest
strategy:
matrix:
node-version: [18, 20, 22]
steps:
- uses: actions/checkout@v4
- name: Use Node.js ${{ matrix.node-version }}
run: |
source use-node ${{ matrix.node-version }}
node -v
- name: Install and test
run: |
npm install
npm test
使用不同包管理器
name: Build with pnpm
on: [push]
jobs:
build:
runs-on: ubuntu-latest
container:
image: timi/gitea_runner_node:latest
steps:
- uses: actions/checkout@v4
- name: Install dependencies with pnpm
run: pnpm install
- name: Build
run: pnpm build
环境变量
| 变量 | 默认值 |
|---|---|
NODE_BASE |
/usr/local/node |
PATH |
包含当前 Node.js 版本的 bin 目录 |
常见问题
如何查看已安装的 Node.js 版本？
n ls
如何全局安装 npm 包？
npm install -g <package-name>
pnpm 和 yarn 的区别？
- pnpm: 使用硬链接节省磁盘空间，速度快，严格依赖管理
- yarn: 速度快，离线缓存，workspaces 支持好
- npm: Node.js 官方包管理器，兼容性最好