EGit 1. 도구개요 2. 설치및실행 3. 주요기능 4. 활용예제
1. 도구개요 1.1 도구정보요약 도구명소개특징주요기능 EGit (http://www.eclipse.org/egit/) Eclipse 용 Git 플러그인 라이선스 Eclipse Public License v1.0 Eclipse IDE 내에서 DVCS(Distributed Version Control System) 인 Git 을바로사용할수있도록지원 Git 을 Java 로구현한 JGit 을사용 다양한 GUI 들 (perspective, view 등 ) 은 git 사용에대해사용자편리성을제공 Label Decorations Graphical History View Git Tree Compare View Mylyn Github Connector 실행환경 Windows, Unix, Linux, MacOS 사전설치도구 JDK 1.6+, Eclipse MARS 카테고리 형상관리최신버전 v4.1.1 (2015.11) 관련도구 Eclipse, Git, Subversion, Subversive, Subclipse 2
1. 도구개요 1.2 스크린캡쳐및주요기능 Eclipse 내에서 Git 저장소와연계 add, commit, merge, rebase, push, pull 등의형상관리명령을 Eclipse GUI 환경을이용해서수행가능 history view, merge tool 등작업편의기능제공 3
2. 설치및실행 세부목차 2.1 사전설치사항확인 2.2 설치확인 2.3 설치 2.4 Marketplace 통한설치 2.5 실행 2.6 사용자정보입력 2.7 환경변수설정 4
2. 설치및실행 2.1 사전설치사항확인 (1/2) EGit 는 eclipse 플러그인이므로사용할 eclipse 의버전에따라유효한 JDK 버전이설치되어있는지확인한다. - Eclipse 버전은 Help > About > Install Details > Plug-ins 에서 Eclipse Platform 플러그인의버전을확인한다. 5
2. 설치및실행 2.1 사전설치사항확인 (2/2) Windows 의경우아래와같이 Command 창에서 java version 을실행하여설치된 JDK 버전을확인한다. Eclipse 4.0 이상인경우 JDK 1.6 이상, Eclipse 3.7 이하인경우 JDK 1.5 이상을필요로한다. 6
2. 설치및실행 2.2 설치확인 Eclipse Kepler(4.3+) 버전부터 EGit 가 Eclipse 패키지에기본으로포함되어배포되므로별도의설치가필요없다. - Help -> About Eclipse SDK 에서 EGit 아이콘이보이면설치된것임 Juno 이하의구버전 Eclipse 사용시 2.3 절을참고하고, Kepler 이상의버전사용시 2.6 절로이동한다. 7
2. 설치및실행 2.3 설치 (1/4) Juno 이하의구버전 Eclipse 에서는 EGit 을플러그인으로설치해야한다. - Help > Install New Software 을클릭한다. 8
2. 설치및실행 2.3 설치 (2/4) - Add 버튼을누르고 Name 에 EGit, Location 에사이트링크를입력한다. ( 주소는 http://www.eclipse.org/egit/download/ 에서확인한다.) 9
2. 설치및실행 2.3 설치 (3/4) - 해당주소에서다운로드가능한플러그인들이검색된다. - 모두설치해도되지만 Java implementation of Git, Eclipse Git Team Provider, Command Line Interface for Java implementation of Git 만선택하고 Next 버튼을누른다. 10
2. 설치및실행 2.3 설치 (4/4) - Next 클릭후 라이선스조항동의함 을선택하고 Finish 를눌러설치를진행한다. - 설치가완료되면 Eclipse 를재실행한다. 11
2. 설치및실행 2.4 Marketplace 통한설치 (1/2) Eclipse 의 Marketplace 를통해 EGit 을보다쉽게설치할수있다. - Help > Eclipse Marketplace 를실행 - EGit 을검색하여항목의 Install 버튼을클릭하여설치 12
2. 설치및실행 2.4 Marketplace 통한설치 (2/2) - Next 를눌러진행하다가 라이선스조항동의함 을선택하고 Finish 클릭 - 설치가완료되면 Eclipse 를재실행 13
2. 설치및실행 2.5 실행 Eclipse 메뉴에서 Help > About 을실행한다. - 아래그림같이 EGit 아이콘이확인되면설치가완료된것이다. 14
2. 설치및실행 2.6 사용자정보입력 (1/2) Git 은 commit 을생성한사용자추적을위해사용자식별정보가필요하다. 사용자정보는이름과 E-mail 로구성되어 Git 환경설정파일 (.gitconfig) 에저장된다. EGit 에서첫번째 commit 을할때사용자정보가없다면아래와같이사용자정보입력다이얼로그가표시된다. - User name 과 e-mail 을입력하고 OK 를클릭한다. - Don t show this dialog again 을체크하면 global 로저장하여다음부터는식별정보입력다이얼로그를표시하지않는다. 15
2. 설치및실행 2.6 사용자정보입력 (2/2) 사용자정보는 Git configuration 을통해서도입력가능하다. - Window > Preferences > Team > Git > Configuration 을클릭한다. - Add Entry 를클릭하고 user.email 과 user.name 의키값쌍을입력한다. Location 에등록된.gitconfig 파일을직접열어편집할수도있다. 16
2. 설치및실행 2.7 환경변수설정 윈도우에서 EGit 은기본적으로 %HOME% 경로에서.gitconfig 파일을찾는다. - %HOME% 이없으면 %USERPROFILE% 가기본값 따라서 HOME 환경변수를설정하여.gitconfig 파일경로를지정할수있다. - 시작에서 environment 를검색하여 계정의환경변수편집 을실행한다. - 새로만들기버튼을클릭하고변수이름에 HOME, 변수값에.gitconfig 파일이위치한폴더의경로를입력한후확인을누른다. - 기존에 Git 을사용했으면 Git 이설치된경로를입력하여기존환경설정을사용할수있다. 17
3. 주요기능 세부목차 3.1 Label Decorations 3.2 Graphical History View 3.3 Git Tree Compare View 3.4 Create Local Repository 3.5 Clone Remote Repository 3.6 Push 3.7 Fetch 3.8 Configure Upstream 3.9 Stage 3.10 Commit 3.11 Branching Branch 생성 3.12 Branching Branch 변경 3.13 Merge 18
3. 주요기능 3.1 Label Decorations 이클립스의 Label decorations 기능은뷰의모델객체를 Text 나 Icon 등을통해시각적으로꾸며주는역할을한다. 이것은 Project Explorer, Package Explorer, Navigator, Hierarchy View 등모델객체를보여주는모든뷰에나타난다. Git 도 Label decorations 을통해리소스들의상태를시각화하여보여준다. 모든등록된 Label decorations 은환경설정 (Window > Preferences) 의 General > Appearance > Label Decorations 에서 on/off 전환이가능하다. Git 에대한꾸밈세부설정은 Team > Git > Label Decorations 에서가능하다. Icon Decorations Text Decorations 19
3. 주요기능 3.2 Graphical History View 탐색기팝업메뉴에서 Team > Show in History 를실행한다. - Git 의 History View 는선택된저장소의브랜치별 commit 을보여준다. - 특정 commit 을클릭하면커밋메시지와해당커밋에관련된파일목록을보여준다. - History View 는아래와같이구성되어있다. Current Input Commit Graph Revision Comment Area Revision Detail Area 20
3. 주요기능 3.3 Git Tree Compare View 프로젝트나패키지를선택하고 compare 를실행할경우 Git Tree Compare View 가표시된다. - 파일의변경상태 ( 추가, 삭제, 변경 ) 에따라아이콘을표시해준다. 탐색기팝업메뉴에서 Compare With 하위메뉴를실행한다. - Commit : 현재작업트리와다른 commit 간의비교 - HEAD Revision : 현재작업트리와마지막 commit 간의비교 - Branch, Tag or Reference : 현재작업트리와레퍼런스간의비교 - Git Index : 현재작업트리와 git 인덱스간의비교 21
3. 주요기능 3.4 Create Local Repository 프로젝트폴더를 git 저장소로만드는기능을한다. - Command 창에서의 git init 명령과동일하다. - Eclipse Workspace 외의다른위치에 git 저장소를만드는경우프로젝트폴더가자동으로해당위치로옮겨진다. 22
3. 주요기능 3.5 Clone Remote Repository 원격저장소의복사본을로컬에생성하는기능이다. - 원격저장소 URI 를통해 Host, Path, Protocol 을자동으로판별한다. - 저장소생성시입력하는 authentication 정보를 push 시사용한다. 자동채움 로컬경로 23
3. 주요기능 3.6 Push 로컬저장소에 commit 된내용을원격저장소에반영하는기능이다. - branch 나 tag 를기준으로실행된다. - 복수의 branch/tag 를선택하여실행할수있다. - 원격저장소의 branch/tag 를삭제할경우에도 push 를이용한다. 24
3. 주요기능 3.7 Fetch 원격저장소의내용을로컬저장소로가져오는기능이다. - 원격저장소의 branch 는 [remote 명 ]/[branch 명 ] 으로표시된다. - 원격저장소에변경이없다고보장할수없으므로 push 전에는항상 fetch 하여변경사항을확인하는과정이필요하다. 25
3. 주요기능 3.8 Configure Upstream 저장소별로 Push 혹은 Fetch 될 branch 에대한설정을저장하여 push 나 fetch 시같은행동의반복을줄여주는기능이다. 일정한 branch 에대한 push 나 fetch 가반복적으로발생할경우유용하다. 26
3. 주요기능 3.9 Stage Stage 는수정 / 추가된파일을 commit 에앞서 index 에추가하는기능이다. 프로젝트의리소스는아래와같은상태를갖으며마크에따라 stage 여부를확인할수있다. - > 마크 : 리소스혹은폴더의하위에변경사항이있음 (ModifiedNotYetStaged.java) -? 마크 : 새로생성되어아직 stage 되지않은리소스 (Untracked.java) - * 마크 : > 마크된리소스를 stage 된상태 (Staged.java) - + 마크 :? 마크된리소스를 stage 된상태 (StagedNewFile.java) 27
3. 주요기능 3.10 Commit 현재작업중인브랜치의변경사항을로컬저장소에반영하는기능이다. Message 작성 파일선택 28
3. 주요기능 3.11 Branching Branch 생성 새로운로컬브랜치를생성하는기능이다. - 로컬브랜치는 history 뷰에녹색브랜치명으로표시된다. 브랜치생성과동시에새로운브랜치로 checkout 할수있다. 원격 branch 특수포인터 브랜치명입력 로컬 branch 29
3. 주요기능 3.12 Branching Branch 변경 작업중인브랜치를다른브랜치로변경하는기능이다. - Checkout 된브랜치는 history 뷰에서 bold 로표시된다. 브랜치의변경은목표브랜치를 checkout 함으로써이루어지며, Package Explorer 에서는 Switch 라는명령으로표현된다. 30
3. 주요기능 3.13 Merge 내용이다른 2 개이상의브랜치를합병하는기능이다. Merge 가이루어질브랜치 (base branch) 를체크아웃하고다른브랜치를 merge 한다. checkout 된브랜치 merge 할브랜치선택 31
4. 활용예제 세부목차 4.1 예제소개 4.2 Github 저장소생성 4.3 Github 저장소복제 4.4 프로젝트생성 4.5 저장소에프로젝트추가 4.6 Initial Commit 4.7 파일수정및 Commit 4.8 원격저장소로부터 Fetch 4.9 Merge 4.10 원격저장소로 Push 32
4. 활용예제 4.1 예제소개 본예제는 EGit 사용시가장많이접하는기능위주로보편적인 git 저장소관리방법을작은샘플프로젝트를이용하여설명한다. Github 에저장소를생성하고 EGit 를통해해당저장소를로컬컴퓨터에복제 Eclipse 의프로젝트를 commit & push 로원격저장소에업로드 원격저장소의변경된파일을 fetch 하고로컬의파일과 merge 저장소에 commit & push 하는과정을설명한다. 33
4. 활용예제 4.2 Github 저장소생성 Github(https://github.com/) 에새로운저장소를생성한다. - Create a new repo 를클릭한다. - 저장소이름을입력하고, Create repository 를클릭한다. 34
4. 활용예제 4.3 Github 저장소복제 Github 의우측에서 HTTPS clone URL 을복사한다. 이클립스의 Git Repositories View 에서 Ctrl + V 혹은 Clone a Git repository 를실행하여 repo 를복제한다. Ctrl + c Ctrl + v 35
4. 활용예제 4.4 프로젝트생성 예제에사용될샘플프로젝트를생성한다. - Plug-in 프로젝트의 template 를이용한다. 36
4. 활용예제 4.5 저장소에프로젝트추가 Package Explorer 에서프로젝트를선택하고마우스오른쪽버튼을눌러 Team > Share Project 를실행한다. - Repository type 에서 Git 선택후 Next 클릭 - Repository 에이전장에서복제한저장소를선택후 Finish 를클릭 - 프로젝트및리소스에 Label Decoration 이표시되면완료 37
4. 활용예제 4.6 Initial commit 현재파일들은로컬저장소에만추가되어있는상태이고, 이제원격저장소에업로드하여야한다. - Team > Commit 을클릭한다. - Commit message 를작성하고, 모든파일들을체크한후 Commit and Push 를클릭한다. (commit 과 push 를따로실행해도된다.) <commit> <push> 38
4. 활용예제 4.7 파일수정및 Commit 아래와같이로컬의파일을수정하고 commit 을한다. merge 기능설명을위해 github 사이트에서직접파일을수정하여로컬 repo 와원격 repo 간의충돌을만들었다. github 의파일정보에서 edit 를클릭하여파일수정후저장하면자동으로 commit 된다. 수정된부분 39
4. 활용예제 4.8 원격저장소로부터 Fetch (1/3) 탐색기팝업메뉴에서 Team > Remote > Fetch From 클릭한다. - 혹은 Repositories View 팝업메뉴에서 Fetch 클릭해도동일하다. 40
4. 활용예제 4.8 원격저장소로부터 Fetch (2/3) Configured remote repository 를클릭하고 drop-down 리스트에서원격저장소를선택한다. 41
4. 활용예제 4.8 원격저장소로부터 Fetch (3/3) Fetch 가이루어질로컬, 원격레퍼런스간매핑작업을한다. - Source ref 에서 master 를선택하면 destination 는자동으로선택 - Add Spec 버튼클릭하여 Specifications for fetch 에명세추가 Finish 를눌러 fetch 를완료하면결과화면이표시된다. 42
4. 활용예제 4.9 Merge 로컬 master 에서, Fetch 로가져온원격 master 를 merge 하기위해 Package Explorer 의팝업메뉴에서 Team > Merge 를실행한다. - 현재 checkout 된브랜치는 master 여야한다. Remote Tracking 하위의 origin/master 를선택하고 Merge 를클릭한다. 43
4. 주요기능 4.10 원격저장소로 Push (1/4) 탐색기팝업메뉴에서 Team > Remote > Push 클릭한다. - 혹은 Repositories View 팝업메뉴에서 Push 클릭해도동일하다. 44
4. 주요기능 4.10 원격저장소로 Push (2/4) Configured remote repository 를클릭하고 drop-down 리스트에서 push 대상원격저장소를선택한다. 45
4. 주요기능 4.10 원격저장소로 Push (3/4) Push 가이루어질로컬, 원격레퍼런스간매핑작업을한다. - Source ref 에서 master 를선택하면 destination 은자동으로선택 - Add Spec 버튼클릭하여 Specifications for push 에명세추가 Next 를클릭하여 expected 화면을볼수있다. 46
4. 주요기능 4.10 원격저장소로 Push (4/4) Finish 를클릭하면실제 push 가실행되며결과화면을보여준다. 47