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
• 可选依赖组件：
  • PostgreSQL
  • Redis
  • MinIO
• 可选附加组件：
  • 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 

–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文件

2. 添加、查看远程仓库

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

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

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

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

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

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

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

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

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

# git commit -m "test modify readme.md"  *** Please tell me who you are.  Run    git config --global user.email "you@example.com"   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 "vfan@163.com" # 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%) 

6. 推送至远程仓库

# git push -u origin main  Username for 'http://gitlab.example.com:880': vfan Password for 'http://vfan@gitlab.example.com: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 = vfan@163.com  name = vfan [credential]  helper = store 

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

7. 代码撤销和撤销同步

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

# 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 <任意版本号> --> 恢复到本地仓库的指定版本，并清空暂存区和工作区的修改 

8. 合并分支

创建并切换到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 

9. 删除分支

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