## GitLab recipes: unofficial guides for using GitLab with different software
Unofficial guides for using GitLab with different software (operating systems, webservers, etc.)
Here you will find unofficial guides for using GitLab with different software (operating systems, webservers, etc.)
provided by the community, for systems other than the officially supported (Debian/Ubuntu).
Bare in mind that this repository is co-maintained by volunteers/contributors like you.
# Contributing
## Contributing
## Naming guidelines
See [contributing.md](contributing.md) for contribution guidelines.
For better maintainance and clarity, some naming guidelines should be followed.
## Notes on the reliability of guides/scripts
* Installation guides should be provided in README files so that they render first when viewing the repository.
* Installation scripts reside in a `scripts/` directory inside every platform folder.
### Scripts
There are scripts doing similar things
? Scripts should be named after the following scheme: platform-platform_version
Example: `ubuntu-server-12.04.sh`
## Install information
If you have an installation guide to provide, fill in the template and place it on top
of your guide or include it in your installation script (commented), again on top.
### Template
```
Distribution :
GitLab version :
Web Server :
Init system :
Database :
Contributor :
Additional Notes :
```
### Explanation
| Label | Explanation |
| ---------------- | ------------------------- |
| Distribution | The official name and version of the platform/distribution, case sensitive. |
| GitLab version | GitLab version on which the guide/script was tested. |
| Web Server | The web server used to serve GitLab. May be two-fold, eg. apache with mod_passenger. |
| Init system | (Optional but recommended) The init system used by the platform if any. Examples: `sysvinit`, `systemd`, `upstart`, `openrc`, etc |
| Database | The database used for installation. Examples: `mysql`, `postrgres`, `mariadb`.
| 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)** |
| 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.|
### Example
```
Distribution : Fedora 19
GitLab version : 5.4
Web Server : apache with mod_passenger
Init system : systemd
Database : mariadb
Contributor : thedude
Additional Notes : the script uses rvm to install ruby
```
### Accepting Pull Requests
Please stick as close as possible to the guidelines. That way we ensure quality guides
and easy to merge requests.
Your Pull Request will be reviewed by one of our volunteers and you will be
asked to reformat it if needed. We don't bite and we will try to be as flexible
as possible, so don't get intimidated by the extent of the quidelines :)
## Notes
* We try to test everything before accepting PRs, in a clean, newly installed platform.
* We will try to test everything before accepting PRs, in a clean, newly installed platform.
* You should read a script and understand what it does prior to running it.
* If something goes wrong during installation and you think the guide/script needs fixing, file a bug report or a Pull Request.
* If something goes wrong during installation and you think the guide/script needs fixing, file a bug report or a submit a Pull Request.
Each installation guide has its own namespace and it should be provided in a
`README` file so that it renders first when viewing the repository. Submit a new
one in `install/platform/README.md` (it doesn't have to be strictly in markdown though).
## Scripts
Installation scripts reside in `install/platform/scripts/`, so if you have one,
submit it there. They should named after the following scheme: `platform-platform_version`.
Example: `ubuntu-server-12.04.sh`
You are strongly encouraged to also provide a `README` file that describes
how to use the script. You may have included all the needed info in the script
itself (recommended), so you could simply write something between the lines:
> This script installs GitLab 6.0 on Archlinux. Run it with `./archlinux.sh your_domain_name`
> For more info and variables you can change, read the comments in the script.
### Scripts doing similar things
There is a strong possibility that your script will do similar things to what a
script already in this repo do. In that case, please work on the existing script
and enhance it with your changes. No need to duplicate things.
## What information to put on your guide/script etc (mandatory)
If you have an installation guide to provide, fill in the template and place it on top
of it or include it in your installation script (commented), again on top. Try to
include as many items of this template as you can.
### Template
```
Distribution :
GitLab version :
Web Server :
Init system :
Database :
Contributor :
Additional Notes :
```
### Explanation
| Label | Explanation |
| ---------------- | ------------------------- |
| Distribution | The official name and version of the platform/distribution, case sensitive. |
| GitLab version | GitLab version on which the guide/script was tested. |
| Web Server | The web server used to serve GitLab. May be two-fold, eg. apache with mod_passenger. |
| Init system | (Optional but recommended) The init system used by the platform if any. Examples: `sysvinit`, `systemd`, `upstart`, `openrc`, etc |
| Database | The database used for installation. Examples: `mysql`, `postrgres`, `mariadb`.
| Contributors | 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)** |
| 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.|
### Example
```
Distribution : Fedora 19
GitLab version : 5.4
Web Server : apache with mod_passenger
Init system : systemd
Database : mariadb
Contributors : thedude
Additional Notes : the script uses rvm to install ruby
