[`23 하계 모각코] 今我異昨我 2회차 개인 리뷰

[ # 2회차 정보 ]

• 2023년 7월 26일 14:00 - 17:00
• Discord 영상 통화로 온라인 스터디 회의 진행

---

[ # 2회차 개인 목표 ]

Git 기본 명령어 알아보기

02 깃 기본 명령어 알아보기

2.1 깃/깃허브 소스 관리 기본 흐름

2.2 지역 저장소 생성하기

2.3 환경 설정하기

2.4 파일 상태 확인하기

---

[ # 2회차 개인 활동 내용 ]

Git & Github 소스 관리 기본 흐름

크게 보면 소스 코드는 다음과 같이 두 가지 흐름을 갖게 된다.

1 지역 저장소 → 깃허브(원격 저장소)

지역 저장소에 새 프로젝트를 생성하면 ① git init 명령어로 해당 프로젝트를 깃 지역 저장소로 지정한다. ② 파일을 수정하고 ③ git add 명령어로 수정한 파일을 스테이징 영역(staging area)으로 옮기고 ④ git commit으로 지역 저장소(local repository)에 저장하게 된다. 이렇게 지역 저장소에서 발생한 변경 내역을 ⑤ git push 명령어로 원격 저장소에 반영한다.

2 깃허브(원격 저장소) → 지역 저장소

이미 깃허브에 올려진 프로젝트 전체를 ⑥ git clone 명령어로 지역 저장소에 내려받거나 혹은 일부 변경 사항만 ⑦ git pull 명령어로 내려받을 수 있다.

지역 저장소 생성하기

프로젝트를 깃 지역 저장소로 설정하고, 이때 생성되는 .git 폴더에 대해 알아보자.

깃 지역 저장소 설정

깃 지역 저장소는 init 명령으로 설정한다.

git init

01 깃 저장소 초기화부터 다시 실습하기 위해 새로운 chapter2-basic 폴더를 생성한다.
02 폴더에서 Open Git Bash here를 클릭하고 git init 명령어를 실행하면 깃 지역 저장소로 설정된다.

$ git init
Initialized empty Git repository in C:/Users/USER/Documents/Projects/git/github/programming/chapter2-basic/.git/

'Initialized empty Git repository in ...' 메시지를 확인했다면 깃 지역 저장소로 설정된 것이다.

.git 은 숨겨진 폴더로(폴더명 앞에 점이 붙어 있으면 숨겨진 폴더이다), .git 폴더 내부를 살펴보고 싶다면 숨김 폴더 및 파일 목록을 함께 보여주는 ls -a 명령어를 사용하여 .git 폴더를 확인하면 된다.

$ ls -a
./  ../  .git/

.git 폴더 확인

앞에서 git init 명령어를 이용하여 일반 프로젝트를 깃 지역 저장소로 설정했다. 이 말은 해당 프로젝트를 깃 지역 저장소로 관리하는 정보가 어딘가에 있다는 뜻이다. 바로 그 정보가 담긴 곳이 .git 숨김 폴더이다. ls -l 명령어로 .git 폴더 내의 파일 및 폴더 목록을 확인해보자.

chapter2-basic
$ cd .git

.git
$ ls -l
total 7
-rw-r--r-- 1 USER 197121  23 Jul 26 22:31 HEAD
-rw-r--r-- 1 USER 197121 130 Jul 26 22:31 config
-rw-r--r-- 1 USER 197121  73 Jul 26 22:31 description
drwxr-xr-x 1 USER 197121   0 Jul 26 22:31 hooks/
drwxr-xr-x 1 USER 197121   0 Jul 26 22:31 info/
drwxr-xr-x 1 USER 197121   0 Jul 26 22:31 objects/
drwxr-xr-x 1 USER 197121   0 Jul 26 22:31 refs/

깃 지역 저장소에서 관리하는 파일, 브랜치, 설정 정보 등이 담겨 있다. .git 폴더 내의 파일 및 폴더를 사람이 직접 수정할 일은 거의 없다. 깃 명령어를 이용하여 작업할 때 깃에 의해 자동으로 관리된다.

git init 취소

특정 프로젝트를 깃 지역 저장소로 관리하고 싶지 않거나 처음부터 다시 깃 지역 저장소로 지정하고 싶을 수 있다. 이때 기존 git init을 취소해야 한다.
.git 숨김 폴더를 삭제하는 것이 그 원리이다.
터미널을 이용해 삭제하는 경우 rm -rf .git 명령어를 통해 .git 숨김 폴더를 삭제할 수 있다.

rm -rf .git

환경 설정하기

깃 지역 저장소에 사용자 정보를 등록하고, 등록한 사용자 정보가 어떻게 저장되어 있는지 확인하자. 또한 깃 원격 저장소를 설정하고 깃으로 관리할 필요가 없는 파일 및 폴더를 정의해보자.

사용자 등록

다음 명령어를 이용하여 생성한 깃 지역 저장소의 사용자 정보를 등록한다. 한 프로젝트를 대상으로 여러 개발자가 작업할 수 있기 때문에 현재 작업하는 개발자가 누구인지 등록하는 과정이다(사용자 이름과 이메일 주소는 본인 깃허브 계정의 Username, Email과 동일해야 한다).

git config user.name "사용자 이름"
git config user.email "이메일 주소"

01 사용자를 등록한다.

chapter2-basic
$ git config user.name "lrycro"

chapter2-basic
$ git config user.email "thscw973@naver.com"

현재 깃 지역 저장소에만 해당하는 사용자 정보를 등록했지만, 모든 프로젝트에 적용될 사용자 정보를 등록하고 싶다면 --global 옵션을 사용한다.

git config --global user.name "사용자 이름"
git config --global user.email "이메일 주소"

한 컴퓨터에서 여러 계정을 사용할 일이 없다면 --global 옵션을 사용해서 입력하면 된다. 그러면 모든 프로젝트에서 동일한 사용자 정보로 사용할 수 있어 편리하다.
만약, 한 컴퓨터에서 회사 프로젝트와 개인 프로젝트를 동시에 진행한다면 프로젝트마다 지역 사용자 정보를 등록하여 사용하면 된다.

깃 설정 파일 확인

앞에서 깃 저장소에 사용자 정보를 등록했다. 깃은 .git 폴더 안의 config 파일 안에 저장된 설정 정보를 참고하게 된다.

현재 프로젝트 경로를 기준으로 터미널에서 cat .git/config 명령어를 실행하여 config 파일 내용을 살펴보자.

cat .git/config

chapter2-basic
$ cat .git/config
[core]
        repositoryformatversion = 0 ①
        filemode = false ②
        bare = false ③
        logallrefupdates = true ④
        symlinks = false ⑤
        ignorecase = true ⑥
[user]
        name = lrycro
        email = thscw973@naver.com

core와 user 섹션으로 구성되어 있다. core는 깃이 파일을 감지하는 방법, 캐싱하는 방법 등 깃의 동작을 제어하는 설정이 저장되어 있고, user 섹션에는 사용자 정보가 저장되어 있다.

 

위는 Windows 환경의 기본 설정값이다. macOS를 사용할 경우 아래와 같이 나타난다.

chapter2-baisc % cat .git/config
[core]
        repositoryformatversion = 0 ①
        filemode = true ②
        bare = false ③
        logallrefupdates = true ④
        ignorecase = true ⑥
        precomposeunicode = true ⑦
[user]
        name = lrycro
        email = thscw973@naver.com

core 섹션의 몇 가지 설정 내용을 살펴보면 다음과 같다.

 

① repositoryformatversion : 현재 깃 저장소의 형식 및 버전을 식별하기 위해 내부적으로 사용되는 변수이다.

② filemode : 깃 저장소에 포함된 파일 모드의 변경 감지 여부를 설정한다. 예를 들어 파일시스템이 다른 윈도우와 리눅스에서 동시에 작업하는 깃 저장소 파일이라면 실제 코드를 변경하지 않았는데도 변경된 파일이라고 표시될 수 있다. 파일 모드의 변경을 무시하고 싶다면 'filemode = false'로 설정하면 된다.

③ bare : 현재 깃 저장소가 코드를 변경하고 작업하는 용도가 아닌 현재까지 작업을 복사하는 용도라면 'bare = true'로 설정하면 된다. 보통 원격 중앙 저장소를 만드는 데 사용하며, 학습 중에는 사용할 일이 없다.

④ logallrefupdates : 깃 명령어를 통해 수행되는 작업 내역을 기록하는 reflog를 활성화한다. git reflog 명령어를 통해 기록된 작업 내역을 확인할 수 있다.

⑤ symlinks : 깃이 심볼릭 링크를 어떻게 다룰지 설정하는 옵션이다. 심볼릭 링크란 파일 시스템에서 파일 또는 디렉토리를 가리키는 특별한 종류의 링크이다. 윈도우 환경에서는 "바로 가기"라고 생각하면 된다. 심볼릭 링크를 사용하면 동일한 파일이나 디렉토리를 여러 곳에서 공유할 수 있으며, 저장 공간을 절약하고 유지 보수를 쉽게 할 수 있다. 'symlinks = false'로 설정된 경우 깃이 심볼릭 링크를 일반 파일로 취급하도록 하며, 이는 해당 플랫폼에서 심볼릭 링크가 지원되지 않을 때 유용하다. 심볼릭 링크를 포함하는 저장소를 윈도우와 같은 심볼릭 링크를 지원하지 않는 플랫폼에서 공유할 필요가 없는 경우에는 'symlinks = false'로 설정하여 저장소를 더 널리 사용할 수 있다. 반면에 리눅스나 macOS와 같이 심볼릭 링크를 지원하는 플랫폼에서는 'symlinks = true'로 설정하는 것이 바람직하다.

⑥ ignorecase : 대소문자 구분 여부를 설정하는 값이다. 기본값은 true로 대소문자를 구분하지 않는다.

⑦ precomposeunicode : macOS로 깃 저장소를 작업할 때 사용할 수 있는 설정이다. macOS의 유니코드 정규화 방식이 달라서 파일명이 한글일 때 깃에서 해당 파일을 인식하지 못하는 문제가 발생할 수 있다. 이때 'precomposeuicode = true'로 설정하면 해당 문제를 해결할 수 있다.

 

깃 저장소에서 작업할 때 core 섹션의 설정을 변경할 일은 많지 않다. 따라서 깃 저장소의 기본 설정값으로 학습을 진행하려고 한다. 기본 설정값은 개인 환경에 따라 달라질 수 있다. 소개한 것과 값이 다를 수 있으나 학습을 진행하는 데 문제는 없다.

깃 원격 저장소 설정

01 원격 저장소를 설정하려면 우선 깃허브에서 새로운 저장소를 생성해야 한다. github.com 로그인 → 우상단 + 기호를 좌클릭 → 팝업에서 [New repository]를 선택한다.

02 프로젝트 이름인 [Repository name] 항목에 chapter2-basic 이라고 작성 후 나머지 항목은 기본값으로 유지한 채 [Create repository] 버튼을 눌러 저장소를 생성한다.

03 생성한 원격 저장소의 주소를 복사한다.

04 터미널을 실행해 cd 명령으로 chapter2-basic 폴더로 이동한다(윈도우 환경에서는 앞서 언급한 것처럼 진행하면 된다).

05 git remote add origin 명령어를 실행해 원격 저장소 주소를 깃 지역 저장소에 등록한다.

git remote add origin {복사한 원격 저장소 주소}

chapter2-basic
$ git remote add origin https://github.com/lrycro/chapter2-basic.git

06 설정 파일을 확인해보기 위해 터미널에서 cat .git/config 명령어를 실행한다.

chapter2-basic
$ cat .git/config
[core]
        repositoryformatversion = 0
        filemode = false
        bare = false
        logallrefupdates = true
        symlinks = false
        ignorecase = true
[user]
        name = lrycro
        email = thscw973@naver.com
[remote "origin"]
        url = https://github.com/lrycro/chapter2-basic.git
        fetch = +refs/heads/*:refs/remotes/origin/*

앞에서 확인했던 config 파일과는 다르게 [remote "origin"] 섹션이 추가되어 있다.

이렇게 깃 지역 저장소에 설정하는 내용들은 .git 폴더의 config 파일에 추가되어 깃이 사용한다.

이것으로 깃 지역 저장소에 원격 저장소 설정을 마쳤다.

.gitignore 파일 설정

특정 프로젝트에서 생성되는 모든 파일의 버전을 깃으로 관리할 필요가 있을까? 예를 들어 로그 파일 혹은 빌드 결과 파일 등은 개발자가 직접 수정할 일이 없고, 프로젝트 버전 관리용으로도 필요 없다. 따라서 깃으로 관리할 필요가 없기 때문에 .gitignore 파일을 이용해 이런 파일들을 깃이 무시하도록 만들 수 있다.

 

01 .gitignore 파일을 chapter2-basic 프로젝트의 최상위 경로에 생성한다. 다음은 VSCode에서 생성하는 그림이다. 원하는 방식으로 생성하면 된다.

02 .gitignore 파일을 (원하는 편집기로) 열어 로그 파일과 외부 패키지들이 설치되는 node_modules/ 폴더를 깃으로 관리하지 않겠다고 지정 후 저장한다.

# Logs
logs
*.log
npm-debug.log*

# Dependency directories
node_modules/

.gitignore

폴더 말고 개별 파일도 지정할 수 있다. 프로젝트를 진행하면서 깃으로 관리할 필요가 없는 파일이 생길 때마다 해당 .gitignore 파일에 추가하면 된다. .gitignore 파일에 포함된 파일은 수정이 일어나도 깃에서 변경된 파일이라고 알려주지 않는다.

 

참고로 .gitignore 파일에 명시하는 경로는 .gitignore 파일 경로에 상대적이기 때문에 이를 주의해서 작성해야 한다.

.gitignore 파일에서 #은 주석 기호다. #으로 시작하는 줄은 주석으로 .gitignore 파일의 동작에는 영향을 주지 않고 설명 목적으로 사용된다.
.gitignore 파일 사용에 익숙해졌다면, 개발 환경에 맞게 기본적인 .gitignore 파일을 생성해주는 gitignore.io와 같은 도구를 활용해도 좋다.

파일 상태 확인하기

깃으로 관리하는 파일 상태를 이해하려면 깃 작업 트리(working tree) 개념을 알아야 한다.

깃 작업 트리(working tree)

깃은 관리하는 프로젝트의 작업을 효율적으로 처리하는 작업 트리라는 개념을 사용한다. 작업 트리란 깃이 추적(관리)하는 파일과 추적하지 않는 파일을 구분하고, 추적하는 파일들의 상태를 구분 짓는 영역이라고 생각하면 된다. 깃 작업 트리 내용들은 .git 숨김 폴더 안에서 관리된다.

깃 작업 트리

깃 작업 트리에는 크게 3가지 영역이 존재한다.

 

① 작업 디렉터리(Working Directory) : 실제 작업 중인 파일들이 존재하는 영역이다. 파일을 생성하거나 기존 파일을 수정한다면 이는 작업 중인 파일을 의미한다.

② 스테이징 영역(Staging Area) : 작업 디렉터리에서 작업 중인 파일 중 깃이 추적하는 파일들을 식별하는 영역이다. 실제로는 .git 숨김 폴더 내부의 index 파일에서 추적하는 파일들을 식별하고 있다.

③ 지역 저장소(Local Repository) : 스테이징 영역에서 추적되는 파일이 커밋으로 등록되는 영역이다. 즉, 스테이징 영역의 파일 혹은 파일들이 하나의 변경 단위인 커밋으로 등록되는 과정이다.

깃 명령어와 함께 보는 깃 작업 트리

위 그림과 같이 깃 작업 트리는 깃 명령어에 따라 동작한다. 작업 디렉터리에서 작업 중인 파일을 ① git add 명령어를 이용하여 스테이징 영역에 추적하는 파일로 등록하고, 스테이징 영역에서 식별된 파일을 ② git commit 명령어를 이용하여 지역 저장소에 등록하게 된다.

깃으로 파일 상태 확인 - Untracked 및 Tracked 상태

깃에서 관리하는 파일은 Untracked(추적하지 않는)와 Tracked(추적하는) 상태로 나뉜다. 현재 작업 진행 중인 작업 디렉터리에서 새로 생성된 파일은 Untracked 상태가 된다. 주의할 점은 한 번 Tracked 상태가 되었다가 작업 디렉터리에서 수정된 파일은 Untracked 상태가 아니라는 점이다.

깃 작업 트리와 파일의 Untracked 및 Tracked 상태

01 git status 명령어를 실행하여 프로젝트의 현재 파일 상태를 확인한다.

git status

chapter2-basic
$ git status
On branch master

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        .gitignore

nothing added to commit but untracked files present (use "git add" to track)

.gitignore 파일은 현재 작업 진행 중인 작업 디렉터리에서 새로 생성한 파일이기 때문에 Untracked 상태로 존재한다.

 

02 .gitignore 파일을 git add 명령어로 커밋에 포함될 파일로 등록하면 파일 상태가 tracked 상태로 변경된다.

git add "파일명"

만약 폴더를 통째로 올리고 싶다면 해당 폴더의 상위 폴더에서 다음과 같이 명령어를 실행하면 된다.

git add "폴더 이름"

정확히 이를 실행하는 방법은 두 가지가 있는데, 첫 번째로 위와 같이 해당 폴더의 상위 폴더에서 진행하는 방법이다.
예를 들어, 폴더 구조가 다음과 같다고 가정했을 때

my_project/
└── my_folder/
    ├── file1.txt
    └── file2.txt

현재 작업 중인 디렉토리가 'my_project'라고 하자. 이 상태에서 'my_folder'를 통째로 올리고 싶다면, git add 명령을 실행할 때 '폴더 이름'에 상대 경로를 지정하여 해당 폴더를 선택한다.

git add my_folder

이때 'my_folder'는 'my_project' 폴더의 하위 폴더로 위치하고 있기 때문에 상대 경로로 그냥 'my_folder'를 지정하면 된다.

다음은 해당 폴더에서 진행하는 방법이다. 만약 이미 해당 폴더 안에 위치해 있다면, 해당 폴더로 이동한 후에 git add 명령을 실행하면 된다.

cd my_project/my_folder
git add .

.은 현재 디렉토리(즉, 'my_folder')를 의미한다.

 

다시 본론으로 돌아와서 ① .gitignore 파일을 add하고 ② git status를 살펴보면 다음과 같다.

chapter2-basic
$ git add .gitignore
chapter2-basic
$ git status
On branch master

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
        new file:   .gitignore

git add 명령어를 이용하여 .gitignore 파일을 커밋 대상으로 등록하고, git status 명령어를 이용하여 파일 상태를 다시 확인해보니 결과가 바뀌었다. Changes to be committed는 해당 파일이 깃에서 관리하는 파일인 Tracked 상태뿐만 아니라 스테이징 영역에서 커밋으로 기록될 준비가 되어있다는 뜻이다.

 

참고로, git add를 수행할 때 여러 파일을 선택하기 원하는 경우 해당 파일 이름을 나열하면 된다.
git add 명령어를 실행할 때 다음과 같은 경고 문구가 보일 수도 있다.

warning: LF will be replaced by CRLF in .gitignore.

이 경고는 운영체제마다 개행문자를 인식하는 방법이 달라서 발생한다. 해당 경고를 무시해도 실습을 진행하는 데 문제는 없지만, 경고 문구를 보고 싶지 않다면 터미널에서 다음 명령어를 실행하면 된다. 이 명령어를 통해 경고 문구 없이 깃이 자동으로 처리하도록 설정할 수 있다.

git config core.autocrlf true

깃으로 파일 상태 확인 - Unmodified 및 Modified 상태

한 번 스테이징 영역에 추가된 파일은 수정 여부에 따라 Unmodified(수정되지 않은) 상태와 Modified(수정된) 상태로 분류된다.

파일 수정 여부에 따른 Unmofied 및 Modified 상태

작업 디렉터리에서 git add 명령으로 스테이징 영역에 추가된 파일의 상태를 크게 2가지로 분류할 수 있다.

 

① Stage : 커밋으로 기록할 수 있는 최종 상태
② Unstage : 스테이징 영역에 있지만, 파일에 변화가 있는 상태

 

Stage 상태는 Tracked 상태와 Unmodified 상태로 분류할 수 있지만 같은 의미라고 생각하면 된다. Unmodified 상태는 Tracked 상태이면서 파일이 변경되지 않은 상태를 의미한다. Unstage 상태에 있는 파일은 스테이지 영역에 있음에도 불구하고 커밋으로 기록할 수 있는 상태가 아니다. 즉, Stage 상태였다가 파일에 변경이 생기는 순간 Unstage인 Modified 상태로 이전된다.

① 현재 프로젝트에서 새로운 파일을 생성하고 내용을 작성한다. 작업 디렉터리의 Untracked 상태가 된다. ② git add 명령어를 이용하여 파일을 등록한다. 스테이징 영역의 Tracked 및 Unmodified 상태로 이전한다. ③ 해당 파일에 코드 한 줄을 추가했다. 파일이 변경되었기에 여전히 스테이징 영역에 존재하지만 Tracked 및 Modified 상태로 이전한다. ④ 코드 추가가 완료되어 다시 git add 명령어로 해당 파일을 재등록하면 Tracked 및 Unmodified 상태로 이전된다.

 

git status 명령어를 자주 실행해보며 깃에서 관리하는 파일의 영역과 상태에 대해 파악할 수 있다.