diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2023-05-17 12:10:09 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2023-05-17 12:10:09 +0300 |
commit | eeb25534bae1021f5b7940138ee56dea8fc79949 (patch) | |
tree | 26cf3d6a4ac582ed3d0d3a20b82a200da580f1e3 /doc | |
parent | 75621c94b5dbe233edd72c3d8cc602fed25e84d2 (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc')
-rw-r--r-- | doc/api/merge_request_approvals.md | 14 | ||||
-rw-r--r-- | doc/api/search_admin.md | 125 | ||||
-rw-r--r-- | doc/update/removals.md | 10 | ||||
-rw-r--r-- | doc/user/group/epics/index.md | 7 | ||||
-rw-r--r-- | doc/user/project/issues/index.md | 7 |
5 files changed, 163 insertions, 0 deletions
diff --git a/doc/api/merge_request_approvals.md b/doc/api/merge_request_approvals.md index ccd79c697a0..19179bddb00 100644 --- a/doc/api/merge_request_approvals.md +++ b/doc/api/merge_request_approvals.md @@ -596,6 +596,20 @@ Supported attributes: } ``` +<!--- start_remove The following content will be removed on remove_date: '2023-08-17' --> + +### Change approval configuration (removed) + +> - Endpoint `/approvals` [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/11132) in GitLab 12.3. +> - Endpoint `approvals` [disabled](https://gitlab.com/gitlab-org/gitlab/-/issues/353097) in GitLab 16.0 [with a flag](../administration/feature_flags.md) named `remove_deprecated_approvals`. Disabled by default. + +The endpoint `POST /projects/:id/merge_requests/:merge_request_iid/approvals` was +deprecated in GitLab 12.3, and removed in GitLab 16.0. To change the approvals +required for a merge request, use the `/approval_rules` endpoint described in +[Create merge request level rule](#create-merge-request-level-rule) on this page. + +<!--- end_remove --> + ### Get the approval state of merge requests > Moved to GitLab Premium in 13.9. diff --git a/doc/api/search_admin.md b/doc/api/search_admin.md new file mode 100644 index 00000000000..9e1aa1a4439 --- /dev/null +++ b/doc/api/search_admin.md @@ -0,0 +1,125 @@ +--- +stage: Data Stores +group: Global Search +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments +--- + +# Search admin API **(PREMIUM SELF)** + +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/120751) in GitLab 16.1 + +The search admin API returns information about [advanced search migrations](../integration/advanced_search/elasticsearch.md#advanced-search-migrations). + +You must have administrator access to use this API. + +## List all advanced search migrations + +Get a list of all advanced search migrations for the GitLab instance. + +```plaintext +GET /admin/search/migrations +``` + +Example request: + +```shell +curl --header "PRIVATE-TOKEN: <your_access_token>" "https://primary.example.com/api/v4/admin/search/migrations" +``` + +Example response: + +```json +[ + { + "version": 20230427555555, + "name": "BackfillHiddenOnMergeRequests", + "started_at": "2023-05-12T01:35:05.469+00:00", + "completed_at": "2023-05-12T01:36:06.432+00:00", + "completed": true, + "obsolete": false, + "migration_state": {} + }, + { + "version": 20230428500000, + "name": "AddSuffixProjectInWikiRid", + "started_at": "2023-05-04T18:59:43.542+00:00", + "completed_at": "2023-05-04T18:59:43.542+00:00", + "completed": false, + "obsolete": false, + "migration_state": { + "pause_indexing": true, + "slice": 1, + "task_id": null, + "max_slices": 5, + "retry_attempt": 0 + } + }, + { + "version": 20230503064300, + "name": "BackfillProjectPermissionsInBlobsUsingPermutations", + "started_at": "2023-05-03T16:04:44.074+00:00", + "completed_at": "2023-05-03T16:04:44.074+00:00", + "completed": true, + "obsolete": false, + "migration_state": { + "permutation_idx": 8, + "documents_remaining": 5, + "task_id": "I2_LXc-xQlOeu-KmjYpM8g:172820", + "documents_remaining_for_permutation": 0 + } + } +] +``` + +## Get an advanced search migration + +Get a single advanced search migration by providing the migration version or name. + +```plaintext +GET /admin/search/mirations/:version_or_name +``` + +Parameters: + +| Attribute | Type | Required | Description | +|-------------------|----------------|----------|--------------------------------------| +| `version_or_name` | integer/string | Yes | The version or name of the migration. | + +Example request: + +```shell +curl --header "PRIVATE-TOKEN: <your_access_token>" "https://primary.example.com/api/v4/admin/search/mirations/20230503064300" +curl --header "PRIVATE-TOKEN: <your_access_token>" "https://primary.example.com/api/v4/admin/search/mirations/BackfillProjectPermissionsInBlobsUsingPermutations" +``` + +If successful, returns [`200`](rest/index.md#status-codes) and the following +response attributes: + +| Attribute | Type | Description | +|:------------------|:---------|:------------------------------------------------------| +| `version` | integer | Version of the migration. | +| `name` | string | Name of the migration. | +| `started_at` | datetime | Start date for the migration. | +| `completed_at` | datetime | Completion date for the migration. | +| `completed` | boolean | If `true`, the migration is completed. | +| `obsolete` | boolean | If `true`, the migration has been marked as obsolete. | +| `migration_state` | object | Stored migration state. | + +Example response: + +```json +{ + "version": 20230503064300, + "name": "BackfillProjectPermissionsInBlobsUsingPermutations", + "started_at": "2023-05-03T16:04:44.074+00:00", + "completed_at": "2023-05-03T16:04:44.074+00:00", + "completed": true, + "obsolete": false, + "migration_state": { + "permutation_idx": 8, + "documents_remaining": 5, + "task_id": "I2_LXc-xQlOeu-KmjYpM8g:172820", + "documents_remaining_for_permutation": 0 + } +} +``` diff --git a/doc/update/removals.md b/doc/update/removals.md index 1673fb6bf49..e371e2f0fb0 100644 --- a/doc/update/removals.md +++ b/doc/update/removals.md @@ -804,6 +804,16 @@ The predefined CI/CD variables that start with `CI_BUILD_*` were deprecated in G | `CI_BUILD_TOKEN` | `CI_JOB_TOKEN` | | `CI_BUILD_TRIGGERED` | `CI_PIPELINE_TRIGGERED` | +### `POST /projects/:id/merge_requests/:merge_request_iid/approvals` removed + +<div class="deprecation-notes"> +- Announced in: GitLab <span class="milestone">12.3</span> +- This is a [breaking change](https://docs.gitlab.com/ee/development/deprecation_guidelines/). Review the details carefully before upgrading. +- To discuss this change or learn more, see the [deprecation issue](https://gitlab.com/gitlab-org/gitlab/-/issues/353097). +</div> + +The `/approvals` endpoint was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/11132) in GitLab 12.3. To change the approvals required for a merge request via the API, use the `/approval_rules` endpoint described in [Create merge request level rule](https://docs.gitlab.com/ee/api/merge_request_approvals.html#create-merge-request-level-rule). + ### `POST ci/lint` API endpoint removed <div class="deprecation-notes"> diff --git a/doc/user/group/epics/index.md b/doc/user/group/epics/index.md index 32454693d71..5d3bac4f895 100644 --- a/doc/user/group/epics/index.md +++ b/doc/user/group/epics/index.md @@ -19,6 +19,13 @@ Use epics: - To track when the work for the group of issues is targeted to begin and end. - To discuss and collaborate on feature ideas and scope at a high level. +<div class="video-fallback"> + See the video: <a href="https://www.youtube.com/watch?v=kdE-yb6Puuo">GitLab Epics - Setting up your Organization with GitLab</a>. +</div> +<figure class="video-container"> + <iframe src="https://www.youtube-nocookie.com/embed/kdE-yb6Puuo" frameborder="0" allowfullscreen> </iframe> +</figure> + ## Relationships between epics and issues The possible relationships between epics and issues are: diff --git a/doc/user/project/issues/index.md b/doc/user/project/issues/index.md index 6c9a645d817..a43dd65ed74 100644 --- a/doc/user/project/issues/index.md +++ b/doc/user/project/issues/index.md @@ -22,6 +22,13 @@ For more information about using issues, see the GitLab blog post: Issues are always associated with a specific project. If you have multiple projects in a group, you can view all of the projects' issues at once. +<div class="video-fallback"> + See the video: <a href="https://www.youtube.com/watch?v=tTE6omrBBZI">Issues - Setting up your Organization with GitLab</a>. +</div> +<figure class="video-container"> + <iframe src="https://www.youtube-nocookie.com/embed/tTE6omrBBZI" frameborder="0" allowfullscreen> </iframe> +</figure> + <i class="fa fa-youtube-play youtube" aria-hidden="true"></i> To learn how the GitLab Strategic Marketing department uses GitLab issues with [labels](../labels.md) and [issue boards](../issue_board.md), see the video on |