CI/CD / 系统课时

配置 Git 仓库

配置 Git 仓库

本课将从一个空目录开始,完成远程仓库创建、本地关联、主分支与开发分支初始化、首个版本标签发布,并补齐适合 CI/CD 的基础协作规则。

学习目标

  • 创建空远程仓库并将本地项目推送到 main
  • 建立 develop 分支和首个版本标签
  • 配置分支保护、提交规范与合并要求

前置检查

本机需要已安装 Git,并且拥有远程代码托管平台的账号与仓库创建权限。先确认 Git 可用,并设置提交者信息;姓名和邮箱会写入后续提交记录。

bash
git --version
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global --get user.name
git config --global --get user.email

预期输出

text
git version <VERSION>
Your Name
you@example.com

<VERSION> 会随本机安装版本变化。若第一条命令提示找不到 Git,应先完成安装并重新打开终端。

创建并连接远程仓库

在 GitHub、GitLab 或其他托管平台中创建一个空仓库。不要预先生成 README、许可证或 .gitignore,否则远程仓库会先产生一次提交,首次推送时还要额外处理历史合并。

复制仓库的 HTTPS 或 SSH 地址,将其替换到下面的 <REMOTE_URL>。示例会初始化项目、创建首次提交并推送主分支。

bash
mkdir cicd-demo
cd cicd-demo
git init -b main

printf "# CI/CD Demo\n" > README.md
git add README.md
git commit -m "chore: initialize repository"

git remote add origin <REMOTE_URL>
git push -u origin main
git status --short --branch

预期结果

text
## main...origin/main

该状态表示本地 main 已跟踪远程同名分支,且当前没有未提交改动。推送过程中的对象数量和传输日志会因 Git 版本与托管平台不同而变化。完成后,在仓库设置中确认默认分支为 main。

建立开发分支与版本标签

main 用于保存可发布状态,develop 用于集成尚未发布的改动。标签用于固定一个不可移动的版本节点,CI/CD 流水线通常会监听类似 v1.2.0 的标签触发正式发布。

bash
git switch -c develop
git push -u origin develop

git switch main
git tag -a v0.1.0 -m "initial baseline"
git push origin v0.1.0

printf "REMOTES\n"
git remote -v
printf "BRANCHES\n"
git branch --format='%(refname:short) -> %(upstream:short)'
printf "TAGS\n"
git tag --list

预期输出

text
REMOTES
origin  <REMOTE_URL> (fetch)
origin  <REMOTE_URL> (push)
BRANCHES
develop -> origin/develop
main -> origin/main
TAGS
v0.1.0

若平台将远程地址规范化为另一种写法,以 git remote -v 的实际结果为准。-u 会建立本地分支与远程分支的跟踪关系,后续可直接使用 git pull 和 git push。

设置基础协作规则

对 main 开启分支保护,禁止直接推送和强制推送;所有变更必须通过合并请求进入。团队有持续集成任务时,还应要求流水线成功后才能合并。

规则 建议配置 作用
合并方式 合并请求或拉取请求 保留评审入口
审核人数 至少 1 人 避免未经检查直接发布
状态检查 构建与测试必须通过 阻止失败代码进入主分支
历史策略 禁止强推,按需启用 Squash 降低提交历史被改写的风险
提交格式 type: subject 便于生成变更日志和定位改动

常见类型可使用 feat、fix、docs、test、build、ci 和 chore。仓库中还应加入 .gitignore,排除构建产物、依赖目录、密钥和本地配置;任何访问令牌都不得提交到 Git。

本课总结

  • 空远程仓库可避免首次推送时产生无关历史冲突
  • main、develop 和版本标签分别承担发布、集成与版本定位职责
  • 分支保护、评审和状态检查是 CI/CD 仓库的最低协作基线

下一课预告

下一课将根据团队规模选择分支模型,并把功能开发、版本发布和标签命名整理成可执行的版本策略。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Git 仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通