美文网首页
gitlab安装与配置

gitlab安装与配置

作者: 凤之恋 | 来源:发表于2019-05-04 14:49 被阅读0次

参考资料

官方文档 https://docs.gitlab.com/ce/
安装说明 https://about.gitlab.com/install

安装

官方企业版安装文档 https://about.gitlab.com/install/#centos-7?version=ee
官方社区版安装文档 https://about.gitlab.com/install/#centos-7?version=ce
清华大学镜像站 https://mirror.tuna.tsinghua.edu.cn/help/gitlab-ce/

参照上述官方文档即可安装，其中需要注意以下地方。

  • 如果没有开启firewalld可以不用执行命令行中关于firewalld的指令
  • 如果你想使用其他邮件系统发送邮件通知可以不用安装postfix
  • 注意在执行sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ee安装时替换地址https://gitlab.example.com 如果你这里使用https，系统会自动给你配置一个证书，也可以使用http。当然你可以安装完毕之后通过修改配置文件/etc/gitlab/gitlab.rb修改
  • 注意选择版本ee企业版，ce社区版

以下为centos7 ce社区版，使用清华大学的镜像的安装示例

  1. 安装依赖包
yum install -y curl policycoreutils-python openssh-server openssh-clients
systemctl enable sshd
systemctl start sshd
  1. 添加清华大学的gitlab-ce镜像 https://mirror.tuna.tsinghua.edu.cn/help/gitlab-ce/

新建 /etc/yum.repos.d/gitlab-ce.repo，内容为

[gitlab-ce]
name=Gitlab CE Repository
baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
gpgcheck=0
enabled=1
  1. 安装gitlab-ce
yum makecache
EXTERNAL_URL="http://code.cainiaolexue.com:8090" yum install -y gitlab-ce

服务配置

官方文档 https://docs.gitlab.com/omnibus/README.html#installation-and-configuration-using-omnibus-package

注意：

  • 在gitlab的服务架构中，unicorn是ruby的http server，nginx只是unicorn的反向代理。
  • 配置文件地址 /etc/gitlab/gitlab.rb，配置修改之后执行 gitlab-ctl reconfigure 使配置生效到各个服务的配置中去。
  • 以下为我主要调整的配置项。（因为存在端口占用冲突的情况，主要是修改各种端口）
external_url 'http://code.cainiaolexue.com:8090'

# 优化unicorn服务
unicorn['worker_processes'] = 2

# 调整时区
gitlab_rails['time_zone'] = 'Asia/Shanghai'

gitlab_rails['gitlab_email_enabled'] = true
gitlab_rails['gitlab_email_from'] = 'service@cainiaolexue.com'
gitlab_rails['gitlab_email_display_name'] = '源码管理系统'
gitlab_rails['gitlab_email_reply_to'] = 'service@cainiaolexue.com'
gitlab_rails['gitlab_email_subject_suffix'] = ''

# 配置邮箱 https://docs.gitlab.com/omnibus/settings/smtp.html

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.ym.163.com"
gitlab_rails['smtp_port'] = 994
gitlab_rails['smtp_user_name'] = "service@cainiaolexue.com"
gitlab_rails['smtp_password'] = "smtp password"
gitlab_rails['smtp_domain'] = "cainiaolexue.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['smtp_openssl_verify_mode'] = 'peer'

# If your SMTP server does not like the default 'From: gitlab@localhost' you
# can change the 'From' with this setting.
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'
gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com'

查看配置

[root@web37 ~]# grep -v "#" /etc/gitlab/gitlab.rb  | grep -v "^$"
external_url 'http://code.cainiaolexue.com:80090'
unicorn['worker_processes'] = 2
gitlab_rails['time_zone'] = 'Asia/Shanghai'
gitlab_rails['gitlab_email_enabled'] = true
gitlab_rails['gitlab_email_from'] = 'service@cainiaolexue.com'
gitlab_rails['gitlab_email_display_name'] = '源码管理系统'
gitlab_rails['gitlab_email_reply_to'] = 'service@cainiaolexue.com'
gitlab_rails['gitlab_email_subject_suffix'] = ''
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.ym.163.com"
gitlab_rails['smtp_port'] = 994
gitlab_rails['smtp_user_name'] = "service@cainiaolexue.com"
gitlab_rails['smtp_password'] = ""
gitlab_rails['smtp_domain'] = "cainiaolexue.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
[root@web37 ~]#

因为我的服务器上有另外一个nginx，所以我使用了8090端口作为gitlab的访问，也可以在之前的nginx上使用反向代理。

server {
        listen 80;
        server_name code.cainiaolexue.com;
        access_log  /data/weblog/code_access.log  main;
        error_log  /data/weblog/code_error.log;
        location / {
                proxy_redirect off;
                proxy_set_header Host $host;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_pass http://127.0.0.1:8090;
        }
}

GitLab常用命令

gitlab-ctl start        # 启动所有 gitlab 组件
gitlab-ctl stop         # 停止所有 gitlab 组件
gitlab-ctl restart      # 重启所有 gitlab 组件
gitlab-ctl status       # 查看服务状态
gitlab-ctl reconfigure  # 重新配置服务使配置文件写入到各个服务中
gitlab-ctl tail         # 查看日志
gitlab-ctl show-config  # 显示配置信息
vim /etc/gitlab/gitlab.rb  # 修改默认的配置文件
gitlab-rake gitlab:check SANITIZE=true --trace  # 检查gitlab

汉化包

网址 https://gitlab.com/xhang/gitlab

  • 查看gitlab版本 （一定要下载对应版本的汉化文件）
[root@zhangxiu-test gitlab-rails]# rpm -q gitlab-ce
gitlab-ce-11.9.8-ce.0.el7.x86_64
# 或者
[root@zhangxiu-test gitlab-rails]# cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
11.9.8
  • 下载并使用中文包
# 使用 wget
wget https://gitlab.com/xhang/gitlab/-/archive/11-9-stable-zh/gitlab-11-9-stable-zh.tar.gz -O /gitlab-11-9-stable-zh.tar.gz

# 或者使用 git clone 然后选择对应的版本分支
git clone https://gitlab.com/xhang/gitlab.git
git branch -r
git branch

# 查看汉化包版本
cat VERSION

# 备份文件gitlab无法使用（注意此处cp 前的\ 是因为我的cp命令使用了别名 alias）
[root@zhangxiu-test gitlab]# alias
alias cp='cp -i'
alias egrep='egrep --color=auto'
alias fgrep='fgrep --color=auto'
alias grep='grep --color=auto'
alias l.='ls -d .* --color=auto'
alias ll='ls -l --color=auto'
alias ls='ls --color=auto'
alias mv='mv -i'
alias rm='rm -i'
alias which='alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'

\cp -fr ./* /opt/gitlab/embedded/service/gitlab-rails/
gitlab-ctl reconfigure
gitlab-ctl restart 

# 语言包文件位置
cat /opt/gitlab/embedded/service/gitlab-rails/locale/zh_CN/gitlab.po

备份与恢复

# 备份
gitlab-rake gitlab:backup:create
# 恢复（把备份的文件放在备份目录下，然后执行恢复）
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
gitlab-rake gitlab:backup:restore BACKUP=1556156510_2019_04_25_11.9.8

# 注意备份gitlab密钥文件，不然用户无法访问
/etc/gitlab/gitlab-secrets.json

gitlab使用 管理员设置

  • 用户 用户组 项目设置

用户组中的用户会生效到用户组下属的所有项目中


用户 用户组 项目设置.png
  • 广播消息发送
消息广播.png

gitlab使用 个人基础信息设置

  • 设置语言，每周星期几开始
基础设置.png
  • 设置access tokens访问令牌

此令牌可以用于jenkins的触发自动部署等


访问令牌.png
  • 设置邮箱姓名等基础信息
邮箱设置.png
  • 设置 ssh 密钥

添加ssh公钥到gitlab,用来获取代码。


ssh密钥.png

常见问题

  • 服务没有启动
[root@zhangxiu-test gitlab]# gitlab-ctl start
fail: alertmanager: runsv not running
fail: gitaly: runsv not running
fail: gitlab-monitor: runsv not running
fail: gitlab-workhorse: runsv not running
fail: logrotate: runsv not running
fail: nginx: runsv not running
fail: node-exporter: runsv not running
fail: postgres-exporter: runsv not running
fail: postgresql: runsv not running
fail: prometheus: runsv not running
fail: redis: runsv not running
fail: redis-exporter: runsv not running
fail: sidekiq: runsv not running
fail: unicorn: runsv not running

需要手动启动一下gitlab服务

systemctl start gitlab-runsvdir.service
  • 新安装服务的管理员账号为 admin@example.com，首次进入系统需要设置密码
  • admin设置500 gitlab 500 errors in the admin area
Started PATCH "/admin/application_settings" for 58.135.84.38 at 2019-04-24 18:09:58 +0800
Processing by Admin::ApplicationSettingsController#update as HTML
  Parameters: {"utf8"=>"✓", "authenticity_token"=>"[FILTERED]", "application_setting"=>{"max_pages_size"=>"100", "pages_domain_verification_enabled"=>"1"}}
Completed 500 Internal Server Error in 34ms (ActiveRecord: 12.3ms)

OpenSSL::Cipher::CipherError ():

lib/gitlab/crypto_helper.rb:27:in `aes256_gcm_decrypt'
app/models/concerns/token_authenticatable_strategies/encrypted.rb:45:in `get_token'
app/models/concerns/token_authenticatable_strategies/base.rb:27:in `ensure_token'
app/models/concerns/token_authenticatable_strategies/encrypted.rb:32:in `ensure_token'

参照 https://stackoverflow.com/questions/54128023/gitlab-500-errors-in-the-admin-area

gitlab-rails console
ApplicationSetting.current.reset_runners_registration_token!
  • 添加了公钥到gitlab无法获取代码

注意gitlab ssh端口的开发，防火墙，iptables，/etc/hosts.allow 配置 等

相关文章

网友评论

      本文标题：gitlab安装与配置

      本文链接：https://www.haomeiwen.com/subject/blvxoqtx.html

      延伸阅读

      深度阅读

      • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

      栏目导航

      热点阅读

      关于我们|服务条款|联系我们|gitlab安装与配置|投稿指南|网站地图|RSS订阅|排版工具|手机版

      提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

      Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

      备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

      本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

      所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！