Git LFS 문제 해결

Git LFS 사용 시 발생하는 일반적인 오류와 문제를 진단하고 해결하는 방법을 설명합니다.

Git LFS를 사용할 때 다음과 같은 문제가 발생할 수 있습니다. Git LFS 구버전 v1 API는 지원되지 않습니다. Git LFS 요청은 HTTPS 자격 증명을 사용하므로, Git 자격 증명 저장소 를 사용해야 합니다. 그룹 위키 는 Git LFS를 지원하지 않습니다. 오류: 리포지터리 또는 오브젝트를 찾을 수 없음 # 이 오류는 다음과 같은 몇 가지 이유로 발생할 수 있습니다. 특정 LFS 오브젝트에 접근할 권한이 없습니다. 프로젝트에 푸시하거나 프로젝트에서 페치할 권한이 있는지 확인하세요. 프로젝트가 LFS 오브젝트에 접근할 수 없습니다. 푸시(또는 페치)하려는 LFS 오브젝트가 더 이상 프로젝트에서 사용할 수 없습니다. 대부분의 경우 오브젝트가 서버에서 제거된 것입니다. 로컬 Git 리포지터리가 더 이상 사용되지 않는 Git LFS API 버전을 사용하고 있습니다. 로컬 Git LFS 복사본을 업데이트하고 다시 시도하세요. <url> 에 대한 잘못된 상태: 501 # Git LFS는 실패를 로그 파일에 기록합니다. 이 로그 파일을 보려면: 터미널 창에서 프로젝트 디렉터리로 이동합니다. 다음 명령을 실행하여 최근 로그 파일을 확인합니다. git lfs logs last 다음 문제가 501 오류를 유발할 수 있습니다. 프로젝트 설정에서 Git LFS가 활성화되어 있지 않습니다. 프로젝트 설정을 확인하고 Git LFS를 활성화하세요. GitLab 서버에서 Git LFS 지원이 활성화되어 있지 않습니다. GitLab 관리자에게 서버에서 Git LFS가 활성화되지 않은 이유를 문의하세요. Git LFS 지원을 활성화하는 방법은 LFS 관리 문서 를 참조하세요. Git LFS 클라이언트 버전이 GitLab 서버에서 지원되지 않습니다. 다음을 수행하세요. git lfs version 명령으로 Git LFS 버전을 확인합니다. git lfs -l 명령으로 더 이상 사용되지 않는 API 관련 흔적이 있는지 프로젝트의 Git 구성을 확인합니다. 구성에 batch = false 가 설정되어 있으면 해당 줄을 제거한 후 Git LFS 클라이언트를 업데이트하세요. GitLab은 버전 1.0.1 이상만 지원합니다. 오브젝트 푸시 시 항상 자격 증명이 요구됨 # Git LFS는 모든 푸시 시 모든 오브젝트에 대해 HTTP Basic 인증으로 사용자를 인증하므로, 사용자 HTTPS 자격 증명이 필요합니다. 기본적으로 Git은 사용하는 각 리포지터리의 자격 증명을 기억하는 기능을 지원합니다. 자세한 내용은 공식 Git 문서 를 참조하세요. 예를 들어, 오브젝트를 푸시할 것으로 예상되는 기간 동안 비밀번호를 기억하도록 Git에 지시할 수 있습니다. 이 예시는 자격 증명을 한 시간(3600초) 동안 기억하며, 한 시간 후에는 다시 인증해야 합니다. git config --global credential.helper 'cache --timeout=3600' 자격 증명을 저장하고 암호화하려면 다음을 참조하세요. MacOS: osxkeychain 을 사용