gitlab-ci-local for Mac 版
以 shell 执行器或 docker 执行器在本地运行 gitlab 流水线
gitlab-ci-local 是什么
gitlab-ci-local 是一个在本地运行 GitLab CI 流水线的命令行工具,支持 shell 和 docker 两种执行器。它的核心用途是让开发者在推送代码之前就能验证 .gitlab-ci.yml 的配置是否正确,省去反复提交才能测试流水线的麻烦。
工具会按照 .gitlab-ci.yml 的定义在本地执行 job,支持 includes、artifacts、CI/CD inputs、文件变量等常见配置,也处理了自托管 GitLab 的自定义端口场景。它还提供 `--list` 参数,可以在实际执行前先查看哪些 job 会被加入流水线,并自动过滤掉 `when: never` 的任务,输出中包含 description 和 allow_failure 等信息。此外,CLI 选项可以通过环境变量、配置文件、bash alias 或 tab 补全来设置默认值。
它适合需要频繁调整 CI 配置的开发者,以及希望摆脱为本地开发单独维护 shell 脚本和 Makefile 的团队。安装方式覆盖 Debian、Arch Linux、NPM、Bun、macOS 和 Windows(Git Bash),Windows 下会禁用 Git Bash 的路径转换,避免 Linux 路径被错误重写。
工具会按照 .gitlab-ci.yml 的定义在本地执行 job,支持 includes、artifacts、CI/CD inputs、文件变量等常见配置,也处理了自托管 GitLab 的自定义端口场景。它还提供 `--list` 参数,可以在实际执行前先查看哪些 job 会被加入流水线,并自动过滤掉 `when: never` 的任务,输出中包含 description 和 allow_failure 等信息。此外,CLI 选项可以通过环境变量、配置文件、bash alias 或 tab 补全来设置默认值。
它适合需要频繁调整 CI 配置的开发者,以及希望摆脱为本地开发单独维护 shell 脚本和 Makefile 的团队。安装方式覆盖 Debian、Arch Linux、NPM、Bun、macOS 和 Windows(Git Bash),Windows 下会禁用 Git Bash 的路径转换,避免 Linux 路径被错误重写。
如何安装 gitlab-ci-local
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-11-04,当前版本 4.77.1,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| 4.77.1 | 2026-11-04 | 稳定版 | 40.2 MB | 下载 | 下载 | 下载 |
| 4.77.0 | 2026-10-24 | 稳定版 | 40.1 MB | 下载 | 下载 | 下载 |
| 4.76.1 | 2026-10-07 | 稳定版 | 26.0 MB | 下载 | 下载 | 下载 |
| 4.76.0 | 2026-09-30 | 稳定版 | 26.0 MB | 下载 | 下载 | 下载 |
| 4.75.1 | 2026-08-25 | 稳定版 | 26.1 MB | 下载 | 下载 | 下载 |
| 4.75.0 | 2026-08-21 | 稳定版 | 24.3 MB | 下载 | 下载 | 下载 |
| 4.74.0 | 2026-07-31 | 稳定版 | 24.2 MB | 下载 | 下载 | 下载 |
| 4.73.0 | 2026-06-22 | 稳定版 | 24.1 MB | 下载 | 下载 | 下载 |
| 4.72.0 | 2026-05-09 | 稳定版 | 23.2 MB | 下载 | 下载 | 下载 |
| 4.71.0 | 2026-04-17 | 稳定版 | 22.4 MB | 下载 | 下载 | 下载 |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- all
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| gitlab-ci-local | 4.77.1 | MIT | 命令行 | 925 |
| dive | v0.13.1 | MIT | 命令行 | 870 |
| docker-engine | docker-v29.9.3 | Apache-2.0 | 命令行 | 1,032 |
| docker-agent | v1.160.0 | Apache-2.0 | 命令行 | 577 |
DevOps 与云服务中的类似应用
dive
dive 是一个用来分析 Docker/OCI 镜像的工具,能按层查看镜像内容,并帮你找出镜像体积可以压缩的地方。docker-engine
Moby 是由 Docker 创建的开源项目,目标是推动软件容器化的发展。它提供了一套“乐高式”的工具组件,包括容器构建工具、镜像仓库、编排工具、运行时等…docker-agent
docker-agent 是一个 Docker CLI 插件,通过 `docker agent` 命令使用。dagger
Dagger 是一个用于自动化软件交付的平台,能够可靠、大规模地构建、测试和发布任何代码库。podman-compose
podman-compose 是用 Podman 作为后端的 Compose 规范实现。awscli
AWS CLI 是亚马逊云服务的统一命令行接口,让用户通过终端直接管理和操作 AWS 资源。所属分类:DevOps 与云服务、命令行工具、终端与 Shell