cicd resource_error ai_generated true

Uploading artifacts to coordinator... too large

ID: cicd/gitlab-runner-artifact-size-limit

Also available as: JSON · Markdown · 中文
85%Fix Rate
85%Confidence
1Evidence
2023-06-15First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
GitLab CE 15.0+ active — — —
GitLab Runner 15.0+ active — — —
GitLab EE 15.0+ active — — —

Root Cause

GitLab Runner failed to upload a job artifact because it exceeds the maximum allowed size configured on the GitLab instance or runner.

generic

中文

GitLab Runner 无法上传作业工件，因为其超出了 GitLab 实例或 runner 上配置的最大允许大小。

Official Documentation

https://docs.gitlab.com/ee/ci/yaml/#artifactsreports

Workarounds

  1. 85% success Increase the maximum artifact size in the GitLab admin panel (Admin Area > Settings > CI/CD > Artifacts > Maximum artifacts size (MB)) and restart the runner: `gitlab-runner restart` 
    Increase the maximum artifact size in the GitLab admin panel (Admin Area > Settings > CI/CD > Artifacts > Maximum artifacts size (MB)) and restart the runner: `gitlab-runner restart`
  2. 75% success Compress the artifact before uploading by adding a job step to tar and gzip the output: `tar -czf output.tar.gz build/ && artifacts: paths: [output.tar.gz]` 
    Compress the artifact before uploading by adding a job step to tar and gzip the output: `tar -czf output.tar.gz build/ && artifacts: paths: [output.tar.gz]`

中文步骤

  1. Increase the maximum artifact size in the GitLab admin panel (Admin Area > Settings > CI/CD > Artifacts > Maximum artifacts size (MB)) and restart the runner: `gitlab-runner restart`
  2. Compress the artifact before uploading by adding a job step to tar and gzip the output: `tar -czf output.tar.gz build/ && artifacts: paths: [output.tar.gz]`

Dead Ends

Common approaches that don't work:

  1. Increasing the artifact size limit in the project's CI/CD settings without restarting the runner 40% fail

    The runner's cache or configuration may still enforce the old limit; a runner restart is required for the new limit to take effect.

  2. Setting the artifact size limit to an extremely high value (e.g., 999999 MB) in the GitLab admin panel 60% fail

    The GitLab instance may have a hard-coded maximum limit (e.g., 1 GB) that cannot be overridden via the admin UI; also, unlimited size can cause disk space issues.