Commit f3888772 authored by Nick Gaskill's avatar Nick Gaskill

Merge branch '336903-aqualls-download-wiki' into 'master'

Explain how to export group wikis

See merge request gitlab-org/gitlab!66961
parents 050ecf64 eade04b9
......@@ -19,9 +19,11 @@ See also:
- [Project Import/Export](../../project/settings/import_export.md)
- [Project Import/Export API](../../../api/project_import_export.md)
To enable GitLab import/export:
Users with the [Owner role](../../permissions.md) for a group can enable
import and export for that group:
1. On the top bar, go to **Menu > Admin > Settings > General > Visibility and access controls**.
1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > General > Visibility and access controls**.
1. Scroll to **Import sources**.
1. Enable the desired **Import sources**.
......@@ -48,7 +50,8 @@ The following items are exported:
- Subgroups (including all the aforementioned data)
- Epics
- Events
- Wikis **(PREMIUM SELF)** (Introduced in [GitLab 13.9](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/53247))
- [Wikis](../../project/wiki/index.md#group-wikis) **(PREMIUM SELF)**
(Introduced in [GitLab 13.9](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/53247))
The following items are **not** exported:
......@@ -60,21 +63,21 @@ NOTE:
For more details on the specific data persisted in a group export, see the
[`import_export.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/import_export/group/import_export.yml) file.
## Exporting a Group
## Export a group
1. Navigate to your group's homepage.
1. Click **Settings** in the sidebar.
1. In the **Advanced** section, click the **Export Group** button.
![Export group panel](img/export_panel_v13_0.png)
Users with the [Owner role](../../permissions.md) for a group can export the
contents of that group:
1. On the top bar, select **Menu >** **Groups** and find your group.
1. In the left sidebar, select **Settings**.
1. Scroll to the **Advanced** section, and select **Export Group**.
1. After the export is generated, you should receive an email with a link to the [exported contents](#exported-contents)
in a compressed tar archive, with contents in NDJSON format.
1. Alternatively, you can download the export from the UI:
1. Alternatively, you can come back to the project settings and download the
file from there by clicking **Download export**, or generate a new file by clicking **Regenerate export**.
1. Return to your group's **Settings > General** page.
1. Scroll to the **Advanced** section, and select **Download export**.
You can also generate a new file by clicking **Regenerate export**.
NOTE:
The maximum import file size can be set by the Administrator, default is `0` (unlimited).
......@@ -103,7 +106,7 @@ on an existing group's page.
1. Click **Choose file**
1. Select the file that you exported in the [exporting a group](#exporting-a-group) section.
1. Select the file that you exported in the [Export a group](#export-a-group) section.
1. Click **Import group** to begin importing. Your newly imported group page appears after the operation completes.
......
......@@ -253,6 +253,14 @@ Group wikis can be edited by members with the [Developer role](../../permissions
and above. Group wiki repositories can be moved using the
[Group repository storage moves API](../../../api/group_repository_storage_moves.md).
### Export a group wiki **(PREMIUM)**
Users with the [Owner role](../../permissions.md) in a group can
[import and export group wikis](../../group/settings/import_export.md) when importing
or exporting a group.
Content created in a group wiki is not deleted when an account is downgraded or a GitLab trial ends.
## Link an external wiki
To add a link to an external wiki from a project's left sidebar:
......
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