[GIT] This repository is configured for Git LFS but 'git-lfs' was not found on your path.

배경

git push를 진행하던 중에 아래와 같은 에러가 발생했다

Can't connect to any URI: https://github.com/ < Organization > / < Repository > .git (Rejected by "pre-push" hook. This repository is configured for Git LFS but 'git-lfs' was not found on your path. If you no longer wish to use Git LFS, remove this hook by deleting '.git/hooks/pre-push'.

위 에러는 아래와 같이 해석할 수 있다.

어떤 URI에도 연결할 수 없습니다: https://github.com/ < Organization > / < Repository >.git (pre-push 훅에 의해 거부되었습니다. 이 리포지토리는 Git LFS에 대해 구성되어 있지만 'git-lfs'가 경로에 없습니다. 더 이상 Git LFS를 사용하고 싶지 않다면, '.git/hooks/pre-push'를 삭제하여 이 훅을 제거하세요.)

---

해결 방법

1. Homebrew 설치

Homebrew 란
: macOS와 Linux에서 소프트웨어 패키지를 쉽게 설치하고 관리할 수 있도록 도와주는 패키지 관리자입니다.
: 개발자와 사용자들이 필요한 도구와 라이브러리를 간편하게 설치하고 업데이트할 수 있게 해줍니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Homebrew를 PATH에 추가

① Homebrew 경로를 zsh의 .zprofile에 추가

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/yejichoi/.zprofile

② Homebrew 환경 변수를 현재 세션에 적용

eval "$(/opt/homebrew/bin/brew shellenv)"

3. Homebrew가 제대로 설치되었는지 확인

brew --version

4. Git LFS를 설치

정상적으로 버전 정보가 출력되면 설치가 잘 된 것입니다. 그 다음으로 Git LFS를 설치할 수 있습니다:

Git LFS (Git Large File Storage)
: Git 저장소에서 대용량 파일을 효율적으로 관리하기 위한 확장 도구입니다.
: 일반적인 Git은 버전 관리를 위해 모든 파일을 저장소에 직접 저장하지만, 대용량 파일을 저장할 경우 성능 문제가 발생할 수 있습니다.
: Git LFS는 이러한 문제를 해결하기 위해 고안되었습니다.

brew install git-lfs

5. Git LFS 설치 확인

git lfs version

Git LFS 버전이 표시되지 않고 오류가 발생한다면, Git LFS 설치가 제대로 이루어지지 않은 것입니다.
이 경우, 다시 설치 시도 해야 합니다.

brew install git-lfs

6. Git LFS 활성화

Git LFS가 설치되었다면, 다음 명령어를 실행하여 Git LFS를 활성화하세요.
이 명령은 Git LFS를 시스템 전체에서 사용할 수 있도록 설정하는 명령입니다.

git lfs install

위 과정을 다 끝내면, 정상적으로 push가 되는 것을 확인할 수 있다.