GitLab CI/CD本地测试替代方案：gitlab-runner exec docker命令已失效

针对你提到的gitlab-runner exec docker命令废弃的问题，以下是官方支持的本地测试方案：

1. 使用GitLab Runner的Shell执行器 #

虽然exec docker已废弃，但可以通过Shell执行器直接在本地环境运行指定job，命令如下：

gitlab-runner exec shell <job-name>

注意：需要在本地提前安装好该job依赖的所有工具（如编程语言环境、Docker、构建工具等），因为Shell执行器会直接复用本地系统环境，适合快速验证脚本逻辑，但环境一致性可能不如线上GitLab Runner。

2. 官方CI Lint工具验证配置语法 #

GitLab提供的CI Lint可以快速检查.gitlab-ci.yml的语法正确性、关键词有效性，避免因配置错误导致流水线失败。

• 在线方式：在GitLab项目的「CI/CD」→「CI Lint」页面，粘贴或上传配置文件即可完成检查。
• 本地API调用方式：通过GitLab API本地验证，示例命令：

curl --header "PRIVATE-TOKEN: <你的GitLab访问令牌>" "https://你的GitLab域名/api/v4/ci/lint" --data "content=$(cat .gitlab-ci.yml)"

该方式仅验证语法，不会实际执行job。

3. 部署本地GitLab实例（完整流水线模拟） #

如果需要完全模拟线上GitLab的流水线运行环境（包括缓存、artifacts、多job依赖等），可以用Docker启动本地GitLab CE/EE实例：

docker run --detach --hostname localhost --publish 443:443 --publish 80:80 --publish 22:22 --name gitlab --restart always gitlab/gitlab-ce:latest

启动后，将本地GitLab Runner注册到该实例，推送代码到本地仓库即可触发完整流水线执行。这种方案最接近真实生产环境，但对本地硬件资源（内存、磁盘）要求较高。

内容的提问来源于stack exchange，提问作者David Cruz Sánchez