如何在GitLab CI部署任务后获取环境URL用于后续测试任务？

我来帮你搞定这个GitLab CI里的变量传递难题！你想在部署后的E2E测试里复用$CI_ENVIRONMENT_URL，又不想写多个测试任务，核心就是把部署阶段拿到的这个URL传递给后续的测试job就行。这里有几个官方推荐、简单好用的方法：

1. 用Dotenv报告传递变量（最推荐，官方原生支持） #

GitLab CI有个专门的dotenv报告功能，能让你把部署阶段的变量自动注入到后续依赖的任务中，完全不用手动处理文件加载。

示例配置： #

stages:
  - deploy
  - test

deploy:
  stage: deploy
  script:
    # 把环境URL写入一个.env格式的文件
    - echo "BASE_URL=$CI_ENVIRONMENT_URL" > deployment.env
  artifacts:
    reports:
      # 告诉GitLab这个是dotenv报告，自动加载变量
      dotenv: deployment.env
  environment:
    name: $CI_ENVIRONMENT_NAME
    url: $CI_ENVIRONMENT_URL

e2e-test:
  stage: test
  # 依赖deploy任务，确保它先执行并传递变量
  needs: [deploy]
  script:
    # 直接用传递过来的BASE_URL变量启动Cypress
    - npx cypress run --env baseUrl=$BASE_URL
  # 可选：添加Cypress依赖缓存，加快测试速度
  cache:
    key: ${CI_COMMIT_REF_SLUG}-cypress
    paths:
      - ~/.cache/Cypress

原理： #

部署任务生成的deployment.env文件会被GitLab解析，其中的BASE_URL变量会自动被注入到e2e-test任务的环境中，测试任务直接用$BASE_URL就能拿到对应环境的URL，不管是生产还是预发布环境，完全复用同一个测试任务。

2. 用Artifacts传递变量文件（兼容旧版GitLab） #

如果你的GitLab版本不支持dotenv报告（低于12.0版本），可以直接把变量文件作为artifacts传递，然后在测试任务里手动加载。

示例配置： #

deploy:
  stage: deploy
  script:
    - echo "BASE_URL=$CI_ENVIRONMENT_URL" > .env.deployment
  artifacts:
    # 指定要传递的文件路径
    paths:
      - .env.deployment
  environment:
    name: $CI_ENVIRONMENT_NAME
    url: $CI_ENVIRONMENT_URL

e2e-test:
  stage: test
  needs: [deploy]
  script:
    # 把变量加载到当前shell环境中（Linux/macOS）
    - source .env.deployment
    # 启动Cypress测试
    - npx cypress run --env baseUrl=$BASE_URL

注意： #

如果用的是Windows Runner，加载变量的命令要换成type .env.deployment | set /p或者其他Windows兼容的方式。

3. 优化Cypress配置，自动读取环境变量 #

你还可以在Cypress的配置文件里直接读取环境变量，这样测试脚本里连--env参数都不用加了，更简洁：

在cypress.config.js中添加：

module.exports = defineConfig({
  e2e: {
    baseUrl: process.env.BASE_URL || 'http://localhost:3000', // 加个默认值防止变量不存在
    // 其他Cypress配置...
  },
});

这样测试任务的脚本直接写npx cypress run就行，Cypress会自动用$BASE_URL作为baseUrl。

关键注意点： #

• 确保测试任务通过needs或者dependencies关联到部署任务，这样才能拿到artifacts或者dotenv变量。
• 部署任务的environment配置必须正确，这样$CI_ENVIRONMENT_URL才会对应到当前环境的真实URL。
• 这种方式完全不用为不同环境写多个测试任务，只要部署任务对应不同的环境，测试任务会自动拿到对应的URL。

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