基于cypress/included镜像在GitLab流水线修改/etc/hosts权限问题求助

问题说明 #

我正尝试创建GitLab流水线任务，用Cypress执行端到端测试。选用cypress/included作为基础镜像（自带Cypress可执行文件），但在往/etc/hosts文件追加测试URL时，收到权限拒绝提示。目标是在流水线中正常运行Cypress测试并成功修改/etc/hosts文件。

曾尝试自定义Dockerfile，以cypress/included为基础镜像，想把用户加入sudoers组，但发现该镜像只有wheel组，不确定加入该组能否获取权限提升。当前GitLab YAML大致内容如下：

stages:
  - test

variables:
  BASE_IMAGE: cypress/included

test_job:
  stage: test
  image: $BASE_IMAGE
  script:
    - echo "Running tests..."
    - echo "127.0.0.1 your-url.com" | tee -a /etc/hosts
    - npx cypress run --configure --baseUrl="your-url.com"

可行解决方案 #

方案1：直接以root用户运行任务 #

cypress/included镜像默认使用非root的cypress用户运行，而修改/etc/hosts需要root权限。在GitLab YAML中指定user: root即可解决：

stages:
  - test

variables:
  BASE_IMAGE: cypress/included

test_job:
  stage: test
  image: $BASE_IMAGE
  user: root # 切换到root用户
  script:
    - echo "Running tests..."
    - echo "127.0.0.1 your-url.com" >> /etc/hosts
    - npx cypress run --configure --baseUrl="your-url.com"

方案2：自定义镜像配置免密sudo #

如果不想用root用户，可自定义Dockerfile，将默认的cypress用户加入wheel组，并配置该组免密执行sudo：

FROM cypress/included:latest

RUN echo "%wheel ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers \
    && usermod -aG wheel cypress

将该镜像构建后推送到你的容器仓库，然后在GitLab YAML中替换镜像地址，修改hosts时加上sudo：

stages:
  - test

variables:
  BASE_IMAGE: 你的自定义镜像地址/cypress-custom:latest

test_job:
  stage: test
  image: $BASE_IMAGE
  script:
    - echo "Running tests..."
    - sudo echo "127.0.0.1 your-url.com" >> /etc/hosts
    - npx cypress run --configure --baseUrl="your-url.com"

方案3：用Cypress内置hosts配置替代系统修改 #

Cypress本身支持在配置文件中设置host映射，无需修改系统/etc/hosts。在项目的cypress.config.js中添加以下配置：

const { defineConfig } = require("cypress");

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      config.hosts = {
        "your-url.com": "127.0.0.1"
      };
      return config;
    },
    baseUrl: "http://your-url.com"
  }
});

之后GitLab流水线中无需修改/etc/hosts，直接运行npx cypress run即可，完全避开权限问题。

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