1. 实验目标
本实验的目的是自行搭建一个 Git 远程仓库托管平台 Gitea,并完整演示一个项目从创建 Git 仓库到发布一个版本的完整操作过程。
2. 环境准备
- 操作系统: Ubuntu 20.04 (虚拟机)
- Git 版本: 2.25.1
- Gitea 版本: latest (Docker 运行)
- Docker 版本: 20.10.21
3. 搭建 Gitea 服务器
3.1 运行 Gitea
使用 Docker 运行 Gitea:
sudo docker run -d --name gitea -p 3000:3000 -p 22:22 gitea/gitea:latest
该命令会:
- 以
-d
方式后台运行 Gitea。 - 绑定 3000 端口(Web 访问)和 22 端口(SSH 访问)。
- 使用
gitea/gitea:latest
最新版镜像。
3.2 确认 Gitea 运行状态
sudo docker ps | grep gitea
如果看到类似如下的输出,说明 Gitea 运行成功:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
0eca4e5ee472 gitea/gitea:latest ... Up 2 minutes 0.0.0.0:3000->3000/tcp, 0.0.0.0:22->22/tcp gitea
3.3 访问 Gitea Web 界面
在浏览器中输入 http://localhost:3000
,初始化 Gitea 并创建一个管理员账号。
3.4 创建 Git 仓库
- 登录 Gitea 后,点击 New Repository。
- 输入仓库名称
my_project
,保持默认设置,点击 Create Repository。 - 复制仓库地址
http://localhost:3000/your_username/my_project.git
。
4. Git 本地操作流程
4.1 初始化 Git 仓库
git init my_project
cd my_project
4.2 配置 Git 用户信息
git config --global user.name "lxc"
git config --global user.email "lxc@example.com"
4.3 创建 README 文件并提交
echo "# My Project" > README.md
git add README.md
git commit -m "初始化项目"
4.4 关联远程仓库
git remote add origin http://localhost:3000/lxc/my_project.git
4.5 推送主分支
git branch -M main
git push -u origin main
4.6 创建并切换到新分支
git checkout -b feature-1
echo "print('Hello, Git')" > main.py
git add main.py
git commit -m "添加主程序"
git push -u origin feature-1
5. 在 Gitea 确认代码提交
- 打开浏览器访问
http://localhost:3000/lxc/my_project
。 - 进入
main
和feature-1
分支,查看代码是否正确提交。
6. 版本发布
当代码开发完成后,可以创建一个版本(Tag):
git tag -a v1.0 -m "版本 1.0 发布"
git push origin v1.0
在 Gitea 远程仓库 Releases
页面可以看到 v1.0
版本。
7. 结论
本实验成功搭建了 Gitea 作为 Git 托管平台,并演示了完整的 Git 操作流程,包括初始化 Git 仓库、远程仓库关联、分支管理、推送代码和发布版本。该流程适用于个人或小型团队的 Git 代码管理实践。