GitLab CI Runbooks
Runner, pipeline, artifact, and container-registry failures in GitLab CI.
7 scenarios ยท search and filter below, or jump via the quick nav.
Foundation2 runbooks
GitLab CI artifact download fails - expired or 403 forbiddenmedium
Downloading artifacts returns 403 Forbidden or 404 Not Found
GitLab CIFoundation2 causes
1Open runbookGitLab pipeline blocked - manual job with allow_failure: falsemedium
Pipeline shows 'Blocked' status and cannot proceed
GitLab CIFoundation2 causes
2Open runbookIntermediate4 runbooks
GitLab job stuck 'waiting for a runner' - tag mismatchhigh
Job stuck in 'pending' state with 'Waiting for a runner'
GitLab CIIntermediate2 causes
1Open runbookGitLab CI image pull failed - private registry or missing imagehigh
Job fails with 'Error response from daemon: manifest for <image> not found'
GitLab CIIntermediate2 causes
2Open runbookGitLab CI variable masking wrong or protected variable unavailablehigh
Secret appears in plaintext in the job log instead of being masked
GitLab CIIntermediate2 causes
3Open runbookGitLab container registry push fails - expired token or 401high
docker push to registry.gitlab.com fails with 'unauthorized' or 401
GitLab CIIntermediate2 causes
4Open runbook