# 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 官方包管理器，兼容性最好