모두의 지식 저장고

Git은 기본적으로 빈 디렉토리를 추적하지 않기 때문에 빈 디렉토리를 저장할수 없다.  

파일이 없는 빈 디렉토리는 자동으로 무시 되기 때문에 간접적인 방법으로 .gitkeep 파일을 사용 하여 빈디렉토리를 저장 한다. 

.gitkeep 파일 사용 방법 

• 빈파일을 생성 한다. 

mkdir my_empty_directory

• 디렉토리 안에 .gitkeep 파일을 생성합니다

touch my_empty_directory/.gitkeep

• 디렉토리를 Git에 추가하고 커밋한다.

# 모든 빈 디렉토릴를 저장 하고 자 할때 
git add .

# 특정 빈 디렉토리를 저장하고자 할때 
git add my_empty_directory/.gitkeep
git commit -m "Add empty directory my_empty_directory with .gitkeep"

• .gitkeep 파일은 특별한 의미를 가지지 않는 관례적인 이름으로 사용 하며 빈 디렉토리임을 다른 사용자가 의도적으로 비어있는것을 표현해 주는 의미다. 

• git push 

git push origin main

gitlab 올라간 특정 디렉토리만 다운로드 받을 수 있는 방법을 소개 합니다. 

일반적으로 git clone 을 수행 하면 gitlab 에 등록된 프로젝트를 모두 다운로드 받게 되는데 

이럴경우 원하지 않는 파일도 모두 다운로드 받게 되어 비효율 적입니다. 

이번 글에서는 git config core.sparsecheckout true 명령을 통해 프로젝트중 원하는 디렉토리만 다운로드 방법을 소개 하겠습니다. 

GitLab 프로젝트 생성

• 테스트위해 우선 임의로 아래 처럼 테스트를 위해 프로젝트를 생성 하고 디렉토리를 만듭니다.

GitLab 특정 디렉토리(폴더) 다운로드 

• git lab 에 등록된 파일을 다운로드 받기 위해 test 프로젝트를 만듭니다. 

mkdir test
cd test

• 이후 test 디렉 토리로 이동하여 local emtpy repository 를 생성 gitlab 프로젝트 정보를 등록 합니다. 

git init

git remote add -f origin http://xxx.xxx.xxx.xxx:6060/comdoc/testProject.git

• 특정 디렉토리만 다운로드 받기 위해 sparse-checkout 을 활성화 합니다. 
• guide_doc/doc  는 testProject 하위 폴더 입니다. 

echo "guide_doc/doc" > .git/info/sparse-checkout
git config core.sparsecheckout true

• git pull 명령을 통해 디렉토리를 내려 받습니다. 

git pull origin main

GitLab 파일 수정 및 추가 후 업로드 [git push] 

• 다운로드 받은 디렉토리에서 파일을 추가 하거나 수정 할경우 아래 절차로 gitlab 서버에 파일을 업로드 할수 있습니다.
  • git add [파일명]
  •  git commit -m "[comment]"
  • git push origin main
• 테스트를 위해 임의로 쉘 스크립트를 만들었습니다. 

git add option_test.sh
git commit -m "option test shell commit"

• git commit 명령 수행중 에러가 발생하면 에러 내용에 따라 git lab 계정정보를 등록 해주면 됩니다. 

• local 에 저장된 파일을 이제 gitlab 프로젝트로 업로드 합니다. 

git push origin main

• 아래 에러가 발생 할경우 브렌치를 변경해 줘야 합니다. [master -> main]

git show-ref
git remote -v
git status

git branch -m master main

• GitLab 파일 업로드 확인