관리자를 위한 작업 아티팩트 문제 해결

관리자를 위한 작업 아티팩트 문제 해결에 대해 설명합니다.

job 아티팩트를 관리할 때 다음과 같은 문제가 발생할 수 있습니다. job 아티팩트의 파일 이름이 잘못될 수 있음 # GitLab 18.6 이전에는 원격 스토리지에서 로컬 스토리지로 마이그레이션할 때 아티팩트가 잘못된 파일 이름으로 복사될 수 있었습니다. 예를 들면 다음과 같습니다. 아티팩트는 path/to/artifacts/2025_10_15/922/485/artifacts.zip 과 비슷한 형태여야 합니다. 파일 이름이 잘못된 아티팩트는 path/to/artifacts/2025_10_15/922/485/4f8681af93715b90c913e507f24b05cc6ca6e ( .zip 확장자 없음)와 비슷한 형태입니다. 사용 중인 GitLab 인스턴스에서 이 문제가 발생했다면 다음을 실행합니다. gitlab-rake gitlab:artifacts:fix_artifact_filepath 이 태스크는 로컬 스토리지에서 파일 이름이 잘못된 아티팩트를 확인하고 예상되는 파일 이름으로 이름을 변경합니다. job 아티팩트가 디스크 공간을 너무 많이 사용함 # job 아티팩트는 예상보다 빠르게 디스크 공간을 채울 수 있습니다. 가능한 원인은 다음과 같습니다. 사용자가 job 아티팩트 만료 기간을 필요 이상으로 길게 설정했습니다. 실행된 job 수, 따라서 생성된 아티팩트 수가 예상보다 많습니다. job 로그가 예상보다 크고 시간이 지나면서 누적되었습니다. 아티팩트 하우스키핑이 빈 디렉터리를 남기기 때문에 파일 시스템의 inode가 부족해질 수 있습니다. 고아 아티팩트 파일용 Rake 태스크 가 이를 제거합니다. 아티팩트 파일이 디스크에 남아 하우스키핑으로 삭제되지 않을 수 있습니다. 이를 제거하려면 고아 아티팩트 파일용 Rake 태스크 를 실행합니다. 이 스크립트는 빈 디렉터리도 함께 제거하므로(앞의 원인 참고) 항상 처리할 작업이 있습니다. unknown 상태인 아티팩트는 자동 정리로 처리되지 않을 수 있습니다. 이러한 아티팩트를 확인 하고 정리해 디스크 공간을 회수할 수 있습니다. 최근 성공한 job의 최신 아티팩트 유지 기능이 활성화되어 있습니다. 이런 경우와 그 밖의 경우에는 디스크 공간 사용에 가장 큰 영향을 주는 프로젝트를 파악하고, 어떤 유형의 아티팩트가 공간을 가장 많이 사용하는지 확인하며, 경우에 따라 job 아티팩트를 수동으로 삭제해 디스크 공간을 회수합니다. 아티팩트 하우스키핑 # 아티팩트 하우스키핑은 어떤 아티팩트가 만료되어 삭제할 수 있는지 식별하는 과정입니다. unknown 상태인 아티팩트 확인 # 하우스키핑 시스템이 올바른 락 상태를 판단할 수 없어 일부 아티팩트는 상태가 unknown 입니다. 이러한 아티팩트는 만료된 뒤에도 자동 정리로 처리되지 않으며 디스크 공간을 과도하게 사용하는 원인이 될 수 있습니다. 인스턴스에 unknown 상태인 아티팩트가 있는지 확인하려면 다음과 같이 합니다. 데이터베이스 콘솔을 시작합니다. Linux package (Omnibus) Helm chart (Kubernetes) Docker