167 lines
3.0 KiB
Markdown
167 lines
3.0 KiB
Markdown
# 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。
|
||
|
||
## 构建
|
||
|
||
```bash
|
||
# 先构建基础镜像
|
||
./rebuild.sh gitea_runner_base
|
||
|
||
# 再构建 Node.js 镜像
|
||
./rebuild.sh gitea_runner_node
|
||
```
|
||
|
||
## 切换 Node.js 版本
|
||
|
||
### 方式一：使用切换脚本
|
||
|
||
```bash
|
||
source use-node 18 # 切换到 Node.js 18
|
||
source use-node 20 # 切换到 Node.js 20
|
||
source use-node 22 # 切换到 Node.js 22
|
||
```
|
||
|
||
### 方式二：使用 n 命令
|
||
|
||
```bash
|
||
n use 18 # 切换到 Node.js 18
|
||
n use 20 # 切换到 Node.js 20
|
||
n use 22 # 切换到 Node.js 22
|
||
```
|
||
|
||
## 包管理器选择
|
||
|
||
镜像内置三种包管理器，可按需选择：
|
||
|
||
```bash
|
||
npm install # 使用 npm
|
||
yarn install # 使用 yarn
|
||
pnpm install # 使用 pnpm
|
||
```
|
||
|
||
## Gitea Action 示例
|
||
|
||
### 基础构建
|
||
|
||
```yaml
|
||
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
|
||
```
|
||
|
||
### 多版本测试
|
||
|
||
```yaml
|
||
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
|
||
```
|
||
|
||
### 使用不同包管理器
|
||
|
||
```yaml
|
||
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 版本？
|
||
|
||
```bash
|
||
n ls
|
||
```
|
||
|
||
### 如何全局安装 npm 包？
|
||
|
||
```bash
|
||
npm install -g <package-name>
|
||
```
|
||
|
||
### pnpm 和 yarn 的区别？
|
||
|
||
- **pnpm**: 使用硬链接节省磁盘空间，速度快，严格依赖管理
|
||
- **yarn**: 速度快，离线缓存，workspaces 支持好
|
||
- **npm**: Node.js 官方包管理器，兼容性最好
|