Gitlab安装及配置

HanlyJiang

已于 2022-05-26 22:25:37 修改

阅读量3.3k

点赞数

分类专栏：代码管理&CI&CD 文章标签： gitlab 持续集成系统代码托管

于 2021-03-04 14:11:22 首次发布

本文链接：https://blog.csdn.net/hanly_jiang/article/details/114367174

版权

代码管理&CI&CD 专栏收录该内容

7 篇文章 0 订阅

订阅专栏

主要内容：

使用docker运行 gitlab；
配置LDAP及邮箱；
配置管理员账号；
配置邮箱通知；
关闭用户注册；

安装

我们使用docker来安装Gitlab，执行如下命令即可安装运行，完成后使用

export GITLAB_DATA=/data/gitlab
# 设置主机的ip域名
export HOST_IP=192.168.43.62
mkdir $GITLAB_DATA/config $GITLAB_DATA/logs $GITLAB_DATA/data
docker run --detach \
        --hostname $HOST_IP \
        --publish 443:443 --publish 80:80 --publish 22:22 \
        --name gitlab \
        --restart always \
        --volume $GITLAB_DATA/config:/etc/gitlab \
        --volume $GITLAB_DATA/logs:/var/log/gitlab \
        --volume $GITLAB_DATA/data:/var/opt/gitlab \
        gitlab/gitlab-ce:13.9.1-ce.0

数据全部挂载在外部目录 GITLAB_DATA 中
--hostname 192.168.43.62 : 指定当前服务的IP或者域名，后续将会显示为gitlab代码仓库的克隆地址
--restart always : 设置服务自动重启

查看gitlab的可用版本：

dockerhub/gitlab-ce
gitlab release page

查看启动状态

启动期间可以使用 docker ps 查看状态，如STATUS中显示为starting则表示服务还在启动中，如显示为healthy则表示服务已正常启动，即可访问 http://192.168.43.62 访问Gitlab的web地址。

CONTAINER ID        IMAGE                          COMMAND             CREATED             STATUS                 PORTS                                                          NAMES
79b432f0f601        gitlab/gitlab-ce:13.0.6-ce.0   "/assets/wrapper"   2 months ago        Up 2 weeks (healthy)   0.0.0.0:22->22/tcp, 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   gitlab

也可使用 docker logs -f gitlab 来查看gitlab的服务启动日志

设置root管理员用户密码

首次打开页面后会提示设置root用户的密码，设置后务必记录好用户密码，后续将使用此用户对Gitlab进行管理

20210302163607

配置LDAP

服务启动正常后，$GITLAB_DATA/config 文件夹中即生成了gitlab的配置文件，可编辑$GITLAB_DATA/config/gitlab.rb （对应容器内部 /etc/gitlab/gitlab.rb ）文件来修改gitlab配置以使用LDAP

vim /etc/gitlab/gitlab.rb

通过? 搜索LDAP，找到如下配置端，按如下方式进行修改：


### LDAP Settings
###! Docs: https://docs.gitlab.com/omnibus/settings/ldap.html
###! **Be careful not to break the indentation in the ldap_servers block. It is
###!   in yaml format and the spaces must be retained. Using tabs will not work.**

gitlab_rails['ldap_enabled'] = true

gitlab_rails['ldap_servers'] = YAML.load <<-'EOS'
   main:
     label: '域账号'
     host: '172.17.0.3'
     port: 389
     uid: 'sAMAccountName'
     bind_dn: 'CN=域账号读取用户,OU=colorless-域用户,DC=colorless,DC=com,DC=cn'
     password: '域账号读取用户的登录密码'
     encryption: 'plain' # "start_tls" or "simple_tls" or "plain"
     verify_certificates: false
     smartcard_auth: false
     active_directory: true
     allow_username_or_email_login: false # 是否允许以用户名登录（邮箱也会取用户名来严重）
     lowercase_usernames: false
     block_auto_created_users: false
     base: 'OU=colorless-域用户,DC=colorless,DC=com,DC=cn'
     user_filter: ''
EOS

配置修改说明：

ldap_enabled 需要设置为true
ldap_servers 配置AD域相关信息
label：随便取，会显示在gitlab的登录页面
host：域控制服务器主机地址
port：域控制器服务端口
uid：将域用户信息中的哪个字段作为gitlab上的登录标识（一般都是sAMAccountName）
bind_dn：用于访问域控制服务器的用户账号，用户账号的格式需要使用CN=xxx,OU=XXX,DC=XXXX 类似的格式
password：对应的base_dn账号的密码
base：用于登录时，会去base所定义的组里面去检索用户是否存在，如用户在这个范围内，才可以登录；如及用于公司一个部门的登录，可将base值配置到部门级别，则其他部分无法以域账号进行登录；

提示：如无法确认 uid，bind_dn，base 等的值，可以咨询信息中心或者使用AD域访问查看软件（如：Apache Directory）连接到域账号控制器服务后，通过图形界面查看对应信息；

修改完毕后需要保存文件后重启gitlab服务，对于docker启动的gitlab来说，可执行如下命令重启服务：

# 其中gitlab为我们使用docker run 命令时通过--name选项指定的容器名称
docker restart gitlab

待gitlab重启完毕后，登录界面即出现域账号登录的tab入口，点击域账号tab即可使用域账号进行登录

配置邮箱通知

公司邮箱服务器配置：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "mail.colorless.com.cn"
gitlab_rails['smtp_port'] = 25
gitlab_rails['smtp_user_name'] = "gitlab@colorless.com.cn"
gitlab_rails['smtp_password'] = "xxxxx"
gitlab_rails['smtp_domain'] = "colorless.com.cn"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false

163邮箱配置示例：（需在163邮箱中开启SMTP服务，可参考： CSDN-如何使用163的SMTP服务发邮件？）

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.163.com"
gitlab_rails['smtp_port'] = 25
gitlab_rails['smtp_user_name'] = "colorless@163.com"
gitlab_rails['smtp_password'] = "密码"
gitlab_rails['smtp_domain'] = "163.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false