devops-gitlab

介绍

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

核心组件：
- NGINX Ingress
- Registry
- GitLab/Gitaly
- GitLab/GitLab Exporter
- GitLab/GitLab Grafana
- GitLab/GitLab Pages
- GitLab/GitLab Shell
- GitLab/Mailroom
- GitLab/Migrations
- GitLab/Sidekiq
- GitLab/Toolbox
- GitLab/Webservice
可选依赖组件：
可选附加组件：
- Prometheus
- Grafana
- 无特权的极狐GitLab Runner，使用 Kubernetes 执行器
- 通过 Let’s Encrypt 自动开启 SSL, 使用 Jetstack 的 cert-manager 和 certmanager-issuer
- GitLab/Praefect
- GitLab/Kubernetes agent server (KAS)
- GitLab/Spamcheck

运行一个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

因为修改了默认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

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

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

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

创建群组、项目

创建群组：
devops-1：代码仓库git的使用-LMLPHP

创建新用户：

devops-1：代码仓库git的使用-LMLPHP

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

devops-1：代码仓库git的使用-LMLPHP

开始创建项目：

devops-1：代码仓库git的使用-LMLPHP

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

devops-1：代码仓库git的使用-LMLPHP

开始使用git来管理gitlab

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

git工作流程

devops-1：代码仓库git的使用-LMLPHP

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

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

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

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

常用操作演示

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

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

添加、查看远程仓库

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

拷贝远程仓库项目到本地

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

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

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

将修改变提交到本地仓库

# 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%)

推送至远程仓库

# 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.

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

# git config --global credential.helper store

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

代码撤销和撤销同步

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

# 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 checkout README.md

# 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

当文件已提交，还未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 <任意版本号> --> 恢复到本地仓库的指定版本，并清空暂存区和工作区的修改

合并分支

创建并切换到dev分支

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

查看当前存在的分支

# git branch
* dev
  main

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

将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

删除分支

方法一：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

Running的菜鸟

devops-1：代码仓库git的使用

devops-gitlab

介绍

运行一个gitlab

创建群组、项目

开始使用git来管理gitlab

git工作流程

常用操作演示