Commit d74b8b450a8278e5f070eae6ebde69d97f6c69fc
Exists in
spb-stable
and in
2 other branches
Merge branch 'pkgr-improve-gitlab-shell-installation'
Showing
2 changed files
with
83 additions
and
30 deletions
Show diff stats
doc/install/installation.md
... | ... | @@ -27,10 +27,9 @@ The GitLab installation consists of setting up the following components: |
27 | 27 | 1. Packages / Dependencies |
28 | 28 | 2. Ruby |
29 | 29 | 3. System Users |
30 | -4. GitLab shell | |
31 | -5. Database | |
32 | -6. GitLab | |
33 | -7. Nginx | |
30 | +4. Database | |
31 | +5. GitLab | |
32 | +6. Nginx | |
34 | 33 | |
35 | 34 | |
36 | 35 | # 1. Packages / Dependencies |
... | ... | @@ -119,30 +118,7 @@ Create a `git` user for Gitlab: |
119 | 118 | |
120 | 119 | sudo adduser --disabled-login --gecos 'GitLab' git |
121 | 120 | |
122 | - | |
123 | -# 4. GitLab shell | |
124 | - | |
125 | -GitLab Shell is an ssh access and repository management software developed specially for GitLab. | |
126 | - | |
127 | - # Go to home directory | |
128 | - cd /home/git | |
129 | - | |
130 | - # Clone gitlab shell | |
131 | - sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab-shell.git -b v1.9.3 | |
132 | - | |
133 | - cd gitlab-shell | |
134 | - | |
135 | - sudo -u git -H cp config.yml.example config.yml | |
136 | - | |
137 | - # Edit config and replace gitlab_url | |
138 | - # with something like 'http://domain.com/' | |
139 | - sudo -u git -H editor config.yml | |
140 | - | |
141 | - # Do setup | |
142 | - sudo -u git -H ./bin/install | |
143 | - | |
144 | - | |
145 | -# 5. Database | |
121 | +# 4. Database | |
146 | 122 | |
147 | 123 | We recommend using a PostgreSQL database. For MySQL check [MySQL setup guide](database_mysql.md). |
148 | 124 | |
... | ... | @@ -165,7 +141,7 @@ We recommend using a PostgreSQL database. For MySQL check [MySQL setup guide](da |
165 | 141 | sudo -u git -H psql -d gitlabhq_production |
166 | 142 | |
167 | 143 | |
168 | -# 6. GitLab | |
144 | +# 5. GitLab | |
169 | 145 | |
170 | 146 | # We'll install GitLab into home directory of the user "git" |
171 | 147 | cd /home/git |
... | ... | @@ -276,6 +252,18 @@ that were [fixed](https://github.com/bundler/bundler/pull/2817) in 1.5.2. |
276 | 252 | |
277 | 253 | # When done you see 'Administrator account created:' |
278 | 254 | |
255 | +## Install GitLab shell | |
256 | + | |
257 | +GitLab Shell is an ssh access and repository management software developed specially for GitLab. | |
258 | + | |
259 | + # Go to the Gitlab installation folder: | |
260 | + cd /home/git/gitlab | |
261 | + | |
262 | + # Run the installation task for gitlab-shell (replace `REDIS_URL` if needed): | |
263 | + sudo -u git -H bundle exec rake gitlab:shell:install[v1.9.3] REDIS_URL=redis://localhost:6379 | |
264 | + | |
265 | + # By default, the gitlab-shell config is generated from your main gitlab config. You can review (and modify) it as follows: | |
266 | + sudo -u git -H editor /home/git/gitlab-shell/config.yml | |
279 | 267 | |
280 | 268 | ## Install Init Script |
281 | 269 | |
... | ... | @@ -313,7 +301,13 @@ Check if GitLab and its environment are configured correctly: |
313 | 301 | # or |
314 | 302 | sudo /etc/init.d/gitlab restart |
315 | 303 | |
316 | -# 7. Nginx | |
304 | + | |
305 | +## Compile assets | |
306 | + | |
307 | + sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production | |
308 | + | |
309 | + | |
310 | +# 6. Nginx | |
317 | 311 | |
318 | 312 | **Note:** |
319 | 313 | Nginx is the officially supported web server for GitLab. If you cannot or do not want to use Nginx as your web server, have a look at the | ... | ... |
lib/tasks/gitlab/shell.rake
1 | 1 | namespace :gitlab do |
2 | 2 | namespace :shell do |
3 | + desc "GITLAB | Install or upgrade gitlab-shell" | |
4 | + task :install, [:tag, :repo] => :environment do |t, args| | |
5 | + warn_user_is_not_gitlab | |
6 | + | |
7 | + args.with_defaults(tag: "v1.9.1", repo: "https://gitlab.com/gitlab-org/gitlab-shell.git") | |
8 | + | |
9 | + user = Settings.gitlab.user | |
10 | + home_dir = Settings.gitlab.user_home | |
11 | + gitlab_url = Settings.gitlab.url | |
12 | + # gitlab-shell requires a / at the end of the url | |
13 | + gitlab_url += "/" unless gitlab_url.match(/\/$/) | |
14 | + repos_path = Gitlab.config.gitlab_shell.repos_path | |
15 | + target_dir = Gitlab.config.gitlab_shell.path | |
16 | + | |
17 | + # Clone if needed | |
18 | + unless File.directory?(target_dir) | |
19 | + sh "git clone '#{args.repo}' '#{target_dir}'" | |
20 | + end | |
21 | + | |
22 | + # Make sure we're on the right tag | |
23 | + Dir.chdir(target_dir) do | |
24 | + sh "git fetch origin && git reset --hard $(git describe #{args.tag} || git describe origin/#{args.tag})" | |
25 | + | |
26 | + redis_url = URI.parse(ENV['REDIS_URL'] || "redis://localhost:6379") | |
27 | + | |
28 | + config = { | |
29 | + user: user, | |
30 | + gitlab_url: gitlab_url, | |
31 | + http_settings: {self_signed_cert: false}, | |
32 | + repos_path: repos_path, | |
33 | + auth_file: File.join(home_dir, ".ssh", "authorized_keys"), | |
34 | + redis: { | |
35 | + bin: %x{which redis-cli}.chomp, | |
36 | + host: redis_url.host, | |
37 | + port: redis_url.port, | |
38 | + namespace: "resque:gitlab" | |
39 | + }, | |
40 | + log_level: "INFO", | |
41 | + audit_usernames: false | |
42 | + }.stringify_keys | |
43 | + | |
44 | + # Generate config.yml based on existing gitlab settings | |
45 | + File.open("config.yml", "w+") {|f| f.puts config.to_yaml} | |
46 | + | |
47 | + # Launch installation process | |
48 | + sh "bin/install" | |
49 | + end | |
50 | + | |
51 | + # Required for debian packaging with PKGR: Setup .ssh/environment with | |
52 | + # the current PATH, so that the correct ruby version gets loaded | |
53 | + # Requires to set "PermitUserEnvironment yes" in sshd config (should not | |
54 | + # be an issue since it is more than likely that there are no "normal" | |
55 | + # user accounts on a gitlab server). The alternative is for the admin to | |
56 | + # install a ruby (1.9.3+) in the global path. | |
57 | + File.open(File.join(home_dir, ".ssh", "environment"), "w+") do |f| | |
58 | + f.puts "PATH=#{ENV['PATH']}" | |
59 | + end | |
60 | + end | |
61 | + | |
3 | 62 | desc "GITLAB | Setup gitlab-shell" |
4 | 63 | task setup: :environment do |
5 | 64 | setup | ... | ... |