Gitlab CI动态环境URL中$RANDOM_PORT变量未填充问题求助

GitLab CI 的 environment.url 配置是在Job启动前就完成变量解析的，而你在script段落里通过export RANDOM_PORT生成的变量是Job运行时才创建的，此时环境配置早已解析完毕，自然无法获取到运行时生成的端口值。

推荐使用GitLab API动态更新环境URL，这是处理运行时动态变量最可靠的方式：

步骤1：创建GitLab API访问令牌 #

1. 进入你的GitLab项目 → 设置 → 访问令牌
2. 创建一个新令牌，勾选api权限，设置过期时间后保存
3. 将生成的令牌添加到项目的CI/CD变量中，命名为GITLAB_API_TOKEN（记得勾选「掩码」选项，避免泄露）

步骤2：修改gitlab-ci.yml的deploy-stage #

更新后的deploy-stage配置如下：

deploy-stage:
  stage: deploy-stage
  script:
    - docker pull ${DESTINATION_REPOSITORY}:${TAG_COMMIT_VERSION} 
    # 生成随机端口并检查可用性（可选但推荐）
    - |
      while true; do
        export RANDOM_PORT=$(shuf -i 1000-9999 -n 1)
        # 检查端口是否已被占用（需要测试服务器安装nc工具）
        nc -z 192.168.208.8 $RANDOM_PORT || break
      done
    - echo $RANDOM_PORT
    - docker run -d --name ${TAG_COMMIT_VERSION} -p $RANDOM_PORT:80 ${DESTINATION_REPOSITORY}:${TAG_COMMIT_VERSION}
    # 通过API更新环境URL
    - |
      curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/environments/${CI_ENVIRONMENT_SLUG}" \
        --form "url=http://192.168.208.8:$RANDOM_PORT"
  environment :
     name: main-stage
     url: http://192.168.208.8:placeholder # 占位符，后续由API动态替换

额外说明 #

• 端口检查逻辑：添加while循环确保生成的端口未被占用，避免docker run因端口冲突失败
• API请求中使用的CI_API_V4_URL、CI_PROJECT_ID、CI_ENVIRONMENT_SLUG都是GitLab内置的预定义变量，无需手动配置

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