diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-02-27 03:08:49 +0000 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-02-27 03:08:49 +0000 |
commit | 996c6bf06f602ada62e3f754c121c17051072892 (patch) | |
tree | c7568793468de0faef693795e00f34c07da8e793 /doc | |
parent | 0a0e82d1440b06650e5fc524168b1f50a8feec68 (diff) | |
download | gitlab-ce-996c6bf06f602ada62e3f754c121c17051072892.tar.gz |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc')
-rw-r--r-- | doc/api/graphql/reference/gitlab_schema.graphql | 30 | ||||
-rw-r--r-- | doc/api/graphql/reference/gitlab_schema.json | 68 | ||||
-rw-r--r-- | doc/api/group_import_export.md | 37 | ||||
-rw-r--r-- | doc/development/README.md | 2 | ||||
-rw-r--r-- | doc/development/contributing/merge_request_workflow.md | 1 | ||||
-rw-r--r-- | doc/user/project/settings/import_export.md | 1 |
6 files changed, 126 insertions, 13 deletions
diff --git a/doc/api/graphql/reference/gitlab_schema.graphql b/doc/api/graphql/reference/gitlab_schema.graphql index 816512c83bb..5cf48ab901d 100644 --- a/doc/api/graphql/reference/gitlab_schema.graphql +++ b/doc/api/graphql/reference/gitlab_schema.graphql @@ -5404,6 +5404,16 @@ type Project { """ issue( """ + ID of a user assigned to the issues, "none" and "any" values supported + """ + assigneeId: String + + """ + Username of a user assigned to the issues + """ + assigneeUsername: String + + """ Issues closed after this date """ closedAfter: Time @@ -5439,6 +5449,11 @@ type Project { labelName: [String] """ + Milestones applied to this issue + """ + milestoneTitle: [String] + + """ Search query for finding issues by title or description """ search: String @@ -5474,6 +5489,16 @@ type Project { after: String """ + ID of a user assigned to the issues, "none" and "any" values supported + """ + assigneeId: String + + """ + Username of a user assigned to the issues + """ + assigneeUsername: String + + """ Returns the elements in the list that come before the specified cursor. """ before: String @@ -5524,6 +5549,11 @@ type Project { last: Int """ + Milestones applied to this issue + """ + milestoneTitle: [String] + + """ Search query for finding issues by title or description """ search: String diff --git a/doc/api/graphql/reference/gitlab_schema.json b/doc/api/graphql/reference/gitlab_schema.json index 2053bdb9404..ba716f82630 100644 --- a/doc/api/graphql/reference/gitlab_schema.json +++ b/doc/api/graphql/reference/gitlab_schema.json @@ -750,6 +750,40 @@ "defaultValue": null }, { + "name": "milestoneTitle", + "description": "Milestones applied to this issue", + "type": { + "kind": "LIST", + "name": null, + "ofType": { + "kind": "SCALAR", + "name": "String", + "ofType": null + } + }, + "defaultValue": null + }, + { + "name": "assigneeUsername", + "description": "Username of a user assigned to the issues", + "type": { + "kind": "SCALAR", + "name": "String", + "ofType": null + }, + "defaultValue": null + }, + { + "name": "assigneeId", + "description": "ID of a user assigned to the issues, \"none\" and \"any\" values supported", + "type": { + "kind": "SCALAR", + "name": "String", + "ofType": null + }, + "defaultValue": null + }, + { "name": "createdBefore", "description": "Issues created before this date", "type": { @@ -895,6 +929,40 @@ "defaultValue": null }, { + "name": "milestoneTitle", + "description": "Milestones applied to this issue", + "type": { + "kind": "LIST", + "name": null, + "ofType": { + "kind": "SCALAR", + "name": "String", + "ofType": null + } + }, + "defaultValue": null + }, + { + "name": "assigneeUsername", + "description": "Username of a user assigned to the issues", + "type": { + "kind": "SCALAR", + "name": "String", + "ofType": null + }, + "defaultValue": null + }, + { + "name": "assigneeId", + "description": "ID of a user assigned to the issues, \"none\" and \"any\" values supported", + "type": { + "kind": "SCALAR", + "name": "String", + "ofType": null + }, + "defaultValue": null + }, + { "name": "createdBefore", "description": "Issues created before this date", "type": { diff --git a/doc/api/group_import_export.md b/doc/api/group_import_export.md index c97a753d298..09bc9810615 100644 --- a/doc/api/group_import_export.md +++ b/doc/api/group_import_export.md @@ -1,19 +1,19 @@ # Group Import/Export API -> Introduced in GitLab 12.8 as an experimental feature. May change in future releases. +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/20353) in GitLab 12.8 as an experimental feature. May change in future releases. -Group Import/Export functionality allows to export group structure and import it at a new location. -Used in combination with [Project Import/Export](project_import_export.md) it allows you to preserve connections with group level relations -(e.g. a connection between a project issue and group epic). +Group Import/Export allows you to export group structure and import it to a new location. +When used with [Project Import/Export](project_import_export.md), you can preserve connections with +group-level relationships, such as connections between project issues and group epics. -Group Export includes: +Group exports include the following: -1. Group Milestones -1. Group Boards -1. Group Labels -1. Group Badges -1. Group Members -1. Sub-groups (each sub-group includes all data above) +- Group milestones +- Group boards +- Group labels +- Group badges +- Group members +- Sub-groups. Each sub-group includes all data above ## Schedule new export @@ -58,7 +58,11 @@ ls *export.tar.gz 2020-12-05_22-11-148_namespace_export.tar.gz ``` -Time spent on exporting a group may vary depending on a size of the group. Export download endpoint will return exported archive once it is available. 404 is returned otherwise. +Time spent on exporting a group may vary depending on a size of the group. This endpoint +returns either: + +- The exported archive (when available) +- A 404 message ## Import a file @@ -81,3 +85,12 @@ by `@`. For example: ```shell curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form "name=imported-group" --form "path=imported-group" --form "file=@/path/to/file" https://gitlab.example.com/api/v4/groups/import ``` + +## Important notes + +Note the following: + +- To preserve group-level relationships from imported projects, run Group Import/Export first, + to allow project imports into the desired group structure. +- Imported groups are given a `private` visibility level, unless imported into a parent group. +- If imported into a parent group, subgroups will inherit a similar level of visibility, unless otherwise restricted. diff --git a/doc/development/README.md b/doc/development/README.md index 039b53d7adf..d1ad9216596 100644 --- a/doc/development/README.md +++ b/doc/development/README.md @@ -22,7 +22,7 @@ description: 'Learn how to contribute to GitLab.' - [Code review guidelines](code_review.md) for reviewing code and having code reviewed - [Database review guidelines](database_review.md) for reviewing database-related changes and complex SQL queries, and having them reviewed -- [Secure coding guidlines](https://gitlab.com/gitlab-com/gl-security/security-guidelines) +- [Secure coding guidelines](https://gitlab.com/gitlab-com/gl-security/security-guidelines) - [Pipelines for the GitLab project](pipelines.md) Complementary reads: diff --git a/doc/development/contributing/merge_request_workflow.md b/doc/development/contributing/merge_request_workflow.md index cf71d436a15..460bb6d25df 100644 --- a/doc/development/contributing/merge_request_workflow.md +++ b/doc/development/contributing/merge_request_workflow.md @@ -222,6 +222,7 @@ requirements. 1. Regressions and bugs are covered with tests that reduce the risk of the issue happening again. 1. [Performance guidelines](../merge_request_performance_guidelines.md) have been followed. +1. [Secure coding guidelines](https://gitlab.com/gitlab-com/gl-security/security-guidelines) have been followed. 1. [Documented](../documentation/index.md) in the `/doc` directory. 1. [Changelog entry added](../changelog.md), if necessary. 1. Reviewed by relevant (UX/FE/BE/tech writing) reviewers and all concerns are addressed. diff --git a/doc/user/project/settings/import_export.md b/doc/user/project/settings/import_export.md index 716078ed1d1..1a4023b6ded 100644 --- a/doc/user/project/settings/import_export.md +++ b/doc/user/project/settings/import_export.md @@ -12,6 +12,7 @@ See also: - [Project import/export API](../../../api/project_import_export.md) - [Project import/export administration rake tasks](../../../administration/raketasks/project_import_export.md) **(CORE ONLY)** +- [Group import/export API](../../../api/group_import_export.md) To set up a project import/export: |