GitLab从模板仓库创建新仓库时如何自定义修改对应文件

方案1：使用GitLab内置CI变量 + 初始化渲染（推荐，无需额外工具） #

• 给模板仓库内需要修改的配置文件添加统一格式的占位符，比如应用名、服务端口、域名等参数，统一写成{{APP_NAME}}、{{SERVER_PORT}}、{{DOMAIN}}的形式
• 在模板仓库根目录新建.gitlab/ci/init.yml文件，编写首次初始化的CI任务，核心逻辑为读取用户填写的变量，批量替换所有文件中的对应占位符，再自动提交到新仓库的默认分支
• 进入模板仓库的「设置」→「CI/CD」→「变量」页面，添加所有需要用户填写的参数变量，同时勾选「在新项目中可覆盖」「在创建项目时显示」两个选项；敏感参数可以额外勾选「掩码」，避免日志泄露
• 后续用户从该模板创建新项目时，GitLab会自动弹出变量填写弹窗，用户填完参数后CI会自动执行初始化任务，完成所有配置文件的修改，无需本地操作

方案2：群组级统一模板配置（适合企业/团队内部场景） #

• 进入对应群组的「设置」→「模板」→「项目模板」页面，将你的仓库设置为群组公开项目模板
• 在群组级别统一配置模板必填参数，所有从该模板创建的项目都会强制触发参数填写流程，避免遗漏配置
• 可以在CI初始化任务中添加参数合法性校验逻辑，不符合格式要求的参数会直接中断初始化并返回错误提示，降低配置出错概率

初始化CI任务示例 #

stages:
  - init

replace_template_params:
  stage: init
  # 仅在项目首次创建的默认分支流水线触发
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH && $CI_PIPELINE_SOURCE == "create"
  script:
    # 批量替换所有非.git目录下的文件占位符
    - sed -i "s/{{APP_NAME}}/$APP_NAME/g" $(find . -type f -not -path "./.git/*")
    - sed -i "s/{{SERVER_PORT}}/$SERVER_PORT/g" $(find . -type f -not -path "./.git/*")
    - sed -i "s/{{DOMAIN}}/$DOMAIN/g" $(find . -type f -not -path "./.git/*")
    # 提交修改到仓库
    - git config user.name "GitLab CI Bot"
    - git config user.email "ci@your-domain.com"
    - git add .
    - git commit -m "chore: 初始化模板参数"
    - git push "https://$CI_JOB_TOKEN@$CI_SERVER_HOST/$CI_PROJECT_PATH.git" HEAD:$CI_DEFAULT_BRANCH
  variables:
    GIT_DEPTH: 1

注：内置的CI_JOB_TOKEN默认拥有项目推送权限，无需额外配置访问令牌

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