Commit 69a3e091 authored by Marcel Amirault's avatar Marcel Amirault

Change codeblock fence languages to full name

Make sure change codeblock fence languages from text
to plaintext, yml to yaml
parent 204d3d33
...@@ -37,7 +37,7 @@ To use a smartcard with an X.509 certificate to authenticate against a local ...@@ -37,7 +37,7 @@ To use a smartcard with an X.509 certificate to authenticate against a local
database with GitLab, `CN` and `emailAddress` must be defined in the database with GitLab, `CN` and `emailAddress` must be defined in the
certificate. For example: certificate. For example:
```text ```plaintext
Certificate: Certificate:
Data: Data:
Version: 1 (0x0) Version: 1 (0x0)
...@@ -73,7 +73,7 @@ database with GitLab, in: ...@@ -73,7 +73,7 @@ database with GitLab, in:
For example: For example:
```text ```plaintext
Certificate: Certificate:
Data: Data:
Version: 1 (0x0) Version: 1 (0x0)
......
...@@ -149,7 +149,7 @@ before and after. If the hit ratio does not improve, the higher limit is ...@@ -149,7 +149,7 @@ before and after. If the hit ratio does not improve, the higher limit is
probably not making a meaningful difference. Here is an example probably not making a meaningful difference. Here is an example
Prometheus query to see the hit rate: Prometheus query to see the hit rate:
```text ```plaintext
sum(rate(gitaly_catfile_cache_total{type="hit"}[5m])) / sum(rate(gitaly_catfile_cache_total{type=~"(hit)|(miss)"}[5m])) sum(rate(gitaly_catfile_cache_total{type="hit"}[5m])) / sum(rate(gitaly_catfile_cache_total{type=~"(hit)|(miss)"}[5m]))
``` ```
......
...@@ -36,7 +36,7 @@ apt-get install nfs-kernel-server ...@@ -36,7 +36,7 @@ apt-get install nfs-kernel-server
In this setup we will share the home directory on the host with the client. Edit the exports file as below to share the host's home directory with the client. If you have multiple clients running GitLab you must enter the client IP addresses in line in the `/etc/exports` file. In this setup we will share the home directory on the host with the client. Edit the exports file as below to share the host's home directory with the client. If you have multiple clients running GitLab you must enter the client IP addresses in line in the `/etc/exports` file.
```text ```plaintext
#/etc/exports for one client #/etc/exports for one client
/home <client-ip-address>(rw,sync,no_root_squash,no_subtree_check) /home <client-ip-address>(rw,sync,no_root_squash,no_subtree_check)
...@@ -96,7 +96,7 @@ NFS version 4. NFSv3 also supports locking as long as Linux Kernel 2.6.5+ is use ...@@ -96,7 +96,7 @@ NFS version 4. NFSv3 also supports locking as long as Linux Kernel 2.6.5+ is use
We recommend using version 4 and do not specifically test NFSv3. We recommend using version 4 and do not specifically test NFSv3.
See [NFS documentation](nfs.md#nfs-client-mount-options) for guidance on mount options. See [NFS documentation](nfs.md#nfs-client-mount-options) for guidance on mount options.
```text ```plaintext
#/etc/fstab #/etc/fstab
10.0.0.1:/nfs/home /nfs/home nfs4 defaults,hard,vers=4.1,rsize=1048576,wsize=1048576,noatime,nofail,lookupcache=positive 0 2 10.0.0.1:/nfs/home /nfs/home nfs4 defaults,hard,vers=4.1,rsize=1048576,wsize=1048576,noatime,nofail,lookupcache=positive 0 2
``` ```
...@@ -111,7 +111,7 @@ default file locations in `gitlab.rb` on the client allows you to have one main ...@@ -111,7 +111,7 @@ default file locations in `gitlab.rb` on the client allows you to have one main
point and have all the required locations as subdirectories to use the NFS mount for point and have all the required locations as subdirectories to use the NFS mount for
`git-data`. `git-data`.
```text ```plaintext
git_data_dirs({"default" => {"path" => "/nfs/home/var/opt/gitlab-data/git-data"}}) git_data_dirs({"default" => {"path" => "/nfs/home/var/opt/gitlab-data/git-data"}})
gitlab_rails['uploads_directory'] = '/nfs/home/var/opt/gitlab-data/uploads' gitlab_rails['uploads_directory'] = '/nfs/home/var/opt/gitlab-data/uploads'
gitlab_rails['shared_path'] = '/nfs/home/var/opt/gitlab-data/shared' gitlab_rails['shared_path'] = '/nfs/home/var/opt/gitlab-data/shared'
......
...@@ -70,7 +70,7 @@ sudo service tomcat8 restart ...@@ -70,7 +70,7 @@ sudo service tomcat8 restart
Once the Tomcat service restarts the PlantUML service will be ready and Once the Tomcat service restarts the PlantUML service will be ready and
listening for requests on port 8080: listening for requests on port 8080:
```text ```plaintext
http://localhost:8080/plantuml http://localhost:8080/plantuml
``` ```
...@@ -144,7 +144,7 @@ our AsciiDoc snippets, wikis, and repositories using delimited blocks: ...@@ -144,7 +144,7 @@ our AsciiDoc snippets, wikis, and repositories using delimited blocks:
- **AsciiDoc** - **AsciiDoc**
```text ```plaintext
[plantuml, format="png", id="myDiagram", width="200px"] [plantuml, format="png", id="myDiagram", width="200px"]
---- ----
Bob->Alice : hello Bob->Alice : hello
...@@ -154,7 +154,7 @@ our AsciiDoc snippets, wikis, and repositories using delimited blocks: ...@@ -154,7 +154,7 @@ our AsciiDoc snippets, wikis, and repositories using delimited blocks:
- **reStructuredText** - **reStructuredText**
```text ```plaintext
.. plantuml:: .. plantuml::
:caption: Caption with **bold** and *italic* :caption: Caption with **bold** and *italic*
......
...@@ -19,7 +19,7 @@ the configuration options as follows: ...@@ -19,7 +19,7 @@ the configuration options as follows:
### For HTTP ### For HTTP
```yml ```yaml
gravatar: gravatar:
enabled: true enabled: true
# gravatar URLs: possible placeholders: %{hash} %{size} %{email} %{username} # gravatar URLs: possible placeholders: %{hash} %{size} %{email} %{username}
...@@ -28,7 +28,7 @@ the configuration options as follows: ...@@ -28,7 +28,7 @@ the configuration options as follows:
### For HTTPS ### For HTTPS
```yml ```yaml
gravatar: gravatar:
enabled: true enabled: true
# gravatar URLs: possible placeholders: %{hash} %{size} %{email} %{username} # gravatar URLs: possible placeholders: %{hash} %{size} %{email} %{username}
......
...@@ -74,7 +74,7 @@ project creation to fail with the following error (which appears in the log file ...@@ -74,7 +74,7 @@ project creation to fail with the following error (which appears in the log file
when the first admin user is an when the first admin user is an
[external user](../../../user/permissions.md#external-users-core-only): [external user](../../../user/permissions.md#external-users-core-only):
```text ```plaintext
Could not create instance administrators group. Errors: ["You don’t have permission to create groups."] Could not create instance administrators group. Errors: ["You don’t have permission to create groups."]
``` ```
......
...@@ -460,7 +460,7 @@ However, this behavior is undesirable for registries used by internal hosts that ...@@ -460,7 +460,7 @@ However, this behavior is undesirable for registries used by internal hosts that
1. Add the `redirect` flag to your registry configuration YML file: 1. Add the `redirect` flag to your registry configuration YML file:
```yml ```yaml
storage: storage:
s3: s3:
accesskey: 'AKIAKIAKI' accesskey: 'AKIAKIAKI'
......
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
The global time zone configuration parameter can be changed in `config/gitlab.yml`: The global time zone configuration parameter can be changed in `config/gitlab.yml`:
```text ```plaintext
# time_zone: 'UTC' # time_zone: 'UTC'
``` ```
......
...@@ -16,7 +16,7 @@ Create an application by posting a JSON payload. ...@@ -16,7 +16,7 @@ Create an application by posting a JSON payload.
Returns `200` if the request succeeds. Returns `200` if the request succeeds.
```text ```plaintext
POST /applications POST /applications
``` ```
...@@ -52,7 +52,7 @@ Example response: ...@@ -52,7 +52,7 @@ Example response:
List all registered applications. List all registered applications.
```text ```plaintext
GET /applications GET /applications
``` ```
...@@ -85,7 +85,7 @@ Delete a specific application. ...@@ -85,7 +85,7 @@ Delete a specific application.
Returns `204` if the request succeeds. Returns `204` if the request succeeds.
```text ```plaintext
DELETE /applications/:id DELETE /applications/:id
``` ```
......
...@@ -15,7 +15,7 @@ If: ...@@ -15,7 +15,7 @@ If:
NOTE: **Note:** NOTE: **Note:**
This endpoint can be accessed without authentication. This endpoint can be accessed without authentication.
```text ```plaintext
GET /avatar?email=admin@example.com GET /avatar?email=admin@example.com
``` ```
......
...@@ -20,7 +20,7 @@ See [Award Emoji on Comments](#award-emoji-on-comments) for information on using ...@@ -20,7 +20,7 @@ See [Award Emoji on Comments](#award-emoji-on-comments) for information on using
Get a list of all award emoji for a specified awardable. Get a list of all award emoji for a specified awardable.
```text ```plaintext
GET /projects/:id/issues/:issue_iid/award_emoji GET /projects/:id/issues/:issue_iid/award_emoji
GET /projects/:id/merge_requests/:merge_request_iid/award_emoji GET /projects/:id/merge_requests/:merge_request_iid/award_emoji
GET /projects/:id/snippets/:snippet_id/award_emoji GET /projects/:id/snippets/:snippet_id/award_emoji
...@@ -82,7 +82,7 @@ Example response: ...@@ -82,7 +82,7 @@ Example response:
Get a single award emoji from an issue, snippet, or merge request. Get a single award emoji from an issue, snippet, or merge request.
```text ```plaintext
GET /projects/:id/issues/:issue_iid/award_emoji/:award_id GET /projects/:id/issues/:issue_iid/award_emoji/:award_id
GET /projects/:id/merge_requests/:merge_request_iid/award_emoji/:award_id GET /projects/:id/merge_requests/:merge_request_iid/award_emoji/:award_id
GET /projects/:id/snippets/:snippet_id/award_emoji/:award_id GET /projects/:id/snippets/:snippet_id/award_emoji/:award_id
...@@ -127,7 +127,7 @@ Example response: ...@@ -127,7 +127,7 @@ Example response:
Create an award emoji on the specified awardable. Create an award emoji on the specified awardable.
```text ```plaintext
POST /projects/:id/issues/:issue_iid/award_emoji POST /projects/:id/issues/:issue_iid/award_emoji
POST /projects/:id/merge_requests/:merge_request_iid/award_emoji POST /projects/:id/merge_requests/:merge_request_iid/award_emoji
POST /projects/:id/snippets/:snippet_id/award_emoji POST /projects/:id/snippets/:snippet_id/award_emoji
...@@ -173,7 +173,7 @@ Sometimes it's just not meant to be and you'll have to remove the award. ...@@ -173,7 +173,7 @@ Sometimes it's just not meant to be and you'll have to remove the award.
NOTE: **Note:** NOTE: **Note:**
Only available to administrators or the author of the award. Only available to administrators or the author of the award.
```text ```plaintext
DELETE /projects/:id/issues/:issue_iid/award_emoji/:award_id DELETE /projects/:id/issues/:issue_iid/award_emoji/:award_id
DELETE /projects/:id/merge_requests/:merge_request_iid/award_emoji/:award_id DELETE /projects/:id/merge_requests/:merge_request_iid/award_emoji/:award_id
DELETE /projects/:id/snippets/:snippet_id/award_emoji/:award_id DELETE /projects/:id/snippets/:snippet_id/award_emoji/:award_id
...@@ -204,7 +204,7 @@ easily adapted for comments on a merge request or on a snippet. Therefore, you h ...@@ -204,7 +204,7 @@ easily adapted for comments on a merge request or on a snippet. Therefore, you h
Get all award emoji for a comment (note). Get all award emoji for a comment (note).
```text ```plaintext
GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji
``` ```
...@@ -249,7 +249,7 @@ Example response: ...@@ -249,7 +249,7 @@ Example response:
Get a single award emoji for a comment (note). Get a single award emoji for a comment (note).
```text ```plaintext
GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id
``` ```
...@@ -293,7 +293,7 @@ Example response: ...@@ -293,7 +293,7 @@ Example response:
Create an award emoji on the specified comment (note). Create an award emoji on the specified comment (note).
```text ```plaintext
POST /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji POST /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji
``` ```
...@@ -340,7 +340,7 @@ Sometimes it's just not meant to be and you'll have to remove the award. ...@@ -340,7 +340,7 @@ Sometimes it's just not meant to be and you'll have to remove the award.
NOTE: **Note:** NOTE: **Note:**
Only available to administrators or the author of the award. Only available to administrators or the author of the award.
```text ```plaintext
DELETE /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id DELETE /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id
``` ```
......
...@@ -12,7 +12,7 @@ Get a list of repository branches from a project, sorted by name alphabetically. ...@@ -12,7 +12,7 @@ Get a list of repository branches from a project, sorted by name alphabetically.
NOTE: **Note:** NOTE: **Note:**
This endpoint can be accessed without authentication if the repository is publicly accessible. This endpoint can be accessed without authentication if the repository is publicly accessible.
```text ```plaintext
GET /projects/:id/repository/branches GET /projects/:id/repository/branches
``` ```
...@@ -69,7 +69,7 @@ Get a single project repository branch. ...@@ -69,7 +69,7 @@ Get a single project repository branch.
NOTE: **Note:** NOTE: **Note:**
This endpoint can be accessed without authentication if the repository is publicly accessible. This endpoint can be accessed without authentication if the repository is publicly accessible.
```text ```plaintext
GET /projects/:id/repository/branches/:branch GET /projects/:id/repository/branches/:branch
``` ```
...@@ -130,7 +130,7 @@ for information on unprotecting repository branches. ...@@ -130,7 +130,7 @@ for information on unprotecting repository branches.
Create a new branch in the repository. Create a new branch in the repository.
```text ```plaintext
POST /projects/:id/repository/branches POST /projects/:id/repository/branches
``` ```
...@@ -185,7 +185,7 @@ Delete a branch from the repository. ...@@ -185,7 +185,7 @@ Delete a branch from the repository.
NOTE: **Note:** NOTE: **Note:**
In the case of an error, an explanation message is provided. In the case of an error, an explanation message is provided.
```text ```plaintext
DELETE /projects/:id/repository/branches/:branch DELETE /projects/:id/repository/branches/:branch
``` ```
...@@ -209,7 +209,7 @@ Will delete all branches that are merged into the project's default branch. ...@@ -209,7 +209,7 @@ Will delete all branches that are merged into the project's default branch.
NOTE: **Note:** NOTE: **Note:**
[Protected branches](../user/project/protected_branches.md) will not be deleted as part of this operation. [Protected branches](../user/project/protected_branches.md) will not be deleted as part of this operation.
```text ```plaintext
DELETE /projects/:id/repository/merged_branches DELETE /projects/:id/repository/merged_branches
``` ```
......
...@@ -13,7 +13,7 @@ As of GitLab 12.8, GET requests do not require authentication. All other broadca ...@@ -13,7 +13,7 @@ As of GitLab 12.8, GET requests do not require authentication. All other broadca
List all broadcast messages. List all broadcast messages.
```text ```plaintext
GET /broadcast_messages GET /broadcast_messages
``` ```
...@@ -46,7 +46,7 @@ Example response: ...@@ -46,7 +46,7 @@ Example response:
Get a specific broadcast message. Get a specific broadcast message.
```text ```plaintext
GET /broadcast_messages/:id GET /broadcast_messages/:id
``` ```
...@@ -83,7 +83,7 @@ Example response: ...@@ -83,7 +83,7 @@ Example response:
Create a new broadcast message. Create a new broadcast message.
```text ```plaintext
POST /broadcast_messages POST /broadcast_messages
``` ```
...@@ -127,7 +127,7 @@ Example response: ...@@ -127,7 +127,7 @@ Example response:
Update an existing broadcast message. Update an existing broadcast message.
```text ```plaintext
PUT /broadcast_messages/:id PUT /broadcast_messages/:id
``` ```
......
...@@ -41,7 +41,7 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab ...@@ -41,7 +41,7 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab
Download the finished export. Download the finished export.
```text ```plaintext
GET /groups/:id/export/download GET /groups/:id/export/download
``` ```
...@@ -66,7 +66,7 @@ returns either: ...@@ -66,7 +66,7 @@ returns either:
## Import a file ## Import a file
```text ```plaintext
POST /groups/import POST /groups/import
``` ```
......
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
Get SSH key with user by ID of an SSH key. Note only administrators can lookup SSH key with user by ID of an SSH key. Get SSH key with user by ID of an SSH key. Note only administrators can lookup SSH key with user by ID of an SSH key.
```text ```plaintext
GET /keys/:id GET /keys/:id
``` ```
...@@ -63,7 +63,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" 'https://gitlab.example.com/a ...@@ -63,7 +63,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" 'https://gitlab.example.com/a
You can search for a user that owns a specific SSH key. Note only administrators can lookup SSH key with the fingerprint of an SSH key. You can search for a user that owns a specific SSH key. Note only administrators can lookup SSH key with the fingerprint of an SSH key.
```text ```plaintext
GET /keys GET /keys
``` ```
......
...@@ -8,7 +8,7 @@ The GitLab Pages feature must be enabled to use these endpoints. Find out more a ...@@ -8,7 +8,7 @@ The GitLab Pages feature must be enabled to use these endpoints. Find out more a
Remove pages. The user must have admin privileges. Remove pages. The user must have admin privileges.
```text ```plaintext
DELETE /projects/:id/pages DELETE /projects/:id/pages
``` ```
......
...@@ -8,7 +8,7 @@ The GitLab Pages feature must be enabled to use these endpoints. Find out more a ...@@ -8,7 +8,7 @@ The GitLab Pages feature must be enabled to use these endpoints. Find out more a
Get a list of all pages domains. The user must have admin permissions. Get a list of all pages domains. The user must have admin permissions.
```text ```plaintext
GET /pages/domains GET /pages/domains
``` ```
...@@ -35,7 +35,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap ...@@ -35,7 +35,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap
Get a list of project pages domains. The user must have permissions to view pages domains. Get a list of project pages domains. The user must have permissions to view pages domains.
```text ```plaintext
GET /projects/:id/pages/domains GET /projects/:id/pages/domains
``` ```
...@@ -71,7 +71,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap ...@@ -71,7 +71,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap
Get a single project pages domain. The user must have permissions to view pages domains. Get a single project pages domain. The user must have permissions to view pages domains.
```text ```plaintext
GET /projects/:id/pages/domains/:domain GET /projects/:id/pages/domains/:domain
``` ```
...@@ -113,7 +113,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap ...@@ -113,7 +113,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap
Creates a new pages domain. The user must have permissions to create new pages domains. Creates a new pages domain. The user must have permissions to create new pages domains.
```text ```plaintext
POST /projects/:id/pages/domains POST /projects/:id/pages/domains
``` ```
...@@ -155,7 +155,7 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form "domain ...@@ -155,7 +155,7 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form "domain
Updates an existing project pages domain. The user must have permissions to change an existing pages domains. Updates an existing project pages domain. The user must have permissions to change an existing pages domains.
```text ```plaintext
PUT /projects/:id/pages/domains/:domain PUT /projects/:id/pages/domains/:domain
``` ```
...@@ -225,7 +225,7 @@ curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" --form "certifi ...@@ -225,7 +225,7 @@ curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" --form "certifi
Deletes an existing project pages domain. Deletes an existing project pages domain.
```text ```plaintext
DELETE /projects/:id/pages/domains/:domain DELETE /projects/:id/pages/domains/:domain
``` ```
......
...@@ -286,7 +286,7 @@ curl --request DELETE --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" "https://gi ...@@ -286,7 +286,7 @@ curl --request DELETE --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" "https://gi
Trigger a new scheduled pipeline, which runs immediately. The next scheduled run Trigger a new scheduled pipeline, which runs immediately. The next scheduled run
of this pipeline is not affected. of this pipeline is not affected.
```text ```plaintext
POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/play POST /projects/:id/pipeline_schedules/:pipeline_schedule_id/play
``` ```
......
...@@ -18,7 +18,7 @@ data file uploads to the final server. ...@@ -18,7 +18,7 @@ data file uploads to the final server.
From GitLab 10.7, the `upload[url]` parameter is required if the `upload` parameter is present. From GitLab 10.7, the `upload[url]` parameter is required if the `upload` parameter is present.
```text ```plaintext
POST /projects/:id/export POST /projects/:id/export
``` ```
...@@ -49,7 +49,7 @@ The upload request will be sent with `Content-Type: application/gzip` header. En ...@@ -49,7 +49,7 @@ The upload request will be sent with `Content-Type: application/gzip` header. En
Get the status of export. Get the status of export.
```text ```plaintext
GET /projects/:id/export GET /projects/:id/export
``` ```
...@@ -102,7 +102,7 @@ an email notifying the user to download the file, uploading the exported file to ...@@ -102,7 +102,7 @@ an email notifying the user to download the file, uploading the exported file to
Download the finished export. Download the finished export.
```text ```plaintext
GET /projects/:id/export/download GET /projects/:id/export/download
``` ```
...@@ -121,7 +121,7 @@ ls *export.tar.gz ...@@ -121,7 +121,7 @@ ls *export.tar.gz
## Import a file ## Import a file
```text ```plaintext
POST /projects/import POST /projects/import
``` ```
...@@ -185,7 +185,7 @@ requests.post(url, headers=headers, data=data, files=files) ...@@ -185,7 +185,7 @@ requests.post(url, headers=headers, data=data, files=files)
Get the status of an import. Get the status of an import.
```text ```plaintext
GET /projects/:id/import GET /projects/:id/import
``` ```
......
...@@ -6,7 +6,7 @@ Project repository storage can be moved. To retrieve project repository storage ...@@ -6,7 +6,7 @@ Project repository storage can be moved. To retrieve project repository storage
## Retrieve all project repository storage moves ## Retrieve all project repository storage moves
```text ```plaintext
GET /project_repository_storage_moves GET /project_repository_storage_moves
``` ```
...@@ -43,7 +43,7 @@ Example response: ...@@ -43,7 +43,7 @@ Example response:
## Get a single project repository storage move ## Get a single project repository storage move
```text ```plaintext
GET /project_repository_storage_moves/:id GET /project_repository_storage_moves/:id
``` ```
......
...@@ -11,7 +11,7 @@ outlined below. ...@@ -11,7 +11,7 @@ outlined below.
Returns an Array of remote mirrors and their statuses: Returns an Array of remote mirrors and their statuses:
```text ```plaintext
GET /projects/:id/remote_mirrors GET /projects/:id/remote_mirrors
``` ```
...@@ -50,7 +50,7 @@ and password information. ...@@ -50,7 +50,7 @@ and password information.
Create a remote mirror for a project. The mirror will be disabled by default. You can enable it by including the optional parameter `enabled` when creating it: Create a remote mirror for a project. The mirror will be disabled by default. You can enable it by including the optional parameter `enabled` when creating it:
```text ```plaintext
POST /projects/:id/remote_mirrors POST /projects/:id/remote_mirrors
``` ```
...@@ -91,7 +91,7 @@ Example response: ...@@ -91,7 +91,7 @@ Example response:
Toggle a remote mirror on or off, or change which types of branches are Toggle a remote mirror on or off, or change which types of branches are
mirrored: mirrored:
```text ```plaintext
PUT /projects/:id/remote_mirrors/:mirror_id PUT /projects/:id/remote_mirrors/:mirror_id
``` ```
......
...@@ -65,7 +65,7 @@ curl --head --header 'PRIVATE-TOKEN: <your_access_token>' 'https://gitlab.exampl ...@@ -65,7 +65,7 @@ curl --head --header 'PRIVATE-TOKEN: <your_access_token>' 'https://gitlab.exampl
Example response: Example response:
```text ```plaintext
HTTP/1.1 200 OK HTTP/1.1 200 OK
... ...
X-Gitlab-Blob-Id: 79f7bbd25901e8334750839545a9bd021f0e4c83 X-Gitlab-Blob-Id: 79f7bbd25901e8334750839545a9bd021f0e4c83
...@@ -134,7 +134,7 @@ curl --head --header 'PRIVATE-TOKEN: <your_access_token>' 'https://gitlab.exampl ...@@ -134,7 +134,7 @@ curl --head --header 'PRIVATE-TOKEN: <your_access_token>' 'https://gitlab.exampl
Example response: Example response:
```text ```plaintext
HTTP/1.1 200 OK HTTP/1.1 200 OK
... ...
X-Gitlab-Blob-Id: 79f7bbd25901e8334750839545a9bd021f0e4c83 X-Gitlab-Blob-Id: 79f7bbd25901e8334750839545a9bd021f0e4c83
......
...@@ -16,7 +16,7 @@ NOTE: **Note:** ...@@ -16,7 +16,7 @@ NOTE: **Note:**
This endpoint is used as part of the SCIM syncing mechanism and it only returns This endpoint is used as part of the SCIM syncing mechanism and it only returns
a single user based on a unique ID which should match the `extern_uid` of the user. a single user based on a unique ID which should match the `extern_uid` of the user.
```text ```plaintext
GET /api/scim/v2/groups/:group_path/Users GET /api/scim/v2/groups/:group_path/Users
``` ```
...@@ -72,7 +72,7 @@ Example response: ...@@ -72,7 +72,7 @@ Example response:
## Get a single SAML user ## Get a single SAML user
```text ```plaintext
GET /api/scim/v2/groups/:group_path/Users/:id GET /api/scim/v2/groups/:group_path/Users/:id
``` ```
...@@ -113,7 +113,7 @@ Example response: ...@@ -113,7 +113,7 @@ Example response:
## Create a SAML user ## Create a SAML user
```text ```plaintext
POST /api/scim/v2/groups/:group_path/Users/ POST /api/scim/v2/groups/:group_path/Users/
``` ```
...@@ -169,7 +169,7 @@ Fields that can be updated are: ...@@ -169,7 +169,7 @@ Fields that can be updated are:
| `active` | Identity removal if `active` = `false` | | `active` | Identity removal if `active` = `false` |
| `userName` | `username` | | `userName` | `username` |
```text ```plaintext
PATCH /api/scim/v2/groups/:group_path/Users/:id PATCH /api/scim/v2/groups/:group_path/Users/:id
``` ```
...@@ -193,7 +193,7 @@ Returns an empty response with a `204` status code if successful. ...@@ -193,7 +193,7 @@ Returns an empty response with a `204` status code if successful.
Removes the user's SSO identity and group membership. Removes the user's SSO identity and group membership.
```text ```plaintext
DELETE /api/scim/v2/groups/:group_path/Users/:id DELETE /api/scim/v2/groups/:group_path/Users/:id
``` ```
......
...@@ -21,7 +21,7 @@ Valid values for snippet visibility levels are: ...@@ -21,7 +21,7 @@ Valid values for snippet visibility levels are:
Get a list of the current user's snippets. Get a list of the current user's snippets.
```text ```plaintext
GET /snippets GET /snippets
``` ```
...@@ -82,7 +82,7 @@ Example response: ...@@ -82,7 +82,7 @@ Example response:
Get a single snippet. Get a single snippet.
```text ```plaintext
GET /snippets/:id GET /snippets/:id
``` ```
...@@ -128,7 +128,7 @@ Example response: ...@@ -128,7 +128,7 @@ Example response:
Get a single snippet's raw contents. Get a single snippet's raw contents.
```text ```plaintext
GET /snippets/:id/raw GET /snippets/:id/raw
``` ```
...@@ -146,7 +146,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap ...@@ -146,7 +146,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/ap
Example response: Example response:
```text ```plaintext
Hello World snippet Hello World snippet
``` ```
...@@ -157,7 +157,7 @@ Create a new snippet. ...@@ -157,7 +157,7 @@ Create a new snippet.
NOTE: **Note:** NOTE: **Note:**
The user must have permission to create new snippets. The user must have permission to create new snippets.
```text ```plaintext
POST /snippets POST /snippets
``` ```
...@@ -214,7 +214,7 @@ Update an existing snippet. ...@@ -214,7 +214,7 @@ Update an existing snippet.
NOTE: **Note:** NOTE: **Note:**
The user must have permission to change an existing snippet. The user must have permission to change an existing snippet.
```text ```plaintext
PUT /snippets/:id PUT /snippets/:id
``` ```
...@@ -269,7 +269,7 @@ Example response: ...@@ -269,7 +269,7 @@ Example response:
Delete an existing snippet. Delete an existing snippet.
```text ```plaintext
DELETE /snippets/:id DELETE /snippets/:id
``` ```
...@@ -296,7 +296,7 @@ The following are possible return codes: ...@@ -296,7 +296,7 @@ The following are possible return codes:
List all public snippets. List all public snippets.
```text ```plaintext
GET /snippets/public GET /snippets/public
``` ```
...@@ -364,7 +364,7 @@ Example response: ...@@ -364,7 +364,7 @@ Example response:
NOTE: **Note:** NOTE: **Note:**
Available only for administrators. Available only for administrators.
```text ```plaintext
GET /snippets/:id/user_agent_detail GET /snippets/:id/user_agent_detail
``` ```
......
...@@ -29,7 +29,7 @@ To use GitLab CI/CD with a Bitbucket Cloud repository: ...@@ -29,7 +29,7 @@ To use GitLab CI/CD with a Bitbucket Cloud repository:
The web hook URL should be set to the GitLab API to trigger pull mirroring, The web hook URL should be set to the GitLab API to trigger pull mirroring,
using the Personal Access Token we just generated for authentication. using the Personal Access Token we just generated for authentication.
```text ```plaintext
https://gitlab.com/api/v4/projects/<PROJECT_ID>/mirror/pull?private_token=<PERSONAL_ACCESS_TOKEN> https://gitlab.com/api/v4/projects/<PROJECT_ID>/mirror/pull?private_token=<PERSONAL_ACCESS_TOKEN>
``` ```
......
...@@ -36,7 +36,7 @@ Some credentials are required to be able to run `aws` commands: ...@@ -36,7 +36,7 @@ Some credentials are required to be able to run `aws` commands:
1. You can now use `aws` commands in the `.gitlab-ci.yml` file of this project: 1. You can now use `aws` commands in the `.gitlab-ci.yml` file of this project:
```yml ```yaml
deploy: deploy:
stage: deploy stage: deploy
image: registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest # see the note below image: registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest # see the note below
......
...@@ -476,7 +476,7 @@ which can be avoided if a different driver is used, for example `overlay2`. ...@@ -476,7 +476,7 @@ which can be avoided if a different driver is used, for example `overlay2`.
On Ubuntu systems, this is done by editing `/etc/modules`. Just add the On Ubuntu systems, this is done by editing `/etc/modules`. Just add the
following line into it: following line into it:
```text ```plaintext
overlay overlay
``` ```
......
...@@ -46,7 +46,7 @@ application will be deployed to a single pod while the remaining 9 will present ...@@ -46,7 +46,7 @@ application will be deployed to a single pod while the remaining 9 will present
First we [define the template as manual](https://gitlab.com/gl-release/incremental-rollout-example/blob/master/.gitlab-ci.yml#L100-103): First we [define the template as manual](https://gitlab.com/gl-release/incremental-rollout-example/blob/master/.gitlab-ci.yml#L100-103):
```yml ```yaml
.manual_rollout_template: &manual_rollout_template .manual_rollout_template: &manual_rollout_template
<<: *rollout_template <<: *rollout_template
stage: production stage: production
...@@ -55,7 +55,7 @@ First we [define the template as manual](https://gitlab.com/gl-release/increment ...@@ -55,7 +55,7 @@ First we [define the template as manual](https://gitlab.com/gl-release/increment
Then we [define the rollout amount for each step](https://gitlab.com/gl-release/incremental-rollout-example/blob/master/.gitlab-ci.yml#L152-155): Then we [define the rollout amount for each step](https://gitlab.com/gl-release/incremental-rollout-example/blob/master/.gitlab-ci.yml#L152-155):
```yml ```yaml
rollout 10%: rollout 10%:
<<: *manual_rollout_template <<: *manual_rollout_template
variables: variables:
...@@ -86,7 +86,7 @@ countdown and then deploy. ...@@ -86,7 +86,7 @@ countdown and then deploy.
First we [define the template as timed](https://gitlab.com/gl-release/timed-rollout-example/blob/master/.gitlab-ci.yml#L86-89): First we [define the template as timed](https://gitlab.com/gl-release/timed-rollout-example/blob/master/.gitlab-ci.yml#L86-89):
```yml ```yaml
.timed_rollout_template: &timed_rollout_template .timed_rollout_template: &timed_rollout_template
<<: *rollout_template <<: *rollout_template
when: delayed when: delayed
...@@ -95,13 +95,13 @@ First we [define the template as timed](https://gitlab.com/gl-release/timed-roll ...@@ -95,13 +95,13 @@ First we [define the template as timed](https://gitlab.com/gl-release/timed-roll
We can define the delay period using the `start_in` key: We can define the delay period using the `start_in` key:
```yml ```yaml
start_in: 1 minutes start_in: 1 minutes
``` ```
Then we [define the rollout amount for each step](https://gitlab.com/gl-release/timed-rollout-example/blob/master/.gitlab-ci.yml#L97-101): Then we [define the rollout amount for each step](https://gitlab.com/gl-release/timed-rollout-example/blob/master/.gitlab-ci.yml#L97-101):
```yml ```yaml
timed rollout 30%: timed rollout 30%:
<<: *timed_rollout_template <<: *timed_rollout_template
stage: timed rollout 30% stage: timed rollout 30%
......
...@@ -902,7 +902,7 @@ knowing the state of your current environments is only a `git fetch` away. ...@@ -902,7 +902,7 @@ knowing the state of your current environments is only a `git fetch` away.
In your Git configuration, append the `[remote "<your-remote>"]` block with an extra In your Git configuration, append the `[remote "<your-remote>"]` block with an extra
fetch line: fetch line:
```text ```plaintext
fetch = +refs/environments/*:refs/remotes/origin/environments/* fetch = +refs/environments/*:refs/remotes/origin/environments/*
``` ```
......
...@@ -269,7 +269,7 @@ we know we will need to access everything in the `built` folder, given by GitLab ...@@ -269,7 +269,7 @@ we know we will need to access everything in the `built` folder, given by GitLab
We'll also cache `node_modules` to avoid having to do a full re-pull of those dependencies: We'll also cache `node_modules` to avoid having to do a full re-pull of those dependencies:
just pack them up in the cache. Here is the full `build` job: just pack them up in the cache. Here is the full `build` job:
```yml ```yaml
build: build:
stage: build stage: build
script: script:
...@@ -296,7 +296,7 @@ the previous job. Lastly, by convention, we let GitLab CI/CD know this needs to ...@@ -296,7 +296,7 @@ the previous job. Lastly, by convention, we let GitLab CI/CD know this needs to
the `build` job by giving it a `test` [stage](../../../ci/yaml/README.md#stages). the `build` job by giving it a `test` [stage](../../../ci/yaml/README.md#stages).
Following the YAML structure, the `test` job should look like this: Following the YAML structure, the `test` job should look like this:
```yml ```yaml
test: test:
stage: test stage: test
script: script:
...@@ -318,7 +318,7 @@ we've added test artifacts and a test stage to our GitLab CI/CD pipeline using ` ...@@ -318,7 +318,7 @@ we've added test artifacts and a test stage to our GitLab CI/CD pipeline using `
allowing us to run our tests by every push. allowing us to run our tests by every push.
Our entire `.gitlab-ci.yml` file should now look like this: Our entire `.gitlab-ci.yml` file should now look like this:
```yml ```yaml
image: node:10 image: node:10
build: build:
...@@ -440,7 +440,7 @@ we add directives to ensure deployment `only` happens on pushes to `master`. Thi ...@@ -440,7 +440,7 @@ we add directives to ensure deployment `only` happens on pushes to `master`. Thi
single branch still runs through CI, and only merging (or committing directly) to master will single branch still runs through CI, and only merging (or committing directly) to master will
trigger the `deploy` job of our pipeline. Put these together to get the following: trigger the `deploy` job of our pipeline. Put these together to get the following:
```yml ```yaml
deploy: deploy:
stage: deploy stage: deploy
variables: variables:
...@@ -459,7 +459,7 @@ deploy: ...@@ -459,7 +459,7 @@ deploy:
Be sure to update the region and S3 URL in that last script command to fit your setup. Be sure to update the region and S3 URL in that last script command to fit your setup.
Our final configuration file `.gitlab-ci.yml` looks like: Our final configuration file `.gitlab-ci.yml` looks like:
```yml ```yaml
image: node:10 image: node:10
build: build:
......
...@@ -108,7 +108,7 @@ The scripts are grouped into **jobs**, and together they compose ...@@ -108,7 +108,7 @@ The scripts are grouped into **jobs**, and together they compose
a **pipeline**. A minimalist example of `.gitlab-ci.yml` file a **pipeline**. A minimalist example of `.gitlab-ci.yml` file
could contain: could contain:
```yml ```yaml
before_script: before_script:
- apt-get install rubygems ruby-dev -y - apt-get install rubygems ruby-dev -y
......
...@@ -222,7 +222,7 @@ In the example: ...@@ -222,7 +222,7 @@ In the example:
Visually, it can be viewed as: Visually, it can be viewed as:
```text ```plaintext
0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7
AAAAAAA AAAAAAA
BBBBBBB BBBBBBB
...@@ -231,7 +231,7 @@ Visually, it can be viewed as: ...@@ -231,7 +231,7 @@ Visually, it can be viewed as:
The union of A, B, and C is (1, 4) and (6, 7). Therefore, the total running time is: The union of A, B, and C is (1, 4) and (6, 7). Therefore, the total running time is:
```text ```plaintext
(4 - 1) + (7 - 6) => 4 (4 - 1) + (7 - 6) => 4
``` ```
......
...@@ -250,7 +250,7 @@ Depending on the status of your job, a badge can have the following values: ...@@ -250,7 +250,7 @@ Depending on the status of your job, a badge can have the following values:
You can access a pipeline status badge image using the following link: You can access a pipeline status badge image using the following link:
```text ```plaintext
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/pipeline.svg https://example.gitlab.com/<namespace>/<project>/badges/<branch>/pipeline.svg
``` ```
...@@ -262,7 +262,7 @@ pipeline can have the test coverage percentage value defined. ...@@ -262,7 +262,7 @@ pipeline can have the test coverage percentage value defined.
The test coverage badge can be accessed using following link: The test coverage badge can be accessed using following link:
```text ```plaintext
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg
``` ```
...@@ -281,7 +281,7 @@ Pipeline badges can be rendered in different styles by adding the `style=style_n ...@@ -281,7 +281,7 @@ Pipeline badges can be rendered in different styles by adding the `style=style_n
#### Flat (default) #### Flat (default)
```text ```plaintext
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat
``` ```
...@@ -291,7 +291,7 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?st ...@@ -291,7 +291,7 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?st
> [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.
```text ```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
``` ```
......
...@@ -715,7 +715,7 @@ For example, the following are equivalent configuration: ...@@ -715,7 +715,7 @@ For example, the following are equivalent configuration:
- Configured in order: - Configured in order:
```yml ```yaml
stages: stages:
- .pre - .pre
- a - a
...@@ -725,7 +725,7 @@ For example, the following are equivalent configuration: ...@@ -725,7 +725,7 @@ For example, the following are equivalent configuration:
- Configured out of order: - Configured out of order:
```yml ```yaml
stages: stages:
- a - a
- .pre - .pre
...@@ -735,7 +735,7 @@ For example, the following are equivalent configuration: ...@@ -735,7 +735,7 @@ For example, the following are equivalent configuration:
- Not explicitly configured: - Not explicitly configured:
```yml ```yaml
stages: stages:
- a - a
- b - b
...@@ -2554,7 +2554,7 @@ in the [merge request](../../user/project/merge_requests/index.md) UI. ...@@ -2554,7 +2554,7 @@ in the [merge request](../../user/project/merge_requests/index.md) UI.
For example, to match a single file: For example, to match a single file:
```yml ```yaml
test: test:
script: [ 'echo 1' ] script: [ 'echo 1' ]
artifacts: artifacts:
...@@ -2567,7 +2567,7 @@ that points to `file1.txt`. ...@@ -2567,7 +2567,7 @@ that points to `file1.txt`.
An example that will match an entire directory: An example that will match an entire directory:
```yml ```yaml
test: test:
script: [ 'echo 1' ] script: [ 'echo 1' ]
artifacts: artifacts:
...@@ -3534,7 +3534,7 @@ specific directory (Go projects, for example). In that case, you can specify ...@@ -3534,7 +3534,7 @@ specific directory (Go projects, for example). In that case, you can specify
the `GIT_CLONE_PATH` variable to tell the Runner in which directory to clone the the `GIT_CLONE_PATH` variable to tell the Runner in which directory to clone the
repository: repository:
```yml ```yaml
variables: variables:
GIT_CLONE_PATH: $CI_BUILDS_DIR/project-name GIT_CLONE_PATH: $CI_BUILDS_DIR/project-name
...@@ -3564,7 +3564,7 @@ exposes two additional variables that provide a unique `ID` of concurrency: ...@@ -3564,7 +3564,7 @@ exposes two additional variables that provide a unique `ID` of concurrency:
The most stable configuration that should work well in any scenario and on any executor The most stable configuration that should work well in any scenario and on any executor
is to use `$CI_CONCURRENT_ID` in the `GIT_CLONE_PATH`. For example: is to use `$CI_CONCURRENT_ID` in the `GIT_CLONE_PATH`. For example:
```yml ```yaml
variables: variables:
GIT_CLONE_PATH: $CI_BUILDS_DIR/$CI_CONCURRENT_ID/project-name GIT_CLONE_PATH: $CI_BUILDS_DIR/$CI_CONCURRENT_ID/project-name
...@@ -3576,7 +3576,7 @@ test: ...@@ -3576,7 +3576,7 @@ test:
The `$CI_CONCURRENT_PROJECT_ID` should be used in conjunction with `$CI_PROJECT_PATH` The `$CI_CONCURRENT_PROJECT_ID` should be used in conjunction with `$CI_PROJECT_PATH`
as the `$CI_PROJECT_PATH` provides a path of a repository. That is, `group/subgroup/project`. For example: as the `$CI_PROJECT_PATH` provides a path of a repository. That is, `group/subgroup/project`. For example:
```yml ```yaml
variables: variables:
GIT_CLONE_PATH: $CI_BUILDS_DIR/$CI_CONCURRENT_ID/$CI_PROJECT_PATH GIT_CLONE_PATH: $CI_BUILDS_DIR/$CI_CONCURRENT_ID/$CI_PROJECT_PATH
...@@ -3593,7 +3593,7 @@ within is not supported. ...@@ -3593,7 +3593,7 @@ within is not supported.
For example, you define both the variables below in your For example, you define both the variables below in your
`.gitlab-ci.yml` file: `.gitlab-ci.yml` file:
```yml ```yaml
variables: variables:
GOPATH: $CI_BUILDS_DIR/go GOPATH: $CI_BUILDS_DIR/go
GIT_CLONE_PATH: $GOPATH/src/namespace/project GIT_CLONE_PATH: $GOPATH/src/namespace/project
......
...@@ -101,20 +101,20 @@ automatically. ...@@ -101,20 +101,20 @@ automatically.
Its simplest usage is to provide the value for `title`: Its simplest usage is to provide the value for `title`:
```text ```plaintext
bin/changelog 'Hey DZ, I added a feature to GitLab!' bin/changelog 'Hey DZ, I added a feature to GitLab!'
``` ```
If you want to generate a changelog entry for GitLab EE, you will need to pass If you want to generate a changelog entry for GitLab EE, you will need to pass
the `--ee` option: the `--ee` option:
```text ```plaintext
bin/changelog --ee 'Hey DZ, I added a feature to GitLab!' bin/changelog --ee 'Hey DZ, I added a feature to GitLab!'
``` ```
At this point the script would ask you to select the category of the change (mapped to the `type` field in the entry): At this point the script would ask you to select the category of the change (mapped to the `type` field in the entry):
```text ```plaintext
>> Please specify the category of your change: >> Please specify the category of your change:
1. New feature 1. New feature
2. Bug fix 2. Bug fix
...@@ -132,7 +132,7 @@ the command above on a branch called `feature/hey-dz`, it will generate a ...@@ -132,7 +132,7 @@ the command above on a branch called `feature/hey-dz`, it will generate a
The command will output the path of the generated file and its contents: The command will output the path of the generated file and its contents:
```text ```plaintext
create changelogs/unreleased/my-feature.yml create changelogs/unreleased/my-feature.yml
--- ---
title: Hey DZ, I added a feature to GitLab! title: Hey DZ, I added a feature to GitLab!
...@@ -162,7 +162,7 @@ If you use **`--amend`** and don't provide a title, it will automatically use ...@@ -162,7 +162,7 @@ If you use **`--amend`** and don't provide a title, it will automatically use
the "subject" of the previous commit, which is the first line of the commit the "subject" of the previous commit, which is the first line of the commit
message: message:
```text ```plaintext
$ git show --oneline $ git show --oneline
ab88683 Added an awesome new feature to GitLab ab88683 Added an awesome new feature to GitLab
...@@ -180,7 +180,7 @@ type: ...@@ -180,7 +180,7 @@ type:
Use **`--force`** or **`-f`** to overwrite an existing changelog entry if it Use **`--force`** or **`-f`** to overwrite an existing changelog entry if it
already exists. already exists.
```text ```plaintext
$ bin/changelog 'Hey DZ, I added a feature to GitLab!' $ bin/changelog 'Hey DZ, I added a feature to GitLab!'
error changelogs/unreleased/feature-hey-dz.yml already exists! Use `--force` to overwrite. error changelogs/unreleased/feature-hey-dz.yml already exists! Use `--force` to overwrite.
...@@ -198,7 +198,7 @@ type: ...@@ -198,7 +198,7 @@ type:
Use the **`--merge-request`** or **`-m`** argument to provide the Use the **`--merge-request`** or **`-m`** argument to provide the
`merge_request` value: `merge_request` value:
```text ```plaintext
$ bin/changelog 'Hey DZ, I added a feature to GitLab!' -m 1983 $ bin/changelog 'Hey DZ, I added a feature to GitLab!' -m 1983
create changelogs/unreleased/feature-hey-dz.yml create changelogs/unreleased/feature-hey-dz.yml
--- ---
...@@ -213,7 +213,7 @@ type: ...@@ -213,7 +213,7 @@ type:
Use the **`--dry-run`** or **`-n`** argument to prevent actually writing or Use the **`--dry-run`** or **`-n`** argument to prevent actually writing or
committing anything: committing anything:
```text ```plaintext
$ bin/changelog --amend --dry-run $ bin/changelog --amend --dry-run
create changelogs/unreleased/feature-hey-dz.yml create changelogs/unreleased/feature-hey-dz.yml
--- ---
...@@ -230,7 +230,7 @@ $ ls changelogs/unreleased/ ...@@ -230,7 +230,7 @@ $ ls changelogs/unreleased/
Use the **`--git-username`** or **`-u`** argument to automatically fill in the Use the **`--git-username`** or **`-u`** argument to automatically fill in the
`author` value with your configured Git `user.name` value: `author` value with your configured Git `user.name` value:
```text ```plaintext
$ git config user.name $ git config user.name
Jane Doe Jane Doe
...@@ -247,7 +247,7 @@ type: ...@@ -247,7 +247,7 @@ type:
Use the **`--type`** or **`-t`** argument to provide the `type` value: Use the **`--type`** or **`-t`** argument to provide the `type` value:
```text ```plaintext
$ bin/changelog 'Hey DZ, I added a feature to GitLab!' -t added $ bin/changelog 'Hey DZ, I added a feature to GitLab!' -t added
create changelogs/unreleased/feature-hey-dz.yml create changelogs/unreleased/feature-hey-dz.yml
--- ---
......
...@@ -138,7 +138,7 @@ For more information see [How to Write a Git Commit Message](https://chris.beams ...@@ -138,7 +138,7 @@ For more information see [How to Write a Git Commit Message](https://chris.beams
Example commit message template that can be used on your machine that embodies the above (guide for [how to apply template](https://codeinthehole.com/tips/a-useful-template-for-commit-messages/)): Example commit message template that can be used on your machine that embodies the above (guide for [how to apply template](https://codeinthehole.com/tips/a-useful-template-for-commit-messages/)):
```text ```plaintext
# (If applied, this commit will...) <subject> (Max 50 char) # (If applied, this commit will...) <subject> (Max 50 char)
# |<---- Using a Maximum Of 50 Characters ---->| # |<---- Using a Maximum Of 50 Characters ---->|
......
...@@ -541,7 +541,7 @@ In unordered lists (using `-`), this means two spaces for each level of indentat ...@@ -541,7 +541,7 @@ In unordered lists (using `-`), this means two spaces for each level of indentat
- Unordered list item 3 - Unordered list item 3
```text ```plaintext
a codeblock that will next inside list item 3 a codeblock that will next inside list item 3
``` ```
...@@ -564,7 +564,7 @@ For ordered lists, use three spaces for each level of indentation: ...@@ -564,7 +564,7 @@ For ordered lists, use three spaces for each level of indentation:
1. Ordered list item 3 1. Ordered list item 3
```text ```plaintext
a codeblock that will next inside list item 3 a codeblock that will next inside list item 3
``` ```
...@@ -1529,7 +1529,7 @@ The following can be used as a template to get started: ...@@ -1529,7 +1529,7 @@ The following can be used as a template to get started:
One or two sentence description of what endpoint does. One or two sentence description of what endpoint does.
```text ```plaintext
METHOD /endpoint METHOD /endpoint
``` ```
......
...@@ -145,7 +145,7 @@ git push --set-upstream https://gitlab.example.com/namespace/nonexistent-project ...@@ -145,7 +145,7 @@ git push --set-upstream https://gitlab.example.com/namespace/nonexistent-project
Once the push finishes successfully, a remote message will indicate Once the push finishes successfully, a remote message will indicate
the command to set the remote and the URL to the new project: the command to set the remote and the URL to the new project:
```text ```plaintext
remote: remote:
remote: The private project namespace/nonexistent-project was created. remote: The private project namespace/nonexistent-project was created.
remote: remote:
......
...@@ -63,6 +63,6 @@ For example, the following is a link to an image in Markdown: ...@@ -63,6 +63,6 @@ For example, the following is a link to an image in Markdown:
The following is an example of a source link that could result: The following is an example of a source link that could result:
```text ```plaintext
http://proxy.gitlab.example.com/f9dd2b40157757eb82afeedbf1290ffb67a3aeeb/68747470733a2f2f61626f75742e6769746c61622e636f6d2f696d616765732f70726573732f6c6f676f2f6a70672f6769746c61622d69636f6e2d7267622e6a7067 http://proxy.gitlab.example.com/f9dd2b40157757eb82afeedbf1290ffb67a3aeeb/68747470733a2f2f61626f75742e6769746c61622e636f6d2f696d616765732f70726573732f6c6f676f2f6a70672f6769746c61622d69636f6e2d7267622e6a7067
``` ```
...@@ -78,7 +78,7 @@ will whitelist all ports on all IPs in that range. ...@@ -78,7 +78,7 @@ will whitelist all ports on all IPs in that range.
Example: Example:
```text ```plaintext
example.com;gitlab.example.com example.com;gitlab.example.com
127.0.0.1,1:0:0:0:0:0:0:1 127.0.0.1,1:0:0:0:0:0:0:1
127.0.0.0/8 1:0:0:0:0:0:0:0/124 127.0.0.0/8 1:0:0:0:0:0:0:0/124
......
...@@ -263,7 +263,7 @@ and replaced with `KUBE_INGRESS_BASE_DOMAIN`, and removed in ...@@ -263,7 +263,7 @@ and replaced with `KUBE_INGRESS_BASE_DOMAIN`, and removed in
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:
```text ```plaintext
*.example.com 3600 A 1.2.3.4 *.example.com 3600 A 1.2.3.4
``` ```
......
...@@ -13,7 +13,7 @@ with Git. ...@@ -13,7 +13,7 @@ with Git.
'Broken pipe' errors can occur when attempting to push to a remote repository. 'Broken pipe' errors can occur when attempting to push to a remote repository.
When pushing you will usually see: When pushing you will usually see:
```text ```plaintext
Write failed: Broken pipe Write failed: Broken pipe
fatal: The remote end hung up unexpectedly fatal: The remote end hung up unexpectedly
``` ```
...@@ -56,7 +56,7 @@ Configuring *both* the client and the server is unnecessary. ...@@ -56,7 +56,7 @@ Configuring *both* the client and the server is unnecessary.
- On UNIX, edit `~/.ssh/config` (create the file if it doesn’t exist) and - On UNIX, edit `~/.ssh/config` (create the file if it doesn’t exist) and
add or edit: add or edit:
```text ```plaintext
Host your-gitlab-instance-url.com Host your-gitlab-instance-url.com
ServerAliveInterval 60 ServerAliveInterval 60
ServerAliveCountMax 5 ServerAliveCountMax 5
...@@ -68,7 +68,7 @@ Configuring *both* the client and the server is unnecessary. ...@@ -68,7 +68,7 @@ Configuring *both* the client and the server is unnecessary.
**To configure SSH on the server side**, edit `/etc/ssh/sshd_config` and add: **To configure SSH on the server side**, edit `/etc/ssh/sshd_config` and add:
```text ```plaintext
ClientAliveInterval 60 ClientAliveInterval 60
ClientAliveCountMax 5 ClientAliveCountMax 5
``` ```
...@@ -93,7 +93,7 @@ to >= 2.9 (see [Broken pipe when pushing to Git repository](https://stackoverflo ...@@ -93,7 +93,7 @@ to >= 2.9 (see [Broken pipe when pushing to Git repository](https://stackoverflo
Users may experience the following error when attempting to push or pull Users may experience the following error when attempting to push or pull
using Git over SSH: using Git over SSH:
```text ```plaintext
Please make sure you have the correct access rights Please make sure you have the correct access rights
and the repository exists. and the repository exists.
... ...
...@@ -103,7 +103,7 @@ fatal: Could not read from remote repository. ...@@ -103,7 +103,7 @@ fatal: Could not read from remote repository.
or or
```text ```plaintext
ssh_exchange_identification: Connection closed by remote host ssh_exchange_identification: Connection closed by remote host
fatal: The remote end hung up unexpectedly fatal: The remote end hung up unexpectedly
``` ```
...@@ -117,7 +117,7 @@ beginning. The default value is `10`. ...@@ -117,7 +117,7 @@ beginning. The default value is `10`.
Increase `MaxStartups` on the GitLab server Increase `MaxStartups` on the GitLab server
by adding or modifying the value in `/etc/ssh/sshd_config`: by adding or modifying the value in `/etc/ssh/sshd_config`:
```text ```plaintext
MaxStartups 100:30:200 MaxStartups 100:30:200
``` ```
...@@ -140,7 +140,7 @@ If pulling/pushing from/to your repository ends up taking more than 50 seconds, ...@@ -140,7 +140,7 @@ If pulling/pushing from/to your repository ends up taking more than 50 seconds,
a timeout will be issued with a log of the number of operations performed a timeout will be issued with a log of the number of operations performed
and their respective timings, like the example below: and their respective timings, like the example below:
```text ```plaintext
remote: Running checks for branch: master remote: Running checks for branch: master
remote: Scanning for LFS objects... (153ms) remote: Scanning for LFS objects... (153ms)
remote: Calculating new repository size... (cancelled after 729ms) remote: Calculating new repository size... (cancelled after 729ms)
...@@ -153,7 +153,7 @@ and provide GitLab with more information on how to improve the service. ...@@ -153,7 +153,7 @@ and provide GitLab with more information on how to improve the service.
If the buffer size is lower than what is allowed in the request, the action will fail with an error similar to the one below: If the buffer size is lower than what is allowed in the request, the action will fail with an error similar to the one below:
```text ```plaintext
error: RPC failed; curl 18 transfer closed with outstanding read data remaining error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly fatal: The remote end hung up unexpectedly
fatal: early EOF fatal: early EOF
......
...@@ -116,7 +116,7 @@ git log <file> ...@@ -116,7 +116,7 @@ git log <file>
If you get this error message: If you get this error message:
```text ```plaintext
fatal: ambiguous argument <file_name>: unknown revision or path not in the working tree. fatal: ambiguous argument <file_name>: unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this: Use '--' to separate paths from revisions, like this:
``` ```
......
...@@ -46,7 +46,7 @@ Blocking a user: ...@@ -46,7 +46,7 @@ Blocking a user:
The user will be notified with the The user will be notified with the
[following message](https://gitlab.com/gitlab-org/gitlab/blob/master/app/workers/email_receiver_worker.rb#L38): [following message](https://gitlab.com/gitlab-org/gitlab/blob/master/app/workers/email_receiver_worker.rb#L38):
```text ```plaintext
Your account has been blocked. If you believe this is in error, contact a staff member. Your account has been blocked. If you believe this is in error, contact a staff member.
``` ```
......
...@@ -25,15 +25,15 @@ For details, see [how to add IPs to a whitelist for the monitoring endpoints](.. ...@@ -25,15 +25,15 @@ For details, see [how to add IPs to a whitelist for the monitoring endpoints](..
With default whitelist settings, the probes can be accessed from localhost using the following URLs: With default whitelist settings, the probes can be accessed from localhost using the following URLs:
```text ```plaintext
GET http://localhost/-/health GET http://localhost/-/health
``` ```
```text ```plaintext
GET http://localhost/-/readiness GET http://localhost/-/readiness
``` ```
```text ```plaintext
GET http://localhost/-/liveness GET http://localhost/-/liveness
``` ```
...@@ -45,7 +45,7 @@ are running. This endpoint circumvents Rails Controllers ...@@ -45,7 +45,7 @@ are running. This endpoint circumvents Rails Controllers
and is implemented as additional middleware `BasicHealthCheck` and is implemented as additional middleware `BasicHealthCheck`
very early into the request processing lifecycle. very early into the request processing lifecycle.
```text ```plaintext
GET /-/health GET /-/health
``` ```
...@@ -57,7 +57,7 @@ curl 'https://gitlab.example.com/-/health' ...@@ -57,7 +57,7 @@ curl 'https://gitlab.example.com/-/health'
Example response: Example response:
```text ```plaintext
GitLab OK GitLab OK
``` ```
...@@ -71,7 +71,7 @@ If the `all=1` parameter is specified, the check will also validate ...@@ -71,7 +71,7 @@ If the `all=1` parameter is specified, the check will also validate
the dependent services (Database, Redis, Gitaly etc.) the dependent services (Database, Redis, Gitaly etc.)
and gives a status for each. and gives a status for each.
```text ```plaintext
GET /-/readiness GET /-/readiness
GET /-/readiness?all=1 GET /-/readiness?all=1
``` ```
...@@ -111,7 +111,7 @@ Checks whether the application server is running. ...@@ -111,7 +111,7 @@ Checks whether the application server is running.
This probe is used to know if Rails Controllers This probe is used to know if Rails Controllers
are not deadlocked due to a multi-threading. are not deadlocked due to a multi-threading.
```text ```plaintext
GET /-/liveness GET /-/liveness
``` ```
...@@ -148,7 +148,7 @@ accepted token can be found under the **Admin Area > Monitoring > Health check** ...@@ -148,7 +148,7 @@ accepted token can be found under the **Admin Area > Monitoring > Health check**
The access token can be passed as a URL parameter: The access token can be passed as a URL parameter:
```text ```plaintext
https://gitlab.example.com/-/readiness?token=ACCESS_TOKEN https://gitlab.example.com/-/readiness?token=ACCESS_TOKEN
``` ```
......
...@@ -40,7 +40,7 @@ are supported: ...@@ -40,7 +40,7 @@ are supported:
Each template must go in its respective subdirectory, have the correct Each template must go in its respective subdirectory, have the correct
extension and not be empty. So, the hierarchy should look like this: extension and not be empty. So, the hierarchy should look like this:
```text ```plaintext
|-- README.md |-- README.md
|-- Dockerfile |-- Dockerfile
|-- custom_dockerfile.dockerfile |-- custom_dockerfile.dockerfile
......
...@@ -59,7 +59,7 @@ To enable Container Scanning in your pipeline, you need: ...@@ -59,7 +59,7 @@ To enable Container Scanning in your pipeline, you need:
[predefined environment variables](../../../ci/variables/predefined_variables.md) [predefined environment variables](../../../ci/variables/predefined_variables.md)
as defined below: as defined below:
```text ```plaintext
$CI_REGISTRY_IMAGE/$CI_COMMIT_REF_SLUG:$CI_COMMIT_SHA $CI_REGISTRY_IMAGE/$CI_COMMIT_REF_SLUG:$CI_COMMIT_SHA
``` ```
...@@ -479,7 +479,7 @@ When the GitLab Runner uses the Docker executor and NFS is used ...@@ -479,7 +479,7 @@ When the GitLab Runner uses the Docker executor and NFS is used
(for example, `/var/lib/docker` is on an NFS mount), Container Scanning might fail with (for example, `/var/lib/docker` is on an NFS mount), Container Scanning might fail with
an error like the following: an error like the following:
```text ```plaintext
docker: Error response from daemon: failed to copy xattrs: failed to set xattr "security.selinux" on /path/to/file: operation not supported. docker: Error response from daemon: failed to copy xattrs: failed to set xattr "security.selinux" on /path/to/file: operation not supported.
``` ```
......
...@@ -315,7 +315,7 @@ API scans support OpenAPI V2 and OpenAPI V3 specifications. You can define these ...@@ -315,7 +315,7 @@ API scans support OpenAPI V2 and OpenAPI V3 specifications. You can define these
If your API specification is accessible at a URL, you can pass that URL in directly as the target. If your API specification is accessible at a URL, you can pass that URL in directly as the target.
The specification does not have to be hosted on the same host as the API being tested. The specification does not have to be hosted on the same host as the API being tested.
```yml ```yaml
include: include:
- template: DAST.gitlab-ci.yml - template: DAST.gitlab-ci.yml
......
...@@ -570,7 +570,7 @@ doesn't support dependency references made with [local paths](https://docs.npmjs ...@@ -570,7 +570,7 @@ doesn't support dependency references made with [local paths](https://docs.npmjs
in the `package.json` of JavaScript projects. The dependency scan outputs the following error for in the `package.json` of JavaScript projects. The dependency scan outputs the following error for
such references: such references:
```text ```plaintext
ERROR: Could not find dependencies: <dependency-name>. You may need to run npm install ERROR: Could not find dependencies: <dependency-name>. You may need to run npm install
``` ```
......
...@@ -1232,7 +1232,7 @@ epic](https://gitlab.com/groups/gitlab-org/-/epics/1201). ...@@ -1232,7 +1232,7 @@ epic](https://gitlab.com/groups/gitlab-org/-/epics/1201).
Applications can fail with the following error: Applications can fail with the following error:
```text ```plaintext
Error: remote error: tls: bad certificate Error: remote error: tls: bad certificate
``` ```
......
...@@ -284,7 +284,7 @@ license_scanning: ...@@ -284,7 +284,7 @@ license_scanning:
The [`pip.conf`](https://pip.pypa.io/en/stable/reference/pip/) allows you to specify a list of The [`pip.conf`](https://pip.pypa.io/en/stable/reference/pip/) allows you to specify a list of
[trusted hosts](https://pip.pypa.io/en/stable/reference/pip/#cmdoption-trusted-host): [trusted hosts](https://pip.pypa.io/en/stable/reference/pip/#cmdoption-trusted-host):
```text ```plaintext
[global] [global]
trusted-host = pypi.example.com trusted-host = pypi.example.com
``` ```
...@@ -308,7 +308,7 @@ setting to specify its location. ...@@ -308,7 +308,7 @@ setting to specify its location.
For example: For example:
```text ```plaintext
registry = https://npm.example.com registry = https://npm.example.com
``` ```
...@@ -322,7 +322,7 @@ setting. ...@@ -322,7 +322,7 @@ setting.
For example: For example:
```text ```plaintext
strict-ssl = false strict-ssl = false
``` ```
...@@ -363,7 +363,7 @@ license_scanning: ...@@ -363,7 +363,7 @@ license_scanning:
If you use the `license_management` artifact in GitLab 13.0 or later, the License Compliance job generates this error: If you use the `license_management` artifact in GitLab 13.0 or later, the License Compliance job generates this error:
```text ```plaintext
WARNING: Uploading artifacts to coordinator... failed id=:id responseStatus=400 Bad Request status=400 Bad Request token=:sha WARNING: Uploading artifacts to coordinator... failed id=:id responseStatus=400 Bad Request status=400 Bad Request token=:sha
FATAL: invalid_argument FATAL: invalid_argument
......
...@@ -279,7 +279,7 @@ To work with Conan commands within [GitLab CI/CD](./../../../ci/README.md), you ...@@ -279,7 +279,7 @@ To work with Conan commands within [GitLab CI/CD](./../../../ci/README.md), you
It is easiest to provide the `CONAN_LOGIN_USERNAME` and `CONAN_PASSWORD` with each It is easiest to provide the `CONAN_LOGIN_USERNAME` and `CONAN_PASSWORD` with each
Conan command in your `.gitlab-ci.yml` file: Conan command in your `.gitlab-ci.yml` file:
```yml ```yaml
image: conanio/gcc7 image: conanio/gcc7
create_package: create_package:
......
...@@ -154,14 +154,14 @@ docker push registry.example.com/group/project/image ...@@ -154,14 +154,14 @@ docker push registry.example.com/group/project/image
Your image will be named after the following scheme: Your image will be named after the following scheme:
```text ```plaintext
<registry URL>/<namespace>/<project>/<image> <registry URL>/<namespace>/<project>/<image>
``` ```
GitLab supports up to three levels of image repository names. GitLab supports up to three levels of image repository names.
The following examples of image tags are valid: The following examples of image tags are valid:
```text ```plaintext
registry.example.com/group/project:some-tag registry.example.com/group/project:some-tag
registry.example.com/group/project/image:latest registry.example.com/group/project/image:latest
registry.example.com/group/project/my/image:rc1 registry.example.com/group/project/my/image:rc1
......
...@@ -291,7 +291,7 @@ To work with NPM commands within [GitLab CI/CD](./../../../ci/README.md), you ca ...@@ -291,7 +291,7 @@ To work with NPM commands within [GitLab CI/CD](./../../../ci/README.md), you ca
A simple example `.gitlab-ci.yml` file for publishing NPM packages: A simple example `.gitlab-ci.yml` file for publishing NPM packages:
```yml ```yaml
image: node:latest image: node:latest
stages: stages:
...@@ -326,7 +326,7 @@ info Visit https://classic.yarnpkg.com/en/docs/cli/install for documentation abo ...@@ -326,7 +326,7 @@ info Visit https://classic.yarnpkg.com/en/docs/cli/install for documentation abo
In this case, try adding this to your `.npmrc` file (and replace `<your_token>` In this case, try adding this to your `.npmrc` file (and replace `<your_token>`
with your personal access token or deploy token): with your personal access token or deploy token):
```text ```plaintext
//gitlab.com/api/v4/projects/:_authToken=<your_token> //gitlab.com/api/v4/projects/:_authToken=<your_token>
``` ```
......
...@@ -338,7 +338,7 @@ the deployment job: ...@@ -338,7 +338,7 @@ the deployment job:
However, sometimes GitLab can not create them. In such instances, your job will fail with the message: However, sometimes GitLab can not create them. In such instances, your job will fail with the message:
```text ```plaintext
This job failed because the necessary resources were not successfully created. This job failed because the necessary resources were not successfully created.
``` ```
......
...@@ -242,7 +242,7 @@ field. ...@@ -242,7 +242,7 @@ field.
For example: For example:
```text ```plaintext
machine example.gitlab.com machine example.gitlab.com
login <gitlab_user_name> login <gitlab_user_name>
password <personal_access_token> password <personal_access_token>
......
...@@ -41,7 +41,7 @@ an error message and keep troubleshooting from there. ...@@ -41,7 +41,7 @@ an error message and keep troubleshooting from there.
You may see an entry similar to the following in your Sidekiq log: You may see an entry similar to the following in your Sidekiq log:
```text ```plaintext
2019-01-10_13:22:08.42572 2019-01-10T13:22:08.425Z 6877 TID-abcdefg ProjectServiceWorker JID-3bade5fb3dd47a85db6d78c5 ERROR: {:class=>"ProjectServiceWorker", :service_class=>"SlackService", :message=>"SSL_connect returned=1 errno=0 state=error: certificate verify failed"} 2019-01-10_13:22:08.42572 2019-01-10T13:22:08.425Z 6877 TID-abcdefg ProjectServiceWorker JID-3bade5fb3dd47a85db6d78c5 ERROR: {:class=>"ProjectServiceWorker", :service_class=>"SlackService", :message=>"SSL_connect returned=1 errno=0 state=error: certificate verify failed"}
``` ```
......
...@@ -367,7 +367,7 @@ from Jekyll `_config.yml` file, otherwise Jekyll will ...@@ -367,7 +367,7 @@ from Jekyll `_config.yml` file, otherwise Jekyll will
understand it as a regular directory to build understand it as a regular directory to build
together with the site: together with the site:
```yml ```yaml
exclude: exclude:
- vendor - vendor
``` ```
......
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