diff options
Diffstat (limited to 'doc/ci/troubleshooting.md')
| -rw-r--r-- | doc/ci/troubleshooting.md | 34 |
1 files changed, 23 insertions, 11 deletions
diff --git a/doc/ci/troubleshooting.md b/doc/ci/troubleshooting.md index 973c6b90fc5..e94ccfa6b2b 100644 --- a/doc/ci/troubleshooting.md +++ b/doc/ci/troubleshooting.md @@ -246,15 +246,10 @@ After the pipeline is created, the message updates with the pipeline status. ### Merge request status messages -The merge request status widget shows the **Merge** button and whether or not a merge -request is ready to merge. If the merge request can't be merged, the reason for this -is displayed. +The merge request status widget shows: -If the pipeline is still running, **Merge** is replaced with the -**Merge when pipeline succeeds** button. - -If [**Merge Trains**](pipelines/merge_trains.md) -are enabled, the button is either **Add to merge train** or **Add to merge train when pipeline succeeds**. **(PREMIUM)** +- If the merge request is ready to merge. If the merge request can't be merged, the reason is displayed. +- **Merge**, if the pipeline is complete, or **Set to auto-merge** if the pipeline is still running. #### "A CI/CD pipeline must run and be successful before merge" message @@ -333,6 +328,23 @@ When you rerun a job, uses the same configuration each time. If you update confi including separate files added with [`include`](yaml/index.md#include), you must start a new pipeline to use the new configuration. +### Unable to pull image from another project + +When a runner tries to pull an image from a private project, the job could fail with the following error: + +```shell +WARNING: Failed to pull image with policy "always": Error response from daemon: pull access denied for registry.example.com/path/to/project, repository does not exist or may require 'docker login': denied: requested access to the resource is denied +``` + +This error can happen if the following are both true: + +- The **Allow access to this project with a CI_JOB_TOKEN** option is enabled in the private project + hosting the image. +- The job attempting to fetch the image is running for a project that is not listed in + the private project's allowlist. + +The recommended solution is to [add your project to the private project's job token scope allowlist](jobs/ci_job_token.md#add-a-project-to-the-job-token-scope-allowlist). + ## Pipeline warnings Pipeline configuration warnings are shown when you: @@ -387,9 +399,9 @@ on shared runners, which reduces system resource usage on the `jobs/request` end When enabled, jobs are processed in the order they were put in the system, instead of balanced across many projects. -### Disable CI/CD minutes quota enforcement +### Disable compute quota enforcement -To disable the enforcement of CI/CD minutes quotas on shared runners, you can temporarily +To disable the enforcement of [compute quotas](pipelines/cicd_minutes.md) on shared runners, you can temporarily enable the `ci_queueing_disaster_recovery_disable_quota` [feature flag](../administration/feature_flags.md). This flag reduces system resource usage on the `jobs/request` endpoint. @@ -401,7 +413,7 @@ Earlier jobs are already canceled by a periodic background worker (`StuckCiJobsW The following commands are run in the [rails console](../administration/operations/rails_console.md#starting-a-rails-console-session). WARNING: -Any command that changes data directly could be damaging if not run correctly, or under the right conditions. +Any command that changes data directly could be damaging if not run correctly, or under the right conditions. We highly recommend running them in a test environment with a backup of the instance ready to be restored, just in case. ### Cancel stuck pending pipelines |