Download as
Browse Code »

Commit 7a6b7a5c50ee3787c284c8803fdf30dffc10cec1

Authored by Valery Sizov
1 parent 13062458
Exists in master and in 4 other branches 6-8-stable, 7-0-stable, 7-0-stable-spb, spb-stable

added new manual

Showing 1 changed file with 249 additions and 0 deletions   Show diff stats
doc/installation.md 0 → 100644
  Diff comments   View file @7a6b7a5
... ... @@ -0,0 +1,249 @@
  1 +Проект gitlab рассчитан на операционную систему Linux. Имеются сведения о успешной установке ее на FreeBSD и Mac OS, однако мы официально не тестируем на этих системах данный проект и не гарантируем его корректной работы.
  2 +Данная интсрукция написана для систем Debian/Ubuntu.
  3 +
  4 +Установка проекта gitlab состоит из 6 частей:
  5 +
  6 +1. install packeges.
  7 +2. install ruby
  8 +3. install gitolite
  9 +4. install gitlab and configuration. Check status configuration.
  10 +5. server up.
  11 +6. run resque process (for processing queue).
  12 +
  13 +Большая просьба - прежде чем составлять отчет об ошибке убедитесь что все шаги вы проделали верно.
  14 +
  15 +Первые 3 шага возможно проделать автоматически, для этого установите curl:
  16 + #для Debian может понадобиться установить утилиту sudo
  17 + apt-get install curl sudo
  18 +
  19 + # 3 step in 1 command
  20 + curl http://dl.dropbox.com/u/936096/debian_ubuntu.sh | sh
  21 +
  22 +Затем можно приступать к установке:
  23 +
  24 +
  25 +# 1. Install packages
  26 +
  27 +*Имейте ввиду что в debian по умолчанию не установлена утилита sudo. Установите ее от юзера root:* **apt-get update && apt-get upgrade && apt-get install sudo**
  28 +
  29 + sudo apt-get update
  30 + sudo apt-get upgrade
  31 +
  32 + sudo apt-get install -y git-core wget curl gcc checkinstall libxml2-dev libxslt-dev sqlite3 libsqlite3-dev libcurl4-openssl-dev libreadline-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip sendmail
  33 +
  34 +# 2. Install ruby
  35 +
  36 + wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.2-p290.tar.gz
  37 + tar xfvz ruby-1.9.2-p290.tar.gz
  38 + cd ruby-1.9.2-p290
  39 + ./configure
  40 + make
  41 + sudo make install
  42 +
  43 +# 3. Install gitolite
  44 +
  45 +Create user for git:
  46 +
  47 + sudo adduser \
  48 + --system \
  49 + --shell /bin/sh \
  50 + --gecos 'git version control' \
  51 + --group \
  52 + --disabled-password \
  53 + --home /home/git \
  54 + git
  55 +
  56 +
  57 +
  58 +Create user for gitlab:
  59 + # ubuntu/debian
  60 + sudo adduser --disabled-login --gecos 'gitlab system' gitlab
  61 +
  62 +Add your user to git group:
  63 + sudo usermod -a -G git gitlab
  64 +
  65 +Generate key:
  66 + sudo -H -u gitlab ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa
  67 +
  68 +получение исходников gitolite:
  69 + cd /home/git
  70 + sudo -H -u git git clone git://github.com/gitlabhq/gitolite /home/git/gitolite
  71 +
  72 +Setup:
  73 + sudo -u git -H /home/git/gitolite/src/gl-system-install
  74 + sudo cp /home/gitlab/.ssh/id_rsa.pub /home/git/gitlab.pub
  75 + sudo chmod 777 /home/git/gitlab.pub
  76 +
  77 + sudo -u git -H sed -i 's/0077/0007/g' /home/git/share/gitolite/conf/example.gitolite.rc
  78 + sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gl-setup -q /home/git/gitlab.pub"
  79 +Permissions:
  80 + sudo chmod -R g+rwX /home/git/repositories/
  81 + sudo chown -R git:git /home/git/repositories/
  82 +
  83 +#### CHECK: Logout & login again to apply git group to your user
  84 +
  85 + # clone admin repo to add localhost to known_hosts
  86 + # & be sure your user has access to gitolite
  87 + sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin
  88 +
  89 + # if succeed you can remove it
  90 + sudo rm -rf /tmp/gitolite-admin
  91 +
  92 +Если вам не удалось успешно склонировать репозиторий - вы что-то сделали не так. Перепроверьте предидущие шаги. ДАЛЬНЕЙШАЯ УСТАНОВКА БУДЕТ БЕЗУСПЕШНА.
  93 +
  94 +# 4. Install gitlab and configuration. Check status configuration.
  95 +
  96 + sudo gem install charlock_holmes
  97 + sudo pip install pygments
  98 + sudo gem install bundler
  99 + cd /home/gitlab
  100 + sudo -H -u gitlab git clone git://github.com/gitlabhq/gitlabhq.git gitlab
  101 + cd gitlab
  102 +
  103 + # Rename config files
  104 + sudo -u gitlab cp config/gitlab.yml.example config/gitlab.yml
  105 +
  106 +#### Select db you want to use
  107 + # SQLite
  108 + sudo -u gitlab cp config/database.yml.sqlite config/database.yml
  109 +
  110 + # Or
  111 + # Mysql
  112 + sudo -u gitlab cp config/database.yml.example config/database.yml
  113 +
  114 +#### Install gems
  115 + sudo -u gitlab -H bundle install --without development test --deployment
  116 +
  117 +#### Setup DB
  118 + sudo -u gitlab bundle exec rake db:setup RAILS_ENV=production
  119 + sudo -u gitlab bundle exec rake db:seed_fu RAILS_ENV=production
  120 +
  121 +Checking status:
  122 + sudo -u gitlab bundle exec rake gitlab_status
  123 +
  124 +
  125 + # OUTPUT EXAMPLE
  126 + Starting diagnostic
  127 + config/database.yml............exists
  128 + config/gitlab.yml............exists
  129 + /home/git/repositories/............exists
  130 + /home/git/repositories/ is writable?............YES
  131 + remote: Counting objects: 603, done.
  132 + remote: Compressing objects: 100% (466/466), done.
  133 + remote: Total 603 (delta 174), reused 0 (delta 0)
  134 + Receiving objects: 100% (603/603), 53.29 KiB, done.
  135 + Resolving deltas: 100% (174/174), done.
  136 + Can clone gitolite-admin?............YES
  137 + UMASK for .gitolite.rc is 0007? ............YES
  138 +
  139 +If you have all YES then go next.
  140 +Поздравляем!!! установка завершена. Теперь необходимо запустить сервисы.
  141 +
  142 +# 5. Server up
  143 +
  144 +Сервер можно запустить простой командой:
  145 + sudo -u gitlab bundle exec rails s -e production
  146 +Однако этот способ даст вам только возможность проверить работоспособность сервиса, не более. Чтобы запустить сервис в виде демона, сделайте так
  147 + sudo -u gitlab bundle exec rails s -e production -d
  148 +
  149 +
  150 +# 6. Run resque process (for processing queue).
  151 +
  152 + # Manually
  153 + sudo -u gitlab bundle exec rake environment resque:work QUEUE=* RAILS_ENV=production BACKGROUND=yes
  154 +
  155 + # Gitlab start script
  156 + ./resque.sh
  157 +
  158 +# Nginx && Unicorn
  159 +
  160 +### Install Nginx
  161 +
  162 + sudo apt-get install nginx
  163 +
  164 +## Unicorn
  165 + cd /home/gitlab/gitlab
  166 + sudo -u gitlab cp config/unicorn.rb.orig config/unicorn.rb
  167 + sudo -u gitlab unicorn_rails -c config/unicorn.rb -E production -D
  168 +
  169 +В nginx.conf добавим блок upstream в секцию http:
  170 + upstream gitlab {
  171 + server unix:/tmp/gitlab.socket;
  172 + }
  173 +И добавим virtual host:
  174 +
  175 + server {
  176 + listen 80;
  177 + server_name mygitlab.com;
  178 +
  179 + location / {
  180 +
  181 + root /home/gitlab/gitlab/public;
  182 +
  183 + if (!-f $request_filename) {
  184 + proxy_pass http://gitlab;
  185 + break;
  186 + }
  187 + }
  188 +
  189 + }
  190 +
  191 +mygitlab.com - change to your domain.
  192 +Restart nginx:
  193 + /etc/init.d/nginx restart
  194 +Create init script in /etc/init.d/gitlab:
  195 + #! /bin/bash
  196 + ### BEGIN INIT INFO
  197 + # Provides: unicorn
  198 + # Required-Start: $local_fs $remote_fs $network $syslog
  199 + # Required-Stop: $local_fs $remote_fs $network $syslog
  200 + # Default-Start: 2 3 4 5
  201 + # Default-Stop: 0 1 6
  202 + # Short-Description: starts the unicorn web server
  203 + # Description: starts unicorn
  204 + ### END INIT INFO
  205 +
  206 + DAEMON_OPTS="-c /home/gitlab/gitlab/config/unicorn.rb -E production -D"
  207 + NAME=unicorn
  208 + DESC="Gitlab service"
  209 + PID=/home/gitlab/gitlab/tmp/pids/unicorn.pid
  210 +
  211 + case "$1" in
  212 + start)
  213 + CD_TO_APP_DIR="cd /home/gitlab/gitlab"
  214 + START_DAEMON_PROCESS="bundle exec unicorn_rails $DAEMON_OPTS"
  215 +
  216 + echo -n "Starting $DESC: "
  217 + if [ `whoami` = root ]; then
  218 + sudo -u gitlab sh -c "$CD_TO_APP_DIR > /dev/null 2>&1 && $START_DAEMON_PROCESS"
  219 + else
  220 + $CD_TO_APP_DIR > /dev/null 2>&1 && $START_DAEMON_PROCESS
  221 + fi
  222 + echo "$NAME."
  223 + ;;
  224 + stop)
  225 + echo -n "Stopping $DESC: "
  226 + kill -QUIT `cat $PID`
  227 + echo "$NAME."
  228 + ;;
  229 + restart)
  230 + echo -n "Restarting $DESC: "
  231 + kill -USR2 `cat $PID`
  232 + echo "$NAME."
  233 + ;;
  234 + reload)
  235 + echo -n "Reloading $DESC configuration: "
  236 + kill -HUP `cat $PID`
  237 + echo "$NAME."
  238 + ;;
  239 + *)
  240 + echo "Usage: $NAME {start|stop|restart|reload}" >&2
  241 + exit 1
  242 + ;;
  243 + esac
  244 +
  245 + exit 0
  246 +
  247 +When server is rebooted then gitlab must starting:
  248 + sudo update-rc.d gitlab defaults
  249 +
... ...