debian-mirror-gitlab/doc/ci/enable_or_disable_ci.md

66 lines
2.3 KiB
Markdown
Raw Normal View History

2018-03-17 18:26:18 +05:30
# How to enable or disable GitLab CI/CD
2018-03-17 18:26:18 +05:30
To effectively use GitLab CI/CD, you need a valid [`.gitlab-ci.yml`](yaml/README.md)
file present at the root directory of your project and a
[runner](runners/README.md) properly set up. You can read our
2018-03-17 18:26:18 +05:30
[quick start guide](quick_start/README.md) to get you started.
2018-03-17 18:26:18 +05:30
If you are using an external CI/CD server like Jenkins or Drone CI, it is advised
to disable GitLab CI/CD in order to not have any conflicts with the commits status
API.
---
2018-03-17 18:26:18 +05:30
GitLab CI/CD is exposed via the `/pipelines` and `/jobs` pages of a project.
Disabling GitLab CI/CD in a project does not delete any previous jobs.
In fact, the `/pipelines` and `/jobs` pages can still be accessed, although
2017-08-17 22:00:37 +05:30
it's hidden from the left sidebar menu.
2018-03-17 18:26:18 +05:30
GitLab CI/CD is enabled by default on new installations and can be disabled either
individually under each project's settings, or site-wide by modifying the
settings in `gitlab.yml` and `gitlab.rb` for source and Omnibus installations
respectively.
2018-03-17 18:26:18 +05:30
## Per-project user setting
2018-03-17 18:26:18 +05:30
The setting to enable or disable GitLab CI/CD can be found under your project's
**Settings > General > Permissions**. Choose one of "Disabled", "Only team members"
or "Everyone with access" and hit **Save changes** for the settings to take effect.
2018-03-17 18:26:18 +05:30
![Sharing & Permissions settings](../user/project/settings/img/sharing_and_permissions_settings.png)
2018-03-17 18:26:18 +05:30
## Site-wide admin setting
2018-03-17 18:26:18 +05:30
You can disable GitLab CI/CD site-wide, by modifying the settings in `gitlab.yml`
and `gitlab.rb` for source and Omnibus installations respectively.
Two things to note:
2018-03-17 18:26:18 +05:30
1. Disabling GitLab CI/CD, will affect only newly-created projects. Projects that
had it enabled prior to this modification, will work as before.
2018-03-17 18:26:18 +05:30
1. Even if you disable GitLab CI/CD, users will still be able to enable it in the
project's settings.
For installations from source, open `gitlab.yml` with your editor and set
`builds` to `false`:
```yaml
## Default project features settings
default_projects_features:
issues: true
merge_requests: true
wiki: true
snippets: false
builds: false
```
Save the file and restart GitLab: `sudo service gitlab restart`.
For Omnibus installations, edit `/etc/gitlab/gitlab.rb` and add the line:
```
2016-06-02 11:05:42 +05:30
gitlab_rails['gitlab_default_projects_features_builds'] = false
```
Save the file and reconfigure GitLab: `sudo gitlab-ctl reconfigure`.