Commit 03f43291cdf60c6a185383d7d218fd87196d6231
1 parent
f9def679
Exists in
master
and in
4 other branches
Remove easy script cause its should be improved
Showing
2 changed files
with
1 additions
and
316 deletions
Show diff stats
doc/install/:w
@@ -1,295 +0,0 @@ | @@ -1,295 +0,0 @@ | ||
1 | -_This installation guide created for Debian/Ubuntu and properly tested._ | ||
2 | - | ||
3 | -_Checkout requirements before setup_ | ||
4 | - | ||
5 | -### IMPORTANT | ||
6 | - | ||
7 | -Please make sure you have followed all the steps below before posting to the mailing list with installation and configuration questions. | ||
8 | - | ||
9 | -Only create a GitHub Issue if you want a specific part of this installation guide updated. | ||
10 | - | ||
11 | -Also read the [Read this before you submit an issue](https://github.com/gitlabhq/gitlabhq/wiki/Read-this-before-you-submit-an-issue) wiki page. | ||
12 | - | ||
13 | -- - - | ||
14 | - | ||
15 | -# Basic setup | ||
16 | - | ||
17 | -The basic installation will provide you a GitLab setup with options: | ||
18 | - | ||
19 | -1. ruby 1.9.3 | ||
20 | -2. mysql as main db | ||
21 | -3. gitolite v3 fork by gitlab | ||
22 | -4. nginx + unicorn | ||
23 | - | ||
24 | -The installation consists of next steps: | ||
25 | - | ||
26 | -1. Packages / dependencies | ||
27 | -2. Ruby | ||
28 | -3. Users | ||
29 | -4. Gitolite | ||
30 | -5. Mysql | ||
31 | -6. GitLab. | ||
32 | -7. Nginx | ||
33 | - | ||
34 | - | ||
35 | -# 1. Packages / dependencies | ||
36 | - | ||
37 | -*Keep in mind that `sudo` is not installed on Debian by default. You should install it as root:* | ||
38 | - | ||
39 | - apt-get update && apt-get upgrade && apt-get install sudo | ||
40 | - | ||
41 | -Now install the required packages: | ||
42 | - | ||
43 | - sudo apt-get update | ||
44 | - sudo apt-get upgrade | ||
45 | - | ||
46 | - 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 | ||
47 | - | ||
48 | - sudo pip install pygments | ||
49 | - | ||
50 | - | ||
51 | -# 2. Install Ruby | ||
52 | - | ||
53 | - wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p194.tar.gz | ||
54 | - tar xfvz ruby-1.9.3-p194.tar.gz | ||
55 | - cd ruby-1.9.3-p194 | ||
56 | - ./configure | ||
57 | - make | ||
58 | - sudo make install | ||
59 | - | ||
60 | -# 3. Users | ||
61 | - | ||
62 | -Create user for git: | ||
63 | - | ||
64 | - sudo adduser \ | ||
65 | - --system \ | ||
66 | - --shell /bin/sh \ | ||
67 | - --gecos 'git version control' \ | ||
68 | - --group \ | ||
69 | - --disabled-password \ | ||
70 | - --home /home/git \ | ||
71 | - git | ||
72 | - | ||
73 | -Create user for GitLab: | ||
74 | - | ||
75 | - # ubuntu/debian | ||
76 | - sudo adduser --disabled-login --gecos 'gitlab system' gitlab | ||
77 | - | ||
78 | -Add your users to groups: | ||
79 | - | ||
80 | - sudo usermod -a -G git gitlab | ||
81 | - sudo usermod -a -G gitlab git | ||
82 | - | ||
83 | -Generate key: | ||
84 | - | ||
85 | - sudo -H -u gitlab ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa | ||
86 | - | ||
87 | - | ||
88 | -# 4. Gitolite | ||
89 | - | ||
90 | -Clone GitLab's fork of the Gitolite source code: | ||
91 | - | ||
92 | - sudo -H -u git git clone -b gl-v304 https://github.com/gitlabhq/gitolite.git /home/git/gitolite | ||
93 | - | ||
94 | -Setup: | ||
95 | - | ||
96 | - cd /home/git | ||
97 | - sudo -u git -H mkdir bin | ||
98 | - sudo -u git sh -c 'echo -e "PATH=\$PATH:/home/git/bin\nexport PATH" >> /home/git/.profile' | ||
99 | - sudo -u git sh -c 'gitolite/install -ln /home/git/bin' | ||
100 | - | ||
101 | - sudo cp /home/gitlab/.ssh/id_rsa.pub /home/git/gitlab.pub | ||
102 | - sudo chmod 0444 /home/git/gitlab.pub | ||
103 | - | ||
104 | - sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gitolite setup -pk /home/git/gitlab.pub" | ||
105 | - sudo -u git -H sed -i 's/0077/0007/g' /home/git/.gitolite.rc | ||
106 | - sudo -u git -H sed -i "s/\(GIT_CONFIG_KEYS\s*=>*\s*\).\{2\}/\1'\.\*'/g" /home/git/.gitolite.rc | ||
107 | - | ||
108 | -Permissions: | ||
109 | - | ||
110 | - sudo chmod -R g+rwX /home/git/repositories/ | ||
111 | - sudo chown -R git:git /home/git/repositories/ | ||
112 | - | ||
113 | - # clone admin repo to add localhost to known_hosts | ||
114 | - # & be sure your user has access to gitolite | ||
115 | - sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin | ||
116 | - | ||
117 | - # if succeed you can remove it | ||
118 | - sudo rm -rf /tmp/gitolite-admin | ||
119 | - | ||
120 | -**IMPORTANT! If you can't clone `gitolite-admin` repository - DO NOT PROCEED WITH INSTALLATION** | ||
121 | -Check the [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide) | ||
122 | -and ensure you have followed all of the above steps carefully. | ||
123 | - | ||
124 | - | ||
125 | -# 5. Mysql database | ||
126 | - | ||
127 | - sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev | ||
128 | - | ||
129 | - # Login to MySQL | ||
130 | - $ mysql -u root -p | ||
131 | - | ||
132 | - # Create the GitLab production database | ||
133 | - mysql> CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`; | ||
134 | - | ||
135 | - # Create the MySQL User change $password to a real password | ||
136 | - mysql> CREATE USER 'gitlab'@'localhost' IDENTIFIED BY '$password'; | ||
137 | - | ||
138 | - # Grant proper permissions to the MySQL User | ||
139 | - mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 'gitlab'@'localhost'; | ||
140 | - | ||
141 | - | ||
142 | -# 6. GitLab | ||
143 | - | ||
144 | - cd /home/gitlab | ||
145 | - | ||
146 | - | ||
147 | -#### Get source code | ||
148 | - | ||
149 | - # Get gitlab code. Use this for stable setup | ||
150 | - sudo -H -u gitlab git clone -b stable https://github.com/gitlabhq/gitlabhq.git gitlab | ||
151 | - | ||
152 | - # Skip this for stable setup. | ||
153 | - # Master branch (recent changes, less stable) | ||
154 | - sudo -H -u gitlab git clone -b master https://github.com/gitlabhq/gitlabhq.git gitlab | ||
155 | - | ||
156 | - | ||
157 | -#### Copy configs | ||
158 | - | ||
159 | - cd gitlab | ||
160 | - | ||
161 | - # Rename config files | ||
162 | - # | ||
163 | - sudo -u gitlab cp config/gitlab.yml.example config/gitlab.yml | ||
164 | - | ||
165 | - # Copy mysql db config | ||
166 | - # | ||
167 | - # make sure to update username/password in config/database.yml | ||
168 | - # | ||
169 | - sudo -u gitlab cp config/database.yml.mysql config/database.yml | ||
170 | - | ||
171 | - # Copy unicorn config | ||
172 | - # | ||
173 | - sudo -u gitlab cp config/unicorn.rb.example config/unicorn.rb | ||
174 | - | ||
175 | -#### Install gems | ||
176 | - | ||
177 | - cd /home/gitlab/gitlab | ||
178 | - | ||
179 | - sudo gem install charlock_holmes --version '0.6.8' | ||
180 | - sudo gem install bundler | ||
181 | - sudo -u gitlab -H bundle install --without development test sqlite postgres --deployment | ||
182 | - | ||
183 | -#### Setup application | ||
184 | - | ||
185 | - sudo -u gitlab bundle exec rake gitlab:app:setup RAILS_ENV=production | ||
186 | - | ||
187 | - | ||
188 | -#### Setup GitLab hooks | ||
189 | - | ||
190 | - sudo cp ./lib/hooks/post-receive /home/git/.gitolite/hooks/common/post-receive | ||
191 | - sudo chown git:git /home/git/.gitolite/hooks/common/post-receive | ||
192 | - | ||
193 | -#### Check application status | ||
194 | - | ||
195 | -Checking status: | ||
196 | - | ||
197 | - sudo -u gitlab bundle exec rake gitlab:app:status RAILS_ENV=production | ||
198 | - | ||
199 | - | ||
200 | - # OUTPUT EXAMPLE | ||
201 | - Starting diagnostic | ||
202 | - config/database.yml............exists | ||
203 | - config/gitlab.yml............exists | ||
204 | - /home/git/repositories/............exists | ||
205 | - /home/git/repositories/ is writable?............YES | ||
206 | - remote: Counting objects: 603, done. | ||
207 | - remote: Compressing objects: 100% (466/466), done. | ||
208 | - remote: Total 603 (delta 174), reused 0 (delta 0) | ||
209 | - Receiving objects: 100% (603/603), 53.29 KiB, done. | ||
210 | - Resolving deltas: 100% (174/174), done. | ||
211 | - Can clone gitolite-admin?............YES | ||
212 | - UMASK for .gitolite.rc is 0007? ............YES | ||
213 | - /home/git/share/gitolite/hooks/common/post-receive exists? ............YES | ||
214 | - | ||
215 | -If you got all YES - congratulations! You can run a GitLab app. | ||
216 | - | ||
217 | -#### init script | ||
218 | - | ||
219 | -Create init script in /etc/init.d/gitlab: | ||
220 | - | ||
221 | - sudo wget https://raw.github.com/gitlabhq/gitlab-recipes/master/init.d/gitlab -P /etc/init.d/ | ||
222 | - sudo chmod +x /etc/init.d/gitlab | ||
223 | - | ||
224 | -GitLab autostart: | ||
225 | - | ||
226 | - sudo update-rc.d gitlab defaults 21 | ||
227 | - | ||
228 | -#### Now you should start GitLab application: | ||
229 | - | ||
230 | - sudo service gitlab start | ||
231 | - | ||
232 | - | ||
233 | -# 7. Nginx | ||
234 | - | ||
235 | - # Install first | ||
236 | - sudo apt-get install nginx | ||
237 | - | ||
238 | - # Add GitLab to nginx sites & change with your host specific settings | ||
239 | - sudo wget https://raw.github.com/gitlabhq/gitlab-recipes/master/nginx/gitlab -P /etc/nginx/sites-available/ | ||
240 | - sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab | ||
241 | - | ||
242 | - # Change **YOUR_SERVER_IP** and **YOUR_SERVER_FQDN** | ||
243 | - # to the IP address and fully-qualified domain name | ||
244 | - # of the host serving GitLab. | ||
245 | - sudo vim /etc/nginx/sites-enabled/gitlab | ||
246 | - | ||
247 | - # Restart nginx: | ||
248 | - sudo /etc/init.d/nginx restart | ||
249 | - | ||
250 | - | ||
251 | -# Done! Visit YOUR_SERVER for gitlab instance | ||
252 | - | ||
253 | -You can login via web using admin generated with setup: | ||
254 | - | ||
255 | - admin@local.host | ||
256 | - 5iveL!fe | ||
257 | - | ||
258 | - | ||
259 | -- - - | ||
260 | - | ||
261 | - | ||
262 | -# Advanced setup tips: | ||
263 | - | ||
264 | - | ||
265 | -## Quick setup | ||
266 | - | ||
267 | -> - - - | ||
268 | -> The first 3 steps of this guide can be easily skipped by executing an install script: | ||
269 | -> | ||
270 | -> # Install curl and sudo | ||
271 | -> apt-get install curl sudo | ||
272 | -> | ||
273 | -> # 3 steps in 1 command :) | ||
274 | -> curl https://raw.github.com/gitlabhq/gitlab-recipes/master/install/debian_ubuntu.sh | sh | ||
275 | -> | ||
276 | -> Now you can go to [Step 4](#4-install-gitlab-and-configuration-check-status-configuration) | ||
277 | -> | ||
278 | -> Or if you are installing on Amazon Web Services using Ubuntu 12.04 you can do all steps (1 to 6) at once with: | ||
279 | -> | ||
280 | -> curl https://raw.github.com/gitlabhq/gitlab-recipes/master/install/debian_ubuntu_aws.sh | sh | ||
281 | -> | ||
282 | -> for more detailed instructions read the HOWTO section of [the script](https://github.com/gitlabhq/gitlab-recipes/blob/master/install/debian_ubuntu_aws.sh) | ||
283 | -> - - - | ||
284 | - | ||
285 | - | ||
286 | -## Customizing Resque's Redis connection | ||
287 | - | ||
288 | -If you'd like Resque to connect to a Redis server on a non-standard port or on | ||
289 | -a different host, you can configure its connection string in the | ||
290 | -**config/resque.yml** file: | ||
291 | - | ||
292 | - production: redis.example.com:6379 | ||
293 | - | ||
294 | -**Ok - we have a working application now. ** | ||
295 | -**But keep going - there are some things that should be done ** |
doc/install/installation.md
@@ -262,27 +262,7 @@ You can login via web using admin generated with setup: | @@ -262,27 +262,7 @@ You can login via web using admin generated with setup: | ||
262 | 262 | ||
263 | # Advanced setup tips: | 263 | # Advanced setup tips: |
264 | 264 | ||
265 | - | ||
266 | -## Quick setup | ||
267 | - | ||
268 | -> - - - | ||
269 | -> The first 3 steps of this guide can be easily skipped by executing an install script: | ||
270 | -> | ||
271 | -> # Install curl and sudo | ||
272 | -> apt-get install curl sudo | ||
273 | -> | ||
274 | -> # 3 steps in 1 command :) | ||
275 | -> curl https://raw.github.com/gitlabhq/gitlab-recipes/master/install/debian_ubuntu.sh | sh | ||
276 | -> | ||
277 | -> Now you can go to [Step 4](#4-install-gitlab-and-configuration-check-status-configuration) | ||
278 | -> | ||
279 | -> Or if you are installing on Amazon Web Services using Ubuntu 12.04 you can do all steps (1 to 6) at once with: | ||
280 | -> | ||
281 | -> curl https://raw.github.com/gitlabhq/gitlab-recipes/master/install/debian_ubuntu_aws.sh | sh | ||
282 | -> | ||
283 | -> for more detailed instructions read the HOWTO section of [the script](https://github.com/gitlabhq/gitlab-recipes/blob/master/install/debian_ubuntu_aws.sh) | ||
284 | -> - - - | ||
285 | - | 265 | +_Checkout databases.md for postgres or sqlite_ |
286 | 266 | ||
287 | ## Customizing Resque's Redis connection | 267 | ## Customizing Resque's Redis connection |
288 | 268 |