작업 아티팩트 문제 해결

job artifacts를 사용할 때 다음과 같은 문제가 발생할 수 있습니다.

Job에서 특정 아티팩트를 검색하지 않음

기본적으로 작업은 모든 이전 단계의 아티팩트를 가져오지만 dependencies 또는 needs를 사용하는 작업은 기본적으로 모든 작업에서 아티팩트를 가져오지 않습니다.

이러한 키워드를 사용하면 아티팩트가 일부 작업만 가져옵니다. 이러한 키워드로 아티팩트를 가져오는 방법에 대한 정보는 키워드 참조를 확인하세요:

작업 아티팩트가 너무 많은 디스크 공간을 사용함

작업 아티팩트가 너무 많은 디스크 공간을 사용하는 경우, 작업 아티팩트 관리 문서를 참조하세요.

오류 메시지 업로드할 파일이 없음

이 메시지는 러너가 파일을 찾을 수 없을 때 작업 로그에 표시됩니다. 파일 경로가 잘못되었거나 파일이 생성되지 않았을 수 있습니다. 파일 이름과 생성되지 않은 이유를 지정하는 다른 오류나 경고를 작업 로그에서 확인할 수 있습니다.

보다 자세한 작업 로그를 보려면 CI/CD 디버그 로깅을 활성화하고 작업을 다시 시도하세요. 이 로깅에서 파일이 생성되지 않은 이유에 대해 더 많은 정보를 제공할 수 있습니다.

오류 메시지 Missing /usr/bin/gitlab-runner-helper. Uploading artifacts is disabled.

GitLab 15.1 이전에는 DEBUG라는 CI/CD 변수를 설정하면 아티팩트 업로드가 실패할 수 있습니다.

이를 해결하기 위해 다음 중 하나를 할 수 있습니다:

  • GitLab 및 GitLab Runner 15.2로 업데이트
  • 다른 변수 이름 사용

  • script 명령어에서 환경 변수로 설정: 

    failing_test_job:  # 이 작업은 gitlab-org/gitlab-runner#3068 문제로 실패할 수 있음
  variables:
    DEBUG: true
  script: bin/mycommand
  artifacts:
    paths:
      - bin/results
  
successful_test_job:  # 이 작업에는 `DEBUG`라는 CI/CD 변수가 없으며 이 문제에 영향을 받지 않음
  script: DEBUG=true bin/mycommand
  artifacts:
    paths:
      - bin/results

오류 메시지 FATAL: invalid argument를 Windows 러너에서 dotenv 아티팩트를 업로드할 때 발생

PowerShell echo 명령은 UCS-2 LE BOM (바이트 순서 표시) 인코딩으로 파일을 작성하지만 UTF-8만 지원됩니다. echo를 사용하여 dotenv 아티팩트를 만들면 FATAL: invalid argument 오류가 발생합니다.

UTF-8을 사용하는 대신 PowerShell Add-Content를 사용하세요: 

test-job:
  stage: test
  tags:
    - windows
  script:
    - echo "test job"
    - Add-Content -Path build.env -Value "MY_ENV_VAR=true"
  artifacts:
    reports:
      dotenv: build.env

작업 아티팩트가 만료되지 않음

원하는대로 일부 작업 아티팩트가 만료되지 않는 경우, 가장 최근에 성공한 작업의 아티팩트 유지 설정이 활성화되어 있는지 확인하세요.

이 설정이 활성화되면 각 ref의 가장 최근에 성공한 파이프라인의 작업 아티팩트는 만료되지 않고 삭제되지 않습니다.

오류 메시지 This job could not start because it could not retrieve the needed artifacts.

작업이 시작되지 못하고 이 오류 메시지가 표시되는 경우 다음과 같습니다:

  • 작업의 종속 항목을 찾을 수 없는 경우. 기본적으로 나중 단계의 작업은 이전 모든 단계의 작업에서 아티팩트를 가져오므로 이전 작업은 모두 종속적으로 간주됩니다. 작업이 dependencies 키워드를 사용하는 경우 디렉터리화된 작업만 종속적입니다.
  • 아티팩트가 이미 만료된 경우. artifacts:expire_in으로 만료 기간을 더 길게 설정할 수 있습니다.
  • 작업이 관련 리소스에 액세스할 수 없는 경우. 불충분한 권한 때문에 작업이 관련 리소스에 액세스할 수 없게 됩니다.

작업이 needs:artifacts를 사용하는 경우 해당 추가 문제 해결 단계를 확인하세요:

needs:project로 구성된 작업의 경우

needs:project를 사용하는 작업에서 다음과 유사한 구성을 사용하는 경우 needed artifacts를 검색할 수 없는 오류가 발생할 수 있습니다: 

rspec:
  needs:
    - project: my-group/my-project
      job: dependency-job
      ref: master
      artifacts: true

이 오류를 해결하려면:

  • 프로젝트 my-group/my-project이 Premium 가입 플랜이 있는 그룹에 있는지 확인하세요.
  • 작업을 실행하는 사용자가 my-group/my-project의 리소스에 액세스할 수 있는지 확인하세요.
  • 사용 중인 project, job, ref 조합이 존재하고 원하는 의존성을 생성하는지 확인하세요.
  • 사용 중인 모든 변수가 올바른 값을 평가하는지 확인하세요.

needs:pipeline:job로 구성된 작업의 경우

needs:pipeline:job를 사용하는 작업에서 다음과 유사한 구성을 사용하는 경우 needed artifacts를 검색할 수 없는 오류가 발생할 수 있습니다: 

rspec:
  needs:
    - pipeline: $UPSTREAM_PIPELINE_ID
      job: dependency-job
      artifacts: true

이 오류를 해결하려면:

  • $UPSTREAM_PIPELINE_ID CI/CD 변수가 현재 파이프라인의 부모-자식 파이프라인 계층 구조에서 사용 가능한지 확인하세요.
  • pipeline 및 job 조합이 존재하고 기존 파이프라인으로 해결되는지 확인하세요.
  • dependency-job이 실행되고 성공적으로 완료되었는지 확인하세요.

업그레이드 후 작업이 UnlockPipelinesInQueueWorker 표시를 보여줌

작업이 멈추고 UnlockPipelinesInQueueWorker라는 오류가 표시될 수 있습니다.

이 문제는 업그레이드 후 발생합니다.

해결책은 ci_unlock_pipelines_extra_low 특성 플래그를 활성화하는 것입니다. 특성 플래그를 전환하려면 관리자여야 합니다.

GitLab SaaS에서는:

  • 다음의 ChatOps 명령을 실행하세요: 

    /chatops run feature set ci_unlock_pipelines_extra_low true

GitLab Self-managed에서는:

  • ci_unlock_pipelines_extra_low라는 특성 플래그를 활성화하세요.

자세한 정보는 Merge Request 140318의 주석을 참조하세요.