如何实现GitLab CI多阶段并行运行且避免ROS网络相互干扰？

核心思路：容器网络隔离+ROS环境双重隔离 #

1. 通过GitLab Runner实现容器网络彻底隔离 #

GitLab Runner的Docker执行器默认会给每个Job分配独立的bridge网络，但如果你的Runner配置里用了network_mode = "host"（容器共享主机网络栈），就会导致不同Job的容器网络互通，ROS话题互相串扰。解决方法分两种：

方法A：修改Runner全局配置，禁用host网络

找到Runner的配置文件config.toml（通常路径为/etc/gitlab-runner/config.toml），确保执行器的network_mode设置为bridge：

[[runners]]
  name = "docker-runner"
  url = "https://your-gitlab-instance.com/"
  token = "your-runner-token"
  executor = "docker"
  [runners.docker]
    image = "your-ros-base-image:latest"
    privileged = false
    volumes = ["/cache"]
    network_mode = "bridge"  # 关键：用独立bridge网络替代host共享网络

修改后重启Runner生效：gitlab-runner restart

方法B：在.gitlab-ci.yml中为单个Job指定隔离网络

如果不想改动全局配置，也可以直接在测试Job里单独指定网络模式，确保每个Job的容器网络完全独立：

unit_tests:
  stage: unit_tests
  image: your-ros-test-image:latest
  script:
    - source /opt/ros/noetic/setup.bash
    - catkin_make run_tests
  tags:
    - docker
  variables:
    DOCKER_NETWORK_MODE: "bridge"

integration_tests:
  stage: integration_tests
  image: your-ros-test-image:latest
  script:
    - source /opt/ros/noetic/setup.bash
    - catkin_make run_tests
  tags:
    - docker
  variables:
    DOCKER_NETWORK_MODE: "bridge"

如果测试不需要外部网络，甚至可以用network_mode: none，彻底切断容器与外部（包括其他容器）的网络连接：

variables:
  DOCKER_NETWORK_MODE: "none"

2. ROS环境层面的额外隔离（双重保障） #

即使网络隔离生效，也可以通过ROS自身配置进一步避免话题冲突，适合网络隔离无法完全覆盖的场景：

方法A：为每个测试Job设置独立的ROS_MASTER_URI

ROS节点通过ROS_MASTER_URI连接主节点，不同的URI对应不同的主节点实例，话题自然不会互通：

unit_tests:
  stage: unit_tests
  image: your-ros-test-image:latest
  script:
    - export ROS_MASTER_URI=http://localhost:11311
    - source /opt/ros/noetic/setup.bash
    - roscore &
    - sleep 5
    - catkin_make run_tests
  tags:
    - docker

integration_tests:
  stage: integration_tests
  image: your-ros-test-image:latest
  script:
    - export ROS_MASTER_URI=http://localhost:11312
    - source /opt/ros/noetic/setup.bash
    - roscore -p 11312 &
    - sleep 5
    - catkin_make run_tests
  tags:
    - docker

方法B：给ROS话题添加专属命名空间

在测试代码或launch文件中，为每个测试阶段的节点设置不同的命名空间，让相同名字的话题变成不同路径：
比如在launch文件里分组设置命名空间：

<launch>
  <group ns="unit_test">
    <node name="talker" pkg="your_pkg" type="talker" />
    <node name="listener" pkg="your_pkg" type="listener" />
  </group>
</launch>

或者通过命令行指定命名空间：

rosrun your_pkg talker __ns:=/unit_test

这样单元测试的话题会变成/unit_test/abc，集成测试用/integration_test/abc，完全不会互相干扰。

总结 #

优先用GitLab Runner的Docker网络隔离（方法1），这是最彻底的解决方案；再结合ROS命名空间/主节点端口隔离（方法2）做双重保障，就能完全解决测试阶段的话题串扰问题。

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