diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-04-15 12:09:18 +0000 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-04-15 12:09:18 +0000 |
commit | b7c735c8ac11b8182807070fc6f84f2606e15427 (patch) | |
tree | e74b4d25abb8bbf23546f001dd94515e2840a3a3 /doc | |
parent | 221b529789f4090341a825695aeb49b8df6dd11d (diff) | |
download | gitlab-ce-b7c735c8ac11b8182807070fc6f84f2606e15427.tar.gz |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc')
-rw-r--r-- | doc/administration/raketasks/uploads/migrate.md | 18 | ||||
-rw-r--r-- | doc/api/runners.md | 8 | ||||
-rw-r--r-- | doc/user/group/saml_sso/index.md | 26 | ||||
-rw-r--r-- | doc/user/project/integrations/bamboo.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/discord_notifications.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/generic_alerts.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/github.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/hangouts_chat.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/hipchat.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/irker.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/mattermost_slash_commands.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/slack.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/slack_slash_commands.md | 2 | ||||
-rw-r--r-- | doc/user/project/integrations/unify_circuit.md | 2 | ||||
-rw-r--r-- | doc/user/project/releases/index.md | 4 |
15 files changed, 47 insertions, 31 deletions
diff --git a/doc/administration/raketasks/uploads/migrate.md b/doc/administration/raketasks/uploads/migrate.md index d2823847a89..851305d433f 100644 --- a/doc/administration/raketasks/uploads/migrate.md +++ b/doc/administration/raketasks/uploads/migrate.md @@ -111,24 +111,6 @@ sudo -u git -H bundle exec rake "gitlab:uploads:migrate[FileUploader, MergeReque sudo -u git -H bundle exec rake "gitlab:uploads:migrate[DesignManagement::DesignV432x230Uploader, DesignManagement::Action]" ``` -## Migrate legacy uploads out of deprecated paths - -> Introduced in GitLab 12.3. - -To migrate all uploads created by legacy uploaders, run: - -**Omnibus Installation** - -```shell -gitlab-rake gitlab:uploads:legacy:migrate -``` - -**Source Installation** - -```shell -bundle exec rake gitlab:uploads:legacy:migrate -``` - ## Migrate from object storage to local storage If you need to disable Object Storage for any reason, first you need to migrate diff --git a/doc/api/runners.md b/doc/api/runners.md index 523f0363cee..21d768a1605 100644 --- a/doc/api/runners.md +++ b/doc/api/runners.md @@ -162,6 +162,10 @@ GET /runners/:id curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/6" ``` +CAUTION: **Deprecation** +The `token` attribute in the response is deprecated [since GitLab 12.10](https://gitlab.com/gitlab-org/gitlab/-/issues/214320). +It will be removed in [GitLab 13.0](https://gitlab.com/gitlab-org/gitlab/-/issues/214322). + Example response: ```json @@ -221,6 +225,10 @@ PUT /runners/:id curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/6" --form "description=test-1-20150125-test" --form "tag_list=ruby,mysql,tag1,tag2" ``` +CAUTION: **Deprecation** +The `token` attribute in the response is deprecated [since GitLab 12.10](https://gitlab.com/gitlab-org/gitlab/-/issues/214320). +It will be removed in [GitLab 13.0](https://gitlab.com/gitlab-org/gitlab/-/issues/214322). + Example response: ```json diff --git a/doc/user/group/saml_sso/index.md b/doc/user/group/saml_sso/index.md index 2b4170d21af..e78a894d987 100644 --- a/doc/user/group/saml_sso/index.md +++ b/doc/user/group/saml_sso/index.md @@ -112,6 +112,32 @@ To access the Credentials inventory of a group, navigate to **{shield}** **Secur This feature is similar to the [Credentials inventory for self-managed instances](../../admin_area/credentials_inventory.md). +##### Limiting lifetime of personal access tokens of users in Group-managed accounts **(ULTIMATE)** + +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/118893) in GitLab 12.10. + +Users in a group managed account can optionally specify an expiration date for +[personal access tokens](../../profile/personal_access_tokens.md). +This expiration date is not a requirement, and can be set to any arbitrary date. + +Since personal access tokens are the only token needed for programmatic access to GitLab, organizations with security requirements may want to enforce more protection to require regular rotation of these tokens. + +###### Setting a limit + +Only a GitLab administrator or an owner of a Group-managed account can set a limit. Leaving it empty means that the [instance level restrictions](../../admin_area/settings/account_and_limit_settings.md#limiting-lifetime-of-personal-access-tokens-ultimate-only) on the lifetime of personal access tokens will apply. + +To set a limit on how long personal access tokens are valid for users in a group managed account: + +1. Navigate to the **{settings}** **Settings > General** page in your group's sidebar. +1. Expand the **Permissions, LFS, 2FA** section. +1. Fill in the **Maximum allowable lifetime for personal access tokens (days)** field. +1. Click **Save changes**. + +Once a lifetime for personal access tokens is set, GitLab will: + +- Apply the lifetime for new personal access tokens, and require users managed by the group to set an expiration date that is no later than the allowed lifetime. +- After three hours, revoke old tokens with no expiration date or with a lifetime longer than the allowed lifetime. Three hours is given to allow administrators/group owner to change the allowed lifetime, or remove it, before revocation takes place. + ##### Outer forks restriction for Group-managed accounts > [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/34648) in GitLab 12.9. diff --git a/doc/user/project/integrations/bamboo.md b/doc/user/project/integrations/bamboo.md index 726b5f657ea..8c7e6edbf38 100644 --- a/doc/user/project/integrations/bamboo.md +++ b/doc/user/project/integrations/bamboo.md @@ -39,7 +39,7 @@ service in GitLab. 1. Navigate to the project you want to configure to trigger builds. 1. Navigate to the [Integrations page](overview.md#accessing-integrations) 1. Click 'Atlassian Bamboo CI' -1. Select the 'Active' checkbox. +1. Ensure that the **Active** toggle is enabled. 1. Enter the base URL of your Bamboo server. `https://bamboo.example.com` 1. Enter the build key from your Bamboo build plan. Build keys are typically made up from the Project Key and Plan Key that are set on project/plan creation and diff --git a/doc/user/project/integrations/discord_notifications.md b/doc/user/project/integrations/discord_notifications.md index 9252b7dd0f9..aa45cc38cb5 100644 --- a/doc/user/project/integrations/discord_notifications.md +++ b/doc/user/project/integrations/discord_notifications.md @@ -21,7 +21,7 @@ With the webhook URL created in the Discord channel, you can set up the Discord 1. Navigate to the [Integrations page](overview.md#accessing-integrations) in your project's settings. That is, **Project > Settings > Integrations**. 1. Select the **Discord Notifications** integration to configure it. -1. Check the **Active** checkbox to turn on the service. +1. Ensure that the **Active** toggle is enabled. 1. Check the checkboxes corresponding to the GitLab events for which you want to send notifications to Discord. 1. Paste the webhook URL that you copied from the create Discord webhook step. 1. Configure the remaining options and click the **Save changes** button. diff --git a/doc/user/project/integrations/generic_alerts.md b/doc/user/project/integrations/generic_alerts.md index f5d0f5eb21b..1a000fd1c44 100644 --- a/doc/user/project/integrations/generic_alerts.md +++ b/doc/user/project/integrations/generic_alerts.md @@ -18,7 +18,7 @@ To set up the generic alerts integration: 1. Navigate to **Settings > Integrations** in a project. 1. Click on **Alerts endpoint**. -1. Toggle the **Active** alert setting. The `URL` and `Authorization Key` for the webhook configuration can be found there. +1. Toggle the **Active** alert setting. The `URL` and `Authorization Key` for the webhook configuration can be found there. ## Customizing the payload diff --git a/doc/user/project/integrations/github.md b/doc/user/project/integrations/github.md index 2e3801f3a32..42d8eadd35e 100644 --- a/doc/user/project/integrations/github.md +++ b/doc/user/project/integrations/github.md @@ -27,7 +27,7 @@ with `repo:status` access granted: 1. Navigate to the project you want to configure. 1. Navigate to the [Integrations page](overview.md#accessing-integrations) 1. Click "GitHub". -1. Select the "Active" checkbox. +1. Ensure that the **Active** toggle is enabled. 1. Paste the token you've generated on GitHub 1. Enter the path to your project on GitHub, such as `https://github.com/username/repository` 1. Optionally uncheck **Static status check names** checkbox to disable static status check names. diff --git a/doc/user/project/integrations/hangouts_chat.md b/doc/user/project/integrations/hangouts_chat.md index bd32ef91e3c..f33833a9c93 100644 --- a/doc/user/project/integrations/hangouts_chat.md +++ b/doc/user/project/integrations/hangouts_chat.md @@ -19,7 +19,7 @@ When you have the **Webhook URL** for your Hangouts Chat room webhook, you can s 1. Navigate to the [Integrations page](overview.md#accessing-integrations) in your project's settings, i.e. **Project > Settings > Integrations**. 1. Select the **Hangouts Chat** integration to configure it. -1. Check the **Active** checkbox to turn on the service. +1. Ensure that the **Active** toggle is enabled. 1. Check the checkboxes corresponding to the GitLab events you want to receive. 1. Paste the **Webhook URL** that you copied from the Hangouts Chat configuration step. 1. Configure the remaining options and click `Save changes`. diff --git a/doc/user/project/integrations/hipchat.md b/doc/user/project/integrations/hipchat.md index 1e04e28143a..2ed7f13db9b 100644 --- a/doc/user/project/integrations/hipchat.md +++ b/doc/user/project/integrations/hipchat.md @@ -37,7 +37,7 @@ service in GitLab. 1. Navigate to the project you want to configure for notifications. 1. Navigate to the [Integrations page](overview.md#accessing-integrations) 1. Click "HipChat". -1. Select the "Active" checkbox. +1. Ensure that the **Active** toggle is enabled. 1. Insert the `token` field from the URL into the `Token` field on the Web page. 1. Insert the `room` field from the URL into the `Room` field on the Web page. 1. Save or optionally click "Test Settings". diff --git a/doc/user/project/integrations/irker.md b/doc/user/project/integrations/irker.md index db5397ee7d5..2d807d4302b 100644 --- a/doc/user/project/integrations/irker.md +++ b/doc/user/project/integrations/irker.md @@ -28,7 +28,7 @@ need to follow the firsts steps of the next section. 1. Navigate to the project you want to configure for notifications. 1. Navigate to the [Integrations page](overview.md#accessing-integrations) 1. Click "Irker". -1. Select the "Active" checkbox. +1. Ensure that the **Active** toggle is enabled. 1. Enter the server host address where `irkerd` runs (defaults to `localhost`) in the `Server host` field on the Web page 1. Enter the server port of `irkerd` (e.g. defaults to 6659) in the diff --git a/doc/user/project/integrations/mattermost_slash_commands.md b/doc/user/project/integrations/mattermost_slash_commands.md index 6abd613a019..a23d8d7306d 100644 --- a/doc/user/project/integrations/mattermost_slash_commands.md +++ b/doc/user/project/integrations/mattermost_slash_commands.md @@ -103,7 +103,7 @@ in a new slash command. ### Step 4. Copy the Mattermost token into the Mattermost slash command service 1. In GitLab, paste the Mattermost token you copied in the previous step and - check the **Active** checkbox. + ensure that the **Active** toggle is enabled. ![Mattermost copy token to GitLab](img/mattermost_gitlab_token.png) diff --git a/doc/user/project/integrations/slack.md b/doc/user/project/integrations/slack.md index 6ceb398fa17..ba2a8f55d84 100644 --- a/doc/user/project/integrations/slack.md +++ b/doc/user/project/integrations/slack.md @@ -14,7 +14,7 @@ The Slack Notifications Service allows your GitLab project to send events (e.g. 1. Navigate to the [Integrations page](overview.md#accessing-integrations) in your project's settings, i.e. **Project > Settings > Integrations**. 1. Select the **Slack notifications** integration to configure it. -1. Check the **Active** checkbox to turn on the service. +1. Ensure that the **Active** toggle is enabled. 1. Check the checkboxes corresponding to the GitLab events you want to send to Slack as a notification. 1. For each event, optionally enter the Slack channel names where you want to send the event, separated by a comma. If left empty, the event will be sent to the default channel that you configured in the Slack Configuration step. **Note:** Usernames and private channels are not supported. To send direct messages, use the Member ID found under user's Slack profile. 1. Paste the **Webhook URL** that you copied from the Slack Configuration step. diff --git a/doc/user/project/integrations/slack_slash_commands.md b/doc/user/project/integrations/slack_slash_commands.md index d39d5cde46a..d25a367bd1f 100644 --- a/doc/user/project/integrations/slack_slash_commands.md +++ b/doc/user/project/integrations/slack_slash_commands.md @@ -19,7 +19,7 @@ For GitLab.com, use the [Slack app](gitlab_slack_application.md) instead. 1. Enter a trigger term. We suggest you use the project name. Click **Add Slash Command Integration**. 1. Complete the rest of the fields in the Slack configuration page using information from the GitLab browser tab. In particular, the URL needs to be copied and pasted. Click **Save Integration** to complete the configuration in Slack. 1. While still on the Slack configuration page, copy the **token**. Go back to the GitLab browser tab and paste in the **token**. -1. Check the **Active** checkbox and click **Save changes** to complete the configuration in GitLab. +1. Ensure that the **Active** toggle is enabled and click **Save changes** to complete the configuration in GitLab. ![Slack setup instructions](img/slack_setup.png) diff --git a/doc/user/project/integrations/unify_circuit.md b/doc/user/project/integrations/unify_circuit.md index 51f524f95c3..98dc6f298d5 100644 --- a/doc/user/project/integrations/unify_circuit.md +++ b/doc/user/project/integrations/unify_circuit.md @@ -17,7 +17,7 @@ When you have the **Webhook URL** for your Unify Circuit conversation webhook, y 1. Navigate to the [Integrations page](overview.md#accessing-integrations) in your project's settings, i.e. **Project > Settings > Integrations**. 1. Select the **Unify Circuit** integration to configure it. -1. Check the **Active** checkbox to turn on the service. +1. Ensure that the **Active** toggle is enabled. 1. Check the checkboxes corresponding to the GitLab events you want to receive in Unify Circuit. 1. Paste the **Webhook URL** that you copied from the Unify Circuit configuration step. 1. Configure the remaining options and click `Save changes`. diff --git a/doc/user/project/releases/index.md b/doc/user/project/releases/index.md index 37da3d0bb4a..bae514153ac 100644 --- a/doc/user/project/releases/index.md +++ b/doc/user/project/releases/index.md @@ -309,12 +309,12 @@ Here is an example of a Release Evidence object: ### Enabling Release Evidence display **(CORE ONLY)** This feature comes with the `:release_evidence_collection` feature flag -disabled by default in GitLab self-managed instances. To turn it on, +enabled by default in GitLab self-managed instances. To turn it off, ask a GitLab administrator with Rails console access to run the following command: ```ruby -Feature.enable(:release_evidence_collection) +Feature.disable(:release_evidence_collection) ``` NOTE: **Note:** |