一、概述

GitLab是一个基于Web的Git存储库管理器，为软件开发提供完整的DevOps平台。它允许开发人员协作编写代码，管理项目，并自动化软件交付过程。GitLab提供广泛的功能，包括版本控制、问题跟踪、持续集成和部署、代码审查等等。

GitLab有两个版本：社区版和企业版。社区版是开源的，可以免费使用，而企业版是商业产品，提供额外的功能和支持。

一些关键特性包括：

  • Git存储库管理：GitLab提供一个集中式的位置来存储和管理Git存储库。
  • 持续集成和部署（CI/CD）：GitLab提供内置的CI/CD流水线，自动化代码更改的测试、构建和部署。
  • 问题跟踪：GitLab提供内置的问题跟踪系统，允许开发人员跟踪错误和功能请求。
  • 代码审查：GitLab允许开发人员在代码更改之前进行审查和讨论，以提高代码质量。

官方文档：https://docs.gitlab.com/ee/

版本分为：社区版（CE），企业版（EE）

二、gitlab 架构原理

gitlab 社区版升级 gitlab社区版本_git

  • repository：代码库，可以是硬盘或 NFS 文件系统
  • Nginx：Web 入口
  • postgresql 数据库：包含以下信息：
  • repository 中的数据（元数据，issue，合并请求 merge request 等）
  • 可以登录 Web 的用户（权限）
  • Redis：缓存，负责分发任务
  • sidekiq：后台任务，主要负责发送电子邮件。任务需要来自 Redis
  • Unicorn：Gitlab 自身的 Web 服务器，包含了 Gitlab 主进程，负责处理快速/一般任务，与 Redis 一起工作。工作内容包括：
  • 通过检查存储在 Redis 中的用户会话来检查权限
  • 为 Sidekiq 制作任务
  • 从仓库（warehouse）取东西或在那里移动东西
  • gitlab-shell：用于 SSH 交互，而不是 HTTP。gitlab-shell 通过 Redis 与 Sidekiq 进行通信，并直接或通过 TCP 间接访问 Unicorn
  • gitaly：后台服务，专门负责访问磁盘以高效处理 git 操作，并缓存耗时操作。所有的 git 操作都通过 Gitaly 处理
  • gitlab-workhorse：反向代理服务器，可以处理与 Rails 无关的请求（磁盘上的CSS、JS 文件等），处理Git Push/Pull 请求，处理到Rails的连接（修改由Rails发送的响应或发送给 Rails 的请求，管理 Rails 的长期 WebSocket 连接等）。
  • mail_room：处理邮件请求。回复 GitLab 发出的邮件时，GitLab 会调用此服务

总之，GitLab的架构旨在提供一个高度可定制和可扩展的DevOps平台，以支持现代软件开发和交付的需求。

三、前期准备

1）部署 docker

# 安装yum-config-manager配置工具
yum -y install yum-utils

# 建议使用阿里云yum源：（推荐）
#yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 安装docker-ce版本
yum install -y docker-ce
# 启动并开机启动
systemctl enable --now docker
docker --version

2）部署 docker-compose

curl -SL https://github.com/docker/compose/releases/download/v2.16.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

chmod +x /usr/local/bin/docker-compose
docker-compose --version

四、直接通过 docker 部署 gitlab

官方文档：https://docs.gitlab.com/ee/install/docker.html

sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22: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 \
  gitlab/gitlab-ce:latest

获取密码

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

访问：http://ip 或者 http://${hostname}

五、通过docker-compose部署 gitlab

1）下载 gitlab 镜像

# 这里安装社区版，企业版：gitlab/gitlab-ee:latest
docker pull gitlab/gitlab-ce:latest

2）docker-compose 文件配置

在当前目录下创建目录

mkdir config logs data

docker-compose.yaml

version: '3.6'
services:
  web:
    image: 'gitlab/gitlab-ce:latest'
    restart: always
    hostname: 'www.mygitlab.com'
    environment:
      TZ: 'Asia/Shanghai'
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://192.168.182.110:30080' # web站点访问地址
        # Add any other gitlab.rb configuration here, each on its own line
    ports:
      - '30080:30080' # 注意宿主机和容器内部的端口要一致，否则external_url无法访问
      - '30443:443'
      - '30022:22'
    volumes:
      - './config:/etc/gitlab'
      - './logs:/var/log/gitlab'
      - './data:/var/opt/gitlab'
    shm_size: '256m'

3）执行部署

docker-compose -f docker-compose.yml up -d

# 查看日志
docker-compose logs -f

# 查看状态
docker-compose -f docker-compose.yml ps

容器起来之后，默认用户是root，要登录web界面需要先进入容器的这个文件获取密码：

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

gitlab 社区版升级 gitlab社区版本_数据库_02

web 访问：http://ip:port

4）解读 gitlab Dockerfile 文件

FROM ubuntu:20.04
MAINTAINER GitLab Inc. <support@gitlab.com>

SHELL ["/bin/sh", "-c"]

# 设置编码
ENV LANG=C.UTF-8

# 安装必须得依赖包
# BusyBox 是一个小型可执行文件，它结合了许多常见 UNIX 实用程序的精简版。它占用很小的体积，通常用在嵌入式设备上。在安卓系统上安装busybox，就可以运行更多的unix命令如vi，find，grep，cat，wegt等。
# tzdata软件包：是一组表示地球上各地的时间历史的代码和数据，目前由IANA维护。
RUN apt-get update -q \
    && DEBIAN_FRONTEND=noninteractive apt-get install -yq --no-install-recommends \
      busybox \
      ca-certificates \
      openssh-server \
      tzdata \
      wget \
    && rm -rf /var/lib/apt/lists/*

# 使用 BusyBox
ENV EDITOR /bin/vi
RUN busybox --install \
    && { \
        echo '#!/bin/sh'; \
        echo '/bin/vi "$@"'; \
    } > /usr/local/bin/busybox-editor \
    && chmod +x /usr/local/bin/busybox-editor \
    && update-alternatives --install /usr/bin/editor editor /usr/local/bin/busybox-editor 1

# 删除 MOTD
# MOTD 是message of the day的缩写，意思是“当天的提示信息”，通常在用户成功登录到Linux后出现，该信息可以从/etc/motd文本文件中找到
RUN rm -rf /etc/update-motd.d /etc/motd /etc/motd.dynamic
RUN ln -fs /dev/null /run/motd.dynamic

# 拷贝资源
COPY RELEASE /
COPY assets/ /assets/

# 设置资源的权限，去掉w写权限
RUN chmod -R og-w /assets RELEASE ; \
  /assets/setup

# 允许访问内置的工具
ENV PATH /opt/gitlab/embedded/bin:/opt/gitlab/bin:/assets:$PATH

# 设置TERM环境变量
ENV TERM xterm

# 暴露ssh, http, ssh端口
EXPOSE 443 80 22

# 定义卷
VOLUME ["/etc/gitlab", "/var/opt/gitlab", "/var/log/gitlab"]

# 包装器来处理信号、触发runit并重新配置GitLab
CMD ["/assets/wrapper"]

# 配置健康检查
HEALTHCHECK --interval=60s --timeout=30s --retries=5 \
CMD /opt/gitlab/bin/gitlab-healthcheck --fail --max-time 10

六、gitlab 操作（拉取和提交代码）

1）配置 ssh 秘钥

gitlab 社区版升级 gitlab社区版本_docker_03

2）创建项目

gitlab 社区版升级 gitlab社区版本_docker_04

3）拉取代码

git clone git@192.168.182.110:root/test.git

4）提交代码

git add .
git commit -m "test"
git push origin master

这里只是浅显的演示了，关于更多git的操作可以参考我之前的文章：Git常用操作（Gitlab）

七、gitlab 常用命令

# 启动所有 gitlab 组件；
gitlab-ctl start

# 停止所有 gitlab 组件；
gitlab-ctl stop

# 重启所有 gitlab 组件；
gitlab-ctl restart

# 查看服务状态；
gitlab-ctl status

# 修改gitlab配置文件；
vim /etc/gitlab/gitlab.rb

# 重新编译gitlab的配置；
gitlab-ctl reconfigure

# 检查gitlab；
gitlab-rake gitlab:check SANITIZE=true --trace    

# 查看日志；
gitlab-ctl tail        
gitlab-ctl tail nginx/gitlab_access.log

gitlab 一般作为公司的内部代码仓库，用的还是比较多的，通过docker-compose 快速部署 gitlab 的讲解就先到这里了。