GitLab CI/CD流水线使用Redis服务时遇link不支持错误求助

错误本质 #

你遇到的bad parameter: link is not supported错误，核心原因是GitLab Runner的Docker执行器在尝试使用Docker已弃用的--link参数连接服务容器，而当前Docker版本已不再支持该参数。

可能的原因 #

• Runner版本过低：GitLab Runner 13.0版本之后才默认采用用户自定义网络替代--link。若你的Runner版本低于13.0，即使在.gitlab-ci.yml中配置了自定义网络，Runner仍会沿用旧的--link逻辑。
• .gitlab-ci.yml配置不规范：自定义网络的配置位置错误，或未确保服务容器与任务容器加入同一个自定义网络。

解决方案步骤 #

1. 修正.gitlab-ci.yml配置 #

确保服务容器和任务容器都加入同一个自定义网络，标准配置示例如下：

# 顶层定义自定义网络
networks:
  test-net:
    driver: bridge

# 顶层声明Redis服务，并指定加入自定义网络
services:
  - name: redis:latest
    alias: redis
    networks:
      - test-net

# 单元测试任务配置
unit-test-job:
  image: 你的应用镜像标签
  networks:
    - test-net
  script:
    - # 执行单元测试，连接地址使用配置的alias（示例为redis）
    - 你的测试命令（如pytest、npm test等）

2. 排查Runner相关问题 #

由于你无法访问Runner的config.toml，请联系Runner管理员完成以下检查：

• 确认Runner版本：若版本低于13.0，必须升级至13.0及以上版本，才能彻底解决--link参数的兼容问题。
• 检查Runner配置：确认[runners.docker]段是否将network_mode设为默认bridge，或是否存在userns_mode等可能干扰网络配置的参数，这类配置可能导致自定义网络不生效。

额外注意点 #

测试代码中连接Redis的地址必须使用你配置的alias（如示例中的redis），不能使用localhost——因为服务容器与任务容器是同一自定义网络下的独立容器，需通过网络别名互通。

内容的提问来源于stack exchange，提问作者Alex_Pap