You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
GitLab recipes for setup on different platforms, update etc.
4
+
Unofficial guides for using GitLab with different software (operating systems, webservers, etc.)
5
+
provided by the community, for systems other than the officially supported (Debian/Ubuntu).
5
6
6
-
## Guidelines on community contributions
7
+
Bare in mind that this repository is co-maintained by volunteers/contributors like you.
7
8
8
-
Here you will find installation guides or automation scripts provided by the community,
9
-
for systems other than the officially supported (Debian/Ubuntu).
9
+
# Contributing
10
10
11
-
Bare in mind that this repository is co-maintained by volunteers/contributors like you.
11
+
## Naming guidelines
12
12
13
-
### Accepting Pull Requests
13
+
For better maintainance and clarity, some naming guidelines should be followed.
14
+
15
+
* Installation guides should be provided in README files so that they render first when viewing the repository.
16
+
17
+
* Installation scripts reside in a `scripts/` directory inside every platform folder.
18
+
19
+
### Scripts
20
+
21
+
There are scripts doing similar things
22
+
23
+
? Scripts should be named after the following scheme: platform-platform_version
24
+
Example: `ubuntu-server-12.04.sh`
25
+
26
+
## Install information
27
+
28
+
If you have an installation guide to provide, fill in the template and place it on top
29
+
of your guide or include it in your installation script (commented), again on top.
14
30
15
-
In each parent directory (install, init, web-server, etc.) you will find some conventions
16
-
you need to follow in order for your Pull Request to be accepted.
31
+
### Template
32
+
33
+
```
34
+
Distribution :
35
+
GitLab version :
36
+
Web Server :
37
+
Init system :
38
+
Database :
39
+
Contributor :
40
+
Additional Notes :
41
+
```
42
+
43
+
### Explanation
44
+
45
+
| Label | Explanation |
46
+
| ---------------- | ------------------------- |
47
+
| Distribution | The official name and version of the platform/distribution, case sensitive. |
48
+
| GitLab version | GitLab version on which the guide/script was tested. |
49
+
| Web Server | The web server used to serve GitLab. May be two-fold, eg. apache with mod_passenger. |
50
+
| Init system | (Optional but recommended) The init system used by the platform if any. Examples: `sysvinit`, `systemd`, `upstart`, `openrc`, etc |
51
+
| Database | The database used for installation. Examples: `mysql`, `postrgres`, `mariadb`.
52
+
| Contributor | Your github username (recommended in order to track you and give credits) or your real name or both. Example of the latter: **thedude (Jeffrey Lebowski)**|
53
+
| Additional Notes | Anything else you want to add. Any deviations form the official guide can be reported here. Eg. using rvm for ruby install, storing in different locations, etc.|
54
+
55
+
56
+
### Example
57
+
58
+
```
59
+
Distribution : Fedora 19
60
+
GitLab version : 5.4
61
+
Web Server : apache with mod_passenger
62
+
Init system : systemd
63
+
Database : mariadb
64
+
Contributor : thedude
65
+
Additional Notes : the script uses rvm to install ruby
66
+
```
67
+
68
+
### Accepting Pull Requests
17
69
18
70
Please stick as close as possible to the guidelines. That way we ensure quality guides
19
71
and easy to merge requests.
20
72
21
73
Your Pull Request will be reviewed by one of our volunteers and you will be
22
74
asked to reformat it if needed. We don't bite and we will try to be as flexible
23
75
as possible, so don't get intimidated by the extent of the quidelines :)
76
+
77
+
## Notes
78
+
79
+
* We try to test everything before accepting PRs, in a clean, newly installed platform.
80
+
* You should read a script and understand what it does prior to running it.
81
+
* If something goes wrong during installation and you think the guide/script needs fixing, file a bug report or a Pull Request.
For better maintainance and clarity, some naming guidelines should be followed.
4
-
5
-
* Guides should be provided in README files so that they render first when viewing the repository.
6
-
* Installation scripts reside in a `scripts/` directory inside every platform folder.
7
-
8
-
### Scripts
9
-
10
-
TODO: How to name multiple scripts doing similar things?
11
-
12
-
? Scripts should be named after the following scheme: platform-platform_version
13
-
Example: `ubuntu-server-12.04.sh`
14
-
15
-
## General information
16
-
17
-
If you have an installation guide to provide, fill in the template and place it on top
18
-
of your guide or include it in your installation script (commented), again on top.
19
-
20
-
### Template
21
-
22
-
```
23
-
Distribution :
24
-
GitLab version :
25
-
Web Server :
26
-
Init system :
27
-
Database :
28
-
Contributor :
29
-
Additional Notes :
30
-
```
31
-
32
-
### Explanation
33
-
34
-
| Label | Explanation |
35
-
| ---------------- | ------------------------- |
36
-
| Distribution | The official name and version of the platform/distribution, case sensitive. |
37
-
| GitLab version | GitLab version on which the guide/script was tested. |
38
-
| Web Server | The web server used to serve GitLab. May be two-fold, eg. apache with mod_passenger. |
39
-
| Init system | (Optional but recommended) The init system used by the platform if any. Examples: `sysvinit`, `systemd`, `upstart`, `openrc`, etc |
40
-
| Database | The database used for installation. Examples: `mysql`, `postrgres`, `mariadb`.
41
-
| Contributor | Your github username (recommended in order to track you and give credits) or your real name or both. Example of the latter: **thedude (Jeffrey Lebowski)**|
42
-
| Additional Notes | Anything else you want to add. Any deviations form the official guide can be reported here. Eg. using rvm for ruby install, storing in different locations, etc.|
43
-
44
-
45
-
### Example
46
-
47
-
```
48
-
Distribution : Fedora 19
49
-
GitLab version : 5.4
50
-
Web Server : apache with mod_passenger
51
-
Init system : systemd
52
-
Database : mariadb
53
-
Contributor : thedude
54
-
Additional Notes : the script uses rvm to install ruby
55
-
```
56
-
57
-
## Notes
58
-
59
-
* We try to test everything before accepting PRs, in a clean, newly installed platform.
60
-
* You should read the script and understand what it does prior to running it.
61
-
* If something goes wrong during installation and you think the guide/script needs fixing, file a bug report or a Pull Request.
1
+
In this directory you will find installation guides and scripts for various platforms.
2
+
If you have something to contribute please read the [contributing guidelines](../README.md#Contributing).
Copy file name to clipboardExpand all lines: install/centos/README.md
+51-12Lines changed: 51 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,8 +15,8 @@ Additional Notes : Selinux is not disabled but properly configured.
15
15
16
16
Please read `doc/install/requirements.md` for hardware and platform requirements.
17
17
18
-
This guide installs gitlab on a bare system from scratch using MySQL as the database.
19
-
All Postgress installation steps are absent as they have not been tested yet.
18
+
This guide installs GitLab on a bare system from scratch, using MySQL as the database.
19
+
All Postgres installation steps are absent as they have not been tested yet.
20
20
21
21
### Important Notes
22
22
@@ -27,12 +27,12 @@ violate any assumptions GitLab makes about its environment.
27
27
#### If you find a bug
28
28
29
29
If you find a bug/error in this guide please submit an issue or pull request
30
-
following the contribution guide (see `CONTRIBUTING.md`).
30
+
following the contribution guide (see `install/README.md`).
31
31
32
32
#### Security
33
33
34
34
Many setup guides of Linux software simply state: "disable selinux and firewall".
35
-
The original gitlab installation for ubuntu disables StrictHostKeyChecking completely.
35
+
The original GitLab installation for Ubuntu disables StrictHostKeyChecking completely.
36
36
This guide does not disable any of them, we simply configure them as they were intended.
37
37
38
38
- - -
@@ -51,28 +51,65 @@ The GitLab installation consists of setting up the following components:
51
51
52
52
# 1. Installing the operating system (CentOS 6.4 Minimal)
53
53
54
-
We start with a completely clean CentOS 6.4 "minimal" installation which can be accomplished by downloading the appropriate installation iso file. Just boot the system of the iso file and install the system.
54
+
We start with a completely clean CentOS 6.4 "minimal" installation which can be
55
+
accomplished by downloading the appropriate installation iso file. Just boot the
56
+
system of the iso file and install the system.
57
+
58
+
Note that during the installation you use the *"Configure Network"* option (it's a
59
+
button in the same screen where you specify the hostname) to enable the *"Connect automatically"*
60
+
option for the network interface and hand (usually eth0).
55
61
56
-
Note that during the installation you use the *"Configure Network"* option (it's a button in the same screen where you specify the hostname) to enable the *"Connect automatically"* option for the network interface and hand (usually eth0).
57
62
**If you forget this option the network will NOT start at boot.**
58
63
59
64
The end result is a bare minimum CentOS installation that effectively only has network connectivity and (almost) no services at all.
60
65
61
66
## Updating and adding basic software and services
67
+
62
68
### Add EPEL repository
63
69
64
-
*logged in as **root***
70
+
[EPEL][] is a volunteer-based community effort from the Fedora project to create
71
+
a repository of high-quality add-on packages that complement the Fedora-based
72
+
Red Hat Enterprise Linux (RHEL) and its compatible spinoffs, such as CentOS and Scientific Linux.
0 commit comments