Commit 6a66c829 authored by Kamil Trzciński's avatar Kamil Trzciński

Add documentation for archive builds

parent 938d8900
...@@ -42,12 +42,11 @@ ...@@ -42,12 +42,11 @@
<code>4 mins 2 sec</code>, <code>2h42min</code>. <code>4 mins 2 sec</code>, <code>2h42min</code>.
= link_to icon('question-circle'), help_page_path('user/admin_area/settings/continuous_integration', anchor: 'default-artifacts-expiration') = link_to icon('question-circle'), help_page_path('user/admin_area/settings/continuous_integration', anchor: 'default-artifacts-expiration')
.form-group .form-group
= f.label :archive_builds_in_human_readable, 'Archive builds in', class: 'label-bold' = f.label :archive_builds_in_human_readable, 'Archive jobs in', class: 'label-bold'
= f.text_field :archive_builds_in_human_readable, class: 'form-control', placeholder: 'never' = f.text_field :archive_builds_in_human_readable, class: 'form-control', placeholder: 'never'
.form-text.text-muted .form-text.text-muted
Set the duration when build gonna be considered old. Archived builds cannot be retried. Set the duration when job gonna be considered old. Archived jobs cannot be retried.
Make it empty to never expire builds. It has to be larger than 1 day. Make it empty to never expire jobs. It has to be no less than 1 day.
The default unit is in seconds, but you can define an alternative. For example: For example: <code>15 days</code>, <code>1 month</code>, <code>2 years</code>.
<code>4 mins 2 sec</code>, <code>2h42min</code>.
= f.submit 'Save changes', class: "btn btn-success" = f.submit 'Save changes', class: "btn btn-success"
...@@ -49,3 +49,20 @@ and the default value is `30 days`. On GitLab.com they ...@@ -49,3 +49,20 @@ and the default value is `30 days`. On GitLab.com they
This setting is set per job and can be overridden in This setting is set per job and can be overridden in
[`.gitlab-ci.yml`](../../../ci/yaml/README.md#artifacts-expire_in). [`.gitlab-ci.yml`](../../../ci/yaml/README.md#artifacts-expire_in).
To disable the expiration, set it to `0`. The default unit is in seconds. To disable the expiration, set it to `0`. The default unit is in seconds.
## Archive jobs in **[CORE ONLY]**
Set this setting to enable when job gonna be considered old.
The purpose of that feature is to reduce the CI footprint on system
removing some of the capabilities of the jobs (metadata needed to run the build),
but persisting the traces and artifacts to retain for auditing purposes.
The archived jobs cannot be retried. Making this field empty does never expire jobs.
The value has to be no less than 1 day. The example:
`15 days`, `1 month`, `2 years`.
To change it:
1. Go to **Admin area > Settings > Continuous Integration and Deployment**.
1. Change the value of archive jobs in.
1. Hit **Save changes** for the changes to take effect.
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