devops-gitlab

gitlab同github、gitee和bitbucket功能一致，都是提供一个存储代码的服务，这里就以gitlab为例，学习一下如何结合git工具使用。

运行一个gitlab

有很多方法可以运行gitlab服务，可以直接在Ubuntu或centos等linux主机中运行，或者使用docker启动，再或者使用helm chart方式运行在k8s中，具体可以参考官方文档：https://gitlab.cn/install/

我这里使用docker运行，用于poc或者测试环境，没有冗余功能。

export GITLAB_HOME=/srv/gitlab

sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 4443:443 --publish 880:80 --publish 222:22 \
  --name gitlab \
  --restart always \
  --volume $GITLAB_HOME/config:/etc/gitlab \
  --volume $GITLAB_HOME/logs:/var/log/gitlab \
  --volume $GITLAB_HOME/data:/var/opt/gitlab \
  --shm-size 256m \
  registry.gitlab.cn/omnibus/gitlab-jh:latest

--shm-size 256m：指定此容器shm共享内存为256m，默认为64m。

因为修改了默认ssh和http的端口，所以容器启动后要在配置文件中重新修改并生效一下：

# docker exec -it gitlab /bin/bash
# vi /etc/gitlab/gitlab.rb
...
external_url "http://gitlab.example.com:880"  # 外部的访问地址及端口
gitlab_rails['gitlab_shell_ssh_port'] = 222
nginx['listen_port'] = 80  # 指的container内部的端口，这个必须指定，不指定会继承上边的880.
...
# gitlab-ctl reconfigure

notice：这里只启用了http，若要启用https，还要手动将其打开。

做个hosts解析，然后访问http://gitlab.example.com:880来登录web页。

用户名为root，密码用以下方法查看：

sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

此文件24h后会变删除，登录成功后，尽快修改密码。

创建群组、项目

创建群组：

根据需求写上自己群组的名称，选择是私有群组、内部群组还是共有群组，自己定义即可。

群组创建完毕后，默认只有创建者自己，后续可以添加新用户到群组。

我这里测试群组为MyTeam。

创建新用户：

填写用户信息及权限设置即可，例如devzhang。

将新用户加入群组，一起来为我们的Team做贡献：

加入此群组后，就可以创建基于此群组的项目。

开始创建项目：

需要注意的是，创建项目时要选定是属于哪个群组或者哪个个人的。

再就是注意可见性级别，有私有、内部和公开三种。

我这里创建了一个名为myint的内部项目，使用的gitlab自带的项目模板，如下：

开始使用git来管理gitlab

Git 是一个快速、可扩展的分布式版本控制系统，具有异常丰富的命令集，可提供高级操作和对内部的完全访问。Git 易于学习，占用空间小，性能快如闪电。它超越了SCM工具，如Subversion，CVS，Perforce和ClearCase，具有廉价的本地分支，方便的暂存区域和多个工作流程等功能。

git工作流程

首先，git分为三个区域，分别是：

1. 工作区（working directory）就是上图黄色部分，就是我们实际修改代码做操作的区域
2. 暂存区（stage index）就是上图标注index的桶装部分，代码完成编辑后，会先将代码添加到缓存区
3. 历史记录区（history）就是记录操作的历史记录或版本的

其次，git有两个仓库，既远程仓库和本地仓库：

1. 远程仓库：上图的remote部分，就是远程存储代码的仓库，例如咱们这里的gitlab
2. 本地仓库：上图的repository部分，就是.git目录，通过本地修改代码后，一般都会先提交到本地，再push到远程仓库

常用操作演示

1. 首先初始化git，生成.git本地目录

# git init  
Initialized empty Git repository in /opt/gitlab/.git/

会在当前目录下生成.git文件

1. 添加、查看远程仓库

# git remote add origin http://gitlab.example.com:880
# git remote show

1. 拷贝远程仓库项目到本地

# git clone http://gitlab.example.com:880/vfan/mypublic.git
# ls
mypublic
# ls mypublic
README.md

1. 修改项目文件内容，提交到暂存区

# git add .
# git status 
	modified:   README.md

git add . --> 把当前目录下所有更改，添加到暂存区。

git add -a --> 把当前项目下所有更改，添加到暂存区。

git add xxx.sh xxx.py --> 添加指定文件到暂存区。

1. 将修改变提交到本地仓库

# git commit -m "test modify readme.md"

*** Please tell me who you are.

Run

  git config --global user.email "[email protected]"
  git config --global user.name "Your Name"

to set your account's default identity.
Omit --global to set the identity only in this repository.

fatal: unable to auto-detect email address (got 'root@iZ2ze20w5xm11rfza1h8ejZ.(none)')

报错是因为，安装git后，要设置下你的邮箱地址和用户名，才可以commit，执行：

# git config --global user.email "[email protected]"
# git config --global user.name "vfan"

重新commit即可：

# git commit -m "test modify readme.md"
[main 8cc5b90] test modify readme.md
 1 file changed, 5 insertions(+), 92 deletions(-)
 rewrite README.md (99%)

1. 推送至远程仓库

# git push -u origin main 
Username for 'http://gitlab.example.com:880': vfan
Password for 'http://[email protected]:880': 
Counting objects: 5, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 297 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To http://gitlab.example.com:880/vfan/mypublic.git
   52bc770..8cc5b90  main -> main
Branch main set up to track remote branch main from origin.

第一次推时需要用-u参数关联上仓库，后边再推直接git push即可。

如果觉得每次都要输入账号密码很麻烦，可以将账号密码直接储存：

# git config --global credential.helper store

## 实际会将配置保存到此文件中
# cat ~/.gitconfig 
[user]
	email = [email protected]
	name = vfan
[credential]
	helper = store

这个时候，再次push，输入账号密码后，系统就会记住，以后便不用再输入。

1. 代码撤销和撤销同步

已经修改文件，但还未添加到暂存区时

# git diff README.md
diff --git a/README.md b/README.md
index 074b4a5..3d82a16 100644
--- a/README.md
+++ b/README.md
@@ -4,4 +4,4 @@
 
 test add commit push ...
 
-one two three four
+one two three four five

git diff xxx.md --> 列出某文件的修改，不指定文件为列出全部文件修改。

撤销修改（将工作区的状态修改为与暂存区一致）

# git checkout README.md

# git clean -f
# git clean -df 

git checkout . --> 撤销当前目录下所有文件的修改

git checkout --> 撤销当前项目下所有文件修改

git clean -f --> 撤销新增加的文件

git clean -df --> 撤销新增加的文件和文件夹

当文件修改已添加到暂存区，但还未提交时，就不能再使用git diff，因为此命令是对比工作区和暂存区的差异，这时就要加参数--cache：

# git diff --cached
diff --git a/README.md b/README.md
index 074b4a5..3d82a16 100644
--- a/README.md
+++ b/README.md
@@ -4,4 +4,4 @@
 
 test add commit push ...
 
-one two three four
+one two three four five

再次撤销修改（暂存区的修改恢复到工作区）：

# git reset README.md 
Unstaged changes after reset:
M	README.md

git reset --soft --> 等价于git reset

git reset --head --> 回到未修改状态，清空暂存区和工作区的修改

当文件已提交，还未push到远端仓库时，执行完commit后，会在仓库中生成一个版本号(hash值)，之后任何时候，都可以借助这个hash值回退到这次提交：

# git diff main origin/main --> 本地main分支和远程仓库main分支对比
# git diff dev master --> 本地dev分支和master分支对比
# git reset --hard HEAD^ --> 恢复到本地仓库的上一个版本，并清空暂存区和工作区的修改
# git reset HEAD^ --> 恢复到本地仓库的上一个版本，并清空暂存区的修改
# git reset --hard <任意版本号> --> 恢复到本地仓库的指定版本，并清空暂存区和工作区的修改

1. 合并分支

创建并切换到dev分支

# git checkout -b dev
Switched to a new branch 'dev'

如果只是新建，不切换，则去掉-b参数

查看当前存在的分支

# git branch  
* dev
  main

# git branch -a
* dev
  main
  remotes/origin/HEAD -> origin/main
  remotes/origin/main

-a 参数表示查看本地仓库和远程仓库所有的分支

将dev分支合并到main分支

# git checkout main --> 首先要切换到要合并的分支，例如这里要合并到main
Switched to branch 'main'

# git pull --> 拉取最新代码到本地

# git merge dev  --> 合并dev分支到main
Updating 3dd81b4..4554445
Fast-forward
 dev-readme.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 dev-readme.md

1. 删除分支

方法一：gitlab页面上删除此分支，然后执行：

## 查看需要清理的分支
# git remote prune origin --dry-run

## 刷新分支列表
# git remote update origin --prune

## 删除本地分支
# git branch -d dev 
Deleted branch dev (was 4554445).

## 查看全部分支
# git branch -a 

方法二：直接使用git删除分支

# git push origin --delete dev
# git branch -d dev