Document job/pipeline retry
Context
https://gitlab.com/gitlab-org/gitlab/-/issues/508338#note_2251465006
Problem
Job retry is mentioned in several docs but there is no SSoT in the user docs about what it means retrying a job or pipeline. Users may not be aware of the side-effects of retrying a job.
Proposal
Have a section in https://docs.gitlab.com/ee/ci/jobs that describes the retry functionality covering:
- When a job is retried, a clone of the job is created and executed instead. User is redirected to a different page with a new job ID.
- Previous failing jobs that have been retried are still persisted but hidden from the pipeline view.
- When a job is retried, the new job running will be associated to the user that initiated the retry.
- When a job is retried, any subsequent jobs that were
skipped(due to a job failure) are reassigned to the user that initiated the retry.
In addition we should describe:
- pipeline retry is a bulk retry of all the failed jobs, with the same side-effects as above.
- retrying a bridge/trigger job carries the same side-effects as above.