gitlab-ci-local项目本地构建指南

gitlab-ci-local是一个用于本地运行GitLab CI/CD管道的工具，对于开发者来说，了解如何正确地进行本地构建和测试非常重要。本文将详细介绍该项目的几种本地运行方式，帮助开发者快速上手。

直接运行源码

最简单的方式是直接通过Node.js运行源码，无需任何构建步骤：

node src/index.js --cwd ../somefolder-with-gitlabci

这种方式适合快速测试和开发，不需要预先构建任何文件。

构建可执行包

如果需要生成独立的可执行文件，可以按照以下步骤操作：

1. 首先使用esbuild进行构建：

npm run esbuild

2. 然后根据目标平台打包：

npm run pkg-macos    # 针对macOS
npm run pkg-linux    # 针对Linux
npm run pkg-win      # 针对Windows
npm run pkg-all      # 针对所有平台

这种方式适合需要分发或部署的场景，生成的可执行文件可以独立运行，无需Node.js环境。

其他开发运行方式

1. 编译TypeScript为JavaScript：

npm run build

这会生成.js文件在src目录中，之后可以通过node src/index.js运行。

2. 直接执行TypeScript文件：

npx tsx src/index.ts

3. 开发模式（带热重载）：

npm run dev

这种方式适合开发过程中频繁修改代码的场景，可以实时看到修改效果。

选择建议

• 快速测试：直接运行源码或使用开发模式
• 生产部署：构建可执行包
• 开发调试：使用开发模式或直接执行TypeScript

理解这些不同的运行方式可以帮助开发者根据实际需求选择最适合的方法，提高开发效率。对于新手开发者，建议从直接运行源码开始，逐步了解其他构建方式。