Commit db25a759 authored by Evan Read's avatar Evan Read

Merge branch 'docs-update-redirected-links-6' into 'master'

Find and replace issue links to add hyphens in various dirs

See merge request gitlab-org/gitlab!32626
parents d8fb900e aeda2263
...@@ -8,7 +8,7 @@ Technical articles are ...@@ -8,7 +8,7 @@ Technical articles are
topic-related documentation, written with a user-friendly approach and language, aiming topic-related documentation, written with a user-friendly approach and language, aiming
to provide the community with guidance on specific processes to achieve certain objectives. to provide the community with guidance on specific processes to achieve certain objectives.
The list of technical articles was [deprecated](https://gitlab.com/gitlab-org/gitlab-foss/issues/41138) in favor of having them linked from their topic-related documentation: The list of technical articles was [deprecated](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41138) in favor of having them linked from their topic-related documentation:
- [Git](../topics/git/index.md) - [Git](../topics/git/index.md)
- [GitLab administrator](../administration/index.md) - [GitLab administrator](../administration/index.md)
......
...@@ -207,19 +207,19 @@ been necessary. These are: ...@@ -207,19 +207,19 @@ been necessary. These are:
#### 12.0 #### 12.0
- [Use refspec to clone/fetch Git - [Use refspec to clone/fetch Git
repository](https://gitlab.com/gitlab-org/gitlab-runner/issues/4069). repository](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4069).
- [Old cache - [Old cache
configuration](https://gitlab.com/gitlab-org/gitlab-runner/issues/4070). configuration](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4070).
- [Old metrics server - [Old metrics server
configuration](https://gitlab.com/gitlab-org/gitlab-runner/issues/4072). configuration](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4072).
- [Remove - [Remove
`FF_K8S_USE_ENTRYPOINT_OVER_COMMAND`](https://gitlab.com/gitlab-org/gitlab-runner/issues/4073). `FF_K8S_USE_ENTRYPOINT_OVER_COMMAND`](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4073).
- [Remove Linux distributions that reach - [Remove Linux distributions that reach
EOL](https://gitlab.com/gitlab-org/gitlab-runner/-/merge_requests/1130). EOL](https://gitlab.com/gitlab-org/gitlab-runner/-/merge_requests/1130).
- [Update command line API for helper - [Update command line API for helper
images](https://gitlab.com/gitlab-org/gitlab-runner/issues/4013). images](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4013).
- [Remove old `git clean` - [Remove old `git clean`
flow](https://gitlab.com/gitlab-org/gitlab-runner/issues/4175). flow](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4175).
#### 11.0 #### 11.0
......
...@@ -556,7 +556,7 @@ next run of the pipeline, the cache will be stored in a different location. ...@@ -556,7 +556,7 @@ next run of the pipeline, the cache will be stored in a different location.
### Clearing the cache manually ### Clearing the cache manually
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/41249) in GitLab 10.4. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41249) in GitLab 10.4.
If you want to avoid editing `.gitlab-ci.yml`, you can easily clear the cache If you want to avoid editing `.gitlab-ci.yml`, you can easily clear the cache
via GitLab's UI: via GitLab's UI:
......
...@@ -12,7 +12,7 @@ GitLab. ...@@ -12,7 +12,7 @@ GitLab.
Watch a video on [Using GitLab CI/CD pipelines with GitHub repositories](https://www.youtube.com/watch?v=qgl3F2j-1cI). Watch a video on [Using GitLab CI/CD pipelines with GitHub repositories](https://www.youtube.com/watch?v=qgl3F2j-1cI).
NOTE: **Note:** NOTE: **Note:**
Because of [GitHub limitations](https://gitlab.com/gitlab-org/gitlab/issues/9147), Because of [GitHub limitations](https://gitlab.com/gitlab-org/gitlab/-/issues/9147),
[GitHub OAuth](../../integration/github.md#enabling-github-oauth) [GitHub OAuth](../../integration/github.md#enabling-github-oauth)
cannot be used to authenticate with GitHub as an external CI/CD repository. cannot be used to authenticate with GitHub as an external CI/CD repository.
......
...@@ -31,7 +31,7 @@ To connect to an external repository: ...@@ -31,7 +31,7 @@ To connect to an external repository:
## Pipelines for external pull requests ## Pipelines for external pull requests
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/65139) in GitLab Premium 12.3. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/65139) in GitLab Premium 12.3.
When using GitLab CI/CD with an [external repository on GitHub](github_integration.md), When using GitLab CI/CD with an [external repository on GitHub](github_integration.md),
it's possible to run a pipeline in the context of a Pull Request. it's possible to run a pipeline in the context of a Pull Request.
...@@ -87,10 +87,10 @@ The variable names are prefixed with `CI_EXTERNAL_PULL_REQUEST_`. ...@@ -87,10 +87,10 @@ The variable names are prefixed with `CI_EXTERNAL_PULL_REQUEST_`.
### Limitations ### Limitations
This feature currently does not support Pull Requests from fork repositories. Any Pull Requests from fork repositories will be ignored. [Read more](https://gitlab.com/gitlab-org/gitlab/issues/5667). This feature currently does not support Pull Requests from fork repositories. Any Pull Requests from fork repositories will be ignored. [Read more](https://gitlab.com/gitlab-org/gitlab/-/issues/5667).
Given that GitLab will create 2 pipelines, if changes are pushed to a remote branch that Given that GitLab will create 2 pipelines, if changes are pushed to a remote branch that
references an open Pull Request, both will contribute to the status of the Pull Request references an open Pull Request, both will contribute to the status of the Pull Request
via GitHub integration. If you want to exclusively run pipelines on external pull via GitHub integration. If you want to exclusively run pipelines on external pull
requests and not on branches you can add `except: [branches]` to the job specs. requests and not on branches you can add `except: [branches]` to the job specs.
[Read more](https://gitlab.com/gitlab-org/gitlab/issues/24089#workaround). [Read more](https://gitlab.com/gitlab-org/gitlab/-/issues/24089#workaround).
...@@ -15,7 +15,7 @@ cloud provider more easily. ...@@ -15,7 +15,7 @@ cloud provider more easily.
## AWS ## AWS
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/31167) in GitLab 12.6. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/31167) in GitLab 12.6.
GitLab's AWS Docker image provides the [AWS Command Line Interface](https://aws.amazon.com/cli/), GitLab's AWS Docker image provides the [AWS Command Line Interface](https://aws.amazon.com/cli/),
which enables you to run `aws` commands. As part of your deployment strategy, you can run `aws` commands directly from which enables you to run `aws` commands. As part of your deployment strategy, you can run `aws` commands directly from
...@@ -67,7 +67,7 @@ path to point to your ECR. ...@@ -67,7 +67,7 @@ path to point to your ECR.
### Deploy your application to AWS Elastic Container Service (ECS) ### Deploy your application to AWS Elastic Container Service (ECS)
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/207962) in GitLab 12.9. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/207962) in GitLab 12.9.
GitLab provides a series of [CI templates that you can include in your project](../yaml/README.md#include). GitLab provides a series of [CI templates that you can include in your project](../yaml/README.md#include).
To automate deployments of your application to your [Amazon Elastic Container Service](https://aws.amazon.com/ecs/) (AWS ECS) To automate deployments of your application to your [Amazon Elastic Container Service](https://aws.amazon.com/ecs/) (AWS ECS)
......
...@@ -4,7 +4,7 @@ type: reference ...@@ -4,7 +4,7 @@ type: reference
# Directed Acyclic Graph # Directed Acyclic Graph
> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/47063) in GitLab 12.2. > - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/47063) in GitLab 12.2.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/206902) in GitLab 12.10. > - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/206902) in GitLab 12.10.
A [directed acyclic graph](https://www.techopedia.com/definition/5739/directed-acyclic-graph-dag) can be A [directed acyclic graph](https://www.techopedia.com/definition/5739/directed-acyclic-graph-dag) can be
......
...@@ -125,7 +125,7 @@ not without its own challenges: ...@@ -125,7 +125,7 @@ not without its own challenges:
child containers. For example, if you have files you want to share with a child containers. For example, if you have files you want to share with a
child container, you may create a subdirectory under `/builds/$CI_PROJECT_PATH` child container, you may create a subdirectory under `/builds/$CI_PROJECT_PATH`
and use it as your mount point (for a more thorough explanation, check [issue and use it as your mount point (for a more thorough explanation, check [issue
#41227](https://gitlab.com/gitlab-org/gitlab-foss/issues/41227)): #41227](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41227)):
```yaml ```yaml
variables: variables:
......
...@@ -364,7 +364,7 @@ For example, the following two definitions are equal: ...@@ -364,7 +364,7 @@ For example, the following two definitions are equal:
| `alias` | no | 9.4 |Additional alias that can be used to access the service from the job's container. Read [Accessing the services](#accessing-the-services) for more information. | | `alias` | no | 9.4 |Additional alias that can be used to access the service from the job's container. Read [Accessing the services](#accessing-the-services) for more information. |
NOTE: **Note:** NOTE: **Note:**
Alias support for the Kubernetes executor was [introduced](https://gitlab.com/gitlab-org/gitlab-runner/issues/2229) in GitLab Runner 12.8, and is only available for Kubernetes version 1.7 or later. Alias support for the Kubernetes executor was [introduced](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/2229) in GitLab Runner 12.8, and is only available for Kubernetes version 1.7 or later.
### Starting multiple services from the same image ### Starting multiple services from the same image
...@@ -543,7 +543,7 @@ runtime. ...@@ -543,7 +543,7 @@ runtime.
of credentials on runner's host. We recommend to upgrade your Runner to of credentials on runner's host. We recommend to upgrade your Runner to
at least version **1.8** if you want to use private registries. at least version **1.8** if you want to use private registries.
- Not available for [Kubernetes executor](https://docs.gitlab.com/runner/executors/kubernetes.html), - Not available for [Kubernetes executor](https://docs.gitlab.com/runner/executors/kubernetes.html),
follow <https://gitlab.com/gitlab-org/gitlab-runner/issues/2673> for follow <https://gitlab.com/gitlab-org/gitlab-runner/-/issues/2673> for
details. details.
### Using statically-defined credentials ### Using statically-defined credentials
......
...@@ -4,7 +4,7 @@ type: howto ...@@ -4,7 +4,7 @@ type: howto
# Building images with kaniko and GitLab CI/CD # Building images with kaniko and GitLab CI/CD
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/45512) in GitLab 11.2. Requires GitLab Runner 11.2 and above. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/45512) in GitLab 11.2. Requires GitLab Runner 11.2 and above.
[kaniko](https://github.com/GoogleContainerTools/kaniko) is a tool to build [kaniko](https://github.com/GoogleContainerTools/kaniko) is a tool to build
container images from a Dockerfile, inside a container or Kubernetes cluster. container images from a Dockerfile, inside a container or Kubernetes cluster.
......
...@@ -7,7 +7,7 @@ type: reference ...@@ -7,7 +7,7 @@ type: reference
# Environments Dashboard **(PREMIUM)** # Environments Dashboard **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/3713) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.5. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/3713) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.5.
The Environments Dashboard provides a cross-project The Environments Dashboard provides a cross-project
environment-based view that lets you see the big picture environment-based view that lets you see the big picture
......
...@@ -34,7 +34,7 @@ use as examples to build your own: ...@@ -34,7 +34,7 @@ use as examples to build your own:
## Manual Rollouts ## Manual Rollouts
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/5415) in GitLab 10.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/5415) in GitLab 10.8.
It is possible to configure GitLab to do incremental rollouts manually through `.gitlab-ci.yml`. Manual configuration It is possible to configure GitLab to do incremental rollouts manually through `.gitlab-ci.yml`. Manual configuration
allows more control over the this feature. The steps in an incremental rollout depend on the allows more control over the this feature. The steps in an incremental rollout depend on the
...@@ -74,7 +74,7 @@ available, demonstrating manually triggered incremental rollouts. ...@@ -74,7 +74,7 @@ available, demonstrating manually triggered incremental rollouts.
## Timed Rollouts ## Timed Rollouts
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/7545) in GitLab 11.4. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7545) in GitLab 11.4.
Timed rollouts behave in the same way as manual rollouts, except that each job is defined with a delay Timed rollouts behave in the same way as manual rollouts, except that each job is defined with a delay
in minutes before it will deploy. Clicking on the job will reveal the countdown. in minutes before it will deploy. Clicking on the job will reveal the countdown.
......
...@@ -162,7 +162,7 @@ Starting with GitLab 9.3, the environment URL is exposed to the Runner via ...@@ -162,7 +162,7 @@ Starting with GitLab 9.3, the environment URL is exposed to the Runner via
#### Set dynamic environment URLs after a job finishes #### Set dynamic environment URLs after a job finishes
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/17066) in GitLab 12.9. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/17066) in GitLab 12.9.
In a job script, you can specify a static [environment URL](#using-the-environment-url). In a job script, you can specify a static [environment URL](#using-the-environment-url).
However, there may be times when you want a dynamic URL. For example, However, there may be times when you want a dynamic URL. For example,
...@@ -384,7 +384,7 @@ feature. ...@@ -384,7 +384,7 @@ feature.
### Configuring Kubernetes deployments ### Configuring Kubernetes deployments
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/27630) in GitLab 12.6. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/27630) in GitLab 12.6.
If you are deploying to a [Kubernetes cluster](../../user/project/clusters/index.md) If you are deploying to a [Kubernetes cluster](../../user/project/clusters/index.md)
associated with your project, you can configure these deployments from your associated with your project, you can configure these deployments from your
...@@ -421,7 +421,7 @@ NOTE: **Note:** ...@@ -421,7 +421,7 @@ NOTE: **Note:**
Kubernetes configuration is not supported for Kubernetes clusters Kubernetes configuration is not supported for Kubernetes clusters
that are [managed by GitLab](../../user/project/clusters/index.md#gitlab-managed-clusters). that are [managed by GitLab](../../user/project/clusters/index.md#gitlab-managed-clusters).
To follow progress on support for GitLab-managed clusters, see the To follow progress on support for GitLab-managed clusters, see the
[relevant issue](https://gitlab.com/gitlab-org/gitlab/issues/38054). [relevant issue](https://gitlab.com/gitlab-org/gitlab/-/issues/38054).
### Complete example ### Complete example
...@@ -703,7 +703,7 @@ You can read more in the [`.gitlab-ci.yml` reference](../yaml/README.md#environm ...@@ -703,7 +703,7 @@ You can read more in the [`.gitlab-ci.yml` reference](../yaml/README.md#environm
#### Environments auto-stop #### Environments auto-stop
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/20956) in GitLab 12.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/20956) in GitLab 12.8.
You can set a expiry time to environments and stop them automatically after a certain period. You can set a expiry time to environments and stop them automatically after a certain period.
......
...@@ -4,7 +4,7 @@ type: reference ...@@ -4,7 +4,7 @@ type: reference
# Interactive Web Terminals # Interactive Web Terminals
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/50144) in GitLab 11.3. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/50144) in GitLab 11.3.
Interactive web terminals give the user access to a terminal in GitLab for Interactive web terminals give the user access to a terminal in GitLab for
running one-off commands for their CI pipeline. Since this is giving the user running one-off commands for their CI pipeline. Since this is giving the user
...@@ -41,7 +41,7 @@ NOTE: **Note:** Not all executors are ...@@ -41,7 +41,7 @@ NOTE: **Note:** Not all executors are
NOTE: **Note:** The `docker` executor does not keep running NOTE: **Note:** The `docker` executor does not keep running
after the build script is finished. At that point, the terminal will automatically after the build script is finished. At that point, the terminal will automatically
disconnect and will not wait for the user to finish. Please follow [this disconnect and will not wait for the user to finish. Please follow [this
issue](https://gitlab.com/gitlab-org/gitlab-runner/issues/3605) for updates on issue](https://gitlab.com/gitlab-org/gitlab-runner/-/issues/3605) for updates on
improving this behavior. improving this behavior.
Sometimes, when a job is running, things don't go as you would expect, and it Sometimes, when a job is running, things don't go as you would expect, and it
......
...@@ -78,7 +78,7 @@ There are some high level differences between the products worth mentioning: ...@@ -78,7 +78,7 @@ There are some high level differences between the products worth mentioning:
- You can also use the [`extends` keyword](../yaml/README.md#extends) to reuse configuration - You can also use the [`extends` keyword](../yaml/README.md#extends) to reuse configuration
within a single pipeline configuration. within a single pipeline configuration.
- All jobs within a single stage always run in parallel, and all stages run in sequence. We are planning - All jobs within a single stage always run in parallel, and all stages run in sequence. We are planning
to allow certain jobs to break this sequencing as needed with our [directed acyclic graph](https://gitlab.com/gitlab-org/gitlab-foss/issues/47063) to allow certain jobs to break this sequencing as needed with our [directed acyclic graph](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/47063)
feature. feature.
- The [`parallel`](../yaml/README.md#parallel) keyword can automatically parallelize tasks, - The [`parallel`](../yaml/README.md#parallel) keyword can automatically parallelize tasks,
like tests that support parallelization. like tests that support parallelization.
...@@ -90,7 +90,7 @@ There are some high level differences between the products worth mentioning: ...@@ -90,7 +90,7 @@ There are some high level differences between the products worth mentioning:
- One important difference is that jobs run independently of each other and have a - One important difference is that jobs run independently of each other and have a
fresh environment in each job. Passing artifacts between jobs is controlled using the fresh environment in each job. Passing artifacts between jobs is controlled using the
[`artifacts`](../yaml/README.md#artifacts) and [`dependencies`](../yaml/README.md#dependencies) [`artifacts`](../yaml/README.md#artifacts) and [`dependencies`](../yaml/README.md#dependencies)
keywords. When finished, the planned [Workspaces](https://gitlab.com/gitlab-org/gitlab/issues/29265) keywords. When finished, the planned [Workspaces](https://gitlab.com/gitlab-org/gitlab/-/issues/29265)
feature will allow you to more easily persist a common workspace between serial jobs. feature will allow you to more easily persist a common workspace between serial jobs.
- The `.gitlab-ci.yml` file is checked in to the root of your repository, much like a Jenkinsfile, but - The `.gitlab-ci.yml` file is checked in to the root of your repository, much like a Jenkinsfile, but
is in the YAML format (see [complete reference](../yaml/README.md)) instead of a Groovy DSL. It's most is in the YAML format (see [complete reference](../yaml/README.md)) instead of a Groovy DSL. It's most
......
...@@ -4,7 +4,7 @@ type: reference ...@@ -4,7 +4,7 @@ type: reference
# JUnit test reports # JUnit test reports
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/45318) in GitLab 11.2. Requires GitLab Runner 11.2 and above. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/45318) in GitLab 11.2. Requires GitLab Runner 11.2 and above.
## Overview ## Overview
...@@ -221,11 +221,11 @@ Currently, the following tools might not work because their XML formats are unsu ...@@ -221,11 +221,11 @@ 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-foss/issues/50964>| |`<testcase>` does not have `classname` attribute|ESlint, sass-lint|<https://gitlab.com/gitlab-org/gitlab-foss/-/issues/50964>|
## Viewing JUnit test reports on GitLab ## Viewing JUnit test reports on GitLab
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/24792) in GitLab 12.5. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/24792) in GitLab 12.5.
If JUnit XML files are generated and uploaded as part of a pipeline, these reports If JUnit XML files are generated and uploaded as part of a pipeline, these reports
can be viewed inside the pipelines details page. The **Tests** tab on this page will can be viewed inside the pipelines details page. The **Tests** tab on this page will
......
...@@ -5,7 +5,7 @@ last_update: 2019-07-03 ...@@ -5,7 +5,7 @@ last_update: 2019-07-03
# Pipelines for Merge Requests # Pipelines for Merge Requests
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/15310) in GitLab 11.6. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/15310) in GitLab 11.6.
In a [basic configuration](../pipelines/pipeline_architectures.md#basic-pipelines), GitLab runs a pipeline each time In a [basic configuration](../pipelines/pipeline_architectures.md#basic-pipelines), GitLab runs a pipeline each time
changes are pushed to a branch. changes are pushed to a branch.
......
...@@ -5,7 +5,7 @@ last_update: 2019-07-03 ...@@ -5,7 +5,7 @@ last_update: 2019-07-03
# Pipelines for Merged Results **(PREMIUM)** # Pipelines for Merged Results **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/7380) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7380) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10.
When you submit a merge request, you are requesting to merge changes from a When you submit a merge request, you are requesting to merge changes from a
source branch into a target branch. By default, the CI pipeline runs jobs source branch into a target branch. By default, the CI pipeline runs jobs
...@@ -44,7 +44,7 @@ To enable pipelines for merge results: ...@@ -44,7 +44,7 @@ To enable pipelines for merge results:
- You must have maintainer [permissions](../../../user/permissions.md). - You must have maintainer [permissions](../../../user/permissions.md).
- You must be using [GitLab Runner](https://gitlab.com/gitlab-org/gitlab-runner) 11.9 or later. - You must be using [GitLab Runner](https://gitlab.com/gitlab-org/gitlab-runner) 11.9 or later.
- You must not be forking or using cross-repo workflows. To follow progress, - You must not be forking or using cross-repo workflows. To follow progress,
see [#11934](https://gitlab.com/gitlab-org/gitlab/issues/11934). see [#11934](https://gitlab.com/gitlab-org/gitlab/-/issues/11934).
- You must not be using - You must not be using
[fast forward merges](../../../user/project/merge_requests/fast_forward_merge.md) yet. [fast forward merges](../../../user/project/merge_requests/fast_forward_merge.md) yet.
To follow progress, see [#58226](https://gitlab.com/gitlab-org/gitlab/-/issues/26996). To follow progress, see [#58226](https://gitlab.com/gitlab-org/gitlab/-/issues/26996).
...@@ -78,7 +78,7 @@ For more information, read the [documentation on Merge Trains](merge_trains/inde ...@@ -78,7 +78,7 @@ For more information, read the [documentation on Merge Trains](merge_trains/inde
## Automatic pipeline cancelation ## Automatic pipeline cancelation
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/12996) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.3. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/12996) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.3.
GitLab CI/CD can detect the presence of redundant pipelines, GitLab CI/CD can detect the presence of redundant pipelines,
and will cancel them automatically in order to conserve CI resources. and will cancel them automatically in order to conserve CI resources.
......
...@@ -5,8 +5,8 @@ last_update: 2019-07-03 ...@@ -5,8 +5,8 @@ last_update: 2019-07-03
# Merge Trains **(PREMIUM)** # Merge Trains **(PREMIUM)**
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/9186) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.0. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/9186) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.0.
> - [Squash and merge](../../../../user/project/merge_requests/squash_and_merge.md) support [introduced](https://gitlab.com/gitlab-org/gitlab/issues/13001) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.6. > - [Squash and merge](../../../../user/project/merge_requests/squash_and_merge.md) support [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/13001) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.6.
When [pipelines for merged results](../index.md#pipelines-for-merged-results-premium) are When [pipelines for merged results](../index.md#pipelines-for-merged-results-premium) are
enabled, the pipeline jobs run as if the changes from your source branch have already enabled, the pipeline jobs run as if the changes from your source branch have already
...@@ -164,7 +164,7 @@ To check the reason: ...@@ -164,7 +164,7 @@ To check the reason:
[Merge When Pipeline Succeeds](../../../../user/project/merge_requests/merge_when_pipeline_succeeds.md) [Merge When Pipeline Succeeds](../../../../user/project/merge_requests/merge_when_pipeline_succeeds.md)
is currently unavailable when Merge Trains are enabled. is currently unavailable when Merge Trains are enabled.
See [the related issue](https://gitlab.com/gitlab-org/gitlab/issues/12267) See [the related issue](https://gitlab.com/gitlab-org/gitlab/-/issues/12267)
for more information. for more information.
### Merge Train Pipeline cannot be retried ### Merge Train Pipeline cannot be retried
...@@ -191,7 +191,7 @@ Trains, you can create a new pipeline for merged results when this error occurs ...@@ -191,7 +191,7 @@ Trains, you can create a new pipeline for merged results when this error occurs
going to the **Pipelines** tab and clicking **Run pipeline**. Then click going to the **Pipelines** tab and clicking **Run pipeline**. Then click
**Start/Add to merge train when pipeline succeeds**. **Start/Add to merge train when pipeline succeeds**.
See [the related issue](https://gitlab.com/gitlab-org/gitlab/issues/35135) See [the related issue](https://gitlab.com/gitlab-org/gitlab/-/issues/35135)
for more information. for more information.
### Merge Trains feature flag **(PREMIUM ONLY)** ### Merge Trains feature flag **(PREMIUM ONLY)**
......
...@@ -4,7 +4,7 @@ type: reference ...@@ -4,7 +4,7 @@ type: reference
# Metrics Reports **(PREMIUM)** # Metrics Reports **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/9788) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10. Requires GitLab Runner 11.10 and above. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/9788) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10. Requires GitLab Runner 11.10 and above.
## Overview ## Overview
......
...@@ -5,7 +5,7 @@ type: reference ...@@ -5,7 +5,7 @@ type: reference
# Multi-project pipelines # Multi-project pipelines
> - [Introduced](https://about.gitlab.com/releases/2015/08/22/gitlab-7-14-released/#build-triggers-api-gitlab-ci) in GitLab 7.14, as Build Triggers. > - [Introduced](https://about.gitlab.com/releases/2015/08/22/gitlab-7-14-released/#build-triggers-api-gitlab-ci) in GitLab 7.14, as Build Triggers.
> - [Made available](https://gitlab.com/gitlab-org/gitlab/issues/199224) in all tiers in GitLab 12.8. > - [Made available](https://gitlab.com/gitlab-org/gitlab/-/issues/199224) in all tiers in GitLab 12.8.
You can set up [GitLab CI/CD](README.md) across multiple projects, so that a pipeline You can set up [GitLab CI/CD](README.md) across multiple projects, so that a pipeline
in one project can trigger a pipeline in another project. in one project can trigger a pipeline in another project.
...@@ -35,7 +35,7 @@ With Multi-Project Pipelines you can visualize the entire pipeline, including al ...@@ -35,7 +35,7 @@ With Multi-Project Pipelines you can visualize the entire pipeline, including al
## Multi-project pipeline visualization **(PREMIUM)** ## Multi-project pipeline visualization **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/2121) in [GitLab Premium 9.3](https://about.gitlab.com/releases/2017/06/22/gitlab-9-3-released/#multi-project-pipeline-graphs). > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/2121) in [GitLab Premium 9.3](https://about.gitlab.com/releases/2017/06/22/gitlab-9-3-released/#multi-project-pipeline-graphs).
When you configure GitLab CI/CD for your project, you can visualize the stages of your When you configure GitLab CI/CD for your project, you can visualize the stages of your
[jobs](pipelines/index.md#configure-a-pipeline) on a [pipeline graph](pipelines/index.md#visualize-pipelines). [jobs](pipelines/index.md#configure-a-pipeline) on a [pipeline graph](pipelines/index.md#visualize-pipelines).
...@@ -50,7 +50,7 @@ and when hovering or tapping (on touchscreen devices) they will expand and be sh ...@@ -50,7 +50,7 @@ and when hovering or tapping (on touchscreen devices) they will expand and be sh
## Triggering multi-project pipelines through API ## Triggering multi-project pipelines through API
> - Use of `CI_JOB_TOKEN` for multi-project pipelines was [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/2017) in [GitLab Premium](https://about.gitlab.com/pricing/) 9.3. > - Use of `CI_JOB_TOKEN` for multi-project pipelines was [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/2017) in [GitLab Premium](https://about.gitlab.com/pricing/) 9.3.
> - Use of `CI_JOB_TOKEN` for multi-project pipelines was [made available](https://gitlab.com/gitlab-org/gitlab/issues/31573) in all tiers in GitLab 12.4. > - Use of `CI_JOB_TOKEN` for multi-project pipelines was [made available](https://gitlab.com/gitlab-org/gitlab/-/issues/31573) in all tiers in GitLab 12.4.
When you use the [`CI_JOB_TOKEN` to trigger pipelines](triggers/README.md#ci-job-token), GitLab When you use the [`CI_JOB_TOKEN` to trigger pipelines](triggers/README.md#ci-job-token), GitLab
recognizes the source of the job token, and thus internally ties these pipelines recognizes the source of the job token, and thus internally ties these pipelines
...@@ -61,8 +61,8 @@ outbound connections for upstream and downstream pipeline dependencies. ...@@ -61,8 +61,8 @@ outbound connections for upstream and downstream pipeline dependencies.
## Creating multi-project pipelines from `.gitlab-ci.yml` ## Creating multi-project pipelines from `.gitlab-ci.yml`
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/8997) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.8. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/8997) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.8.
> - [Made available](https://gitlab.com/gitlab-org/gitlab/issues/199224) in all tiers in 12.8. > - [Made available](https://gitlab.com/gitlab-org/gitlab/-/issues/199224) in all tiers in 12.8.
### Triggering a downstream pipeline using a bridge job ### Triggering a downstream pipeline using a bridge job
...@@ -129,7 +129,7 @@ Use: ...@@ -129,7 +129,7 @@ Use:
- The `project` keyword to specify the full path to a downstream project. - The `project` keyword to specify the full path to a downstream project.
- The `branch` keyword to specify the name of a branch in the project specified by `project`. - The `branch` keyword to specify the name of a branch in the project specified by `project`.
[From GitLab 12.4](https://gitlab.com/gitlab-org/gitlab/issues/10126), variable expansion is [From GitLab 12.4](https://gitlab.com/gitlab-org/gitlab/-/issues/10126), variable expansion is
supported. supported.
GitLab will use a commit that is currently on the HEAD of the branch when GitLab will use a commit that is currently on the HEAD of the branch when
...@@ -192,8 +192,8 @@ the ones defined in the upstream project will take precedence. ...@@ -192,8 +192,8 @@ the ones defined in the upstream project will take precedence.
### Mirroring status from triggered pipeline ### Mirroring status from triggered pipeline
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/11238) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.3. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/11238) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.3.
> - [Moved](https://gitlab.com/gitlab-org/gitlab/issues/199224) to GitLab Core in 12.8. > - [Moved](https://gitlab.com/gitlab-org/gitlab/-/issues/199224) to GitLab Core in 12.8.
You can mirror the pipeline status from the triggered pipeline to the source You can mirror the pipeline status from the triggered pipeline to the source
bridge job by using `strategy: depend`. For example: bridge job by using `strategy: depend`. For example:
...@@ -240,7 +240,7 @@ Some features are not implemented yet. For example, support for environments. ...@@ -240,7 +240,7 @@ Some features are not implemented yet. For example, support for environments.
## Trigger a pipeline when an upstream project is rebuilt ## Trigger a pipeline when an upstream project is rebuilt
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/9045) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/9045) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.8.
You can trigger a pipeline in your project whenever a pipeline finishes for a new You can trigger a pipeline in your project whenever a pipeline finishes for a new
tag in a different project: tag in a different project:
......
...@@ -4,7 +4,7 @@ type: reference ...@@ -4,7 +4,7 @@ type: reference
# Parent-child pipelines # Parent-child pipelines
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/16094) in GitLab 12.7. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/16094) in GitLab 12.7.
As pipelines grow more complex, a few related problems start to emerge: As pipelines grow more complex, a few related problems start to emerge:
...@@ -131,7 +131,7 @@ microservice_a: ...@@ -131,7 +131,7 @@ microservice_a:
## Dynamic child pipelines ## Dynamic child pipelines
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/35632) in GitLab 12.9. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/35632) in GitLab 12.9.
Instead of running a child pipeline from a static YAML file, you can define a job that runs Instead of running a child pipeline from a static YAML file, you can define a job that runs
your own script to generate a YAML file, which is then [used to trigger a child pipeline](yaml/README.md#trigger-child-pipeline-with-generated-configuration-file). your own script to generate a YAML file, which is then [used to trigger a child pipeline](yaml/README.md#trigger-child-pipeline-with-generated-configuration-file).
...@@ -148,5 +148,5 @@ This is [resolved in GitLab 12.10](https://gitlab.com/gitlab-org/gitlab/-/issues ...@@ -148,5 +148,5 @@ This is [resolved in GitLab 12.10](https://gitlab.com/gitlab-org/gitlab/-/issues
## Limitations ## Limitations
A parent pipeline can trigger many child pipelines, but a child pipeline cannot trigger A parent pipeline can trigger many child pipelines, but a child pipeline cannot trigger
further child pipelines. See the [related issue](https://gitlab.com/gitlab-org/gitlab/issues/29651) further child pipelines. See the [related issue](https://gitlab.com/gitlab-org/gitlab/-/issues/29651)
for discussion on possible future improvements. for discussion on possible future improvements.
...@@ -88,7 +88,7 @@ Clicking a pipeline will bring you to the **Pipeline Details** page and show ...@@ -88,7 +88,7 @@ Clicking a pipeline will bring you to the **Pipeline Details** page and show
the jobs that were run for that pipeline. From here you can cancel a running pipeline, the jobs that were run for that pipeline. From here you can cancel a running pipeline,
retry jobs on a failed pipeline, or [delete a pipeline](#delete-a-pipeline). retry jobs on a failed pipeline, or [delete a pipeline](#delete-a-pipeline).
[Starting in GitLab 12.3](https://gitlab.com/gitlab-org/gitlab-foss/issues/50499), a link to the [Starting in GitLab 12.3](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/50499), a link to the
latest pipeline for the last commit of a given branch is available at `/project/pipelines/[branch]/latest`. latest pipeline for the last commit of a given branch is available at `/project/pipelines/[branch]/latest`.
Also, `/project/pipelines/latest` will redirect you to the latest pipeline for the last commit Also, `/project/pipelines/latest` will redirect you to the latest pipeline for the last commit
on the project's default branch. on the project's default branch.
...@@ -119,7 +119,7 @@ The pipeline will execute the jobs as configured. ...@@ -119,7 +119,7 @@ The pipeline will execute the jobs as configured.
### Run a pipeline by using a URL query string ### Run a pipeline by using a URL query string
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/24146) in GitLab 12.5. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/24146) in GitLab 12.5.
You can use a query string to pre-populate the **Run Pipeline** page. For example, the query string You can use a query string to pre-populate the **Run Pipeline** page. For example, the query string
`.../pipelines/new?ref=my_branch&var[foo]=bar&file_var[file_foo]=file_bar` will pre-populate the `.../pipelines/new?ref=my_branch&var[foo]=bar&file_var[file_foo]=file_bar` will pre-populate the
...@@ -179,7 +179,7 @@ This functionality is only available: ...@@ -179,7 +179,7 @@ This functionality is only available:
### Delete a pipeline ### Delete a pipeline
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/24851) in GitLab 12.7. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/24851) in GitLab 12.7.
Users with [owner permissions](../../user/permissions.md) in a project can delete a pipeline Users with [owner permissions](../../user/permissions.md) in a project can delete a pipeline
by clicking on the pipeline in the **CI/CD > Pipelines** to get to the **Pipeline Details** by clicking on the pipeline in the **CI/CD > Pipelines** to get to the **Pipeline Details**
...@@ -403,7 +403,7 @@ For example, if you start rolling out new code and: ...@@ -403,7 +403,7 @@ For example, if you start rolling out new code and:
### Expand and collapse job log sections ### Expand and collapse job log sections
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/14664) in GitLab 12.0. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/14664) in GitLab 12.0.
Job logs are divided into sections that can be collapsed or expanded. Each section will display Job logs are divided into sections that can be collapsed or expanded. Each section will display
the duration. the duration.
...@@ -500,7 +500,7 @@ Stages in pipeline mini graphs are collapsible. Hover your mouse over them and c ...@@ -500,7 +500,7 @@ Stages in pipeline mini graphs are collapsible. Hover your mouse over them and c
### Pipeline success and duration charts ### Pipeline success and duration charts
> - Introduced in GitLab 3.1.1 as Commit Stats, and later renamed to Pipeline Charts. > - Introduced in GitLab 3.1.1 as Commit Stats, and later renamed to Pipeline Charts.
> - [Renamed](https://gitlab.com/gitlab-org/gitlab/issues/38318) to CI / CD Analytics in GitLab 12.8. > - [Renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/38318) to CI / CD Analytics in GitLab 12.8.
GitLab tracks the history of your pipeline successes and failures, as well as how long each pipeline ran. To view this information, go to **Analytics > CI / CD Analytics**. GitLab tracks the history of your pipeline successes and failures, as well as how long each pipeline ran. To view this information, go to **Analytics > CI / CD Analytics**.
......
...@@ -103,7 +103,7 @@ combination thereof (`junit: [rspec.xml, test-results/TEST-*.xml]`). ...@@ -103,7 +103,7 @@ combination thereof (`junit: [rspec.xml, test-results/TEST-*.xml]`).
#### `artifacts:reports:dotenv` #### `artifacts:reports:dotenv`
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/17066) in GitLab 12.9. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/17066) in GitLab 12.9.
> - Requires GitLab Runner 11.5 and later. > - Requires GitLab Runner 11.5 and later.
The `dotenv` report collects a set of environment variables as artifacts. The `dotenv` report collects a set of environment variables as artifacts.
...@@ -122,7 +122,7 @@ There are a couple of limitations on top of the [original dotenv rules](https:// ...@@ -122,7 +122,7 @@ There are a couple of limitations on top of the [original dotenv rules](https://
#### `artifacts:reports:cobertura` #### `artifacts:reports:cobertura`
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/3708) in GitLab 12.9. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/3708) in GitLab 12.9.
> - Requires [GitLab Runner](https://docs.gitlab.com/runner/) 11.5 and above. > - Requires [GitLab Runner](https://docs.gitlab.com/runner/) 11.5 and above.
The `cobertura` report collects [Cobertura coverage XML files](../../user/project/merge_requests/test_coverage_visualization.md). The `cobertura` report collects [Cobertura coverage XML files](../../user/project/merge_requests/test_coverage_visualization.md).
......
...@@ -69,7 +69,7 @@ For information about setting a maximum artifact size for a project, see ...@@ -69,7 +69,7 @@ For information about setting a maximum artifact size for a project, see
## Custom CI configuration path ## Custom CI configuration path
> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/12509) in GitLab 9.4. > - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/12509) in GitLab 9.4.
> - [Support for external `.gitlab-ci.yml` locations](https://gitlab.com/gitlab-org/gitlab/issues/14376) introduced in GitLab 12.6. > - [Support for external `.gitlab-ci.yml` locations](https://gitlab.com/gitlab-org/gitlab/-/issues/14376) introduced in GitLab 12.6.
By default we look for the `.gitlab-ci.yml` file in the project's root By default we look for the `.gitlab-ci.yml` file in the project's root
directory. If needed, you can specify an alternate path and file name, including locations outside the project. directory. If needed, you can specify an alternate path and file name, including locations outside the project.
...@@ -208,7 +208,7 @@ you can enable this in the project settings: ...@@ -208,7 +208,7 @@ you can enable this in the project settings:
## Skip outdated deployment jobs ## Skip outdated deployment jobs
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/25276) in GitLab 12.9. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/25276) in GitLab 12.9.
Your project may have multiple concurrent deployment jobs that are Your project may have multiple concurrent deployment jobs that are
scheduled to run within the same time frame. scheduled to run within the same time frame.
...@@ -290,7 +290,7 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?st ...@@ -290,7 +290,7 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?st
#### Flat square #### Flat square
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/30120) in GitLab 11.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/30120) in GitLab 11.8.
```plaintext ```plaintext
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat-square https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat-square
......
...@@ -7,7 +7,7 @@ type: reference ...@@ -7,7 +7,7 @@ type: reference
# Review Apps # Review Apps
> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/21971) in GitLab 8.12. Further additions were made in GitLab 8.13 and 8.14. > - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/21971) in GitLab 8.12. Further additions were made in GitLab 8.13 and 8.14.
> - Inspired by [Heroku's Review Apps](https://devcenter.heroku.com/articles/github-integration-review-apps), which itself was inspired by [Fourchette](https://github.com/rainforestapp/fourchette). > - Inspired by [Heroku's Review Apps](https://devcenter.heroku.com/articles/github-integration-review-apps), which itself was inspired by [Fourchette](https://github.com/rainforestapp/fourchette).
Review Apps is a collaboration tool that takes the hard work out of providing an environment to showcase product changes. Review Apps is a collaboration tool that takes the hard work out of providing an environment to showcase product changes.
...@@ -65,7 +65,7 @@ The process of configuring Review Apps is as follows: ...@@ -65,7 +65,7 @@ The process of configuring Review Apps is as follows:
### Enable Review Apps button ### Enable Review Apps button
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/118844) in GitLab 12.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/118844) in GitLab 12.8.
When configuring Review Apps for a project, you need to add a new job to `.gitlab-ci.yml`, When configuring Review Apps for a project, you need to add a new job to `.gitlab-ci.yml`,
as mentioned above. To facilitate this and if you are using Kubernetes, you can click as mentioned above. To facilitate this and if you are using Kubernetes, you can click
...@@ -185,7 +185,7 @@ Once you have the route mapping set up, it will take effect in the following loc ...@@ -185,7 +185,7 @@ Once you have the route mapping set up, it will take effect in the following loc
## Visual Reviews **(STARTER)** ## Visual Reviews **(STARTER)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/10761) in GitLab Starter 12.0. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/10761) in GitLab Starter 12.0.
With Visual Reviews, you can provide a feedback form to your Review Apps so With Visual Reviews, you can provide a feedback form to your Review Apps so
that reviewers can post comments directly from the app back to the merge request that reviewers can post comments directly from the app back to the merge request
...@@ -258,7 +258,7 @@ Then, when your app is deployed via GitLab CI/CD, those variables should get ...@@ -258,7 +258,7 @@ Then, when your app is deployed via GitLab CI/CD, those variables should get
replaced with their real values. replaced with their real values.
NOTE: **Note:** NOTE: **Note:**
Future enhancements [are planned](https://gitlab.com/gitlab-org/gitlab/issues/11322) Future enhancements [are planned](https://gitlab.com/gitlab-org/gitlab/-/issues/11322)
to make this process even easier. to make this process even easier.
### Determining merge request ID ### Determining merge request ID
......
...@@ -49,7 +49,7 @@ with the [GitLab Container Registry](../../user/packages/container_registry/inde ...@@ -49,7 +49,7 @@ with the [GitLab Container Registry](../../user/packages/container_registry/inde
#### When used with multi-project pipelines #### When used with multi-project pipelines
> - Use of `CI_JOB_TOKEN` for multi-project pipelines was [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/2017) in [GitLab Premium](https://about.gitlab.com/pricing/) 9.3. > - Use of `CI_JOB_TOKEN` for multi-project pipelines was [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/2017) in [GitLab Premium](https://about.gitlab.com/pricing/) 9.3.
> - Use of `CI_JOB_TOKEN` for multi-project pipelines was [made available](https://gitlab.com/gitlab-org/gitlab/issues/31573) in all tiers in GitLab 12.4. > - Use of `CI_JOB_TOKEN` for multi-project pipelines was [made available](https://gitlab.com/gitlab-org/gitlab/-/issues/31573) in all tiers in GitLab 12.4.
This way of triggering can only be used when invoked inside `.gitlab-ci.yml`, This way of triggering can only be used when invoked inside `.gitlab-ci.yml`,
and it creates a dependent pipeline relation visible on the and it creates a dependent pipeline relation visible on the
......
...@@ -133,7 +133,7 @@ The output will be: ...@@ -133,7 +133,7 @@ The output will be:
### Custom environment variables of type Variable ### Custom environment variables of type Variable
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/46806) in GitLab 11.11. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/46806) in GitLab 11.11.
For variables with the type **Variable**, the Runner creates an environment variable For variables with the type **Variable**, the Runner creates an environment variable
that uses the key for the name and the value for the value. that uses the key for the name and the value for the value.
...@@ -143,7 +143,7 @@ which may be further validated. They appear when you add or update a variable in ...@@ -143,7 +143,7 @@ which may be further validated. They appear when you add or update a variable in
### Custom environment variables of type File ### Custom environment variables of type File
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/46806) in GitLab 11.11. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/46806) in GitLab 11.11.
For variables with the type **File**, the Runner creates an environment variable that uses the key for the name. For variables with the type **File**, the Runner creates an environment variable that uses the key for the name.
For the value, the Runner writes the variable value to a temporary file and uses this path. For the value, the Runner writes the variable value to a temporary file and uses this path.
...@@ -175,7 +175,7 @@ kubectl config set-cluster e2e --server="$KUBE_URL" --certificate-authority="$KU ...@@ -175,7 +175,7 @@ kubectl config set-cluster e2e --server="$KUBE_URL" --certificate-authority="$KU
### Mask a custom variable ### Mask a custom variable
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/13784) in GitLab 11.10 > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/13784) in GitLab 11.10
Variables can be masked so that the value of the variable will be hidden in job logs. Variables can be masked so that the value of the variable will be hidden in job logs.
...@@ -195,7 +195,7 @@ The value of the variable must: ...@@ -195,7 +195,7 @@ The value of the variable must:
- Be at least 8 characters long. - Be at least 8 characters long.
- Not be a predefined or custom environment variable. - Not be a predefined or custom environment variable.
- Consist only of characters from the Base64 alphabet (RFC4648). - Consist only of characters from the Base64 alphabet (RFC4648).
[In GitLab 12.2](https://gitlab.com/gitlab-org/gitlab-foss/issues/63043) [In GitLab 12.2](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/63043)
and newer, `@` and `:` are also valid values. and newer, `@` and `:` are also valid values.
You can't mask variables that don't meet these requirements. You can't mask variables that don't meet these requirements.
...@@ -518,7 +518,7 @@ An example integration that defines deployment variables is the ...@@ -518,7 +518,7 @@ An example integration that defines deployment variables is the
### Auto DevOps environment variables ### Auto DevOps environment variables
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/49056) in GitLab 11.7. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/49056) in GitLab 11.7.
You can configure [Auto DevOps](../../topics/autodevops/index.md) to You can configure [Auto DevOps](../../topics/autodevops/index.md) to
pass CI variables to the running application by prefixing the key of the pass CI variables to the running application by prefixing the key of the
...@@ -535,7 +535,7 @@ limitations with the current Auto DevOps scripting environment. ...@@ -535,7 +535,7 @@ limitations with the current Auto DevOps scripting environment.
### Override a variable by manually running a pipeline ### Override a variable by manually running a pipeline
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/44059) in GitLab 10.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/44059) in GitLab 10.8.
You can override the value of a current variable by You can override the value of a current variable by
[running a pipeline manually](../pipelines/index.md#run-a-pipeline-manually). [running a pipeline manually](../pipelines/index.md#run-a-pipeline-manually).
...@@ -555,8 +555,8 @@ value for this specific pipeline. ...@@ -555,8 +555,8 @@ value for this specific pipeline.
## Environment variables expressions ## Environment variables expressions
> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/37397) in GitLab 10.7 for [the `only` and `except` CI keywords](../yaml/README.md#onlyexcept-advanced) > - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/37397) in GitLab 10.7 for [the `only` and `except` CI keywords](../yaml/README.md#onlyexcept-advanced)
> - [Expanded](https://gitlab.com/gitlab-org/gitlab/issues/27863) in GitLab 12.3 with [the `rules` keyword](../yaml/README.md#rules) > - [Expanded](https://gitlab.com/gitlab-org/gitlab/-/issues/27863) in GitLab 12.3 with [the `rules` keyword](../yaml/README.md#rules)
Use variable expressions to limit which jobs are created Use variable expressions to limit which jobs are created
within a pipeline after changes are pushed to GitLab. within a pipeline after changes are pushed to GitLab.
...@@ -652,7 +652,7 @@ Below you can find supported syntax reference: ...@@ -652,7 +652,7 @@ Below you can find supported syntax reference:
Examples: Examples:
- `=~`: True if pattern is matched. Ex: `$VARIABLE =~ /^content.*/` - `=~`: True if pattern is matched. Ex: `$VARIABLE =~ /^content.*/`
- `!~`: True if pattern is not matched. Ex: `$VARIABLE_1 !~ /^content.*/` ([Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/61900) in GitLab 11.11) - `!~`: True if pattern is not matched. Ex: `$VARIABLE_1 !~ /^content.*/` ([Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/61900) in GitLab 11.11)
Variable pattern matching with regular expressions uses the Variable pattern matching with regular expressions uses the
[RE2 regular expression syntax](https://github.com/google/re2/wiki/Syntax). [RE2 regular expression syntax](https://github.com/google/re2/wiki/Syntax).
...@@ -694,7 +694,7 @@ deploy_staging: ...@@ -694,7 +694,7 @@ deploy_staging:
``` ```
NOTE: **Note:** NOTE: **Note:**
The available regular expression syntax is limited. See [related issue](https://gitlab.com/gitlab-org/gitlab/issues/35438) The available regular expression syntax is limited. See [related issue](https://gitlab.com/gitlab-org/gitlab/-/issues/35438)
for more details. for more details.
If needed, you can use a test pipeline to determine whether a regular expression will If needed, you can use a test pipeline to determine whether a regular expression will
......
This diff is collapsed.
...@@ -103,7 +103,7 @@ You can improve the existing built-in templates or contribute new ones in the ...@@ -103,7 +103,7 @@ You can improve the existing built-in templates or contribute new ones in the
#### Custom project templates **(PREMIUM)** #### Custom project templates **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2.
Creating new projects based on custom project templates is a convenient option for Creating new projects based on custom project templates is a convenient option for
quickly starting projects. quickly starting projects.
...@@ -123,7 +123,7 @@ To use a custom project template on the **New project** page: ...@@ -123,7 +123,7 @@ To use a custom project template on the **New project** page:
## Push to create a new project ## Push to create a new project
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/26388) in GitLab 10.5. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/26388) in GitLab 10.5.
When you create a new repository locally, instead of going to GitLab to manually When you create a new repository locally, instead of going to GitLab to manually
create a new project and then [clone the repo](start-using-git.md#clone-a-repository) create a new project and then [clone the repo](start-using-git.md#clone-a-repository)
......
...@@ -620,7 +620,7 @@ Remember to run `sudo gitlab-ctl reconfigure` after saving the changes to the `g ...@@ -620,7 +620,7 @@ Remember to run `sudo gitlab-ctl reconfigure` after saving the changes to the `g
NOTE: **Note:** NOTE: **Note:**
One current feature of GitLab that still requires a shared directory (NFS) is One current feature of GitLab that still requires a shared directory (NFS) is
[GitLab Pages](../../user/project/pages/index.md). [GitLab Pages](../../user/project/pages/index.md).
There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/issues/196) There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/-/issues/196)
to eliminate the need for NFS to support GitLab Pages. to eliminate the need for NFS to support GitLab Pages.
--- ---
...@@ -774,7 +774,7 @@ And the more complex the solution, the more work is involved in setting up and ...@@ -774,7 +774,7 @@ And the more complex the solution, the more work is involved in setting up and
maintaining it. maintaining it.
Have a read through these other resources and feel free to Have a read through these other resources and feel free to
[open an issue](https://gitlab.com/gitlab-org/gitlab/issues/new) [open an issue](https://gitlab.com/gitlab-org/gitlab/-/issues/new)
to request additional material: to request additional material:
- [Scaling GitLab](../../administration/reference_architectures/index.md): - [Scaling GitLab](../../administration/reference_architectures/index.md):
......
...@@ -200,7 +200,7 @@ needs to be installed. ...@@ -200,7 +200,7 @@ needs to be installed.
sudo apt-get install -y graphicsmagick sudo apt-get install -y graphicsmagick
``` ```
**Note:** In order to receive mail notifications, make sure to install a mail server. By default, Debian is shipped with exim4 but this [has problems](https://gitlab.com/gitlab-org/gitlab-foss/issues/12754) while Ubuntu does not ship with one. The recommended mail server is postfix and you can install it with: **Note:** In order to receive mail notifications, make sure to install a mail server. By default, Debian is shipped with exim4 but this [has problems](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/12754) while Ubuntu does not ship with one. The recommended mail server is postfix and you can install it with:
```shell ```shell
sudo apt-get install -y postfix sudo apt-get install -y postfix
...@@ -986,7 +986,7 @@ Using Sidekiq directly will still be supported until 14.0. So if you're experien ...@@ -986,7 +986,7 @@ Using Sidekiq directly will still be supported until 14.0. So if you're experien
1. Edit the system `init.d` script to remove the `SIDEKIQ_WORKERS` flag. If you have `/etc/default/gitlab`, then you should edit it instead. 1. Edit the system `init.d` script to remove the `SIDEKIQ_WORKERS` flag. If you have `/etc/default/gitlab`, then you should edit it instead.
1. Restart GitLab. 1. Restart GitLab.
1. [Create an issue](https://gitlab.com/gitlab-org/gitlab/issues/-/new) describing the problem. 1. [Create an issue](https://gitlab.com/gitlab-org/gitlab/-/issues/-/new) describing the problem.
## Troubleshooting ## Troubleshooting
......
...@@ -35,7 +35,7 @@ Please see the [installation from source guide](installation.md) and the [instal ...@@ -35,7 +35,7 @@ Please see the [installation from source guide](installation.md) and the [instal
### Microsoft Windows ### Microsoft Windows
GitLab is developed for Linux-based operating systems. GitLab is developed for Linux-based operating systems.
It does **not** run on Microsoft Windows, and we have no plans to support it in the near future. For the latest development status view this [issue](https://gitlab.com/gitlab-org/gitlab/issues/22337). It does **not** run on Microsoft Windows, and we have no plans to support it in the near future. For the latest development status view this [issue](https://gitlab.com/gitlab-org/gitlab/-/issues/22337).
Please consider using a virtual machine to run GitLab. Please consider using a virtual machine to run GitLab.
## Software requirements ## Software requirements
...@@ -55,7 +55,7 @@ The minimum required Go version is 1.12. ...@@ -55,7 +55,7 @@ The minimum required Go version is 1.12.
### Git versions ### Git versions
GitLab 11.11 and higher only supports Git 2.21.x and newer, and GitLab 11.11 and higher only supports Git 2.21.x and newer, and
[dropped support for older versions](https://gitlab.com/gitlab-org/gitlab-foss/issues/54255). [dropped support for older versions](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/54255).
### Node.js versions ### Node.js versions
...@@ -284,7 +284,7 @@ For reference, GitLab.com's [auto-scaling shared runner](../user/gitlab_com/inde ...@@ -284,7 +284,7 @@ For reference, GitLab.com's [auto-scaling shared runner](../user/gitlab_com/inde
CAUTION: **Caution:** With GitLab 13.0 (May 2020) we are removing official support for Internet Explorer 11. CAUTION: **Caution:** With GitLab 13.0 (May 2020) we are removing official support for Internet Explorer 11.
With the release of GitLab 13.4 (September 2020) we will remove all code that supports Internet Explorer 11. With the release of GitLab 13.4 (September 2020) we will remove all code that supports Internet Explorer 11.
You can provide feedback [on this issue](https://gitlab.com/gitlab-org/gitlab/issues/197987) or via your usual support channels. You can provide feedback [on this issue](https://gitlab.com/gitlab-org/gitlab/-/issues/197987) or via your usual support channels.
GitLab supports the following web browsers: GitLab supports the following web browsers:
......
...@@ -54,7 +54,7 @@ The way you install the Go indexer depends on your version of GitLab: ...@@ -54,7 +54,7 @@ The way you install the Go indexer depends on your version of GitLab:
### Omnibus GitLab ### Omnibus GitLab
Since GitLab 11.8 the Go indexer is included in Omnibus GitLab. Since GitLab 11.8 the Go indexer is included in Omnibus GitLab.
The former Ruby-based indexer was removed in [GitLab 12.3](https://gitlab.com/gitlab-org/gitlab/issues/6481). The former Ruby-based indexer was removed in [GitLab 12.3](https://gitlab.com/gitlab-org/gitlab/-/issues/6481).
### From source ### From source
...@@ -633,7 +633,7 @@ There is more [low level troubleshooting documentation](../administration/troubl ...@@ -633,7 +633,7 @@ There is more [low level troubleshooting documentation](../administration/troubl
### Known Issues ### Known Issues
- **[Elasticsearch `code_analyzer` doesn't account for all code cases](https://gitlab.com/gitlab-org/gitlab/issues/10693)** - **[Elasticsearch `code_analyzer` doesn't account for all code cases](https://gitlab.com/gitlab-org/gitlab/-/issues/10693)**
The `code_analyzer` pattern and filter configuration is being evaluated for improvement. We have noticed [several edge cases](https://gitlab.com/gitlab-org/gitlab/-/issues/10693#note_158382332) that are not returning expected search results due to our pattern and filter configuration. The `code_analyzer` pattern and filter configuration is being evaluated for improvement. We have noticed [several edge cases](https://gitlab.com/gitlab-org/gitlab/-/issues/10693#note_158382332) that are not returning expected search results due to our pattern and filter configuration.
......
...@@ -21,4 +21,4 @@ In particular, note: ...@@ -21,4 +21,4 @@ In particular, note:
- Emails must be authenticated via DKIM or SPF. - Emails must be authenticated via DKIM or SPF.
- Before sending the final form ("Gmail Schema Whitelist Request"), you must send a real email from your production server. This means that you will have to find a way to send this email from the email address you are registering. You can do this by, for example, forwarding the real email from the email address you are registering or going into the rails console on the GitLab server and triggering the email sending from there. - Before sending the final form ("Gmail Schema Whitelist Request"), you must send a real email from your production server. This means that you will have to find a way to send this email from the email address you are registering. You can do this by, for example, forwarding the real email from the email address you are registering or going into the rails console on the GitLab server and triggering the email sending from there.
You can check how it looks going through all the steps laid out in the "Registering with Google" doc in [this GitLab.com issue](https://gitlab.com/gitlab-org/gitlab-foss/issues/1517). You can check how it looks going through all the steps laid out in the "Registering with Google" doc in [this GitLab.com issue](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/1517).
# GitLab Jira development panel integration **(PREMIUM)** # GitLab Jira development panel integration **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/2381) in [GitLab Premium](https://about.gitlab.com/pricing/) 10.0. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/2381) in [GitLab Premium](https://about.gitlab.com/pricing/) 10.0.
Complementary to our [existing Jira](../user/project/integrations/jira.md) project integration, you're now able to integrate Complementary to our [existing Jira](../user/project/integrations/jira.md) project integration, you're now able to integrate
GitLab projects with [Jira Development Panel](https://confluence.atlassian.com/adminjiraserver070/). Both can be used GitLab projects with [Jira Development Panel](https://confluence.atlassian.com/adminjiraserver070/). Both can be used
...@@ -173,8 +173,8 @@ Click the links to see your GitLab repository data. ...@@ -173,8 +173,8 @@ Click the links to see your GitLab repository data.
### 11.10 ### 11.10
- [Instance admins can now setup integration for all namespaces](https://gitlab.com/gitlab-org/gitlab/issues/8902) - [Instance admins can now setup integration for all namespaces](https://gitlab.com/gitlab-org/gitlab/-/issues/8902)
### 11.1 ### 11.1
- [Support GitLab subgroups in Jira development panel](https://gitlab.com/gitlab-org/gitlab/issues/3561) - [Support GitLab subgroups in Jira development panel](https://gitlab.com/gitlab-org/gitlab/-/issues/3561)
...@@ -7,7 +7,7 @@ type: reference, howto ...@@ -7,7 +7,7 @@ type: reference, howto
# Vault Authentication with GitLab OpenID Connect # Vault Authentication with GitLab OpenID Connect
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/22323) in GitLab 9.0 > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/22323) in GitLab 9.0
[Vault](https://www.vaultproject.io/) is a secrets management application offered by HashiCorp. [Vault](https://www.vaultproject.io/) is a secrets management application offered by HashiCorp.
It allows you to store and manage sensitive information such as secret environment variables, encryption keys, and authentication tokens. It allows you to store and manage sensitive information such as secret environment variables, encryption keys, and authentication tokens.
......
...@@ -33,7 +33,7 @@ NOTE: **Note:** ...@@ -33,7 +33,7 @@ NOTE: **Note:**
From July 2019, the `Internal` visibility setting is disabled for new projects, groups, From July 2019, the `Internal` visibility setting is disabled for new projects, groups,
and snippets on GitLab.com. Existing projects, groups, and snippets using the `Internal` and snippets on GitLab.com. Existing projects, groups, and snippets using the `Internal`
visibility setting keep this setting. You can read more about the change in the visibility setting keep this setting. You can read more about the change in the
[relevant issue](https://gitlab.com/gitlab-org/gitlab/issues/12388). [relevant issue](https://gitlab.com/gitlab-org/gitlab/-/issues/12388).
### Private projects ### Private projects
...@@ -89,7 +89,7 @@ For details, see [Restricted visibility levels](../user/admin_area/settings/visi ...@@ -89,7 +89,7 @@ For details, see [Restricted visibility levels](../user/admin_area/settings/visi
## Reducing visibility ## Reducing visibility
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/33358) in GitLab 12.6. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/33358) in GitLab 12.6.
Reducing a project's visibility level will remove the fork relationship between the project and Reducing a project's visibility level will remove the fork relationship between the project and
any forked project. This is a potentially destructive action which requires confirmation before any forked project. This is a potentially destructive action which requires confirmation before
......
...@@ -95,7 +95,7 @@ GitLab uses [RE2 syntax](https://github.com/google/re2/wiki/Syntax) for regular ...@@ -95,7 +95,7 @@ GitLab uses [RE2 syntax](https://github.com/google/re2/wiki/Syntax) for regular
## Prevent pushing secrets to the repository ## Prevent pushing secrets to the repository
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/385) in [GitLab Starter](https://about.gitlab.com/pricing/) 8.12. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/385) in [GitLab Starter](https://about.gitlab.com/pricing/) 8.12.
Secrets such as credential files, SSH private keys, and other files containing secrets should never be committed to source control. Secrets such as credential files, SSH private keys, and other files containing secrets should never be committed to source control.
GitLab allows you to turn on a predefined blacklist of files which won't be allowed to be GitLab allows you to turn on a predefined blacklist of files which won't be allowed to be
......
...@@ -811,7 +811,7 @@ For GitLab 12.1 and earlier, use `gitlab-rake gitlab:backup:restore`. ...@@ -811,7 +811,7 @@ For GitLab 12.1 and earlier, use `gitlab-rake gitlab:backup:restore`.
CAUTION: **Warning:** CAUTION: **Warning:**
`gitlab-rake gitlab:backup:restore` does not set the right file system permissions on your Registry directory. `gitlab-rake gitlab:backup:restore` does not set the right file system permissions on your Registry directory.
This is a [known issue](https://gitlab.com/gitlab-org/gitlab-foss/issues/62759). On GitLab 12.2 or newer, you can This is a [known issue](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62759). On GitLab 12.2 or newer, you can
use `gitlab-backup restore` to avoid this issue. use `gitlab-backup restore` to avoid this issue.
Next, restore `/etc/gitlab/gitlab-secrets.json` if necessary as mentioned above. Next, restore `/etc/gitlab/gitlab-secrets.json` if necessary as mentioned above.
...@@ -853,7 +853,7 @@ For GitLab 12.1 and earlier, use `gitlab-rake gitlab:backup:restore`. ...@@ -853,7 +853,7 @@ For GitLab 12.1 and earlier, use `gitlab-rake gitlab:backup:restore`.
CAUTION: **Warning:** CAUTION: **Warning:**
`gitlab-rake gitlab:backup:restore` does not set the right file system permissions on your Registry directory. `gitlab-rake gitlab:backup:restore` does not set the right file system permissions on your Registry directory.
This is a [known issue](https://gitlab.com/gitlab-org/gitlab-foss/issues/62759). On GitLab 12.2 or newer, you can This is a [known issue](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62759). On GitLab 12.2 or newer, you can
use `gitlab-backup restore` to avoid this issue. use `gitlab-backup restore` to avoid this issue.
The GitLab Helm chart uses a different process, documented in The GitLab Helm chart uses a different process, documented in
...@@ -1063,7 +1063,7 @@ err.message="unknown error" ...@@ -1063,7 +1063,7 @@ err.message="unknown error"
This is caused by the restore being run as the unprivileged user `git` which was This is caused by the restore being run as the unprivileged user `git` which was
unable to assign the correct ownership to the registry files during the restore unable to assign the correct ownership to the registry files during the restore
([issue 62759](https://gitlab.com/gitlab-org/gitlab-foss/issues/62759 "Incorrect permissions on registry filesystem after restore")). ([issue 62759](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62759 "Incorrect permissions on registry filesystem after restore")).
To get your registry working again: To get your registry working again:
......
...@@ -4,7 +4,7 @@ GitLab provides Rake tasks for cleaning up GitLab instances. ...@@ -4,7 +4,7 @@ GitLab provides Rake tasks for cleaning up GitLab instances.
## Remove unreferenced LFS files from filesystem ## Remove unreferenced LFS files from filesystem
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/36628) in GitLab 12.10. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/36628) in GitLab 12.10.
DANGER: **Danger:** DANGER: **Danger:**
Do not run this within 12 hours of a GitLab upgrade. This is to ensure that all background migrations Do not run this within 12 hours of a GitLab upgrade. This is to ensure that all background migrations
......
...@@ -122,7 +122,7 @@ Bare repositories are **not** importable by GitLab 10.4 and later when all the f ...@@ -122,7 +122,7 @@ Bare repositories are **not** importable by GitLab 10.4 and later when all the f
- Its ancestor namespaces were not renamed or transferred in GitLab 10.4 and later. - Its ancestor namespaces were not renamed or transferred in GitLab 10.4 and later.
There is an [open issue to add a migration to make all bare repositories There is an [open issue to add a migration to make all bare repositories
importable](https://gitlab.com/gitlab-org/gitlab-foss/issues/41776). importable](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41776).
Until then, you may wish to manually migrate repositories yourself. You can use Until then, you may wish to manually migrate repositories yourself. You can use
[Rails console](../administration/troubleshooting/debug.md#starting-a-rails-console-session) [Rails console](../administration/troubleshooting/debug.md#starting-a-rails-console-session)
......
...@@ -122,7 +122,7 @@ The following settings can be configured: ...@@ -122,7 +122,7 @@ The following settings can be configured:
**Installations from source** **Installations from source**
NOTE: **Note:** Rack Attack initializer was temporarily renamed to `rack_attack_new`, to NOTE: **Note:** Rack Attack initializer was temporarily renamed to `rack_attack_new`, to
support backwards compatibility with the one [Omnibus initializer](https://docs.gitlab.com/omnibus/settings/configuration.html#setting-up-paths-to-be-protected-by-rack-attack). It'll be renamed back to `rack_attack.rb` once Omnibus throttle is removed. Please see the [GitLab issue](https://gitlab.com/gitlab-org/gitlab/issues/29952) for more information. support backwards compatibility with the one [Omnibus initializer](https://docs.gitlab.com/omnibus/settings/configuration.html#setting-up-paths-to-be-protected-by-rack-attack). It'll be renamed back to `rack_attack.rb` once Omnibus throttle is removed. Please see the [GitLab issue](https://gitlab.com/gitlab-org/gitlab/-/issues/29952) for more information.
These settings can be found in `config/initializers/rack_attack.rb`. If you are These settings can be found in `config/initializers/rack_attack.rb`. If you are
missing `config/initializers/rack_attack.rb`, the following steps need to be missing `config/initializers/rack_attack.rb`, the following steps need to be
......
...@@ -54,7 +54,7 @@ set up by administrators. However, you can turn this off by disabling the ...@@ -54,7 +54,7 @@ set up by administrators. However, you can turn this off by disabling the
## Whitelist for local requests ## Whitelist for local requests
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/44496) in GitLab 12.2 > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/44496) in GitLab 12.2
You can allow certain domains and IP addresses to be accessible to both *system hooks* You can allow certain domains and IP addresses to be accessible to both *system hooks*
and *webhooks* even when local requests are not allowed by adding them to the and *webhooks* even when local requests are not allowed by adding them to the
......
...@@ -440,7 +440,7 @@ The new subscription tier is active when the license file is uploaded. ...@@ -440,7 +440,7 @@ The new subscription tier is active when the license file is uploaded.
## Subscription expiry ## Subscription expiry
When your subscription or trial expires, GitLab does not delete your data, but it may become inaccessible, depending on the tier at expiry. Some features may not behave as expected if you're not prepared for the expiry. For example, [environment specific variables not being passed](https://gitlab.com/gitlab-org/gitlab/issues/24759). When your subscription or trial expires, GitLab does not delete your data, but it may become inaccessible, depending on the tier at expiry. Some features may not behave as expected if you're not prepared for the expiry. For example, [environment specific variables not being passed](https://gitlab.com/gitlab-org/gitlab/-/issues/24759).
If you renew or upgrade, your data will again be accessible. If you renew or upgrade, your data will again be accessible.
...@@ -508,7 +508,7 @@ Be aware that: ...@@ -508,7 +508,7 @@ Be aware that:
## Contact Support ## Contact Support
We also encourage all users to search our project trackers for known issues and We also encourage all users to search our project trackers for known issues and
existing feature requests in the [GitLab](https://gitlab.com/gitlab-org/gitlab/issues/) project. existing feature requests in the [GitLab](https://gitlab.com/gitlab-org/gitlab/-/issues/) project.
These issues are the best avenue for getting updates on specific product plans These issues are the best avenue for getting updates on specific product plans
and for communicating directly with the relevant GitLab team members. and for communicating directly with the relevant GitLab team members.
......
...@@ -296,7 +296,7 @@ If the user is blocked via LDAP, `state` will be `ldap_blocked`. ...@@ -296,7 +296,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/issues/20011>. `owner_name` and `owner_email` are always `null`. Please see <https://gitlab.com/gitlab-org/gitlab/-/issues/20011>.
**Group removed:** **Group removed:**
...@@ -313,7 +313,7 @@ If the user is blocked via LDAP, `state` will be `ldap_blocked`. ...@@ -313,7 +313,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/issues/20011>. `owner_name` and `owner_email` are always `null`. Please see <https://gitlab.com/gitlab-org/gitlab/-/issues/20011>.
**Group renamed:** **Group renamed:**
...@@ -333,7 +333,7 @@ If the user is blocked via LDAP, `state` will be `ldap_blocked`. ...@@ -333,7 +333,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/issues/20011>. `owner_name` and `owner_email` are always `null`. Please see <https://gitlab.com/gitlab-org/gitlab/-/issues/20011>.
**New Group Member:** **New Group Member:**
......
...@@ -74,7 +74,7 @@ persisted in your image. See ...@@ -74,7 +74,7 @@ persisted in your image. See
## Passing secrets to `docker build` ## Passing secrets to `docker build`
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/25514) in GitLab 12.3, but available in versions 11.9 and above. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/25514) in GitLab 12.3, but available in versions 11.9 and above.
CI environment variables can be passed as CI environment variables can be passed as
[build secrets](https://docs.docker.com/develop/develop-images/build_enhancements/#new-docker-build-secret-information) to the `docker build` command by listing them [build secrets](https://docs.docker.com/develop/develop-images/build_enhancements/#new-docker-build-secret-information) to the `docker build` command by listing them
...@@ -128,7 +128,7 @@ repository or by specifying a project variable: ...@@ -128,7 +128,7 @@ repository or by specifying a project variable:
## Customize values for Helm Chart ## Customize values for Helm Chart
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/30628) in GitLab 12.6, `.gitlab/auto-deploy-values.yaml` will be used by default for Helm upgrades. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/30628) in GitLab 12.6, `.gitlab/auto-deploy-values.yaml` will be used by default for Helm upgrades.
You can override the default values in the `values.yaml` file in the You can override the default values in the `values.yaml` file in the
[default Helm chart](https://gitlab.com/gitlab-org/charts/auto-deploy-app) by either: [default Helm chart](https://gitlab.com/gitlab-org/charts/auto-deploy-app) by either:
...@@ -175,7 +175,7 @@ into your project and edit it as needed. ...@@ -175,7 +175,7 @@ into your project and edit it as needed.
## Customizing the Kubernetes namespace ## Customizing the Kubernetes namespace
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/27630) in GitLab 12.6. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/27630) in GitLab 12.6.
For clusters not managed by GitLab, you can customize the namespace in For clusters not managed by GitLab, you can customize the namespace in
`.gitlab-ci.yml` by specifying `.gitlab-ci.yml` by specifying
...@@ -368,7 +368,7 @@ The following table lists variables used to disable jobs. ...@@ -368,7 +368,7 @@ The following table lists variables used to disable jobs.
### Application secret variables ### Application secret variables
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/49056) in GitLab 11.7. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/49056) in GitLab 11.7.
Some applications need to define secret variables that are accessible by the deployed Some applications need to define secret variables that are accessible by the deployed
application. Auto DevOps detects variables starting with `K8S_SECRET_`, and makes application. Auto DevOps detects variables starting with `K8S_SECRET_`, and makes
...@@ -506,7 +506,7 @@ If you define `CANARY_ENABLED` in your project, such as setting `CANARY_ENABLED` ...@@ -506,7 +506,7 @@ If you define `CANARY_ENABLED` in your project, such as setting `CANARY_ENABLED`
### Incremental rollout to production **(PREMIUM)** ### Incremental rollout to production **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/5415) in GitLab 10.8. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/5415) in GitLab 10.8.
TIP: **Tip:** TIP: **Tip:**
You can also set this inside your [project's settings](index.md#deployment-strategy). You can also set this inside your [project's settings](index.md#deployment-strategy).
...@@ -563,7 +563,7 @@ removed in the future. ...@@ -563,7 +563,7 @@ removed in the future.
### Timed incremental rollout to production **(PREMIUM)** ### Timed incremental rollout to production **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/7545) in GitLab 11.4. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7545) in GitLab 11.4.
TIP: **Tip:** TIP: **Tip:**
You can also set this inside your [project's settings](index.md#deployment-strategy). You can also set this inside your [project's settings](index.md#deployment-strategy).
......
# Auto DevOps # Auto DevOps
> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/37115) in GitLab 10.0. > - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/37115) in GitLab 10.0.
> - Generally available on GitLab 11.0. > - Generally available on GitLab 11.0.
Auto DevOps provides pre-defined CI/CD configuration allowing you to automatically Auto DevOps provides pre-defined CI/CD configuration allowing you to automatically
...@@ -27,7 +27,7 @@ For an introduction to Auto DevOps, watch [AutoDevOps in GitLab 11.0](https://yo ...@@ -27,7 +27,7 @@ For an introduction to Auto DevOps, watch [AutoDevOps in GitLab 11.0](https://yo
## Enabled by default ## Enabled by default
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/41729) in GitLab 11.3. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41729) in GitLab 11.3.
Auto DevOps is enabled by default for all projects and attempts to run on all pipelines Auto DevOps is enabled by default for all projects and attempts to run on all pipelines
in each project. An instance administrator can enable or disable this default in the in each project. An instance administrator can enable or disable this default in the
...@@ -35,7 +35,7 @@ in each project. An instance administrator can enable or disable this default in ...@@ -35,7 +35,7 @@ in each project. An instance administrator can enable or disable this default in
Auto DevOps automatically disables in individual projects on their first pipeline failure, Auto DevOps automatically disables in individual projects on their first pipeline failure,
if it has not been explicitly enabled for the project. if it has not been explicitly enabled for the project.
Since [GitLab 12.7](https://gitlab.com/gitlab-org/gitlab/issues/26655), Auto DevOps Since [GitLab 12.7](https://gitlab.com/gitlab-org/gitlab/-/issues/26655), Auto DevOps
runs on pipelines automatically only if a [`Dockerfile` or matching buildpack](stages.md#auto-build) runs on pipelines automatically only if a [`Dockerfile` or matching buildpack](stages.md#auto-build)
exists. exists.
...@@ -256,9 +256,9 @@ the URL endpoint should be automatically configured for you. All you must do ...@@ -256,9 +256,9 @@ the URL endpoint should be automatically configured for you. All you must do
is use its value for the `KUBE_INGRESS_BASE_DOMAIN` variable. is use its value for the `KUBE_INGRESS_BASE_DOMAIN` variable.
NOTE: **Note:** NOTE: **Note:**
`AUTO_DEVOPS_DOMAIN` was [deprecated in GitLab 11.8](https://gitlab.com/gitlab-org/gitlab-foss/issues/52363) `AUTO_DEVOPS_DOMAIN` was [deprecated in GitLab 11.8](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/52363)
and replaced with `KUBE_INGRESS_BASE_DOMAIN`, and removed in and replaced with `KUBE_INGRESS_BASE_DOMAIN`, and removed in
[GitLab 12.0](https://gitlab.com/gitlab-org/gitlab-foss/issues/56959). [GitLab 12.0](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/56959).
Auto DevOps requires a wildcard DNS A record matching the base domain(s). For Auto DevOps requires a wildcard DNS A record matching the base domain(s). For
a base domain of `example.com`, you'd need a DNS entry like: a base domain of `example.com`, you'd need a DNS entry like:
...@@ -305,7 +305,7 @@ After enabling the feature, an Auto DevOps pipeline is triggered on the default ...@@ -305,7 +305,7 @@ After enabling the feature, an Auto DevOps pipeline is triggered on the default
### At the group level ### At the group level
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/52447) in GitLab 11.10. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/52447) in GitLab 11.10.
Only administrators and group owners can enable or disable Auto DevOps at the group level. Only administrators and group owners can enable or disable Auto DevOps at the group level.
...@@ -342,7 +342,7 @@ Feature.get(:force_autodevops_on_by_default).enable_percentage_of_actors(10) ...@@ -342,7 +342,7 @@ Feature.get(:force_autodevops_on_by_default).enable_percentage_of_actors(10)
### Deployment strategy ### Deployment strategy
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/38542) in GitLab 11.0. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/38542) in GitLab 11.0.
You can change the deployment strategy used by Auto DevOps by going to your You can change the deployment strategy used by Auto DevOps by going to your
project's **{settings}** **Settings > CI/CD > Auto DevOps**. The following options project's **{settings}** **Settings > CI/CD > Auto DevOps**. The following options
......
...@@ -102,7 +102,7 @@ To remove objects from LFS: ...@@ -102,7 +102,7 @@ To remove objects from LFS:
## File Locking ## File Locking
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/35856) in GitLab 10.5. > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/35856) in GitLab 10.5.
The first thing to do before using File Locking is to tell Git LFS which The first thing to do before using File Locking is to tell Git LFS which
kind of files are lockable. The following command will store PNG files kind of files are lockable. The following command will store PNG files
......
# Migration guide from Git Annex to Git LFS # Migration guide from Git Annex to Git LFS
>**Note:** >**Note:**
Git Annex support [has been removed](https://gitlab.com/gitlab-org/gitlab/issues/1648) in GitLab Enterprise Git Annex support [has been removed](https://gitlab.com/gitlab-org/gitlab/-/issues/1648) in GitLab Enterprise
Edition 9.0 (2017/03/22). Edition 9.0 (2017/03/22).
Both [Git Annex](http://git-annex.branchable.com/) and [Git LFS](https://git-lfs.github.com/) are tools to manage large files in Git. Both [Git Annex](http://git-annex.branchable.com/) and [Git LFS](https://git-lfs.github.com/) are tools to manage large files in Git.
......
...@@ -11,7 +11,7 @@ If you're looking for a GitLab subscription for _your university_, see our [GitL ...@@ -11,7 +11,7 @@ If you're looking for a GitLab subscription for _your university_, see our [GitL
CAUTION: **Caution:** CAUTION: **Caution:**
Some of the content in GitLab University may be out of date and we plan to Some of the content in GitLab University may be out of date and we plan to
[evaluate](https://gitlab.com/gitlab-org/gitlab-foss/issues/41064) it. [evaluate](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41064) it.
The GitLab University curriculum is composed of GitLab videos, screencasts, presentations, projects and external GitLab content hosted on other services and has been organized into the following sections: The GitLab University curriculum is composed of GitLab videos, screencasts, presentations, projects and external GitLab content hosted on other services and has been organized into the following sections:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment