관리자를 위한 작업 아티팩트 트러블슈팅

관리자를 위한 작업 아티팩트 트러블슈팅에 대해 설명합니다.

작업 아티팩트를 관리할 때 다음과 같은 문제가 발생할 수 있습니다. 작업 아티팩트의 파일명이 잘못될 수 있음 # 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 이 작업은 잘못된 파일명을 가진 로컬 저장소의 아티팩트를 확인하고 예상되는 파일명으로 이름을 변경합니다. 작업 아티팩트가 디스크 공간을 너무 많이 사용함 # 작업 아티팩트는 예상보다 빠르게 디스크 공간을 채울 수 있습니다. 가능한 원인은 다음과 같습니다: 사용자가 작업 아티팩트 만료를 필요 이상으로 길게 설정했습니다. 실행된 작업 수, 따라서 생성된 아티팩트 수가 예상보다 많습니다. 작업 로그가 예상보다 크고 시간이 지남에 따라 누적되었습니다. 아티팩트 하우스키핑이 빈 디렉토리를 남겨두는 경우 파일 시스템에서 inode가 부족할 수 있습니다. 고아 아티팩트 파일에 대한 Rake 작업 으로 이를 제거합니다. 아티팩트 파일이 디스크에 남아 하우스키핑으로 삭제되지 않을 수 있습니다. 고아 아티팩트 파일에 대한 Rake 작업 을 실행하여 제거합니다. 이 스크립트는 빈 디렉토리도 제거하므로(이전 이유 참조) 항상 작업이 있습니다. unknown 상태의 아티팩트는 자동 정리로 처리되지 않을 수 있습니다. 이러한 아티팩트를 확인 하고 정리하여 디스크 공간을 회수할 수 있습니다. 가장 최근 성공 작업의 최신 아티팩트 유지 기능이 활성화되어 있습니다. 이러한 경우와 다른 경우에 디스크 공간 사용에 가장 많이 기여하는 프로젝트를 파악하고, 어떤 유형의 아티팩트가 가장 많은 공간을 사용하는지 확인하고, 경우에 따라 디스크 공간을 회수하기 위해 작업 아티팩트를 수동으로 삭제합니다. 아티팩트 하우스키핑 # 아티팩트 하우스키핑은 만료된 아티팩트를 식별하고 삭제하는 프로세스입니다. unknown 상태 아티팩트 확인 # 일부 아티팩트는 하우스키핑 시스템이 올바른 잠금 상태를 결정할 수 없기 때문에 unknown 상태를 가집니다. 이러한 아티팩트는 만료된 후에도 자동 정리에서 처리되지 않아 과도한 디스크 공간 사용에 기여할 수 있습니다. 인스턴스에 unknown 상태의 아티팩트가 있는지 확인하려면: 데이터베이스 콘솔을 시작합니다: Linux package (Omnibus) Helm chart (Kubernetes) Docker Self-compiled (source) sudo gitlab-psql # toolbox 파드 찾기 kube