Fix most instances of bare URLs in markdown
This commit is contained in:
		
							parent
							
								
									7d11049237
								
							
						
					
					
						commit
						c2c2d04b3a
					
				| 
						 | 
					@ -335,7 +335,7 @@ group, you can use the following syntax:
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Find more information about this "LDAP_MATCHING_RULE_IN_CHAIN" filter at
 | 
					Find more information about this "LDAP_MATCHING_RULE_IN_CHAIN" filter at
 | 
				
			||||||
https://msdn.microsoft.com/en-us/library/aa746475(v=vs.85).aspx. Support for
 | 
					<https://docs.microsoft.com/en-us/windows/desktop/ADSI/search-filter-syntax>. Support for
 | 
				
			||||||
nested members in the user filter should not be confused with
 | 
					nested members in the user filter should not be confused with
 | 
				
			||||||
[group sync nested groups support (EE only)](https://docs.gitlab.com/ee/administration/auth/ldap-ee.html#supported-ldap-group-types-attributes).
 | 
					[group sync nested groups support (EE only)](https://docs.gitlab.com/ee/administration/auth/ldap-ee.html#supported-ldap-group-types-attributes).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -11,7 +11,7 @@ With the Container Registry integrated into GitLab, every project can have its
 | 
				
			||||||
own space to store its Docker images.
 | 
					own space to store its Docker images.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can read more about the Container Registry at
 | 
					You can read more about the Container Registry at
 | 
				
			||||||
https://docs.docker.com/registry/introduction/.
 | 
					<https://docs.docker.com/registry/introduction/>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Enable the Container Registry
 | 
					## Enable the Container Registry
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -17,7 +17,7 @@ The default pattern can be located in [gitlab.yml.example] under the
 | 
				
			||||||
"Automatic issue closing" section.
 | 
					"Automatic issue closing" section.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
> **Tip:**
 | 
					> **Tip:**
 | 
				
			||||||
You are advised to use http://rubular.com to test the issue closing pattern.
 | 
					You are advised to use <http://rubular.com> to test the issue closing pattern.
 | 
				
			||||||
Because Rubular doesn't understand `%{issue_ref}`, you can replace this by
 | 
					Because Rubular doesn't understand `%{issue_ref}`, you can replace this by
 | 
				
			||||||
`#\d+` when testing your patterns, which matches only local issue references like `#123`.
 | 
					`#\d+` when testing your patterns, which matches only local issue references like `#123`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -33,7 +33,7 @@ Test Connection to ensure the configuration is correct.
 | 
				
			||||||
- **Name**: InfluxDB
 | 
					- **Name**: InfluxDB
 | 
				
			||||||
- **Default**: Checked
 | 
					- **Default**: Checked
 | 
				
			||||||
- **Type**: InfluxDB 0.9.x (Even if you're using InfluxDB 0.10.x)
 | 
					- **Type**: InfluxDB 0.9.x (Even if you're using InfluxDB 0.10.x)
 | 
				
			||||||
- **Url**: https://localhost:8086 (Or the remote URL if you've installed InfluxDB
 | 
					- **Url**: `https://localhost:8086` (Or the remote URL if you've installed InfluxDB
 | 
				
			||||||
on a separate server)
 | 
					on a separate server)
 | 
				
			||||||
- **Access**: proxy
 | 
					- **Access**: proxy
 | 
				
			||||||
- **Database**: gitlab
 | 
					- **Database**: gitlab
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -333,6 +333,6 @@ If all the tests were successful, Postfix is all set up and ready to receive ema
 | 
				
			||||||
 | 
					
 | 
				
			||||||
---
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
_This document was adapted from https://help.ubuntu.com/community/PostfixBasicSetupHowto, by contributors to the Ubuntu documentation wiki._
 | 
					_This document was adapted from <https://help.ubuntu.com/community/PostfixBasicSetupHowto>, by contributors to the Ubuntu documentation wiki._
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[incoming email]: incoming_email.md
 | 
					[incoming email]: incoming_email.md
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -158,7 +158,7 @@ are concerned about affecting others during a production system, you can run a
 | 
				
			||||||
separate Rails process to debug the issue:
 | 
					separate Rails process to debug the issue:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Log in to your GitLab account.
 | 
					1. Log in to your GitLab account.
 | 
				
			||||||
1. Copy the URL that is causing problems (e.g. https://gitlab.com/ABC).
 | 
					1. Copy the URL that is causing problems (e.g. `https://gitlab.com/ABC`).
 | 
				
			||||||
1. Create a Personal Access Token for your user (Profile Settings -> Access Tokens).
 | 
					1. Create a Personal Access Token for your user (Profile Settings -> Access Tokens).
 | 
				
			||||||
1. Bring up the GitLab Rails console. For omnibus users, run:
 | 
					1. Bring up the GitLab Rails console. For omnibus users, run:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -208,7 +208,7 @@ are listed in the descriptions of the relevant settings.
 | 
				
			||||||
| `rsa_key_restriction`                    | integer          | no                                   | The minimum allowed bit length of an uploaded RSA key. Default is `0` (no restriction). `-1` disables RSA keys. |
 | 
					| `rsa_key_restriction`                    | integer          | no                                   | The minimum allowed bit length of an uploaded RSA key. Default is `0` (no restriction). `-1` disables RSA keys. |
 | 
				
			||||||
| `send_user_confirmation_email`           | boolean          | no                                   | Send confirmation email on sign-up. |
 | 
					| `send_user_confirmation_email`           | boolean          | no                                   | Send confirmation email on sign-up. |
 | 
				
			||||||
| `sentry_dsn`                             | string           | required by: `sentry_enabled`        | Sentry Data Source Name. |
 | 
					| `sentry_dsn`                             | string           | required by: `sentry_enabled`        | Sentry Data Source Name. |
 | 
				
			||||||
| `sentry_enabled`                         | boolean          | no                                   | (**If enabled, requires:** `sentry_dsn`) Sentry is an error reporting and logging tool which is currently not shipped with GitLab, available at https://getsentry.com. |
 | 
					| `sentry_enabled`                         | boolean          | no                                   | (**If enabled, requires:** `sentry_dsn`) Sentry is an error reporting and logging tool which is currently not shipped with GitLab, available at <https://sentry.io>. |
 | 
				
			||||||
| `session_expire_delay`                   | integer          | no                                   | Session duration in minutes. GitLab restart is required to apply changes |
 | 
					| `session_expire_delay`                   | integer          | no                                   | Session duration in minutes. GitLab restart is required to apply changes |
 | 
				
			||||||
| `shared_runners_enabled`                 | boolean          | no                                   | (**If enabled, requires:** `shared_runners_text`) Enable shared runners for new projects. |
 | 
					| `shared_runners_enabled`                 | boolean          | no                                   | (**If enabled, requires:** `shared_runners_text`) Enable shared runners for new projects. |
 | 
				
			||||||
| `shared_runners_text`                    | string           | required by: `shared_runners_enabled` | Shared runners text. |
 | 
					| `shared_runners_text`                    | string           | required by: `shared_runners_enabled` | Shared runners text. |
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -194,7 +194,7 @@ not without its own challenges:
 | 
				
			||||||
      - docker run -v "$MOUNT_POINT:/mnt" my-docker-image
 | 
					      - docker run -v "$MOUNT_POINT:/mnt" my-docker-image
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
An example project using this approach can be found here: https://gitlab.com/gitlab-examples/docker.
 | 
					An example project using this approach can be found here: <https://gitlab.com/gitlab-examples/docker>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Use Docker socket binding
 | 
					### Use Docker socket binding
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -16,8 +16,8 @@ to build a [Maven](https://maven.apache.org/) project, deploy it to [Artifactory
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You'll create two different projects:
 | 
					You'll create two different projects:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- `simple-maven-dep`: the app built and deployed to Artifactory (available at https://gitlab.com/gitlab-examples/maven/simple-maven-dep )
 | 
					- `simple-maven-dep`: the app built and deployed to Artifactory (available at <https://gitlab.com/gitlab-examples/maven/simple-maven-dep>)
 | 
				
			||||||
- `simple-maven-app`: the app using the previous one as a dependency (available at https://gitlab.com/gitlab-examples/maven/simple-maven-app )
 | 
					- `simple-maven-app`: the app using the previous one as a dependency (available at <https://gitlab.com/gitlab-examples/maven/simple-maven-app>)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
We assume that you already have a GitLab account on [GitLab.com](https://gitlab.com/), and that you know the basic usage of Git and [GitLab CI/CD](https://about.gitlab.com/features/gitlab-ci-cd/).
 | 
					We assume that you already have a GitLab account on [GitLab.com](https://gitlab.com/), and that you know the basic usage of Git and [GitLab CI/CD](https://about.gitlab.com/features/gitlab-ci-cd/).
 | 
				
			||||||
We also assume that an Artifactory instance is available and reachable from the internet, and that you have valid credentials to deploy on it.
 | 
					We also assume that an Artifactory instance is available and reachable from the internet, and that you have valid credentials to deploy on it.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -138,5 +138,5 @@ buildpack: client-certificate-mapper=1.2.0_RELEASE container-security-provider=1
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can then visit your deployed application (for this example,
 | 
					You can then visit your deployed application (for this example,
 | 
				
			||||||
https://gitlab-hello-world-undissembling-hotchpot.cfapps.io/) and you should
 | 
					`https://gitlab-hello-world-undissembling-hotchpot.cfapps.io/`) and you should
 | 
				
			||||||
see the "Spring is here!" message.
 | 
					see the "Spring is here!" message.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -6,7 +6,7 @@ used with GitLab CI.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
>**Note:**
 | 
					>**Note:**
 | 
				
			||||||
We recommend to use Dpl if you're deploying to any of these services:
 | 
					We recommend to use Dpl if you're deploying to any of these services:
 | 
				
			||||||
https://github.com/travis-ci/dpl#supported-providers.
 | 
					<https://github.com/travis-ci/dpl#supported-providers>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Requirements
 | 
					## Requirements
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -34,7 +34,7 @@ The Dpl provides support for vast number of services, including: Heroku, Cloud F
 | 
				
			||||||
To use it simply define provider and any additional parameters required by the provider.
 | 
					To use it simply define provider and any additional parameters required by the provider.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
For example if you want to use it to deploy your application to heroku, you need to specify `heroku` as provider, specify `api-key` and `app`.
 | 
					For example if you want to use it to deploy your application to heroku, you need to specify `heroku` as provider, specify `api-key` and `app`.
 | 
				
			||||||
There's more and all possible parameters can be found here: https://github.com/travis-ci/dpl#heroku
 | 
					There's more and all possible parameters can be found here: <https://github.com/travis-ci/dpl#heroku>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```yaml
 | 
					```yaml
 | 
				
			||||||
staging:
 | 
					staging:
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -171,4 +171,4 @@ Currently, the following tools might not work because their XML formats are unsu
 | 
				
			||||||
 | 
					
 | 
				
			||||||
|Case|Tool|Issue|
 | 
					|Case|Tool|Issue|
 | 
				
			||||||
|---|---|---|
 | 
					|---|---|---|
 | 
				
			||||||
|`<testcase>` does not have `classname` attribute|ESlint, sass-lint|https://gitlab.com/gitlab-org/gitlab-ce/issues/50964|
 | 
					|`<testcase>` does not have `classname` attribute|ESlint, sass-lint|<https://gitlab.com/gitlab-org/gitlab-ce/issues/50964>|
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -14,7 +14,7 @@ Always use an [Entity] to present the endpoint's payload.
 | 
				
			||||||
## Methods and parameters description
 | 
					## Methods and parameters description
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Every method must be described using the [Grape DSL](https://github.com/ruby-grape/grape#describing-methods)
 | 
					Every method must be described using the [Grape DSL](https://github.com/ruby-grape/grape#describing-methods)
 | 
				
			||||||
(see https://gitlab.com/gitlab-org/gitlab-ce/blob/master/lib/api/environments.rb
 | 
					(see <https://gitlab.com/gitlab-org/gitlab-ce/blob/master/lib/api/environments.rb>
 | 
				
			||||||
for a good example):
 | 
					for a good example):
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- `desc` for the method summary. You should pass it a block for additional
 | 
					- `desc` for the method summary. You should pass it a block for additional
 | 
				
			||||||
| 
						 | 
					@ -49,14 +49,14 @@ end
 | 
				
			||||||
`params` block. It filters out the params that have been passed, but are not
 | 
					`params` block. It filters out the params that have been passed, but are not
 | 
				
			||||||
allowed.
 | 
					allowed.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
– https://github.com/ruby-grape/grape#declared
 | 
					– <https://github.com/ruby-grape/grape#declared>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Exclude params from parent namespaces!
 | 
					### Exclude params from parent namespaces!
 | 
				
			||||||
 | 
					
 | 
				
			||||||
> By default `declared(params) `includes parameters that were defined in all
 | 
					> By default `declared(params) `includes parameters that were defined in all
 | 
				
			||||||
parent namespaces.
 | 
					parent namespaces.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
– https://github.com/ruby-grape/grape#include-parent-namespaces
 | 
					– <https://github.com/ruby-grape/grape#include-parent-namespaces>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
In most cases you will want to exclude params from the parent namespaces:
 | 
					In most cases you will want to exclude params from the parent namespaces:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -177,12 +177,12 @@ If you add a dependency in GitLab (such as an operating system package) please
 | 
				
			||||||
consider updating the following and note the applicability of each in your
 | 
					consider updating the following and note the applicability of each in your
 | 
				
			||||||
merge request:
 | 
					merge request:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Note the addition in the release blog post (create one if it doesn't exist yet) https://gitlab.com/gitlab-com/www-gitlab-com/merge_requests/
 | 
					1. Note the addition in the release blog post (create one if it doesn't exist yet) <https://gitlab.com/gitlab-com/www-gitlab-com/merge_requests/>
 | 
				
			||||||
1. Upgrade guide, for example https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/7.5-to-7.6.md
 | 
					1. Upgrade guide, for example <https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/7.5-to-7.6.md>
 | 
				
			||||||
1. Installation guide https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md#1-packages-dependencies
 | 
					1. Installation guide <https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md#1-packages-dependencies>
 | 
				
			||||||
1. GitLab Development Kit https://gitlab.com/gitlab-org/gitlab-development-kit
 | 
					1. GitLab Development Kit <https://gitlab.com/gitlab-org/gitlab-development-kit>
 | 
				
			||||||
1. Test suite https://gitlab.com/gitlab-org/gitlab-ce/blob/master/scripts/prepare_build.sh
 | 
					1. Test suite <https://gitlab.com/gitlab-org/gitlab-ce/blob/master/scripts/prepare_build.sh>
 | 
				
			||||||
1. Omnibus package creator https://gitlab.com/gitlab-org/omnibus-gitlab
 | 
					1. Omnibus package creator <https://gitlab.com/gitlab-org/omnibus-gitlab>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[definition-of-done]: http://guide.agilealliance.org/guide/definition-of-done.html
 | 
					[definition-of-done]: http://guide.agilealliance.org/guide/definition-of-done.html
 | 
				
			||||||
[testing]: ../testing_guide/index.md
 | 
					[testing]: ../testing_guide/index.md
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -11,7 +11,7 @@ and deploy it to <https://docs.gitlab.com>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
While the source of the documentation content is stored in GitLab's respective product
 | 
					While the source of the documentation content is stored in GitLab's respective product
 | 
				
			||||||
repositories, the source that is used to build the documentation site _from that content_
 | 
					repositories, the source that is used to build the documentation site _from that content_
 | 
				
			||||||
is located at https://gitlab.com/gitlab-com/gitlab-docs. See the README there for
 | 
					is located at <https://gitlab.com/gitlab-com/gitlab-docs>. See the README there for
 | 
				
			||||||
detailed information.
 | 
					detailed information.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Assets
 | 
					## Assets
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -6,9 +6,9 @@ To get started with Vue, read through [their documentation][vue-docs].
 | 
				
			||||||
 | 
					
 | 
				
			||||||
What is described in the following sections can be found in these examples:
 | 
					What is described in the following sections can be found in these examples:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- web ide: https://gitlab.com/gitlab-org/gitlab-ce/tree/master/app/assets/javascripts/ide/stores
 | 
					- web ide: <https://gitlab.com/gitlab-org/gitlab-ce/tree/master/app/assets/javascripts/ide/stores>
 | 
				
			||||||
- security products: https://gitlab.com/gitlab-org/gitlab-ee/tree/master/ee/app/assets/javascripts/vue_shared/security_reports
 | 
					- security products: <https://gitlab.com/gitlab-org/gitlab-ee/tree/master/ee/app/assets/javascripts/vue_shared/security_reports>
 | 
				
			||||||
- registry: https://gitlab.com/gitlab-org/gitlab-ce/tree/master/app/assets/javascripts/registry/stores
 | 
					- registry: <https://gitlab.com/gitlab-org/gitlab-ce/tree/master/app/assets/javascripts/registry/stores>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Vue architecture
 | 
					## Vue architecture
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -128,7 +128,7 @@ to manually run `make` again.
 | 
				
			||||||
Note that CI tests will not use your locally modified version of
 | 
					Note that CI tests will not use your locally modified version of
 | 
				
			||||||
Gitaly. To use a custom Gitaly version in CI you need to update
 | 
					Gitaly. To use a custom Gitaly version in CI you need to update
 | 
				
			||||||
GITALY_SERVER_VERSION. You can use the format `=revision` to use a
 | 
					GITALY_SERVER_VERSION. You can use the format `=revision` to use a
 | 
				
			||||||
non-tagged commit from https://gitlab.com/gitlab-org/gitaly in CI.
 | 
					non-tagged commit from <https://gitlab.com/gitlab-org/gitaly> in CI.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To use a different Gitaly repository, e.g., if your changes are present
 | 
					To use a different Gitaly repository, e.g., if your changes are present
 | 
				
			||||||
on a fork, you can specify a `GITALY_REPO_URL` environment variable when
 | 
					on a fork, you can specify a `GITALY_REPO_URL` environment variable when
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -350,7 +350,7 @@ You can find the credentials on 1Password, under `frontendteam@gitlab.com`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### macOS
 | 
					#### macOS
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can download any older version of Firefox from the releases FTP server, https://ftp.mozilla.org/pub/firefox/releases/
 | 
					You can download any older version of Firefox from the releases FTP server, <https://ftp.mozilla.org/pub/firefox/releases/>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. From the website, select a version, in this case `50.0.1`.
 | 
					1. From the website, select a version, in this case `50.0.1`.
 | 
				
			||||||
1. Go to the mac folder.
 | 
					1. Go to the mac folder.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -47,8 +47,7 @@ type size in descending order with variable sizes (`text`, `varchar`, arrays,
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Type Sizes
 | 
					## Type Sizes
 | 
				
			||||||
 | 
					
 | 
				
			||||||
While the PostgreSQL documentation
 | 
					While the [PostgreSQL documentation](https://www.postgresql.org/docs/current/datatype.html) contains plenty
 | 
				
			||||||
(https://www.postgresql.org/docs/current/static/datatype.html) contains plenty
 | 
					 | 
				
			||||||
of information we will list the sizes of common types here so it's easier to
 | 
					of information we will list the sizes of common types here so it's easier to
 | 
				
			||||||
look them up. Here "word" refers to the word size, which is 4 bytes for a 32
 | 
					look them up. Here "word" refers to the word size, which is 4 bytes for a 32
 | 
				
			||||||
bits platform and 8 bytes for a 64 bits platform.
 | 
					bits platform and 8 bytes for a 64 bits platform.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -121,7 +121,7 @@ failure. In CI you can download these files as job artifacts.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Also, you can manually take screenshots at any point in a test by adding the
 | 
					Also, you can manually take screenshots at any point in a test by adding the
 | 
				
			||||||
methods below. Be sure to remove them when they are no longer needed! See
 | 
					methods below. Be sure to remove them when they are no longer needed! See
 | 
				
			||||||
https://github.com/mattheworiordan/capybara-screenshot#manual-screenshots for
 | 
					<https://github.com/mattheworiordan/capybara-screenshot#manual-screenshots> for
 | 
				
			||||||
more.
 | 
					more.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Add `screenshot_and_save_page` in a `:js` spec to screenshot what Capybara
 | 
					Add `screenshot_and_save_page` in a `:js` spec to screenshot what Capybara
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -48,51 +48,51 @@ examples in a JSON report file on `master` (`retrieve-tests-metadata` and `updat
 | 
				
			||||||
is detected in any other branch (`flaky-examples-check` job). In the future, the
 | 
					is detected in any other branch (`flaky-examples-check` job). In the future, the
 | 
				
			||||||
`flaky-examples-check` job will not be allowed to fail.
 | 
					`flaky-examples-check` job will not be allowed to fail.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This was originally implemented in: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/13021.
 | 
					This was originally implemented in: <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/13021>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[rspec-retry]: https://github.com/NoRedInk/rspec-retry
 | 
					[rspec-retry]: https://github.com/NoRedInk/rspec-retry
 | 
				
			||||||
[`spec/spec_helper.rb`]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/spec/spec_helper.rb
 | 
					[`spec/spec_helper.rb`]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/spec/spec_helper.rb
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Problems we had in the past at GitLab
 | 
					## Problems we had in the past at GitLab
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- [`rspec-retry` is bitting us when some API specs fail](https://gitlab.com/gitlab-org/gitlab-ce/issues/29242): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9825
 | 
					- [`rspec-retry` is bitting us when some API specs fail](https://gitlab.com/gitlab-org/gitlab-ce/issues/29242): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9825>
 | 
				
			||||||
- [Sporadic RSpec failures due to `PG::UniqueViolation`](https://gitlab.com/gitlab-org/gitlab-ce/issues/28307#note_24958837): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9846
 | 
					- [Sporadic RSpec failures due to `PG::UniqueViolation`](https://gitlab.com/gitlab-org/gitlab-ce/issues/28307#note_24958837): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9846>
 | 
				
			||||||
  - Follow-up: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10688
 | 
					  - Follow-up: <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10688>
 | 
				
			||||||
  - [Capybara.reset_session! should be called before requests are blocked](https://gitlab.com/gitlab-org/gitlab-ce/issues/33779): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12224
 | 
					  - [Capybara.reset_session! should be called before requests are blocked](https://gitlab.com/gitlab-org/gitlab-ce/issues/33779): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12224>
 | 
				
			||||||
- FFaker generates funky data that tests are not ready to handle (and tests should be predictable so that's bad!):
 | 
					- FFaker generates funky data that tests are not ready to handle (and tests should be predictable so that's bad!):
 | 
				
			||||||
  - [Make `spec/mailers/notify_spec.rb` more robust](https://gitlab.com/gitlab-org/gitlab-ce/issues/20121): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10015
 | 
					  - [Make `spec/mailers/notify_spec.rb` more robust](https://gitlab.com/gitlab-org/gitlab-ce/issues/20121): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10015>
 | 
				
			||||||
  - [Transient failure in spec/requests/api/commits_spec.rb](https://gitlab.com/gitlab-org/gitlab-ce/issues/27988#note_25342521): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9944
 | 
					  - [Transient failure in spec/requests/api/commits_spec.rb](https://gitlab.com/gitlab-org/gitlab-ce/issues/27988#note_25342521): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9944>
 | 
				
			||||||
  - [Replace FFaker factory data with sequences](https://gitlab.com/gitlab-org/gitlab-ce/issues/29643): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10184
 | 
					  - [Replace FFaker factory data with sequences](https://gitlab.com/gitlab-org/gitlab-ce/issues/29643): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10184>
 | 
				
			||||||
  - [Transient failure in spec/finders/issues_finder_spec.rb](https://gitlab.com/gitlab-org/gitlab-ce/issues/30211#note_26707685): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10404
 | 
					  - [Transient failure in spec/finders/issues_finder_spec.rb](https://gitlab.com/gitlab-org/gitlab-ce/issues/30211#note_26707685): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10404>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Time-sensitive flaky tests
 | 
					### Time-sensitive flaky tests
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10046
 | 
					- <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10046>
 | 
				
			||||||
- https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10306
 | 
					- <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10306>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Array order expectation
 | 
					### Array order expectation
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10148
 | 
					- <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10148>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Feature tests
 | 
					### Feature tests
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- [Be sure to create all the data the test need before starting exercize](https://gitlab.com/gitlab-org/gitlab-ce/issues/32622#note_31128195): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12059
 | 
					- [Be sure to create all the data the test need before starting exercize](https://gitlab.com/gitlab-org/gitlab-ce/issues/32622#note_31128195): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12059>
 | 
				
			||||||
- [Bis](https://gitlab.com/gitlab-org/gitlab-ce/issues/34609#note_34048715): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12604
 | 
					- [Bis](https://gitlab.com/gitlab-org/gitlab-ce/issues/34609#note_34048715): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12604>
 | 
				
			||||||
- [Bis](https://gitlab.com/gitlab-org/gitlab-ce/issues/34698#note_34276286): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12664
 | 
					- [Bis](https://gitlab.com/gitlab-org/gitlab-ce/issues/34698#note_34276286): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12664>
 | 
				
			||||||
- [Assert against the underlying database state instead of against a page's content](https://gitlab.com/gitlab-org/gitlab-ce/issues/31437): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10934
 | 
					- [Assert against the underlying database state instead of against a page's content](https://gitlab.com/gitlab-org/gitlab-ce/issues/31437): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10934>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### Capybara viewport size related issues
 | 
					#### Capybara viewport size related issues
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- [Transient failure of spec/features/issues/filtered_search/filter_issues_spec.rb](https://gitlab.com/gitlab-org/gitlab-ce/issues/29241#note_26743936): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10411
 | 
					- [Transient failure of spec/features/issues/filtered_search/filter_issues_spec.rb](https://gitlab.com/gitlab-org/gitlab-ce/issues/29241#note_26743936): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10411>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### Capybara JS driver related issues
 | 
					#### Capybara JS driver related issues
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- [Don't wait for AJAX when no AJAX request is fired](https://gitlab.com/gitlab-org/gitlab-ce/issues/30461): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10454
 | 
					- [Don't wait for AJAX when no AJAX request is fired](https://gitlab.com/gitlab-org/gitlab-ce/issues/30461): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/10454>
 | 
				
			||||||
- [Bis](https://gitlab.com/gitlab-org/gitlab-ce/issues/34647): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12626
 | 
					- [Bis](https://gitlab.com/gitlab-org/gitlab-ce/issues/34647): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12626>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### PhantomJS / WebKit related issues
 | 
					#### PhantomJS / WebKit related issues
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Memory is through the roof! (TL;DR: Load images but block images requests!): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12003
 | 
					- Memory is through the roof! (TL;DR: Load images but block images requests!): <https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12003>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Resources
 | 
					## Resources
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -6,7 +6,7 @@ _This diagram demonstrates the relative priority of each test type we use. `e2e`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Unit tests
 | 
					## Unit tests
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Formal definition: https://en.wikipedia.org/wiki/Unit_testing
 | 
					Formal definition: <https://en.wikipedia.org/wiki/Unit_testing>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
These kind of tests ensure that a single unit of code (a method) works as
 | 
					These kind of tests ensure that a single unit of code (a method) works as
 | 
				
			||||||
expected (given an input, it has a predictable output). These tests should be
 | 
					expected (given an input, it has a predictable output). These tests should be
 | 
				
			||||||
| 
						 | 
					@ -32,7 +32,7 @@ records should use stubs/doubles as much as possible.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Integration tests
 | 
					## Integration tests
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Formal definition: https://en.wikipedia.org/wiki/Integration_testing
 | 
					Formal definition: <https://en.wikipedia.org/wiki/Integration_testing>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
These kind of tests ensure that individual parts of the application work well
 | 
					These kind of tests ensure that individual parts of the application work well
 | 
				
			||||||
together, without the overhead of the actual app environment (i.e. the browser).
 | 
					together, without the overhead of the actual app environment (i.e. the browser).
 | 
				
			||||||
| 
						 | 
					@ -75,8 +75,8 @@ of multiple components).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Formal definitions:
 | 
					Formal definitions:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- https://en.wikipedia.org/wiki/System_testing
 | 
					- <https://en.wikipedia.org/wiki/System_testing>
 | 
				
			||||||
- https://en.wikipedia.org/wiki/White-box_testing
 | 
					- <https://en.wikipedia.org/wiki/White-box_testing>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
These kind of tests ensure the GitLab *Rails* application (i.e.
 | 
					These kind of tests ensure the GitLab *Rails* application (i.e.
 | 
				
			||||||
`gitlab-ce`/`gitlab-ee`) works as expected from a *browser* point of view.
 | 
					`gitlab-ce`/`gitlab-ee`) works as expected from a *browser* point of view.
 | 
				
			||||||
| 
						 | 
					@ -135,8 +135,8 @@ The reasons why we should follow these best practices are as follows:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Formal definitions:
 | 
					Formal definitions:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- https://en.wikipedia.org/wiki/System_testing
 | 
					- <https://en.wikipedia.org/wiki/System_testing>
 | 
				
			||||||
- https://en.wikipedia.org/wiki/Black-box_testing
 | 
					- <https://en.wikipedia.org/wiki/Black-box_testing>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
GitLab consists of [multiple pieces] such as [GitLab Shell], [GitLab Workhorse],
 | 
					GitLab consists of [multiple pieces] such as [GitLab Shell], [GitLab Workhorse],
 | 
				
			||||||
[Gitaly], [GitLab Pages], [GitLab Runner], and GitLab Rails. All theses pieces
 | 
					[Gitaly], [GitLab Pages], [GitLab Runner], and GitLab Rails. All theses pieces
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -60,7 +60,7 @@ Here's a list of the AWS services we will use, with links to pricing information
 | 
				
			||||||
To minimize the permissions of the user, we'll create a new [IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html)
 | 
					To minimize the permissions of the user, we'll create a new [IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html)
 | 
				
			||||||
role with limited access:
 | 
					role with limited access:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Navigate to the IAM dashboard https://console.aws.amazon.com/iam/home and
 | 
					1. Navigate to the IAM dashboard <https://console.aws.amazon.com/iam/home> and
 | 
				
			||||||
   click **Create role**.
 | 
					   click **Create role**.
 | 
				
			||||||
1. Create a new role by selecting **AWS service > EC2**, then click
 | 
					1. Create a new role by selecting **AWS service > EC2**, then click
 | 
				
			||||||
   **Next: Permissions**.
 | 
					   **Next: Permissions**.
 | 
				
			||||||
| 
						 | 
					@ -78,7 +78,7 @@ Internet Gateway.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
We'll now create a VPC, a virtual networking environment that you'll control:
 | 
					We'll now create a VPC, a virtual networking environment that you'll control:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Navigate to https://console.aws.amazon.com/vpc/home.
 | 
					1. Navigate to <https://console.aws.amazon.com/vpc/home>.
 | 
				
			||||||
1. Select **Your VPCs** from the left menu and then click **Create VPC**.
 | 
					1. Select **Your VPCs** from the left menu and then click **Create VPC**.
 | 
				
			||||||
   At the "Name tag" enter `gitlab-vpc` and at the "IPv4 CIDR block" enter
 | 
					   At the "Name tag" enter `gitlab-vpc` and at the "IPv4 CIDR block" enter
 | 
				
			||||||
   `10.0.0.0/16`. If you don't require dedicated hardware, you can leave
 | 
					   `10.0.0.0/16`. If you don't require dedicated hardware, you can leave
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -22,7 +22,7 @@ Once you have performed those two steps, you can [create a VM](#creating-the-vm)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To deploy GitLab on GCP you need to follow five simple steps:
 | 
					To deploy GitLab on GCP you need to follow five simple steps:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Go to https://console.cloud.google.com/compute/instances and login with your Google credentials.
 | 
					1. Go to <https://console.cloud.google.com/compute/instances> and login with your Google credentials.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Click on **Create**
 | 
					1. Click on **Create**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -51,7 +51,7 @@ After a few seconds, the instance will be created and available to log in. The n
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Next, follow the instructions for installing GitLab for the operating system you choose, at https://about.gitlab.com/installation/. You can use the IP address from the step above, as the hostname.
 | 
					1. Next, follow the instructions for installing GitLab for the operating system you choose, at <https://about.gitlab.com/installation/>. You can use the IP address from the step above, as the hostname.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Congratulations! GitLab is now installed and you can access it via your browser. To finish installation, open the URL in your browser and provide the initial administrator password. The username for this account is `root`.
 | 
					1. Congratulations! GitLab is now installed and you can access it via your browser. To finish installation, open the URL in your browser and provide the initial administrator password. The username for this account is `root`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -7,7 +7,7 @@ instead. A comparison of the two charts is available in [this video](https://you
 | 
				
			||||||
For more information on available GitLab Helm Charts, see the [charts overview](index.md#chart-overview).
 | 
					For more information on available GitLab Helm Charts, see the [charts overview](index.md#chart-overview).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- This GitLab-Omnibus chart has been tested on Google Kubernetes Engine and Azure Container Service.
 | 
					- This GitLab-Omnibus chart has been tested on Google Kubernetes Engine and Azure Container Service.
 | 
				
			||||||
- This work is based partially on: https://github.com/lwolf/kubernetes-gitlab/. GitLab would like to thank Sergey Nuzhdin for his work.
 | 
					- This work is based partially on: <https://github.com/lwolf/kubernetes-gitlab/>. GitLab would like to thank Sergey Nuzhdin for his work.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Introduction
 | 
					## Introduction
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -18,7 +18,7 @@ from happening.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To use Akismet:
 | 
					To use Akismet:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Go to the URL: https://akismet.com/account/
 | 
					1. Go to the URL: <https://akismet.com/account/>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Sign-in or create a new account.
 | 
					1. Sign-in or create a new account.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -21,12 +21,12 @@ configuration file. For example:
 | 
				
			||||||
    - Client Secret: `KbveM3nqfjwCbrhaUy_gDu2dss8TIlHIdzlyf33pB7dEK5u_NyQdp65O_o02hXs2`
 | 
					    - Client Secret: `KbveM3nqfjwCbrhaUy_gDu2dss8TIlHIdzlyf33pB7dEK5u_NyQdp65O_o02hXs2`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Fill in the Allowed Callback URLs:
 | 
					1. Fill in the Allowed Callback URLs:
 | 
				
			||||||
    - http://`YOUR_GITLAB_URL`/users/auth/auth0/callback (or)
 | 
					    - `http://YOUR_GITLAB_URL/users/auth/auth0/callback` (or)
 | 
				
			||||||
    - https://`YOUR_GITLAB_URL`/users/auth/auth0/callback
 | 
					    - `https://YOUR_GITLAB_URL/users/auth/auth0/callback`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Fill in the Allowed Origins (CORS):
 | 
					1. Fill in the Allowed Origins (CORS):
 | 
				
			||||||
    - http://`YOUR_GITLAB_URL` (or)
 | 
					    - `http://YOUR_GITLAB_URL` (or)
 | 
				
			||||||
    - https://`YOUR_GITLAB_URL`
 | 
					    - `https://YOUR_GITLAB_URL`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. On your GitLab server, open the configuration file.
 | 
					1. On your GitLab server, open the configuration file.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -15,12 +15,12 @@ To enable the Microsoft Azure OAuth2 OmniAuth provider you must register your ap
 | 
				
			||||||
    - Type: 'WEB APPLICATION AND/OR WEB API'
 | 
					    - Type: 'WEB APPLICATION AND/OR WEB API'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1.  On the "App properties" page enter the needed URI's and click the "Complete" button.
 | 
					1.  On the "App properties" page enter the needed URI's and click the "Complete" button.
 | 
				
			||||||
    - SIGN-IN URL: Enter the URL of your GitLab installation (e.g 'https://gitlab.mycompany.com/')
 | 
					    - SIGN-IN URL: Enter the URL of your GitLab installation (e.g `https://gitlab.mycompany.com/`)
 | 
				
			||||||
    - APP ID URI: Enter the endpoint URL for Microsoft to use, just has to be unique (e.g 'https://mycompany.onmicrosoft.com/gitlab')
 | 
					    - APP ID URI: Enter the endpoint URL for Microsoft to use, just has to be unique (e.g `https://mycompany.onmicrosoft.com/gitlab`)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Select "Configure" in the top menu.
 | 
					1. Select "Configure" in the top menu.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Add a "Reply URL" pointing to the Azure OAuth callback of your GitLab installation (e.g. https://gitlab.mycompany.com/users/auth/azure_oauth2/callback).
 | 
					1. Add a "Reply URL" pointing to the Azure OAuth callback of your GitLab installation (e.g. `https://gitlab.mycompany.com/users/auth/azure_oauth2/callback`).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Create a "Client secret" by selecting a duration, the secret will be generated as soon as you click the "Save" button in the bottom menu..
 | 
					1. Create a "Client secret" by selecting a duration, the secret will be generated as soon as you click the "Save" button in the bottom menu..
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -28,7 +28,7 @@ To enable the Microsoft Azure OAuth2 OmniAuth provider you must register your ap
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Select "View endpoints" from the bottom menu.
 | 
					1. Select "View endpoints" from the bottom menu.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. You will see lots of endpoint URLs in the form 'https://login.microsoftonline.com/TENANT ID/...', note down the TENANT ID part of one of those endpoints.
 | 
					1. You will see lots of endpoint URLs in the form `https://login.microsoftonline.com/TENANT ID/...`, note down the TENANT ID part of one of those endpoints.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1.  On your GitLab server, open the configuration file.
 | 
					1.  On your GitLab server, open the configuration file.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -287,7 +287,7 @@ so you will not be able to sign in using local credentials. Make sure that at le
 | 
				
			||||||
of the SAML users has admin permissions.
 | 
					of the SAML users has admin permissions.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You may also bypass the auto signin feature by browsing to
 | 
					You may also bypass the auto signin feature by browsing to
 | 
				
			||||||
https://gitlab.example.com/users/sign_in?auto_sign_in=false.
 | 
					`https://gitlab.example.com/users/sign_in?auto_sign_in=false`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### `attribute_statements`
 | 
					### `attribute_statements`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -10,8 +10,8 @@ To enable the Twitter OmniAuth provider you must register your application with
 | 
				
			||||||
    - Name: This can be anything. Consider something like `<Organization>'s GitLab` or `<Your Name>'s GitLab` or
 | 
					    - Name: This can be anything. Consider something like `<Organization>'s GitLab` or `<Your Name>'s GitLab` or
 | 
				
			||||||
    something else descriptive.
 | 
					    something else descriptive.
 | 
				
			||||||
    - Description: Create a description.
 | 
					    - Description: Create a description.
 | 
				
			||||||
    - Website: The URL to your GitLab installation. 'https://gitlab.example.com'
 | 
					    - Website: The URL to your GitLab installation. `https://gitlab.example.com`
 | 
				
			||||||
    - Callback URL: 'https://gitlab.example.com/users/auth/twitter/callback'
 | 
					    - Callback URL: `https://gitlab.example.com/users/auth/twitter/callback`
 | 
				
			||||||
    - Agree to the "Developer Agreement".
 | 
					    - Agree to the "Developer Agreement".
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -71,7 +71,7 @@ sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production SKIP=r
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
If this fails you need to fix it before upgrading to 8.0. Also see
 | 
					If this fails you need to fix it before upgrading to 8.0. Also see
 | 
				
			||||||
https://about.gitlab.com/getting-help/
 | 
					<https://about.gitlab.com/get-help/>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### 2. Check source and target database types
 | 
					### 2. Check source and target database types
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -118,7 +118,7 @@ From this point on, GitLab CI will be unavailable for your end users.
 | 
				
			||||||
### 1. Upgrade GitLab to 8.0
 | 
					### 1. Upgrade GitLab to 8.0
 | 
				
			||||||
 | 
					
 | 
				
			||||||
First upgrade your GitLab server to version 8.0:
 | 
					First upgrade your GitLab server to version 8.0:
 | 
				
			||||||
https://about.gitlab.com/update/
 | 
					<https://about.gitlab.com/update/>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### 2. Disable CI on the GitLab server during the migration
 | 
					### 2. Disable CI on the GitLab server during the migration
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -378,7 +378,7 @@ with the name of your bucket:
 | 
				
			||||||
If you want to use Google Cloud Storage to save backups, you'll have to create
 | 
					If you want to use Google Cloud Storage to save backups, you'll have to create
 | 
				
			||||||
an access key from the Google console first:
 | 
					an access key from the Google console first:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Go to the storage settings page https://console.cloud.google.com/storage/settings
 | 
					1. Go to the storage settings page <https://console.cloud.google.com/storage/settings>
 | 
				
			||||||
1. Select "Interoperability" and create an access key
 | 
					1. Select "Interoperability" and create an access key
 | 
				
			||||||
1. Make note of the "Access Key" and "Secret" and replace them in the
 | 
					1. Make note of the "Access Key" and "Secret" and replace them in the
 | 
				
			||||||
   configurations below
 | 
					   configurations below
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -6,9 +6,9 @@ With [Webhooks](../user/project/integrations/webhooks.md), you and your project
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Things get hairy, however, when a Webhook is set up with a URL that doesn't point to an external, but to an internal service, that may do something completely unintended when the webhook is triggered and the POST request is sent.
 | 
					Things get hairy, however, when a Webhook is set up with a URL that doesn't point to an external, but to an internal service, that may do something completely unintended when the webhook is triggered and the POST request is sent.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Because Webhook requests are made by the GitLab server itself, these have complete access to everything running on the server (http://localhost:123) or within the server's local network (http://192.168.1.12:345), even if these services are otherwise protected and inaccessible from the outside world.
 | 
					Because Webhook requests are made by the GitLab server itself, these have complete access to everything running on the server (`http://localhost:123`) or within the server's local network (`http://192.168.1.12:345`), even if these services are otherwise protected and inaccessible from the outside world.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
If a web service does not require authentication, Webhooks can be used to trigger destructive commands by getting the GitLab server to make POST requests to endpoints like "http://localhost:123/some-resource/delete".
 | 
					If a web service does not require authentication, Webhooks can be used to trigger destructive commands by getting the GitLab server to make POST requests to endpoints like `http://localhost:123/some-resource/delete`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To prevent this type of exploitation from happening, starting with GitLab 10.6, all Webhook requests to the current GitLab instance server address and/or in a private network will be forbidden by default. That means that all requests made to 127.0.0.1, ::1 and 0.0.0.0, as well as IPv4 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 and IPv6 site-local (ffc0::/10) addresses won't be allowed.
 | 
					To prevent this type of exploitation from happening, starting with GitLab 10.6, all Webhook requests to the current GitLab instance server address and/or in a private network will be forbidden by default. That means that all requests made to 127.0.0.1, ::1 and 0.0.0.0, as well as IPv4 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 and IPv6 site-local (ffc0::/10) addresses won't be allowed.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -318,7 +318,7 @@ not implicitly give any access just by setting them up.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Eclipse
 | 
					### Eclipse
 | 
				
			||||||
 | 
					
 | 
				
			||||||
How to add your SSH key to Eclipse: https://wiki.eclipse.org/EGit/User_Guide#Eclipse_SSH_Configuration
 | 
					How to add your SSH key to Eclipse: <https://wiki.eclipse.org/EGit/User_Guide#Eclipse_SSH_Configuration>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## SSH on the GitLab server
 | 
					## SSH on the GitLab server
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -272,7 +272,7 @@ If the user is blocked via LDAP, `state` will be `ldap_blocked`.
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
`owner_name` and `owner_email` are always `null`. Please see https://gitlab.com/gitlab-org/gitlab-ce/issues/39675.
 | 
					`owner_name` and `owner_email` are always `null`. Please see <https://gitlab.com/gitlab-org/gitlab-ce/issues/39675>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
**Group removed:**
 | 
					**Group removed:**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -289,7 +289,7 @@ If the user is blocked via LDAP, `state` will be `ldap_blocked`.
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
`owner_name` and `owner_email` are always `null`. Please see https://gitlab.com/gitlab-org/gitlab-ce/issues/39675.
 | 
					`owner_name` and `owner_email` are always `null`. Please see <https://gitlab.com/gitlab-org/gitlab-ce/issues/39675>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
**Group renamed:**
 | 
					**Group renamed:**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -309,7 +309,7 @@ If the user is blocked via LDAP, `state` will be `ldap_blocked`.
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
`owner_name` and `owner_email` are always `null`. Please see https://gitlab.com/gitlab-org/gitlab-ce/issues/39675.
 | 
					`owner_name` and `owner_email` are always `null`. Please see <https://gitlab.com/gitlab-org/gitlab-ce/issues/39675>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
**New Group Member:**
 | 
					**New Group Member:**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -423,7 +423,7 @@ A set of symbols that are used to organize objects of various kinds so that thes
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Nginx
 | 
					### Nginx
 | 
				
			||||||
 | 
					
 | 
				
			||||||
A web [server](https://www.nginx.com/resources/wiki/) (pronounced "engine x"). [It can act]((https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/settings/nginx.md) as a reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer and an HTTP cache.
 | 
					A web [server](https://www.nginx.com/resources/wiki/) (pronounced "engine x"). [It can act](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/settings/nginx.md) as a reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer and an HTTP cache.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### OAuth
 | 
					### OAuth
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -50,7 +50,7 @@ project.
 | 
				
			||||||
- Use the tools at your disposal when you get stuck.
 | 
					- Use the tools at your disposal when you get stuck.
 | 
				
			||||||
  - Use `git help <command>` command
 | 
					  - Use `git help <command>` command
 | 
				
			||||||
  - Use Google (i.e. StackOverflow, Google groups)
 | 
					  - Use Google (i.e. StackOverflow, Google groups)
 | 
				
			||||||
  - Read documentation at https://git-scm.com
 | 
					  - Read documentation at <https://git-scm.com>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
---
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -62,7 +62,7 @@ Workshop Time!
 | 
				
			||||||
### Setup
 | 
					### Setup
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Windows: Install 'Git for Windows'
 | 
					- Windows: Install 'Git for Windows'
 | 
				
			||||||
  - https://git-for-windows.github.io
 | 
					  - <https://git-for-windows.github.io>
 | 
				
			||||||
- Mac: Type `git` in the Terminal application.
 | 
					- Mac: Type `git` in the Terminal application.
 | 
				
			||||||
  - If it's not installed, it will prompt you to install it.
 | 
					  - If it's not installed, it will prompt you to install it.
 | 
				
			||||||
- Linux
 | 
					- Linux
 | 
				
			||||||
| 
						 | 
					@ -142,7 +142,7 @@ cd ~/workspace
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Sign in into your gitlab.com account
 | 
					- Sign in into your gitlab.com account
 | 
				
			||||||
- Create a project
 | 
					- Create a project
 | 
				
			||||||
- Choose to import from 'Any Repo by URL' and use https://gitlab.com/gitlab-org/training-examples.git
 | 
					- Choose to import from 'Any Repo by URL' and use <https://gitlab.com/gitlab-org/training-examples.git>
 | 
				
			||||||
- On your machine clone the `training-examples` project
 | 
					- On your machine clone the `training-examples` project
 | 
				
			||||||
 | 
					
 | 
				
			||||||
---
 | 
					---
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -8,7 +8,7 @@ comments: false
 | 
				
			||||||
## Install
 | 
					## Install
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- **Windows**
 | 
					- **Windows**
 | 
				
			||||||
  - Install 'Git for Windows' from https://git-for-windows.github.io
 | 
					  - Install 'Git for Windows' from <https://git-for-windows.github.io>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- **Mac**
 | 
					- **Mac**
 | 
				
			||||||
  - Type '`git`' in the Terminal application.
 | 
					  - Type '`git`' in the Terminal application.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -8,7 +8,7 @@ comments: false
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Intro
 | 
					## Intro
 | 
				
			||||||
 | 
					
 | 
				
			||||||
https://git-scm.com/about
 | 
					<https://git-scm.com/about>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Distributed version control
 | 
					- Distributed version control
 | 
				
			||||||
  - Does not rely on connection to a central server
 | 
					  - Does not rely on connection to a central server
 | 
				
			||||||
| 
						 | 
					@ -25,4 +25,4 @@ Use the tools at your disposal when you get stuck.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Use '`git help <command>`' command
 | 
					- Use '`git help <command>`' command
 | 
				
			||||||
- Use Google
 | 
					- Use Google
 | 
				
			||||||
- Read documentation at https://git-scm.com
 | 
					- Read documentation at <https://git-scm.com>
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -218,7 +218,7 @@ log_bin_trust_function_creators=1
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Note: we have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
					Note: we have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/11-5-stable/config/unicorn.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/11-5-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
    - In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
					    - In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```ruby
 | 
					```ruby
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -218,7 +218,7 @@ log_bin_trust_function_creators=1
 | 
				
			||||||
 | 
					
 | 
				
			||||||
We have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
					We have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/11-6-stable/config/unicorn.rb.example but with your settings.
 | 
					Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/11-6-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
					In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```ruby
 | 
					```ruby
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -218,7 +218,7 @@ log_bin_trust_function_creators=1
 | 
				
			||||||
 | 
					
 | 
				
			||||||
We have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
					We have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/11-7-stable/config/unicorn.rb.example but with your settings.
 | 
					Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/11-7-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
					In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```ruby
 | 
					```ruby
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -221,7 +221,7 @@ log_bin_trust_function_creators=1
 | 
				
			||||||
 | 
					
 | 
				
			||||||
We have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
					We have made [changes](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22372) to `unicorn.rb` to allow GitLab run with both Unicorn and Puma in future.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/11-8-stable/config/unicorn.rb.example but with your settings.
 | 
					Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/11-8-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
					In particular, make sure that `require_relative "/home/git/gitlab/lib/gitlab/cluster/lifecycle_events"` line exists and the `before_exec`, `before_fork`, and `after_fork` handlers are configured as shown below:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```ruby
 | 
					```ruby
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -73,8 +73,8 @@ sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 5. Update config files
 | 
					## 5. Update config files
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-2-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-2-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/puma.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-2-stable/config/puma.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/puma.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-2-stable/config/puma.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 6. Update Init script
 | 
					## 6. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -70,8 +70,8 @@ sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 5. Update config files
 | 
					## 5. Update config files
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/puma.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/puma.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/puma.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/puma.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 6. Update Init script
 | 
					## 6. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -185,8 +185,8 @@ sudo -u git -H git config --global core.autocrlf input
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Note: We switched from Puma in GitLab 5.x to unicorn in GitLab 6.0.
 | 
					Note: We switched from Puma in GitLab 5.x to unicorn in GitLab 6.0.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-0-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-0-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-0-stable/config/unicorn.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-0-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 7. Update Init script
 | 
					## 7. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -64,8 +64,8 @@ sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 4. Update config files
 | 
					## 4. Update config files
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-3-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-3-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/puma.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-3-stable/config/puma.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/puma.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-3-stable/config/puma.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 5. Update Init script
 | 
					## 5. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -68,8 +68,8 @@ sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 5. Update config files
 | 
					## 5. Update config files
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/puma.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/puma.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/puma.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/puma.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 6. Update Init script
 | 
					## 6. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -118,8 +118,8 @@ sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Note: We switched from Puma in GitLab 5.4 to unicorn in GitLab 6.0.
 | 
					Note: We switched from Puma in GitLab 5.4 to unicorn in GitLab 6.0.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/unicorn.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 7. Update Init script
 | 
					## 7. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -85,8 +85,8 @@ sudo -u git -H bundle exec rake cache:clear RAILS_ENV=production
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 5. Update config files
 | 
					## 5. Update config files
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-1-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-1-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/unicorn.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-1-stable/config/unicorn.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/unicorn.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-1-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## 6. Update Init script
 | 
					## 6. Update Init script
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -85,9 +85,9 @@ TIP: to see what changed in `gitlab.yml.example` in this release use next comman
 | 
				
			||||||
git diff 6-1-stable:config/gitlab.yml.example 6-2-stable:config/gitlab.yml.example
 | 
					git diff 6-1-stable:config/gitlab.yml.example 6-2-stable:config/gitlab.yml.example
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
-   Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-2-stable/config/gitlab.yml.example but with your settings.
 | 
					-   Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-2-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
-   Make `/home/git/gitlab/config/unicorn.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-2-stable/config/unicorn.rb.example but with your settings.
 | 
					-   Make `/home/git/gitlab/config/unicorn.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-2-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
-   Copy rack attack middleware config:
 | 
					-   Copy rack attack middleware config:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -81,8 +81,8 @@ TIP: to see what changed in gitlab.yml.example in this release use next command:
 | 
				
			||||||
git diff 6-2-stable:config/gitlab.yml.example 6-3-stable:config/gitlab.yml.example
 | 
					git diff 6-2-stable:config/gitlab.yml.example 6-3-stable:config/gitlab.yml.example
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-3-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-3-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/unicorn.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/6-3-stable/config/unicorn.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/unicorn.rb` same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/6-3-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```bash
 | 
					```bash
 | 
				
			||||||
# Copy rack attack middleware config
 | 
					# Copy rack attack middleware config
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -110,8 +110,8 @@ There are new configuration options available for gitlab.yml. View them with the
 | 
				
			||||||
git diff origin/6-9-stable:config/gitlab.yml.example origin/7-0-stable:config/gitlab.yml.example
 | 
					git diff origin/6-9-stable:config/gitlab.yml.example origin/7-0-stable:config/gitlab.yml.example
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- HTTP setups: Make `/etc/nginx/sites-available/nginx` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab but with your settings.
 | 
					- HTTP setups: Make `/etc/nginx/sites-available/nginx` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab> but with your settings.
 | 
				
			||||||
- HTTPS setups: Make `/etc/nginx/sites-available/nginx-ssl` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab-ssl but with your setting.
 | 
					- HTTPS setups: Make `/etc/nginx/sites-available/nginx-ssl` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab-ssl> but with your setting.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### 7. Start application
 | 
					### 7. Start application
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -178,9 +178,9 @@ TIP: to see what changed in `gitlab.yml.example` in this release use next comman
 | 
				
			||||||
git diff 6-0-stable:config/gitlab.yml.example 7-14-stable:config/gitlab.yml.example
 | 
					git diff 6-0-stable:config/gitlab.yml.example 7-14-stable:config/gitlab.yml.example
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Make `/home/git/gitlab/config/gitlab.yml` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/config/gitlab.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/gitlab.yml` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/config/gitlab.yml.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab/config/unicorn.rb` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/config/unicorn.rb.example but with your settings.
 | 
					- Make `/home/git/gitlab/config/unicorn.rb` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/config/unicorn.rb.example> but with your settings.
 | 
				
			||||||
- Make `/home/git/gitlab-shell/config.yml` the same as https://gitlab.com/gitlab-org/gitlab-shell/blob/v2.6.5/config.yml.example but with your settings.
 | 
					- Make `/home/git/gitlab-shell/config.yml` the same as <https://gitlab.com/gitlab-org/gitlab-shell/blob/v2.6.5/config.yml.example> but with your settings.
 | 
				
			||||||
- Copy rack attack middleware config.
 | 
					- Copy rack attack middleware config.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```bash
 | 
					```bash
 | 
				
			||||||
| 
						 | 
					@ -195,8 +195,8 @@ sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Change Nginx settings
 | 
					### Change Nginx settings
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- HTTP setups: Make `/etc/nginx/sites-available/gitlab` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/lib/support/nginx/gitlab but with your settings.
 | 
					- HTTP setups: Make `/etc/nginx/sites-available/gitlab` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/lib/support/nginx/gitlab> but with your settings.
 | 
				
			||||||
- HTTPS setups: Make `/etc/nginx/sites-available/gitlab-ssl` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/lib/support/nginx/gitlab-ssl but with your settings.
 | 
					- HTTPS setups: Make `/etc/nginx/sites-available/gitlab-ssl` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-14-stable/lib/support/nginx/gitlab-ssl> but with your settings.
 | 
				
			||||||
- A new `location /uploads/` section has been added that needs to have the same content as the existing `location @gitlab` section.
 | 
					- A new `location /uploads/` section has been added that needs to have the same content as the existing `location @gitlab` section.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Check the version of /usr/local/bin/git
 | 
					### Check the version of /usr/local/bin/git
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -94,8 +94,8 @@ There are new configuration options available for `gitlab.yml`. View them with t
 | 
				
			||||||
git diff 7-1-stable:config/gitlab.yml.example 7-2-stable:config/gitlab.yml.example
 | 
					git diff 7-1-stable:config/gitlab.yml.example 7-2-stable:config/gitlab.yml.example
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- HTTP setups: Make `/etc/nginx/sites-available/nginx` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab but with your settings.
 | 
					- HTTP setups: Make `/etc/nginx/sites-available/nginx` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab> but with your settings.
 | 
				
			||||||
- HTTPS setups: Make `/etc/nginx/sites-available/nginx-ssl` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab-ssl but with your setting.
 | 
					- HTTPS setups: Make `/etc/nginx/sites-available/nginx-ssl` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-0-stable/lib/support/nginx/gitlab-ssl> but with your setting.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Update rack attack middleware config
 | 
					Update rack attack middleware config
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -108,8 +108,8 @@ git diff origin/7-2-stable:config/gitlab.yml.example origin/7-3-stable:config/gi
 | 
				
			||||||
sudo -u git -H sed -i 's/:backlog => 64/:backlog => 1024/' config/unicorn.rb
 | 
					sudo -u git -H sed -i 's/:backlog => 64/:backlog => 1024/' config/unicorn.rb
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- HTTP setups: Make `/etc/nginx/sites-available/nginx` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-3-stable/lib/support/nginx/gitlab but with your settings.
 | 
					- HTTP setups: Make `/etc/nginx/sites-available/nginx` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-3-stable/lib/support/nginx/gitlab> but with your settings.
 | 
				
			||||||
- HTTPS setups: Make `/etc/nginx/sites-available/nginx-ssl` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-3-stable/lib/support/nginx/gitlab-ssl but with your setting.
 | 
					- HTTPS setups: Make `/etc/nginx/sites-available/nginx-ssl` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-3-stable/lib/support/nginx/gitlab-ssl> but with your setting.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### 7. Start application
 | 
					### 7. Start application
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -75,7 +75,7 @@ sudo -u git -H editor config/unicorn.rb
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### Change Nginx HTTPS settings
 | 
					#### Change Nginx HTTPS settings
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- HTTPS setups: Make `/etc/nginx/sites-available/gitlab-ssl` the same as https://gitlab.com/gitlab-org/gitlab-ce/blob/7-4-stable/lib/support/nginx/gitlab-ssl but with your setting.
 | 
					- HTTPS setups: Make `/etc/nginx/sites-available/gitlab-ssl` the same as <https://gitlab.com/gitlab-org/gitlab-ce/blob/7-4-stable/lib/support/nginx/gitlab-ssl> but with your setting.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#### MySQL Databases: Update database.yml config file
 | 
					#### MySQL Databases: Update database.yml config file
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -57,7 +57,7 @@ server.
 | 
				
			||||||
## Installing Slony
 | 
					## Installing Slony
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Slony will be used to upgrade the database without requiring long downtimes.
 | 
					Slony will be used to upgrade the database without requiring long downtimes.
 | 
				
			||||||
Slony can be downloaded from http://www.slony.info/. If you have installed
 | 
					Slony can be downloaded from <http://www.slony.info/>. If you have installed
 | 
				
			||||||
PostgreSQL using your operating system's package manager you may also be able to
 | 
					PostgreSQL using your operating system's package manager you may also be able to
 | 
				
			||||||
install Slony using said package manager.
 | 
					install Slony using said package manager.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -73,7 +73,7 @@ which also covers the case where you have projects hosted with
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Private profile
 | 
					## Private profile
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The following information will be hidden from the user profile page (https://gitlab.example.com/username) if this feature is enabled:
 | 
					The following information will be hidden from the user profile page (`https://gitlab.example.com/username`) if this feature is enabled:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- Atom feed
 | 
					- Atom feed
 | 
				
			||||||
- Date when account is created
 | 
					- Date when account is created
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -15,7 +15,7 @@
 | 
				
			||||||
With the Docker Container Registry integrated into GitLab, every project can
 | 
					With the Docker Container Registry integrated into GitLab, every project can
 | 
				
			||||||
have its own space to store its Docker images.
 | 
					have its own space to store its Docker images.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can read more about Docker Registry at https://docs.docker.com/registry/introduction/.
 | 
					You can read more about Docker Registry at <https://docs.docker.com/registry/introduction/>.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Enable the Container Registry for your project
 | 
					## Enable the Container Registry for your project
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -92,7 +92,7 @@ integration enabled, that should be the preferred method to import your reposito
 | 
				
			||||||
 | 
					
 | 
				
			||||||
If you are not using the GitHub integration, you can still perform an authorization with GitHub to grant GitLab access your repositories:
 | 
					If you are not using the GitHub integration, you can still perform an authorization with GitHub to grant GitLab access your repositories:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Go to https://github.com/settings/tokens/new
 | 
					1. Go to <https://github.com/settings/tokens/new>
 | 
				
			||||||
1. Enter a token description.
 | 
					1. Enter a token description.
 | 
				
			||||||
1. Select the repo scope.
 | 
					1. Select the repo scope.
 | 
				
			||||||
1. Click **Generate token**.
 | 
					1. Click **Generate token**.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -40,7 +40,7 @@ service in GitLab.
 | 
				
			||||||
1. Navigate to the [Integrations page](project_services.md#accessing-the-project-services)
 | 
					1. Navigate to the [Integrations page](project_services.md#accessing-the-project-services)
 | 
				
			||||||
1. Click 'Atlassian Bamboo CI'
 | 
					1. Click 'Atlassian Bamboo CI'
 | 
				
			||||||
1. Select the 'Active' checkbox.
 | 
					1. Select the 'Active' checkbox.
 | 
				
			||||||
1. Enter the base URL of your Bamboo server. 'https://bamboo.example.com'
 | 
					1. Enter the base URL of your Bamboo server. `https://bamboo.example.com`
 | 
				
			||||||
1. Enter the build key from your Bamboo build plan. Build keys are typically made
 | 
					1. Enter the build key from your Bamboo build plan. Build keys are typically made
 | 
				
			||||||
   up from the Project Key and Plan Key that are set on project/plan creation and
 | 
					   up from the Project Key and Plan Key that are set on project/plan creation and
 | 
				
			||||||
   separated with a dash (`-`), for example  **PROJ-PLAN**. This is a short, all
 | 
					   separated with a dash (`-`), for example  **PROJ-PLAN**. This is a short, all
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -18,7 +18,7 @@ allow GitLab to send messages only to *one* room.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Complete these steps in HipChat
 | 
					### Complete these steps in HipChat
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Go to: https://admin.hipchat.com/admin
 | 
					1. Go to: <https://admin.hipchat.com/admin>
 | 
				
			||||||
1. Click on "Group Admin" -> "Integrations".
 | 
					1. Click on "Group Admin" -> "Integrations".
 | 
				
			||||||
1. Find "Build Your Own!" and click "Create".
 | 
					1. Find "Build Your Own!" and click "Create".
 | 
				
			||||||
1. Select the desired room, name the integration "GitLab", and click "Create".
 | 
					1. Select the desired room, name the integration "GitLab", and click "Create".
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -4,12 +4,12 @@ GitLab provides a way to push update messages to an Irker server. When
 | 
				
			||||||
configured, pushes to a project will trigger the service to send data directly
 | 
					configured, pushes to a project will trigger the service to send data directly
 | 
				
			||||||
to the Irker server.
 | 
					to the Irker server.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
See the project homepage for further info: https://gitlab.com/esr/irker
 | 
					See the project homepage for further info: <https://gitlab.com/esr/irker>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Needed setup
 | 
					## Needed setup
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You will first need an Irker daemon. You can download the Irker code from its
 | 
					You will first need an Irker daemon. You can download the Irker code from its
 | 
				
			||||||
repository on https://gitlab.com/esr/irker:
 | 
					repository on <https://gitlab.com/esr/irker>:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
git clone https://gitlab.com/esr/irker.git
 | 
					git clone https://gitlab.com/esr/irker.git
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -3,7 +3,7 @@
 | 
				
			||||||
An API token is needed when integrating with JIRA Cloud, follow the steps
 | 
					An API token is needed when integrating with JIRA Cloud, follow the steps
 | 
				
			||||||
below to create one:
 | 
					below to create one:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Log in to https://id.atlassian.com with your email.
 | 
					1. Log in to <https://id.atlassian.com> with your email.
 | 
				
			||||||
1. **Click API tokens**, then **Create API token**.
 | 
					1. **Click API tokens**, then **Create API token**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||

 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -10,7 +10,7 @@ To enable Mattermost integration you must create an incoming webhook integration
 | 
				
			||||||
1. Save it, copy the **Webhook URL**, we'll need this later for GitLab.
 | 
					1. Save it, copy the **Webhook URL**, we'll need this later for GitLab.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
There might be some cases that Incoming Webhooks are blocked by admin, ask your mattermost admin to enable
 | 
					There might be some cases that Incoming Webhooks are blocked by admin, ask your mattermost admin to enable
 | 
				
			||||||
it on https://mattermost.example/admin_console/integrations/custom.
 | 
					it on `https://mattermost.example/admin_console/integrations/custom`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Display name override is not enabled by default, you need to ask your admin to enable it on that same section.
 | 
					Display name override is not enabled by default, you need to ask your admin to enable it on that same section.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -38,7 +38,7 @@ At the end, fill in your Mattermost details:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| Field | Description |
 | 
					| Field | Description |
 | 
				
			||||||
| ----- | ----------- |
 | 
					| ----- | ----------- |
 | 
				
			||||||
| **Webhook**  | The incoming webhook URL which you have to set up on Mattermost, it will be something like: http://mattermost.example/hooks/5xo… |
 | 
					| **Webhook**  | The incoming webhook URL which you have to set up on Mattermost, it will be something like: `http://mattermost.example/hooks/5xo…` |
 | 
				
			||||||
| **Username** | Optional username which can be on messages sent to Mattermost. Fill this in if you want to change the username of the bot. |
 | 
					| **Username** | Optional username which can be on messages sent to Mattermost. Fill this in if you want to change the username of the bot. |
 | 
				
			||||||
| **Notify only broken pipelines** | If you choose to enable the **Pipeline** event and you want to be only notified about failed pipelines. |
 | 
					| **Notify only broken pipelines** | If you choose to enable the **Pipeline** event and you want to be only notified about failed pipelines. |
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -10,7 +10,7 @@ Error tracking allows developers to easily discover and view the errors that the
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Deploying Sentry
 | 
					### Deploying Sentry
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You may sign up to the cloud hosted https://sentry.io or deploy your own [on-premise instance](https://docs.sentry.io/server/installation/).
 | 
					You may sign up to the cloud hosted <https://sentry.io> or deploy your own [on-premise instance](https://docs.sentry.io/server/installation/).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Enabling Sentry
 | 
					### Enabling Sentry
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
		Reference in New Issue