119 lines
5.3 KiB
Markdown
119 lines
5.3 KiB
Markdown
## GitLab: self hosted Git management software
|
|
|
|
|
|
|
|
|
|
|
|
### Gitlab is open source software to collaborate on code
|
|
|
|
* Manage git repositories with fine grained access controls that keep your code secure
|
|
* Perform code reviews and enhance collaboration with merge requests
|
|
* Each project can also have an issue tracker and a wiki
|
|
* Used by more than 100,000 organizations, GitLab is the most popular solution to manage git repositories on-premises
|
|
* Completely free and open source (MIT Expat license)
|
|
* Powered by Ruby on Rails
|
|
|
|
### Canonical source
|
|
|
|
* The source of GitLab Community Edition is [hosted on GitLab.com](https://gitlab.com/gitlab-org/gitlab-ce/) and there are mirrors to make [contributing](CONTRIBUTING.md) as easy as possible.
|
|
|
|
### Code status
|
|
|
|
* [](https://ci.gitlab.org/projects/1?ref=master) on ci.gitlab.org (master branch)
|
|
|
|
* [](https://codeclimate.com/github/gitlabhq/gitlabhq)
|
|
|
|
* [](https://coveralls.io/r/gitlabhq/gitlabhq)
|
|
|
|
* [](https://www.pullreview.com/gitlab.gitlab.com/gitlab-org/gitlab-ce/reviews/master)
|
|
|
|
### Resources
|
|
|
|
* [www.gitlab.com](https://www.gitlab.com/) includes information about [subscriptions](https://www.gitlab.com/subscription/), [consultancy](https://www.gitlab.com/consultancy/), the [community](https://www.gitlab.com/community/) and the [hosted GitLab.com](https://www.gitlab.com/gitlab-com/).
|
|
|
|
* [GitLab Enterprise Edition](https://www.gitlab.com/gitlab-ee/) offers additional features aimed at larger organizations.
|
|
|
|
* [GitLab CI](https://www.gitlab.com/gitlab-ci/) is a continuous integration (CI) server that is easy to integrate with GitLab.
|
|
|
|
* Unofficial third-party [iPhone app](http://gitlabcontrol.com/), [Android app](https://play.google.com/store/apps/details?id=com.bd.gitlab&hl=en) and [command line client](https://github.com/drewblessing/gitlab-cli) and [Ruby API wrapper](https://github.com/NARKOZ/gitlab) for GitLab.
|
|
|
|
### Requirements
|
|
|
|
* Ubuntu/Debian/CentOS/RHEL**
|
|
* ruby 2.0+
|
|
* git 1.7.10+
|
|
* redis 2.0+
|
|
* MySQL or PostgreSQL
|
|
|
|
** More details are in the [requirements doc](doc/install/requirements.md)
|
|
|
|
### Installation
|
|
|
|
Please see [the installation page on the GitLab website](https://www.gitlab.com/installation/).
|
|
|
|
### New versions
|
|
|
|
Since 2011 a minor or major version of GitLab is released on the 22nd of every month. Patch and security releases come out when needed. New features are detailed on the [blog](https://www.gitlab.com/blog/) and in the [changelog](CHANGELOG). For more information about the release process see the release [documentation](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/release). Features that will likely be in the next releases can be found on the [feature request forum](http://feedback.gitlab.com/forums/176466-general) with the status [started](http://feedback.gitlab.com/forums/176466-general/status/796456) and [completed](http://feedback.gitlab.com/forums/176466-general/status/796457).
|
|
|
|
### Upgrading
|
|
|
|
For updating the the Omnibus installation please see the [update documentation](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/update.md). For manual installations there is an [upgrader script](doc/update/upgrader.md) and there are [upgrade guides](doc/update).
|
|
|
|
### Run in production mode
|
|
|
|
The Installation guide contains instructions on how to download an init script and run it automatically on boot. You can also start the init script manually:
|
|
|
|
sudo service gitlab start
|
|
|
|
or by directly calling the script
|
|
|
|
sudo /etc/init.d/gitlab start
|
|
|
|
Please login with root / 5iveL!fe
|
|
|
|
### Install a development environment
|
|
|
|
We recommend setting up your development environment with [the cookbook](https://gitlab.com/gitlab-org/cookbook-gitlab/blob/master/README.md#installation).
|
|
If you do not use the cookbook you might need to copy the example development unicorn configuration file
|
|
|
|
cp config/unicorn.rb.example.development config/unicorn.rb
|
|
|
|
### Run in development mode
|
|
|
|
Start it with [Foreman](https://github.com/ddollar/foreman)
|
|
|
|
bundle exec foreman start -p 3000
|
|
|
|
or start each component separately
|
|
|
|
bundle exec rails s
|
|
bin/background_jobs start
|
|
|
|
And surf to [localhost:3000](http://localhost:3000/) and login with root / 5iveL!fe
|
|
|
|
### Run the tests
|
|
|
|
* Run all tests
|
|
|
|
bundle exec rake test
|
|
|
|
* [RSpec](http://rspec.info/) unit and functional tests
|
|
|
|
All RSpec tests: bundle exec rake spec
|
|
|
|
Single RSpec file: bundle exec rspec spec/controllers/commit_controller_spec.rb
|
|
|
|
* [Spinach](https://github.com/codegram/spinach) integration tests
|
|
|
|
All Spinach tests: bundle exec rake spinach
|
|
|
|
Single Spinach test: bundle exec spinach features/project/issues/milestones.feature
|
|
|
|
|
|
### Documentation
|
|
|
|
All documentation can be found on [doc.gitlab.com/ce/](http://doc.gitlab.com/ce/).
|
|
|
|
### Getting help
|
|
|
|
Please see [Getting help for GitLab](https://www.gitlab.com/getting-help/) on our website for the many options to get help.
|