GitLab 是一个使用 Ruby on Rails 开发的开源应用程序, 与 Github 类似, 能够浏览源代码, 管理缺陷和注释, 非常适合在团队内部使用. 安装依赖程序 Packages / Dependencies

Transcription

1 GitLab 搭建 V1.0 概述 GitLab 简介 GitLab 是一个使用 Ruby on Rails 开发的开源应用程序, 与 Github 类似, 能够浏览源代码, 管理缺陷和注释, 非常适合在团队内部使用 GitLab 服务有以下 8 部分组成 : 1.Packages / Dependencies 2.Ruby 3.System Users 4.Database:MySql/PostgreSQL 5.Redis 6.GitLab 7.Web Server:Nginx/Apache 8.Firewall 安装说明 1. 此教程适用于 centos6.7 安装 gitlab 2. 使用 root 帐号登录系统, 如果不是 root 登录使用 ` su root ` 切换为 root 3. 你也可以参考 : 官方 centos 文档 (null) 官方 Ubuntu 文档 (null) 安装依赖程序 Packages / Dependencies 1.Add EPEL repository EPEL(null) 即 Extra Packages for Enterprise Linux, 这个软件仓库里有很多非常常用的软件, 而且是专门针对 RHEL 设计的, 对 RHEL 标准 yum 源是一个很好的补充, 完全免费使用, 由 Fedora 项目维护, 所以如果你使用的是 RHEL, 或者 CentOS,Scientific 等 RHEL 系的 linux, 可以非常放心的使用 EPEL 的 yum 源 下载并安装 GPG key wget -O /etc/pki/rpm-gpg/rpm-gpg-key-epel-6

2 rpm --import /etc/pki/rpm-gpg/rpm-gpg-key-epel-6 检查是否安装成功 rpm -qa gpg* 成功后会输出 : gpg-pubkey-0608b895-4bd22942 接着安装 epel-release-6-8.noarch 包 rpm -Uvh 提示 : 不要在意 x86_64, 在 i686 的机器上一样能使用 2.Add PUIAS Computational repository PUIAS Linux 是面向桌面和服务器的完整的操作系统, 它靠编译 Red Hat Enterprise Linux 的源代码包来创建 除了这些上游的软件包外, 该项目还提供一些其他的软件仓库 : Addons 包含了通常的 Red Hat 发行中未收入的额外软件包, Computational 提供专门针对科学计算的软件, Unsupported 则收入各种各样的测试性软件包 该发行由美国普林斯顿大学的高等研究所维护 下载 PUIAS repo wget -O /etc/yum.repos.d/puias_6_computational.repo 下载并安装 GPG key wget -O /etc/pki/rpm-gpg/rpm-gpg-key-puias rpm --import /etc/pki/rpm-gpg/rpm-gpg-key-puias 检查是否安装成功 rpm -qa gpg* 成功会输出 :` gpg-pubkey-41a ce19266 ` 3.Install the required tools for GitLab yum -y update yum -y groupinstall 'Development Tools' yum -y install readline readline-devel ncurses-devel gdbm-devel glibc-devel tcl-devel

3 openssl-devel curl-devel expat-devel db4-devel byacc sqlite-devel libyaml libyamldevel libffi libffi-devel libxml2 libxml2-devel libxslt libxslt-devel libicu libicu-devel system-config-firewall-tui redis sudo wget crontabs logwatch logrotate perl-time- HiRes git cmake libcom_err-devel.i686 libcom_err-devel.x86_64 nodejs RHEL 提示 如果部分包不能安装, 例如 : eg. gdbm-devel, libffi-devel and libicu-devel, 那么增加 rhel6 的安装源 yum-config-manager --enable rhel-6-server-optional-rpms 提示 : 安装过程中, 有些文件需要我们手动配置, 如果你熟悉 vim 就是用 vim 配置, 否则使用默认的编辑器 # Install vim and set as default editor yum -y install vim-enhanced update-alternatives --set editor /usr/bin/vim.basic # For restructuredtext markup language support, install required package: yum -y install python-docutils 4.Install mail server yum -y install postfix Configure the default editor ln -s /usr/bin/vim /usr/bin/editor Git 安装 安装 git 确保 git 的版本 > git --version 如果低于 yum -y remove git 安装 git 的依赖程序 yum install -y libcurl4-openssl-dev libexpat1-dev gettext libz-dev libssl-dev buildessential

4 下载并安装 git mkdir /tmp/git && cd /tmp/git curl --progress tar xz cd git-2.4.3/./configure make make prefix=/usr/local install 确认 git 安装到 $PATH which git 提示 : 使用 yum 安装的 git 目录为 :/usr/bin/git, 下载安装的 git 目录为 :/usr/local/bin/git, 这个在之后 gitlab.yml 中需要修改 Ruby 安装 安装 ruby 卸载掉旧版本的 rubyyum remove ruby 这里使用 2.0 以上的版本 ruby -v mkdir /tmp/ruby && cd /tmp/ruby curl --progress tar xz cd ruby /configure --disable-install-rdoc make make prefix=/usr/local install 检查 ruby 是否安装成功 which ruby # /usr/local/bin/ruby 替换 Ruby gem 源 gem sources -l # 移除 源 gem sources --remove # 增加 源 gem sources -a # 更新缓存

5 gem sources -u 安装 Bundler gem install bundler --no-doc 创建 System Users 为 gitlab 创建 git 用户 adduser --system --shell /bin/bash --comment 'GitLab' --create-home --home-dir /home/git/ git 重要 : 执行 visudo 找到 Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin 改为 : Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin 保存并退出 MySQL 安装 MySQL 安装 安装 : yum install -y mysql-server mysql-devel chkconfig mysqld on service mysqld start 设置 mysql root 账号的密码 : mysql_secure_installation 用 root 登录 mysql mysql -u root -p 创建新用户和数据库给 gitlab 使用

6 CREATE USER IDENTIFIED BY ' 这里改为你自己的密码 '; SET storage_engine=innodb; 创建 gitlab 使用的数据库 CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`; 给予 gitlab 用户权限 GRANT SELECT, LOCK TABLES, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 退出 \q 检查是否能用 git 帐号登录数据库 sudo -u git -H mysql -u git -p -D gitlabhq_production Redis 配置 Redis 配置 ` chkconfig redis on cp /etc/redis.conf /etc/redis.conf.orig sed 's/^port.*/port 0/' /etc/redis.conf.orig sudo tee /etc/redis.conf echo 'unixsocket /var/run/redis/redis.sock' sudo tee -a /etc/redis.confecho -e 'unixsocketperm 0770' sudo tee -a /etc/redis.conf mkdir /var/run/redis chown redis:redis /var/run/redis chmod 755 /var/run/redis 重启 redis: service redis restart 将 git 用户添加到 redis 组

7 usermod -ag redis git ` GitLab 安装 GitLab 安装 cd /home/git 克隆 GitLab 并切换分支到 8-2-stable( 你可以选择更新的版本 ) sudo -u git -H git clone -b 8-2-stable gitlab 配置 GitLab # Go to GitLab installation folder cd /home/git/gitlab # Copy the example GitLab config sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml # Update GitLab config file, follow the directions at top of file # 不要忘记修改 gitlab.yml 中 git 的路径 sudo -u git -H editor config/gitlab.yml # Copy the example secrets file sudo -u git -H cp config/secrets.yml.example config/secrets.yml sudo -u git -H chmod 0600 config/secrets.yml # Make sure GitLab can write to the log/ and tmp/ directories sudo chown -R git log/ sudo chown -R git tmp/ sudo chmod -R u+rwx,go-w log/ sudo chmod -R u+rwx tmp/ # Make sure GitLab can write to the tmp/pids/ and tmp/sockets/ directories sudo chmod -R u+rwx tmp/pids/ sudo chmod -R u+rwx tmp/sockets/ # Make sure GitLab can write to the public/uploads/ directory sudo chmod -R u+rwx public/uploads # Change the permissions of the directory where CI build traces are stored sudo chmod -R u+rwx builds/

8 # Change the permissions of the directory where CI artifacts are stored sudo chmod -R u+rwx shared/artifacts/ # Copy the example Unicorn config sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb # Find number of cores nproc # Enable cluster mode if you expect to have a high load instance # Set the number of workers to at least the number of cores # Ex. change amount of workers to 3 for 2GB RAM server sudo -u git -H editor config/unicorn.rb # Copy the example Rack attack config sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb # Configure Git global settings for git user, used when editing via web editor sudo -u git -H git config --global core.autocrlf input # Configure Redis connection settings sudo -u git -H cp config/resque.yml.example config/resque.yml # Change the Redis socket path if you are not using the default Debian / Ubuntu configuration sudo -u git -H editor config/resque.yml 注 : 这里如果提示没有路径, 就手动创建文件夹 配置 GitLab 数据库 sudo -u git cp config/database.yml.mysql config/database.yml # 修改其中 username 和 password 即可, 其中密码就是上面数据库步骤中创建 gitlab 用户的密码 sudo -u git -H editor config/database.yml # 确保该文件只有 git 账号有权限读取 sudo -u git -H chmod o-rwx config/database.yml 安装 GitLab 需要的 Gems

9 cd /home/git/gitlab 接着修改 Gemfile 中的 为 sudo -u git -H bundle install --deployment --without development test postgres aws kerberos 安装 GitLabShell # Run the installation task for gitlab-shell (replace `REDIS_URL` if needed): sudo -u git -H bundle exec rake gitlab:shell:install REDIS_URL=unix:/var/run/redis/redis.sock RAILS_ENV=production # By default, the gitlab-shell config is generated from your main GitLab config. # You can review (and modify) the gitlab-shell config as follows: sudo -u git -H editor /home/git/gitlab-shell/config.yml # Ensure the correct SELinux contexts are set # Read restorecon -Rv /home/git/.ssh 安装 gitlab-workhorse gitlab-workhorse 是用 go 语言写的一个 small daemon, 所以先要安装 go 语言编译器 yum install go 接着安装 gitlab-workhorse cd /home/git sudo -u git -H git clone cd gitlab-workhorse sudo -u git -H git checkout sudo -u git -H make 初始化 gitlab 数据库并激活高级功能 # Go to GitLab installation folder cd /home/git/gitlab

10 sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production # Type 'yes' to create the database tables. # 这里会生成你的管理员帐号和密码请牢记 安装启动脚本 sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab chmod +x /etc/init.d/gitlab chkconfig --add gitlab chkconfig gitlab on cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab 检测应用程序状态并编译 Assets sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production 编译完成后就可以启动 gitlab 了 service gitlab start Nginx 安装 Nginx 安装 yum install yum-fastestmirror yum update yum -y install nginx 查看 nginx 版本 nginx -v 如果不是最新版本使用下面的命令进行升级

11 cd /etc/yum.repos.d/ vim nginx.repo # 输入下面的文本 #nginx.repo [nginx] name=nginx repo baseurl= gpgcheck=0 enabled=1 升级 nginx yum update nginx 配置 Nginx 把 nginx 加入 git 用户组 usermod -a -G git nginx chmod g+rx /home/git/ chown -R git /etc/nginx 编辑 /etc/nginx/nginx.conf, 将 include /etc/nginx/conf.d/.conf; 改为 include /etc/nginx/sites-enabled/;, 就是修改额外加载的配置文件目录 修改 nginx.conf 文件总的 user 为 git Site Configuration mkdir /etc/nginx/sites-available mkdir /etc/nginx/sites-enabled cd /home/git/gitlab sudo cp lib/support/nginx/gitlab /etc/nginx/sites-available/gitlab sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab 启动 nginx 服务 chkconfig nginx on service nginx start 注 : 如果遇到 Starting nginx: nginx: [emerg] bind() to :80 failed (98: Address already use) 编辑 /etc/nginx/sites-available/gitlab, 将 listen [::]:80 defaultserver; 改为 listen [::]:80

12 ipv6only=on defaultserver; 防火墙配置 防火墙配置 lokkit -s http -s https -s ssh service iptables restart 完成安装 完成安装 现在可以在浏览器中访问 如果没有问题是可以访问成功的, 如果有问题请看 问题记录 问题记录 1. 如果 nginx 出现 502 Bad gateway, 可以去查看 gitlab 和 nginx 的日志 # 这里有 gitlab 访问的日志 cd /etc/log/nginx/ 1. 如果日志中错误为 :connect() to unix:/home/git/gitlab/tmp/sockets/gitlab.socket failed (13: Permission denied) while connecting to upstream, # 关闭 selinux 防火墙 setenforce 0