如何修改本地Docker部署GitLab Omnibus实例创建新项目的默认README.md

1. 进入GitLab容器 #

先查运行中的GitLab容器ID或名称，再进入容器内部：

docker ps | grep gitlab
docker exec -it <容器ID/名称> /bin/bash

2. 定位并编辑默认README模板 #

GitLab Omnibus的默认项目README模板路径为：

/opt/gitlab/embedded/service/gitlab-rails/lib/gitlab/ci/templates/README.md

用vi打开文件直接修改：

vi /opt/gitlab/embedded/service/gitlab-rails/lib/gitlab/ci/templates/README.md

3. 替换为团队定制模板 #

把原有内容换成适配你们工作流程的模板，比如：

项目基础信息 #

核心字段 #

• 负责人：_______
• 所属团队：_______
• 当前状态：□ 计划中 □ 开发中 □ 已上线

项目简介 #

简述项目目标、核心业务场景

技术栈清单 #

• 后端：_______
• 前端：_______
• 数据库：_______
• 中间件：_______

开发/部署指南 #

1. 本地环境搭建步骤
2. 代码提交规范
3. 线上部署流程

其他说明 #

项目相关的特殊要求、风险提示等

4. 保存并生效 #

编辑完成后保存退出vi，再退出容器：

exit

如果修改后创建新项目没生效，重启容器内的GitLab服务：

docker exec <容器ID/名称> gitlab-ctl restart

持久化修改（避免容器重启后丢失） #

直接修改容器内文件会在容器重启后被覆盖，要永久生效，把自定义模板挂载到容器：

1. 宿主机先创建模板文件：

mkdir -p /opt/gitlab/custom-templates
vi /opt/gitlab/custom-templates/README.md

2. 重新启动容器时添加挂载参数（已运行容器需先停止再重建）：

docker run -d \
  --name gitlab \
  -v /opt/gitlab/custom-templates/README.md:/opt/gitlab/embedded/service/gitlab-rails/lib/gitlab/ci/templates/README.md \
  # 此处添加你原有端口、数据挂载等参数
  gitlab/gitlab-omnibus:latest

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