Skip to content

G
gitlab-ce
Commit b2e95fde authored by Marcel Amirault's avatar Marcel Amirault Committed by Suzanne Selhorn
Browse files
Options

Update navigation to admin area in verify docs

parent b9a5a079
Hide whitespace changes
Inline Side-by-side
Showing with 63 additions and 56 deletions
doc/ci/variables/README.md
View file @ b2e95fde
...@@ -199,19 +199,20 @@ inherited. ...@@ -199,19 +199,20 @@ inherited.
![CI/CD settings - inherited variables](img/inherited_group_variables_v12_5.png) ![CI/CD settings - inherited variables](img/inherited_group_variables_v12_5.png)
### Add a CI/CD variable to an instance ### Add a CI/CD variable to an instance **(FREE SELF)**
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/14108) in GitLab 13.0. > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/14108) in GitLab 13.0.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/299879) in GitLab 13.11. > - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/299879) in GitLab 13.11.
To make a CI/CD variable available to all projects and groups in a GitLab instance, To make a CI/CD variable available to all projects and groups in a GitLab instance,
define an instance CI/CD variable. add an instance CI/CD variable. You must have the [Administrator role](../../user/permissions.md).
You can define instance variables via the UI or [API](../../api/instance_level_ci_variables.md). You can define instance variables via the UI or [API](../../api/instance_level_ci_variables.md).
To add an instance variable: To add an instance variable:
1. Navigate to your Admin Area's **Settings > CI/CD** and expand the **Variables** section. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD** and expand the **Variables** section.
1. Select the **Add variable** button, and fill in the details: 1. Select the **Add variable** button, and fill in the details:
- **Key**: Must be one line, with no spaces, using only letters, numbers, or `_`. - **Key**: Must be one line, with no spaces, using only letters, numbers, or `_`.
...@@ -286,7 +287,7 @@ does not display in job logs. ...@@ -286,7 +287,7 @@ does not display in job logs.
To mask a variable: To mask a variable:
1. Go to **Settings > CI/CD** in the project, group or instance admin area. 1. In the project, group, or Admin Area, go to **Settings > CI/CD**.
1. Expand the **Variables** section. 1. Expand the **Variables** section.
1. Next to the variable you want to protect, select **Edit**. 1. Next to the variable you want to protect, select **Edit**.
1. Select the **Mask variable** check box. 1. Select the **Mask variable** check box.
......
doc/user/admin_area/settings/continuous_integration.md
View file @ b2e95fde
...@@ -5,18 +5,18 @@ info: To determine the technical writer assigned to the Stage/Group associated w ...@@ -5,18 +5,18 @@ info: To determine the technical writer assigned to the Stage/Group associated w
type: reference type: reference
--- ---
# Continuous Integration and Deployment Admin settings **(FREE SELF)** # Continuous Integration and Deployment Admin Area settings **(FREE SELF)**
In this area, you will find settings for Auto DevOps, runners, and job artifacts. The [Admin Area](index.md) has the instance settings for Auto DevOps, runners, and
You can find it in the [Admin Area](index.md) by navigating to job artifacts.
**Admin Area > Settings > CI/CD**.
## Auto DevOps **(FREE SELF)** ## Auto DevOps
To enable (or disable) [Auto DevOps](../../../topics/autodevops/index.md) To enable (or disable) [Auto DevOps](../../../topics/autodevops/index.md)
for all projects: for all projects:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Check (or uncheck to disable) the box that says **Default to Auto DevOps pipeline for all projects**. 1. Check (or uncheck to disable) the box that says **Default to Auto DevOps pipeline for all projects**.
1. Optionally, set up the [Auto DevOps base domain](../../../topics/autodevops/index.md#auto-devops-base-domain) 1. Optionally, set up the [Auto DevOps base domain](../../../topics/autodevops/index.md#auto-devops-base-domain)
which is used for Auto Deploy and Auto Review Apps. which is used for Auto Deploy and Auto Review Apps.
...@@ -28,7 +28,7 @@ From now on, every existing project and newly created ones that don't have a ...@@ -28,7 +28,7 @@ From now on, every existing project and newly created ones that don't have a
If you want to disable it for a specific project, you can do so in If you want to disable it for a specific project, you can do so in
[its settings](../../../topics/autodevops/index.md#enable-or-disable-auto-devops). [its settings](../../../topics/autodevops/index.md#enable-or-disable-auto-devops).
## Maximum artifacts size **(FREE SELF)** ## Maximum artifacts size
The maximum size of the [job artifacts](../../../administration/job_artifacts.md) The maximum size of the [job artifacts](../../../administration/job_artifacts.md)
can be set at: can be set at:
...@@ -45,9 +45,10 @@ To change it at the: ...@@ -45,9 +45,10 @@ To change it at the:
- Instance level: - Instance level:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. Change the value of maximum artifacts size (in MB). 1. On the left sidebar, select **Settings > CI/CD**.
1. Click **Save changes** for the changes to take effect. 1. Change the value of maximum artifacts size (in MB).
1. Click **Save changes** for the changes to take effect.
- Group level (this overrides the instance setting): - Group level (this overrides the instance setting):
...@@ -64,14 +65,15 @@ To change it at the: ...@@ -64,14 +65,15 @@ To change it at the:
NOTE: NOTE:
The setting at all levels is only available to GitLab administrators. The setting at all levels is only available to GitLab administrators.
## Default artifacts expiration **(FREE SELF)** ## Default artifacts expiration
The default expiration time of the [job artifacts](../../../administration/job_artifacts.md) The default expiration time of the [job artifacts](../../../administration/job_artifacts.md)
can be set in the Admin Area of your GitLab instance. The syntax of duration is can be set in the Admin Area of your GitLab instance. The syntax of duration is
described in [`artifacts:expire_in`](../../../ci/yaml/README.md#artifactsexpire_in) described in [`artifacts:expire_in`](../../../ci/yaml/README.md#artifactsexpire_in)
and the default value is `30 days`. and the default value is `30 days`.
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Change the value of default expiration time. 1. Change the value of default expiration time.
1. Click **Save changes** for the changes to take effect. 1. Click **Save changes** for the changes to take effect.
...@@ -85,9 +87,9 @@ be updated for artifacts created before this setting was changed. ...@@ -85,9 +87,9 @@ be updated for artifacts created before this setting was changed.
The administrator may need to manually search for and expire previously-created The administrator may need to manually search for and expire previously-created
artifacts, as described in the [troubleshooting documentation](../../../administration/troubleshooting/gitlab_rails_cheat_sheet.md#remove-artifacts-more-than-a-week-old). artifacts, as described in the [troubleshooting documentation](../../../administration/troubleshooting/gitlab_rails_cheat_sheet.md#remove-artifacts-more-than-a-week-old).
## Keep the latest artifacts for all jobs in the latest successful pipelines **(CORE ONLY)** ## Keep the latest artifacts for all jobs in the latest successful pipelines
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/50889) in GitLab Core 13.9. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/50889) in GitLab 13.9.
When enabled (default), the artifacts of the most recent pipeline for each Git ref When enabled (default), the artifacts of the most recent pipeline for each Git ref
([branches and tags](https://git-scm.com/book/en/v2/Git-Internals-Git-References)) ([branches and tags](https://git-scm.com/book/en/v2/Git-Internals-Git-References))
...@@ -101,7 +103,8 @@ If disabled at the instance level, you cannot enable this per-project. ...@@ -101,7 +103,8 @@ If disabled at the instance level, you cannot enable this per-project.
To disable the setting: To disable the setting:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Expand **Continuous Integration and Deployment**. 1. Expand **Continuous Integration and Deployment**.
1. Clear the **Keep the latest artifacts for all jobs in the latest successful pipelines** checkbox. 1. Clear the **Keep the latest artifacts for all jobs in the latest successful pipelines** checkbox.
1. Click **Save changes** 1. Click **Save changes**
...@@ -126,14 +129,13 @@ On GitLab.com, the quota is calculated based on your ...@@ -126,14 +129,13 @@ On GitLab.com, the quota is calculated based on your
To change the pipelines minutes quota: To change the pipelines minutes quota:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Expand **Continuous Integration and Deployment**. 1. Expand **Continuous Integration and Deployment**.
1. In the **Pipeline minutes quota** box, enter the maximum number of minutes. 1. In the **Pipeline minutes quota** box, enter the maximum number of minutes.
1. Click **Save changes** for the changes to take effect. 1. Click **Save changes** for the changes to take effect.
--- While the setting in the Admin Area has a global effect, as an administrator you can
While the setting in the Admin Area has a global effect, as an admin you can
also change each group's pipeline minutes quota to override the global value. also change each group's pipeline minutes quota to override the global value.
1. Navigate to the **Admin Area > Overview > Groups** and hit the **Edit** 1. Navigate to the **Admin Area > Overview > Groups** and hit the **Edit**
...@@ -141,8 +143,8 @@ also change each group's pipeline minutes quota to override the global value. ...@@ -141,8 +143,8 @@ also change each group's pipeline minutes quota to override the global value.
1. In the **Pipeline Minutes Quota** box, enter the maximum number of minutes. 1. In the **Pipeline Minutes Quota** box, enter the maximum number of minutes.
1. Click **Save changes** for the changes to take effect. 1. Click **Save changes** for the changes to take effect.
Once saved, you can see the build quota in the group admin view. Once saved, you can see the build quota in the group settings.
The quota can also be viewed in the project admin view if shared runners The quota can also be viewed in the project settings if shared runners
are enabled. are enabled.
![Project admin information](img/admin_project_quota_view.png) ![Project admin information](img/admin_project_quota_view.png)
...@@ -152,7 +154,7 @@ a group in the **Usage Quotas** page available to the group page settings list. ...@@ -152,7 +154,7 @@ a group in the **Usage Quotas** page available to the group page settings list.
![Group pipelines quota](img/group_pipelines_quota.png) ![Group pipelines quota](img/group_pipelines_quota.png)
## Archive jobs **(FREE SELF)** ## Archive jobs
Archiving jobs is useful for reducing the CI/CD footprint on the system by Archiving jobs is useful for reducing the CI/CD footprint on the system by
removing some of the capabilities of the jobs (metadata needed to run the job), removing some of the capabilities of the jobs (metadata needed to run the job),
...@@ -160,12 +162,13 @@ but persisting the traces and artifacts for auditing purposes. ...@@ -160,12 +162,13 @@ but persisting the traces and artifacts for auditing purposes.
To set the duration for which the jobs are considered as old and expired: To set the duration for which the jobs are considered as old and expired:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Expand the **Continuous Integration and Deployment** section. 1. Expand the **Continuous Integration and Deployment** section.
1. Set the value of **Archive jobs**. 1. Set the value of **Archive jobs**.
1. Hit **Save changes** for the changes to take effect. 1. Hit **Save changes** for the changes to take effect.
Once that time passes, the jobs are archived and no longer able to be After that time passes, the jobs are archived and no longer able to be
retried. Make it empty to never expire jobs. It has to be no less than 1 day, retried. Make it empty to never expire jobs. It has to be no less than 1 day,
for example: <code>15 days</code>, <code>1 month</code>, <code>2 years</code>. for example: <code>15 days</code>, <code>1 month</code>, <code>2 years</code>.
...@@ -178,7 +181,8 @@ As of June 22, 2020 the [value is set](../../gitlab_com/index.md#gitlab-cicd) to ...@@ -178,7 +181,8 @@ As of June 22, 2020 the [value is set](../../gitlab_com/index.md#gitlab-cicd) to
The default CI configuration file path for new projects can be set in the Admin The default CI configuration file path for new projects can be set in the Admin
Area of your GitLab instance (`.gitlab-ci.yml` if not set): Area of your GitLab instance (`.gitlab-ci.yml` if not set):
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Admin Area > Settings > CI/CD**.
1. Input the new path in the **Default CI configuration path** field. 1. Input the new path in the **Default CI configuration path** field.
1. Hit **Save changes** for the changes to take effect. 1. Hit **Save changes** for the changes to take effect.
...@@ -213,7 +217,8 @@ in the pipeline editor. ...@@ -213,7 +217,8 @@ in the pipeline editor.
To select a CI/CD template for the required pipeline configuration: To select a CI/CD template for the required pipeline configuration:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Expand the **Required pipeline configuration** section. 1. Expand the **Required pipeline configuration** section.
1. Select a CI/CD template from the dropdown. 1. Select a CI/CD template from the dropdown.
1. Click **Save changes**. 1. Click **Save changes**.
...@@ -226,7 +231,8 @@ GitLab administrators can disable the forwarding of npm requests to [npmjs.com]( ...@@ -226,7 +231,8 @@ GitLab administrators can disable the forwarding of npm requests to [npmjs.com](
To disable it: To disable it:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Expand the **Package Registry** section. 1. Expand the **Package Registry** section.
1. Uncheck **Enable forwarding of npm package requests to npmjs.org**. 1. Uncheck **Enable forwarding of npm package requests to npmjs.org**.
1. Click **Save changes**. 1. Click **Save changes**.
...@@ -239,7 +245,8 @@ GitLab administrators can adjust the maximum allowed file size for each package ...@@ -239,7 +245,8 @@ GitLab administrators can adjust the maximum allowed file size for each package
To set the maximum file size: To set the maximum file size:
1. Go to **Admin Area > Settings > CI/CD**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. On the left sidebar, select **Settings > CI/CD**.
1. Expand the **Package Registry** section. 1. Expand the **Package Registry** section.
1. Find the package type you would like to adjust. 1. Find the package type you would like to adjust.
1. Enter the maximum file size, in bytes. 1. Enter the maximum file size, in bytes.
......
doc/user/permissions.md
View file @ b2e95fde
...@@ -454,33 +454,32 @@ NOTE: ...@@ -454,33 +454,32 @@ NOTE:
In GitLab 11.0, the Master role was renamed to Maintainer. In GitLab 11.0, the Master role was renamed to Maintainer.
GitLab CI/CD permissions rely on the role the user has in GitLab. There are four GitLab CI/CD permissions rely on the role the user has in GitLab. There are four
permission levels in total: roles:
- admin - Administrator
- maintainer - Maintainer
- developer - Developer
- guest/reporter - Guest/Reporter
The admin user can perform any action on GitLab CI/CD in scope of the GitLab The Administrator role can perform any action on GitLab CI/CD in scope of the GitLab
instance and project. In addition, all admins can use the admin interface under instance and project.
`/admin/runners`.
| Action | Guest, Reporter | Developer |Maintainer| Administrator |
| Action | Guest, Reporter | Developer |Maintainer| Admin | |---------------------------------------|-----------------|-------------|----------|---------------|
|---------------------------------------|-----------------|-------------|----------|--------| | See commits and jobs | ✓ | ✓ | ✓ | ✓ |
| See commits and jobs | ✓ | ✓ | ✓ | ✓ | | Retry or cancel job | | ✓ | ✓ | ✓ |
| Retry or cancel job | | ✓ | ✓ | ✓ | | Erase job artifacts and job logs | | ✓ (*1*) | ✓ | ✓ |
| Erase job artifacts and job logs | | ✓ (*1*) | ✓ | ✓ | | Delete project | | | ✓ | ✓ |
| Delete project | | | ✓ | ✓ | | Create project | | | ✓ | ✓ |
| Create project | | | ✓ | ✓ | | Change project configuration | | | ✓ | ✓ |
| Change project configuration | | | ✓ | ✓ | | Add specific runners | | | ✓ | ✓ |
| Add specific runners | | | ✓ | ✓ | | Add shared runners | | | | ✓ |
| Add shared runners | | | | ✓ | | See events in the system | | | | ✓ |
| See events in the system | | | | ✓ | | Admin Area | | | | ✓ |
| Admin interface | | | | ✓ |
1. Only if the job was: 1. Only if the job was:
- Triggered by the user - Triggered by the user
- [In GitLab 13.0](https://gitlab.com/gitlab-org/gitlab/-/issues/35069) and later, not run for a protected branch - [In GitLab 13.0](https://gitlab.com/gitlab-org/gitlab/-/issues/35069) and later, run for a non-protected branch.
### Job permissions ### Job permissions
......
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
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7