Gitlab 基本实操

• Gitlab 基本实操
  • Gitlab简括
  • 安装参考
    • gitlab 安装目录
    • gitlab 命令
  • GitLab的基本操作
    • 创建用户
    • 关闭注册页面
    • 创建项目组
    • 创建项目
  • GitFlow的三种流程
    • 最早期分支流程
    • 第二种分支流程
    • 第三种分支流程
  • GitLab CI
  • GitLab Runner注册和安装
    • 下载安装包
    • 注册Runner
    • 添加SSH Keys
    • 创建项目
    • 解决Docker非服务启动问题
  • 私有仓库的搭建
    • Docker registry介绍
    • 运用Docker registry
    • 运用Docker registry UI(docker-registry-frontend)
    • Docker registry本地基本身份验证

Gitlab简括

Gitlab 本身是一个代码托管的工具。
特点如下：

• 免费、开源
• 功能强大
• 分布式
• Git flow
• Git CI

安装参考

https://docs.gitlab.com/omnibus/docker/

请提前为 $GITLAB_HOME 环境变量提供路径

docker run --detach \
  --hostname localhost \
  --publish 8929:8929 --publish 2222: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 \
  gitlab/gitlab-ce:latest

或

sudo docker run --detach \
--hostname 127.0.0.1 \
--publish 8929:8929 --publish 2222:22 \
--name gitlab \
--restart always \
--volume /srv/gitlab/config:/etc/gitlab \
--volume /srv/gitlab/logs:/var/log/gitlab \
--volume /srv/gitlab/data:/var/opt/gitlab \
gitlab/gitlab-ce:latest

进入容器内部

sudo docker exec -it gitlab /bin/bash

/etc/gitlab/gitlab.rb用您的编辑器打开并设置external_url：

# For HTTP
external_url "http://gitlab.example.com:8929"
or
# For HTTPS (notice the https)
external_url "https://gitlab.example.com:8929"

设置gitlab_shell_ssh_port：

gitlab_rails['gitlab_shell_ssh_port'] = 2222

最后，重新配置GitLab：

gitlab-ctl reconfigure

注意运行内存8个g，如果需要对资源进行限制，可以参考这篇文章：https://www.cnblogs.com/zhuochong/p/9728383.html

gitlab 安装目录

gitlab 命令

# gitlab-ctl #客户端命令行操作行
# gitlab-ctl reconfigure #重新加载配置
# gitlab-ctl stop #停止gitlab
# gitlab-ctl start #启动gitlab
# gitlab-ctl restart #重启gitlab
# gitlab-ctl status #查看组件运行状态
# gitlab-ctl tail nginx #查看某个组件的日志

GitLab的基本操作

创建用户

关闭注册页面

创建项目组

创建项目

GitFlow的三种流程

最早期分支流程

问题有如下两点:

• 当 Jesse 代码有问题时,需要等待 Jesse 在本地修改完成后，Lei 才可以再次拉取与提交代码，会造成 Master 分支拥堵。
• 测试直接影响 Master 分支对线上项目有一定影响

第二种分支流程

问题:

• 这种开发模式只适合一个开发团队，不适合多个团队同时开发

第三种分支流程

GitLab CI

GitLab CI 支持多平台（Windows、OSX、Unix) 多语言（Java、Php、Ruby等)，这其中自然也包括C#。它还有以下几个特性：

• 分布式运行：多服务器、并行
• 可以运行在本地、Docker容器、SSH Remote等
• 支持批处理：windows、Power Shell （这让我们用msbuild 编译上一代的.net程序有了可能）

在使用也就是执行阶段，GitLab Runner 给我们提供了以下7种执行方式。官方称之为 executors。

• Shell
• Docker
• Docker Machine
• Parallels
• VirtualBox
• SSH
• Kubernetes

在注册Runner阶段，我们就需要选择executor，我们今天将选择使用本地Shell这种大家最熟悉的方式来执行作业Job。

GitLab Runner注册和安装

下载安装包

wget -O /usr/local/bin/gitlab-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-amd64

赋予执行权限

chmod +x /usr/local/bin/gitlab-runner

注册Runner

1.输入以下命令启动注册

gitlab-runner register

2.在GitLab Server上找到相关信息（从首页的Gitlab config中去设置）

3.注册相关信息

4.查看CI

添加SSH Keys

1.从本地路径找到C:\Users\{用户名}}\.ssh\id_rsa.pub显示SSH的key

2.添加 SSH-Key

创建项目

1.创建项目地址

2.编写.gitlab-ci.yml

rtest:
    script:
        - cd User.API
        - docker-compose up -d --build --force-recreate
        - docker rmi $(docker images | grep "none" | awk '{print $3}')

3.按照项目提示的方式提交代码

git init
git remote add origin ssh://git@127.0.0.1:2222/root/beta2.git
git add .
git commit -m "Initial commit"
git push -u origin master

解决Docker非服务启动问题

解决方案(1)

service docker start

systemctl enable docker.service

systemctl status docker.service

解决方案(2)

sudo usermod -aG docker gitlab-runner

私有仓库的搭建

Docker registry介绍

如果要执行以下操作，则应使用registry介绍：

• 严格控制图像的存储位置
• 完全拥有您的图像分发管道
• 将图像存储和分发紧密集成到您的内部开发工作流程中

运用Docker registry

docker run -d -p 311:5000 --name registry registry:2

docker tag alpine localhost:311/alpine:local
docker images

docker push localhost:311/alpine:local

运用Docker registry UI(docker-registry-frontend)

docker run -d --name registry-web --link registry:registry -e ENV_DOCKER_REGISTRY_HOST=registry -e ENV_DOCKER_REGISTRY_PORT=5000 -p 312:80 konradkleine/docker-registry-frontend:v2

Docker registry本地基本身份验证

实现访问限制的最简单方法是通过基本身份验证（这与其他Web服务器的基本身份验证机制非常相似）。本示例使用本机基本身份验证htpasswd来存储机密。

1.创建一个密码文件，为用户提供一个条目testuser，密码为 testpassword：

mkdir auth
yum -y install httpd
htpasswd -Bbn testuser testpassword > auth/htpasswd

或

docker run \
  --entrypoint htpasswd \
  registry:2 -Bbn testuser testpassword > auth/htpasswd

2.如果使用的是第二种方式注意停止registry。

docker container stop registry

3.使用基本身份验证启动注册表。

docker run -d \
  --restart=always \
  --name registry \
  -v `pwd`/auth:/auth \
  -e "REGISTRY_AUTH=htpasswd" \
  -e "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm" \
  -e "REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd" \
  -v `pwd`/cert:/certs \
  -v /root/docker/registry:/var/lib/registry\
  -e REGISTRY_HTTP_ADDR=0.0.0.0:443 \
  -e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/xxxx.crt \
  -e REGISTRY_HTTP_TLS_KEY=/certs/xxxx.key \
  -p 443:443 \
  registry:2

未完待续…..