Commit 6ad1ecd0 authored by Evan Read's avatar Evan Read

Merge branch 'deastman-docs-group-view-runners-37366' into 'master'

Docs: Group view runners

See merge request gitlab-org/gitlab!36404
parents a1150528 43c597ba
...@@ -156,14 +156,43 @@ To create a group Runner: ...@@ -156,14 +156,43 @@ To create a group Runner:
1. Note the URL and token. 1. Note the URL and token.
1. [Register the Runner](https://docs.gitlab.com/runner/register/). 1. [Register the Runner](https://docs.gitlab.com/runner/register/).
#### View and manage group Runners
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/37366/) in GitLab 13.2.
You can view and manage all Runners for a group, its subgroups, and projects.
You can do this for your self-managed GitLab instance or for GitLab.com.
You must have [Owner permissions](../../user/permissions.md#group-members-permissions) for the group.
1. Go to the group where you want to view the Runners.
1. Go to **{settings}** **Settings > CI/CD** and expand the **Runners** section.
1. The following fields are displayed.
| Attribute | Description |
| ------------ | ----------- |
| Type | One or more of the following states: shared, group, specific, locked, or paused |
| Runner token | Token used to identify the Runner, and which the Runner uses to communicate with the GitLab instance |
| Description | Description given to the Runner when it was created |
| Version | GitLab Runner version |
| IP address | IP address of the host on which the Runner is registered |
| Projects | The count of projects to which the Runner is assigned |
| Jobs | Total of jobs run by the Runner |
| Tags | Tags associated with the Runner |
| Last contact | Timestamp indicating when the GitLab instance last contacted the Runner |
From this page, you can edit, pause, and remove Runners from the group, its subgroups, and projects.
#### Pause or remove a group Runner #### Pause or remove a group Runner
You can pause or remove a group Runner. You can pause or remove a group Runner for your self-managed GitLab instance or for GitLab.com.
You must have [Owner permissions](../../user/permissions.md#group-members-permissions) for the group. You must have [Owner permissions](../../user/permissions.md#group-members-permissions) for the group.
1. Go to the group you want to remove or pause the Runner for. 1. Go to the group you want to remove or pause the Runner for.
1. Go to **{settings}** **Settings > CI/CD** and expand the **Runners** section. 1. Go to **{settings}** **Settings > CI/CD** and expand the **Runners** section.
1. Click **Pause** or **Remove Runner**. 1. Click **Pause** or **Remove Runner**.
- If you pause a group Runner that is used by multiple projects, the Runner pauses for all projects.
- From the group view, you cannot remove a Runner that is assigned to more than one project.
You must remove it from each project first.
1. On the confirmation dialog, click **OK**. 1. On the confirmation dialog, click **OK**.
### Specific Runners ### Specific Runners
......
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