Commit 5ff6fadcc1fc4588485d34a06c7e27d8b6f302c4
Committed by
Dmitriy Zaporozhets
1 parent
c8fe07ed
Exists in
master
and in
4 other branches
refactor installation doc
Showing
1 changed file
with
33 additions
and
19 deletions
Show diff stats
doc/installation.md
@@ -51,12 +51,13 @@ The basic installation will provide you a GitLab setup with options: | @@ -51,12 +51,13 @@ The basic installation will provide you a GitLab setup with options: | ||
51 | 51 | ||
52 | The installation consists of next steps: | 52 | The installation consists of next steps: |
53 | 53 | ||
54 | -1. packages / dependencies | ||
55 | -2. ruby | ||
56 | -3. gitolite | ||
57 | -4. mysql | ||
58 | -5. GitLab. | ||
59 | -6. nginx | 54 | +1. Packages / dependencies |
55 | +2. Ruby | ||
56 | +3. Users | ||
57 | +4. Gitolite | ||
58 | +5. Mysql | ||
59 | +6. GitLab. | ||
60 | +7. Nginx | ||
60 | 61 | ||
61 | 62 | ||
62 | # 1. Install packages | 63 | # 1. Install packages |
@@ -72,6 +73,9 @@ Now install the required packages: | @@ -72,6 +73,9 @@ Now install the required packages: | ||
72 | 73 | ||
73 | sudo apt-get install -y wget curl gcc checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libreadline6-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip libyaml-dev postfix libpq-dev | 74 | sudo apt-get install -y wget curl gcc checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libreadline6-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip libyaml-dev postfix libpq-dev |
74 | 75 | ||
76 | + sudo pip install pygments | ||
77 | + | ||
78 | + | ||
75 | # 2. Install Ruby | 79 | # 2. Install Ruby |
76 | 80 | ||
77 | wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p194.tar.gz | 81 | wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p194.tar.gz |
@@ -81,7 +85,7 @@ Now install the required packages: | @@ -81,7 +85,7 @@ Now install the required packages: | ||
81 | make | 85 | make |
82 | sudo make install | 86 | sudo make install |
83 | 87 | ||
84 | -# 3. Install Gitolite | 88 | +# 3. Users |
85 | 89 | ||
86 | Create user for git: | 90 | Create user for git: |
87 | 91 | ||
@@ -111,6 +115,9 @@ Generate key: | @@ -111,6 +115,9 @@ Generate key: | ||
111 | 115 | ||
112 | sudo -H -u gitlab ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa | 116 | sudo -H -u gitlab ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa |
113 | 117 | ||
118 | + | ||
119 | +# 4. Gitolite | ||
120 | + | ||
114 | Clone GitLab's fork of the Gitolite source code: | 121 | Clone GitLab's fork of the Gitolite source code: |
115 | 122 | ||
116 | sudo -H -u git git clone -b gl-v304 https://github.com/gitlabhq/gitolite.git /home/git/gitolite | 123 | sudo -H -u git git clone -b gl-v304 https://github.com/gitlabhq/gitolite.git /home/git/gitolite |
@@ -134,8 +141,6 @@ Permissions: | @@ -134,8 +141,6 @@ Permissions: | ||
134 | sudo chmod -R g+rwX /home/git/repositories/ | 141 | sudo chmod -R g+rwX /home/git/repositories/ |
135 | sudo chown -R git:git /home/git/repositories/ | 142 | sudo chown -R git:git /home/git/repositories/ |
136 | 143 | ||
137 | -#### CHECK: Logout & login again to apply git group to your user | ||
138 | - | ||
139 | # clone admin repo to add localhost to known_hosts | 144 | # clone admin repo to add localhost to known_hosts |
140 | # & be sure your user has access to gitolite | 145 | # & be sure your user has access to gitolite |
141 | sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin | 146 | sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin |
@@ -148,7 +153,7 @@ Check the [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wik | @@ -148,7 +153,7 @@ Check the [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wik | ||
148 | and ensure you have followed all of the above steps carefully. | 153 | and ensure you have followed all of the above steps carefully. |
149 | 154 | ||
150 | 155 | ||
151 | -# 4. Mysql database | 156 | +# 5. Mysql database |
152 | 157 | ||
153 | sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev | 158 | sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev |
154 | 159 | ||
@@ -165,13 +170,13 @@ and ensure you have followed all of the above steps carefully. | @@ -165,13 +170,13 @@ and ensure you have followed all of the above steps carefully. | ||
165 | mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 'gitlab'@'localhost'; | 170 | mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 'gitlab'@'localhost'; |
166 | 171 | ||
167 | 172 | ||
168 | -# 5. Clone GitLab source and install prerequisites | 173 | +# 6. GitLab |
169 | 174 | ||
170 | - sudo gem install charlock_holmes --version '0.6.8' | ||
171 | - sudo pip install pygments | ||
172 | - sudo gem install bundler | ||
173 | cd /home/gitlab | 175 | cd /home/gitlab |
174 | 176 | ||
177 | + | ||
178 | +#### Get source code | ||
179 | + | ||
175 | # Get gitlab code. Use this for stable setup | 180 | # Get gitlab code. Use this for stable setup |
176 | sudo -H -u gitlab git clone -b stable https://github.com/gitlabhq/gitlabhq.git gitlab | 181 | sudo -H -u gitlab git clone -b stable https://github.com/gitlabhq/gitlabhq.git gitlab |
177 | 182 | ||
@@ -179,6 +184,9 @@ and ensure you have followed all of the above steps carefully. | @@ -179,6 +184,9 @@ and ensure you have followed all of the above steps carefully. | ||
179 | # Master branch (recent changes, less stable) | 184 | # Master branch (recent changes, less stable) |
180 | sudo -H -u gitlab git clone -b master https://github.com/gitlabhq/gitlabhq.git gitlab | 185 | sudo -H -u gitlab git clone -b master https://github.com/gitlabhq/gitlabhq.git gitlab |
181 | 186 | ||
187 | + | ||
188 | +#### Copy configs | ||
189 | + | ||
182 | cd gitlab | 190 | cd gitlab |
183 | 191 | ||
184 | # Rename config files | 192 | # Rename config files |
@@ -190,16 +198,18 @@ and ensure you have followed all of the above steps carefully. | @@ -190,16 +198,18 @@ and ensure you have followed all of the above steps carefully. | ||
190 | 198 | ||
191 | #### Install gems | 199 | #### Install gems |
192 | 200 | ||
193 | - # mysql | 201 | + cd /home/gitlab/gitlab |
202 | + | ||
203 | + sudo gem install charlock_holmes --version '0.6.8' | ||
204 | + sudo gem install bundler | ||
194 | sudo -u gitlab -H bundle install --without development test sqlite postgres --deployment | 205 | sudo -u gitlab -H bundle install --without development test sqlite postgres --deployment |
195 | 206 | ||
196 | -#### Setup database | 207 | +#### Setup application |
197 | 208 | ||
198 | sudo -u gitlab bundle exec rake gitlab:app:setup RAILS_ENV=production | 209 | sudo -u gitlab bundle exec rake gitlab:app:setup RAILS_ENV=production |
199 | 210 | ||
200 | #### Copy unicorn config | 211 | #### Copy unicorn config |
201 | 212 | ||
202 | - cd /home/gitlab/gitlab | ||
203 | sudo -u gitlab cp config/unicorn.rb.example config/unicorn.rb | 213 | sudo -u gitlab cp config/unicorn.rb.example config/unicorn.rb |
204 | 214 | ||
205 | #### Setup GitLab hooks | 215 | #### Setup GitLab hooks |
@@ -231,7 +241,7 @@ Checking status: | @@ -231,7 +241,7 @@ Checking status: | ||
231 | 241 | ||
232 | If you got all YES - congratulations! You can run a GitLab app. | 242 | If you got all YES - congratulations! You can run a GitLab app. |
233 | 243 | ||
234 | -### init script | 244 | +#### init script |
235 | 245 | ||
236 | Create init script in /etc/init.d/gitlab: | 246 | Create init script in /etc/init.d/gitlab: |
237 | 247 | ||
@@ -242,7 +252,7 @@ GitLab autostart: | @@ -242,7 +252,7 @@ GitLab autostart: | ||
242 | 252 | ||
243 | sudo update-rc.d gitlab defaults 21 | 253 | sudo update-rc.d gitlab defaults 21 |
244 | 254 | ||
245 | -### Now you should start GitLab application: | 255 | +#### Now you should start GitLab application: |
246 | 256 | ||
247 | sudo service gitlab start | 257 | sudo service gitlab start |
248 | 258 | ||
@@ -276,6 +286,9 @@ You can login via web using admin generated with setup: | @@ -276,6 +286,9 @@ You can login via web using admin generated with setup: | ||
276 | 286 | ||
277 | # Advanced setup tips: | 287 | # Advanced setup tips: |
278 | 288 | ||
289 | + | ||
290 | +## Quick setup | ||
291 | + | ||
279 | > - - - | 292 | > - - - |
280 | > The first 3 steps of this guide can be easily skipped by executing an install script: | 293 | > The first 3 steps of this guide can be easily skipped by executing an install script: |
281 | > | 294 | > |
@@ -294,6 +307,7 @@ You can login via web using admin generated with setup: | @@ -294,6 +307,7 @@ You can login via web using admin generated with setup: | ||
294 | > for more detailed instructions read the HOWTO section of [the script](https://github.com/gitlabhq/gitlab-recipes/blob/master/install/debian_ubuntu_aws.sh) | 307 | > for more detailed instructions read the HOWTO section of [the script](https://github.com/gitlabhq/gitlab-recipes/blob/master/install/debian_ubuntu_aws.sh) |
295 | > - - - | 308 | > - - - |
296 | 309 | ||
310 | + | ||
297 | ## Customizing Resque's Redis connection | 311 | ## Customizing Resque's Redis connection |
298 | 312 | ||
299 | If you'd like Resque to connect to a Redis server on a non-standard port or on | 313 | If you'd like Resque to connect to a Redis server on a non-standard port or on |