Job artifacts 문제 해결

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

Job이 특정 artifacts을 검색하지 않음

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

이러한 키워드를 사용하면 artifacts이 일부 작업에서만 가져옵니다. 이러한 키워드로 artifacts을 가져오는 방법에 대한 정보는 다음을 확인하세요:

Job artifacts이 너무 많은 디스크 공간을 사용함

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

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

이 메시지는 runner가 파일을 찾을 수 없을 때 작업 로그에 나타납니다. 파일 경로가 올바르지 않거나 파일이 생성되지 않았을 수 있습니다. 작업 로그를 확인하여 생성되지 않은 파일의 원인을 지정하는 다른 오류나 경고를 확인할 수 있습니다.

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

오류 메시지 FATAL: invalid argument Windows runner에서 dotenv artifact을 업로드할 때

PowerShell echo 명령은 파일을 UCS-2 LE BOM (바이트 순서 표시) 인코딩으로 작성하지만, UTF-8만 지원됩니다. echo로 dotenv artifact을 생성하려고 하면 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

Job artifacts이 만료되지 않음

일부 작업 artifacts이 기대한대로 만료되지 않는 경우 가장 최근에 성공한 작업에서 artifacts 유지 설정이 활성화되어 있는지 확인하세요.

이 설정이 활성화되면 각 ref의 최신 성공 파이프라인에서의 작업 artifacts은 만료되지 않고 삭제되지 않습니다.

오류 메시지 이 작업은 필요한 artifacts을 검색하지 못했기 때문에 시작할 수 없습니다.

작업이 기대하는 artifacts을 가져올 수 없으면 작업이 시작하지 못하고 이 오류 메시지가 반환됩니다. 이 오류는 다음 경우에 반환됩니다:

  • 작업의 종속 항목을 찾을 수 없는 경우. 기본적으로 나중에 있는 단계의 작업은 모든 이전 단계의 작업에서 artifacts을 가져오므로, 이전 작업은 모두 종속적으로 간주됩니다. 작업이 dependencies 키워드를 사용하는 경우 명시된 작업만 종속됩니다.
  • Artifacts이 이미 만료되었을 때. artifacts:expire_in으로 만료 기간을 더 길게 설정할 수 있습니다.
  • 작업이 관련 리소스에 충분한 권한이 부족하여 해당 리소스에 액세스할 수 없는 경우.

작업이 needs:artifacts 키워드를 사용하는 경우, 다음과 같은 추가 문제 해결 단계를 확인하세요:

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

작업에 needs:project를 사용하여 구성된 경우 needed artifacts를 가져올 수 없을 수 있습니다. 다음과 유사한 구성을 사용하는 작업에 대해 could not retrieve the needed artifacts. 오류가 발생할 수 있습니다. 

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

이 오류를 해결하려면 다음을 확인하세요:

  • my-group/my-project 프로젝트가 프리미엄 구독 요금제가 있는 그룹에 있는지 확인합니다.
  • 작업을 실행하는 사용자가 my-group/my-project의 리소스에 액세스할 수 있는지 확인합니다.
  • project, job, 및 ref 조합이 존재하고 원하는 종속성을 가져오도록 합니다.
  • 사용 중인 모든 변수가 올바른 값으로 평가되는지 확인합니다.

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

작업에 needs:pipeline:job를 사용하여 구성된 경우 needed artifacts를 가져올 수 없을 수 있습니다. 다음과 유사한 구성을 사용하는 작업에 대해 could not retrieve the 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라는 기능 플래그를 활성화하십시오.

자세한 정보는 병합 요청 140318의 코멘트를 참조하십시오.