GitLab的安装管理
GitLab是利用 Ruby on Rails 一个开源的版本管理系统,实现一个自托管的Git项目仓库,可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能,能够浏览源代码,管理缺陷和注释。可以管理团队对仓库的访问,它非常易于浏览提交过的版本并提供一个文件历史库。团队成员可以利用内置的简单聊天程序(Wall)进行交流。它还提供一个代码片段收集功能可以轻松实现代码复用,便于日后有需要的时候进行查找。在线DEMO
社区版基于MIT license开源完全免费
无用户,协作和仓库限制
保护你的源码安全
管理仓库,用户与访问权限
更多功能请看这儿
依赖组件:ruby 1.9.3+,MySQL,git,redis, Sidekiq。
最低配置CPU 1G,RAM 1G+swap可以支持100用户。
安装
官方有安装包与脚本下载,官方安装指南。同样GITHUB上有个社区非官方的安装指南。
但这儿里推荐bitnami下载打包安装版本 https://bitnami.com/stack/gitlab/installer ,省去很多时间。他们也提供相关WIKI
以ubuntu为演示环境,来安装这个包,切换到root账户, 在终端运行:
./bitnami-gitlab-7.1.1-0-linux-x64-installer.run
出现向导,这个时安装就是傻瓜安装了
默认同时安装了GitLab CI, 后然配置Apache的端口,MySQL的端口,注意如果默认端口80, 3306有占用,需要修改。就不截图 了。
这个包默认会安装独立的MySQL,如果需要配置已有Mysql数据库,那么请手工逐个安装各个组件。安装完成后,服务就启动了。
配置OS自动启动:
sudo update-rc.d gitlab defaults 21
管理
管理员帐号登录后,有一个管理区,如下图:
在这里可以管理用户,项目,组,日志,消息,Hooks,后台job。 界面清晰,功能明确,在这儿不再详细描述。
使用
1 . 服务端 启动Gitlab
[email protected]:/opt/gitlab-7.1.1-0# ./ctlscript.sh start
140818 00:31:57 mysqld_safe Logging to ‘/opt/gitlab-7.1.1-0/mysql/data/mysqld.log‘.
140818 00:31:57 mysqld_safe Starting mysqld.bin daemon with databases from /opt/gitlab-7.1.1-0/mysql/data
/opt/gitlab-7.1.1-0/mysql/scripts/ctl.sh : mysql started at port 3307
/opt/gitlab-7.1.1-0/redis/scripts/ctl.sh : redis started at port 6379
/opt/gitlab-7.1.1-0/apps/gitlab/scripts/sidekiq.sh : gitlab_sidekiq started
Session terminated, terminating shell... ...terminated.
/opt/gitlab-7.1.1-0/apps/gitlabci/scripts/sidekiq.sh : gitlabci_sidekiq started
/opt/gitlab-7.1.1-0/apps/gitlabci/scripts/runner.sh : gitlabci_runner started
Syntax OK
/opt/gitlab-7.1.1-0/apache2/scripts/ctl.sh : httpd started at port 81
:/opt/gitlab-7.1.1-0 是Gitlab的安装目录
也可以查看GUI管理控制台 ./manager-linux-x64.run
上面列出各个组件状态。
2 . 创建与Git项目初始化工作
我们的Apache webserver 之间安装于81端口,从客户端访问:
登录后,可创建三种级别的Projects:
增加项目参加成员:
登录Gitlab http://10.1.98.251 ,在profile中填写自己ssh-key,
记事本打开C:\Users\Administrator\.ssh \id_rsa.pub内容,copy到下面Key
对新建Git项目,初始化,第一个commit:
Git global setup(Git全局设置):
git config --global user.name "testman" git config --global user.email "[email protected]"
Create Repository(创建仓库)
mkdir common-util cd common-util git init touch README git add README git commit -m ‘first commit‘ git remote add origin [email protected]:devteam/common-util.git git push -u origin master
对于已存在Git项目:
cd existing_git_repo
git remote add origin [email protected]:devteam/common-util.git
git push -u origin master
进入本地git shell, 生成自己的ssh-key, 联系三个回车
ssh-keygen -t rsa
登录Gitlab,在profile中填写自己ssh-key,
记事本打开C:\Users\Administrator\.ssh \id_rsa.pub内容,copy到下面Key。
3. 使用相关用户名登录,可以看到Dashborad:
显示项目动态:
项目Commit明细:
4. 用Visual Studio 2013做客户端。
由于之前项目已经建好了,Visual Studio 2013里我们修改文件,点右键来Commit
然后在选择界面中,选择Commit,填写这次提交的信息,也可以Commit and push
提交以后,提示Commit cd900236在本地创建,Sync以共享到服务器
然后Sync, 这里点push 到服务端,第一次会提示您输入密码:
之后结果是: 成功推送1commit到origin/master分支
然后我们就把代码提交到Gitlab了,打开页面进入相关项目,可以看到刚才commit
GitLab CI
使用gitlab管理员账户登录后:
提供了基于持续集成的功能,有于API的访问。
用gitlab搭建专属自己的私有github
Gitlab是一个用Ruby on Rails开发的开源项目管理程序,可以通过WEB界面进行访问公开的或者私人项目。它和Github有类似的功能,能够浏览源代码,管理缺陷和注释。
下面介绍如何在 Debian/Ubuntu 和 Centos 下搭建配置 GitLab。
安装依赖
Debian/Ubuntu下:
sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server redis-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate
安装python(注意需要2.5以上版本):
sudo apt-get install -y python python-docutils
安装git(注意需要1.7.10以上版本):
sudo apt-get install -y git-core
Centos下官方仓库的软件比较老旧,推荐先添加epel源,然后再安装依赖:
sudo yum install git patch gcc-c++ readline-devel zlib-devel libffi-devel openssl-devel make autoconf automake libtool bison libxml2-devel libxslt-devel libyaml-devel git python python-docutils
安装 Ruby 2.0
需要安装Ruby2.0,软件仓库中的Ruby 1.8不支持:
mkdir /tmp/ruby && cd /tmp/ruby
curl --progress ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p353.tar.gz | tar xz
cd ruby-2.0.0-p353
./configure --disable-install-rdoc
make
sudo make install
安装Bundler Gem:
sudo gem install bundler --no-ri --no-rdoc
配置gitlab-shell
创建git用户:
sudo adduser --system --create-home --comment ‘GitLab‘ git
配置gitlab-shell
su - git -c "git clone https://github.com/gitlabhq/gitlab-shell.git"
su - git -c "cd gitlab-shell && git checkout v1.3.0"
su - git -c "cp gitlab-shell/config.yml.example gitlab-shell/config.yml"
sed -i "s/localhost/gitlab.51yip.com/g" /home/git/gitlab-shell/config.yml
su - git -c "gitlab-shell/bin/install"
chmod 600 /home/git/.ssh/authorized_keys
chmod 700 /home/git/.ssh
数据库
GitLab支持 MySQL 和 PostgreSQL 数据库。下面以 MySQL为例,介绍安装方法:
Debian/Ubuntu下使用如下命令安装:
sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev
Centos下使用如下命令:
sudo yum install mysql-server
sudo chkconfig mysqld on
配置MySQL:
sudo echo "CREATE DATABASE IF NOT EXISTS gitlabhq_production DEFAULT CHARACTER SET ‘utf8‘ COLLATE ‘utf8_unicode_ci‘;" | mysql -u root
sudo echo "UPDATE mysql.user SET Password=PASSWORD(‘123456‘) WHERE User=‘root‘; FLUSH PRIVILEGES;" | mysql -u root
注意,用你的密码替换123456
。
安装配置 gitlab
su - git -c "git clone https://github.com/gitlabhq/gitlabhq.git gitlab"
su - git -c "cd gitlab;git checkout 5-1-stable"
su git -c "cp config/gitlab.yml.example config/gitlab.yml"
su git -c "mkdir /home/git/gitlab-satellites"
su git -c "mkdir public/uploads"
su git -c "mkdir -p tmp/sockets/"
su git -c "mkdir -p tmp/pids/"
sed -i "s/ host: localhost/ host: gitlab.segmentfault.com/g" config/gitlab.yml
sed -i "s/from: gitlab@localhost/from: gitlab@gitlab.segmentfault.com/g" config/gitlab.yml
su git -c "cp config/puma.rb.example config/puma.rb"
su git -c ‘git config --global user.name "GitLab"‘
su git -c ‘git config --global user.email "gitlab@gitlab.segmentfault.com"‘
注意将gitlab.segmentfault.com
替换为你自己的内容。
配置数据库连接:
sudo su git -c "cp config/database.yml.mysql config/database.yml"
sudo sed -i "s/secure password/mysql的root密码/g" config/database.yml
安装MySQL需要的Gems
sudo -u git -H bundle install --deployment --without development test postgres aws
初始化:
sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production
sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab
sudo chmod +x /etc/init.d/gitlab
sudo update-rc.d gitlab defaults 21
查看是否配置妥当:
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
重启GitLab:
sudo service gitlab start
配置Nginx
Debian/Ubuntu下:
sudo apt-get install -y nginx
CentOS下:
sudo yum install nginx
下载配置文件样例:
sudo cp lib/support/nginx/gitlab /etc/nginx/sites-available/gitlab
sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab
修改 /etc/nginx/sites-available/gitlab
,特别留意将 YOUR_SERVER_FQDN
改成自己的。
重启nginx:
sudo service nginx restart
好了,你可以登录GitLab了,默认安装后的用户名:[email protected]
,密码5iveL!fe
。
GitLab(也适用于GitHub) 多账户下创建ssh keys
公司之前的版本控制工具一直用的svn
,最近开发的新项目,代码准备改换到了gitlab
上进行管理。而我自己平时写的一些代码是放在github
上进行托管的,这二者都是基于git
的开源分布式版本控制系统,在本地可以通过ssh进行远程登录验证和数据传输(关于ssh的详细介绍可以参考这篇博文:http://blog.csdn.net/macrossdzh/article/details/5691924
)。
具体操作是利用ssh在本地生成一对公私秘钥(keys),然后将公钥添加到注册的gitlab/github账户配置ssh key的地方即可。默认情况下本地生成的秘钥位于/Users/mac用户名/.ssh/
(mac平台,本文针对os x系统介绍)。
But,问题来了:默认情况下每个账户生成的秘钥位置和名称都是相同的,这样后生成的秘钥就会覆盖前面的秘钥导致其失效。解决的办法就是在生成后一个秘钥的时候对其重新命名,以避免冲突,同时将不同的秘钥配置到相对应的Host上面,这样在访问不同的远程仓库时调用不同的key,冲突也就解决了。具体操作如下:
生成gitlab秘钥
默认你已经注册了gitlab/github账户,以我自己为例,公司项目用的gitlab,自己代码托管在github。先进行公司账号的设置:
本地生成ssh keys命令:ssh-keygen -t rsa -C "注册的gitlab邮箱"
,生成的公司秘钥会提示是否需要重命名,公司gitlab的秘钥我们就使用默认名称,直接回车跳过,另外还会提示你设置密码,设置密码的话后续登陆会比较麻烦,也直接跳过。成功后大概是这样的:
查看 .ssh/目录,可以看到公私秘钥已经生成,名称分别为id_rsa.pub、id_rsa
执行命令查看公钥内容:cat ~/.ssh/id_rsa.pub
,或者直接用nano
编辑期打开id_rsa.pub
。公钥大概是这个样子:
将这部分代码添加到到gitlab
账户的的SSH Keys
中即可。
生成github秘钥
终端执行命令:ssh-keygen -t rsa -C "注册的github邮箱"
,这次一定要注意,对生成定的秘钥进行重命名,这里暂且重命名为id_rsa_home
,同样不设置密码。可以看到生成的公私秘钥已经分别被重命名为id_rsa_home.pub
和id_rsa_home
。
可以查看公钥里面的内容:cat ~/.ssh/id_rsa_home.pub
不要忘记将其拷到github的SSH Keys里~
gitlab和github的秘钥是分开生成了,可怎么让这两份秘钥分别对应到相应的远程仓库呢?就是让id_rsa.pub
认得gitlab
,让id_rsa_home.pub
认得github
。既然不能自动识别,那就只好手动设置了:
配置config
在.ssh/目录下新建config文件:touch config
,通过nano编辑器进行如下配置:
其中Host
对应的名称是一个别名,命名可以随意,用来进行远程连接,当然使用真实的主机名称也是可以的。HostName
和IdentityFile
就是各自主机名称以及对应的秘钥文件了~
这样配置之后,两份秘钥也就对应到各自相应的仓库上了。通过设置别名,也就可以设置任意多的账户了~
最后利用别名检测下配置是否成功~
检测
检测gitlab
连接,如果提示是否建立连接,直接yes就行:
检测github
连接:
不报错的话,就说明设置成功了!