Commit 236488c2 authored by Amy Qualls's avatar Amy Qualls

Update admin area instructions, Create, part 1

The first of two merge requests to update the Create docset with
the new instructions for accessing the Admin Area.
parent b8008c9c
...@@ -56,7 +56,7 @@ read the [Kroki installation](https://docs.kroki.io/kroki/setup/install/#_images ...@@ -56,7 +56,7 @@ read the [Kroki installation](https://docs.kroki.io/kroki/setup/install/#_images
You need to enable Kroki integration from Settings under Admin Area. You need to enable Kroki integration from Settings under Admin Area.
To do that, log in with an administrator account and follow these steps: To do that, log in with an administrator account and follow these steps:
1. Select the Admin Area (**{admin}**) icon. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. Go to **Settings > General**. 1. Go to **Settings > General**.
1. Expand the **Kroki** section. 1. Expand the **Kroki** section.
1. Select **Enable Kroki** checkbox. 1. Select **Enable Kroki** checkbox.
......
...@@ -100,6 +100,7 @@ they receive a `Connection failed` message. ...@@ -100,6 +100,7 @@ they receive a `Connection failed` message.
By default, terminal sessions do not expire. To limit the terminal session By default, terminal sessions do not expire. To limit the terminal session
lifetime in your GitLab instance: lifetime in your GitLab instance:
1. Go to the Admin Area (**{admin}**) and select 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. Select
[**Settings > Web terminal**](../../user/admin_area/settings/index.md#general). [**Settings > Web terminal**](../../user/admin_area/settings/index.md#general).
1. Set a `max session time`. 1. Set a `max session time`.
...@@ -16,7 +16,8 @@ from an external storage, such as a Content Delivery Network (CDN). ...@@ -16,7 +16,8 @@ from an external storage, such as a Content Delivery Network (CDN).
To configure external storage for static objects: To configure external storage for static objects:
1. Go to **Admin Area > Settings > Repository**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Repository**.
1. Expand the **Repository static objects** section. 1. Expand the **Repository static objects** section.
1. Enter the base URL and an arbitrary token. When you [set up external storage](#set-up-external-storage), 1. Enter the base URL and an arbitrary token. When you [set up external storage](#set-up-external-storage),
use a script that sets these values as `ORIGIN_HOSTNAME` and `STORAGE_TOKEN`. use a script that sets these values as `ORIGIN_HOSTNAME` and `STORAGE_TOKEN`.
......
...@@ -8,8 +8,10 @@ info: To determine the technical writer assigned to the Stage/Group associated w ...@@ -8,8 +8,10 @@ info: To determine the technical writer assigned to the Stage/Group associated w
All methods require administrator authorization. All methods require administrator authorization.
The URL endpoint of the system hooks can also be configured using the UI in You can configure the URL endpoint of the system hooks from the GitLab user interface:
the **Admin Area > System Hooks** (`/admin/hooks`).
1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. Select **System Hooks** (`/admin/hooks`).
Read more about [system hooks](../system_hooks/system_hooks.md). Read more about [system hooks](../system_hooks/system_hooks.md).
......
...@@ -24,7 +24,8 @@ brew services start jenkins ...@@ -24,7 +24,8 @@ brew services start jenkins
GitLab does not allow requests to localhost or the local network by default. When running Jenkins on your local machine, you need to enable local access. GitLab does not allow requests to localhost or the local network by default. When running Jenkins on your local machine, you need to enable local access.
1. Log into your GitLab instance as an administrator. 1. Log into your GitLab instance as an administrator.
1. Go to **Admin Area > Settings > Network**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Network**.
1. Expand **Outbound requests** and check the following checkboxes: 1. Expand **Outbound requests** and check the following checkboxes:
- **Allow requests to the local network from web hooks and services** - **Allow requests to the local network from web hooks and services**
......
...@@ -25,8 +25,10 @@ To use Akismet: ...@@ -25,8 +25,10 @@ To use Akismet:
1. Go to the [Akismet sign-in page](https://akismet.com/account/). 1. Go to the [Akismet sign-in page](https://akismet.com/account/).
1. Sign in or create a new account. 1. Sign in or create a new account.
1. Click **Show** to reveal the API key. 1. Click **Show** to reveal the API key, and copy the API key's value.
1. Go to **Admin Area > Settings > Reporting** (`/admin/application_settings/reporting`). 1. Sign in to GitLab as an administrator.
1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Reporting** (`/admin/application_settings/reporting`).
1. Select the **Enable Akismet** checkbox. 1. Select the **Enable Akismet** checkbox.
1. Fill in the API key from step 3. 1. Fill in the API key from step 3.
1. Save the configuration. 1. Save the configuration.
......
...@@ -45,7 +45,8 @@ For GitLab self-managed instances, a GitLab administrator needs to: ...@@ -45,7 +45,8 @@ For GitLab self-managed instances, a GitLab administrator needs to:
1. Set up a Gitpod instance to integrate with GitLab. Refer to the [Gitpod documentation](https://www.gitpod.io/docs/self-hosted/latest/self-hosted/) 1. Set up a Gitpod instance to integrate with GitLab. Refer to the [Gitpod documentation](https://www.gitpod.io/docs/self-hosted/latest/self-hosted/)
to get your instance up and running. to get your instance up and running.
1. Enable it in GitLab: 1. Enable it in GitLab:
1. Go to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Gitpod** configuration section. 1. Expand the **Gitpod** configuration section.
1. Check the **Enable Gitpod integration** checkbox. 1. Check the **Enable Gitpod integration** checkbox.
1. Add your Gitpod instance URL (for example, `https://gitpod.example.com`). 1. Add your Gitpod instance URL (for example, `https://gitpod.example.com`).
......
...@@ -261,7 +261,7 @@ By default, **Sign In** is enabled by using all the OAuth Providers that have be ...@@ -261,7 +261,7 @@ By default, **Sign In** is enabled by using all the OAuth Providers that have be
To enable/disable an OmniAuth provider: To enable/disable an OmniAuth provider:
1. In the top navigation bar, go to **Admin Area**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, go to **Settings**. 1. In the left sidebar, go to **Settings**.
1. Scroll to the **Sign-in Restrictions** section, and click **Expand**. 1. Scroll to the **Sign-in Restrictions** section, and click **Expand**.
1. Below **Enabled OAuth Sign-In sources**, select the check box for each provider you want to enable or disable. 1. Below **Enabled OAuth Sign-In sources**, select the check box for each provider you want to enable or disable.
......
...@@ -22,7 +22,8 @@ Only the complete settings for an integration can be inherited. Per-field inheri ...@@ -22,7 +22,8 @@ Only the complete settings for an integration can be inherited. Per-field inheri
> - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/2137) in GitLab 13.3 for project-level integrations. > - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/2137) in GitLab 13.3 for project-level integrations.
> - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/2543) in GitLab 13.6 for group-level integrations. > - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/2543) in GitLab 13.6 for group-level integrations.
1. Navigate to **Admin Area > Settings > Integrations**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Integrations**.
1. Select an integration. 1. Select an integration.
1. Enter configuration details and click **Save changes**. 1. Enter configuration details and click **Save changes**.
...@@ -53,7 +54,8 @@ integration on all non-configured groups and projects by default. ...@@ -53,7 +54,8 @@ integration on all non-configured groups and projects by default.
### Remove an instance-level default setting ### Remove an instance-level default setting
1. Navigate to **Admin Area > Settings > Integrations**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Integrations**.
1. Select an integration. 1. Select an integration.
1. Click **Reset** and confirm. 1. Click **Reset** and confirm.
......
...@@ -67,9 +67,9 @@ After you enable custom slash commands in Mattermost, you need configuration ...@@ -67,9 +67,9 @@ After you enable custom slash commands in Mattermost, you need configuration
information from GitLab. To get this information: information from GitLab. To get this information:
1. In a different browser tab than your current Mattermost session, sign in to 1. In a different browser tab than your current Mattermost session, sign in to
GitLab as a user with [administrator permissions](../../permissions.md). GitLab as a user with [Administrator role](../../permissions.md).
1. In the top navigation bar, go to **{admin}** **Admin Area**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left menu, go to **Settings > Integrations** and select 1. In the left menu, select **Settings > Integrations**, then select
**Mattermost slash commands**. **Mattermost slash commands**.
1. GitLab displays potential values for Mattermost settings. Copy the **Request URL** 1. GitLab displays potential values for Mattermost settings. Copy the **Request URL**
as you need it for the next step. All other values are suggestions. as you need it for the next step. All other values are suggestions.
......
...@@ -27,7 +27,8 @@ notifications: ...@@ -27,7 +27,8 @@ notifications:
1. Navigate to: 1. Navigate to:
- **Settings > Integrations** in a project to enable the integration at the project level. - **Settings > Integrations** in a project to enable the integration at the project level.
- **Settings > Integrations** in a group to enable the integration at the group level. - **Settings > Integrations** in a group to enable the integration at the group level.
- **Settings > Integrations** in the Admin Area (**{admin}**) to enable an instance-level integration. - On the top bar, select **Menu >** **{admin}** **Admin**. Then, in the left sidebar,
select **Settings > Integrations** to enable an instance-level integration.
1. Select the **Webex Teams** integration. 1. Select the **Webex Teams** integration.
1. Ensure that the **Active** toggle is enabled. 1. Ensure that the **Active** toggle is enabled.
1. Select the checkboxes corresponding to the GitLab events you want to receive in Webex Teams. 1. Select the checkboxes corresponding to the GitLab events you want to receive in Webex Teams.
......
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