-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathgit-ide.qmd
143 lines (96 loc) · 7.7 KB
/
git-ide.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
---
editor:
markdown:
wrap: sentence
---
# 통합개발환경
\index{통합개발환경} \index{IDE}
데이터 분석 스크립트를 개발할 때 버전 제어(version control)는 매우 유용하다.
R 프로그래밍 언어 전용 통합개발환경 RStudio는 Git과 통합이 잘 되어 있다.
몇몇 고급 Git 기능은 명령 프롬프트가 필요하지만, 일반적인 Git 작업에 대한 좋은 인터페이스를 RStudio을 통해 무료로 제공되고 있다.
RStudio에서 작업 디렉토리와 연관된 프로젝트를 생성을 통해 관련 파일을 추적한다.
Rstudio 프로젝트에 Git을 통합시켜 버전 제어를 함으로써 프로젝트 개발과정을 시간에 따라 추적하고, 이전 버전으로 되돌릴 수 있으며, 다른 사람과 협업을 원활히 수행할 수 있다.
RStudio에서 Git을 이용하여 시작하려면, 새 프로젝트를 생성한다.
\index{RStudio}
{#fig-rstudio-new-project fig-align="center" width="450"}
프로젝트 생성 방식에 대해 묻는 대화 상자가 열린다.
여기서 몇 가지 옵션을 선택할 수 있다.
가령 이미 만들어 둔 `planets` 저장소를 RStudio에서 Git 저장소로 재사용한다고 가정해 보자.
저장소가 컴퓨터 디렉토리에 있으므로, "Existing Directory"("기존 디렉토리") 옵션을 선택한다.
{#fig-rstudio-existing-directory fig-align="center" width="450"}
::: callout-tip
### "버전 제어" 옵션이 보이나요?
\index{git} 여기서 사용하지 않겠지만, 메뉴에 "버전 제어" 옵션이 있어야 한다.
GitHub에서 저장소를 복제하여 컴퓨터에 프로젝트로 생성하려면 클릭해서 지정해야만 된다.
만약 옵션이 존재하지 않는다면, 이는 아마도 RStudio가 Git 실행파일이 어디 있는지 모른다는 것을 의미한다.
RStudio에 Git 실행파일 위치를 알려주지 않는다면 더이상 진행이 불가능하다.
### Git 실행파일 찾기 {.unnumbered}
먼저 Git이 컴퓨터에 설치되어 있는지 확실히 확인한다.
맥이나 리눅스에서 쉘을 열고, 윈도우에서는 명령 프롬프트를 열고 다음을 타이핑한다.
- `which git` (맥, 리눅스)
- `where git` (윈도우)
그러면 Git 실행파일 경로가 나타난다.
만약 컴퓨터에 Git 버전이 없다면, [Git 구축 및 설정](#git-setup)을 참고하여 Git을 설치해야 한다.
다음으로 쉘이나 명령 프롬프트를 열고 `which git` (맥, 리눅스), 또는 `where git` (윈도우)를 타이핑한다.
Git 실행 파일 경로를 복사해 둔다.
GitHub 데스크탑이 설치된 Windows 컴퓨터에서의 경로는 다음과 같다.
> `C:/Users/UserName/AppData/Local/GitHubDesktop/app-1.1.1/resources/app/git/cmd/git.exe`
참고: 사용자 컴퓨터마다 경로에 다소 차이가 날 수 있다.
### RStudio에 GitHub 위치 알리기 {.unnumbered}
RStudio에서 `Tools` 메뉴 \> `Global Options` \> `Git/SVN`으로 이동한 후 명령 프롬프트나 쉘에서 찾은 Git 실행 파일을 찾아간다.
RStudio가 자동으로 재시작된다.
참고: Git이 이미 설치되어 있다 하더라도, 맥OS를 사용하는 경우 `Xcode` 라이센스 동의가 필요할 수 있다.
:::
다음으로, RStudio가 기존 디렉토리를 사용하려는지 물어보게 된다.
"Browse..."("찾아보기...")를 클릭해서 원하는 디렉토리로 이동한 후 "Create Project"("프로젝트 생성")를 클릭한다.
{#fig-rstudio-navigate-existing fig-align="center" width="450"}
이제 완성!
기존 `planets` 저장소에 RStudio 새 프로젝트를 생성했다.
메뉴에서 "Git" 메뉴를 확인해 보자.
RStudio는 현재 디렉토리를 Git 저장소로 올바르게 인식했다.
또한, RStudio를 통해 Git을 자유롭게 활용할 수 있도록 필요한 다양한 도구들이 제공된다.
{#fig-rstudio-git-menubar fig-align="center" width="450"}
저장소 기존 파일들을 편집하기 위해서, 우측 하단 "Files"("파일") 패널에서 클릭할 수 있다.
이제 명왕성에 대한 몇 가지 추가 정보를 명왕성 파일(`pluto.txt`)에 추가한다.
{#fig-rstudio-edit-files fig-align="center" width="450"}
파일을 편집한 후 Git 메뉴에서 "Commit..."("커밋...")을 클릭하여 변경사항을 저장할 수 있다.
{#fig-rstudio-commit fig-align="center" width="450"}
이제 어떤 파일을 커밋할지 선택할 수 있게 하고, 커밋 메시지를 입력할 수 있는 대화 상자를 연다.
("Staged" 적절한 상자를 체크하면 된다).
"Status" 아이콘은 각 파일의 현재 상태를 나타낸다.
파일을 클릭하면 변경사항에 대한 정보가 아래 패널에 펼쳐진다.(`git diff` 출력이 활용된다).
모든 것이 원하는 대로 되면, "커밋"("Commit")을 클릭한다.
{#fig-rstudio-review-commit fig-align="center" width="338"}
변경사항을 푸시하려면 Git 메뉴에서 "브랜치 푸시"("Push Branch")를 선택하면 된다.
원격 저장소에서 가져오는("Pull Branch") 옵션도 있으며, 커밋 이력("History")을 보는 옵션도 있다:
{#fig-rstudio-git-menu fig-align="center" width="450"}
::: callout-tip
### 푸시/풀 명령이 비활성화된 경우
푸시/풀 명령이 비활성화되었다면, 일반적으로 RStudio가 원격 저장소 위치를 모른다는 것을 의미한다.
(예: GitHub).
이를 고치기 위해 저장소 터미널을 열고 `git push -u origin main` 명령어을 입력한다.
그런 다음 RStudio를 재시작한다.
:::
만약 "이력"("History")을 클릭한다면, 콘솔에서 `git log` 출력과 것과 같은 그래픽 버전으로 확인할 수 있다.
{#fig-rstudio-view-history fig-align="center" width="338"}
RStudio는 프로젝트를 추적하는 데 많은 파일들을 자동생성한다.
종종 추적하고 싶지 않은 경우가 있다.
예를 들어, 데이터 크기가 큰 파일이나 API 인증키 같은 보안 정보가 포함된 파일들이다.
이럴 경우 파일명 혹은 디렉토리명을 `.gitignore` 파일에 추가한다.
{#fig-rstudio-gitignore fig-align="center" width="450"}
::: callout-tip
### 일회용 산출물 버전관리
일반적으로 일회용 출력(또는 읽기 전용 데이터)을 버전 제어는 권장하지 않는다.
`.gitignore` 파일을 수정하여 Git이 이들 파일과 디렉토리를 무시하여 버전 제어에서 제외시킨다.
:::
## 연습문제 {.unnumbered}
1. 새로운 디렉토리를 만들어서 프로젝트에 `graphs` 디렉토리를 추가하시오.
2. `.gitignore` 파일을 수정하여 `graphs` 디렉토리를 버전 제어에서 제외시키시오.
::: {.content-visible when-format="revealjs"}
해답:
Rstudio에서 다음과 같이 할 수 있다:
``` r
dir.create("./graphs")
```
그리고 나서, `.gitignore`를 수정해서 `graphs` 디렉토리가 버전 제어되지 않도록 블랙리스트에 추가한다.
:::