GitHub Desktop을 사용하여 첫 번째 리포지토리 만들기

소개

GitHub Desktop은(는) GitHub 또는 기타 Git 호스팅 서비스에서 호스트되는 코드로 작업하는 데 도움이 되는 무료 오픈 소스 애플리케이션입니다. GitHub Desktop에서는 명령줄을 사용하는 대신 그래픽 사용자 인터페이스에서 변경 내용 커밋 및 푸시와 같은 Git 명령을 수행할 수 있습니다. 자세한 내용은 GitHub Desktop에 대한 정보을(를) 참조하세요.

이 가이드를 마치면 GitHub Desktop를 사용하여 리포지토리를 만들고, 리포지토리에 변경 사항을 적용하고, 그 변경 사항을 GitHub에 게시하게 됩니다.

GitHub Desktop를 설치하고 GitHub 또는 GitHub Enterprise에 로그인한 후 튜토리얼 리포지토리를 만들고 클론할 수 있습니다. 이 자습서에서는 Git 작업 및 GitHub텍스트 편집기 설치, 분기 만들기, 커밋 만들기, 푸시 GitHub, 끌어오기 요청 열기 등의 기본 사항을 소개합니다. 아직 GitHub Desktop에 리포지토리가 없는 경우 이 자습서를 사용할 수 있습니다.

자습서를 완료하는 것을 권장하지만, 새 리포지토리를 만들어 GitHub Desktop를 탐색하려는 경우 이 가이드에서는 Git 리포지토리에서 작업할 때 GitHub Desktop를 사용하는 방법을 안내합니다.

1부: 계정 설치 GitHub Desktop 및 인증

지원되는 모든 운영 체제에 GitHub Desktop를 설치할 수 있습니다. 앱을 설치한 후에는 자습서 리포지토리를 만들고 복제하기 전에 로그인하고 계정을 GitHubGitHub Enterprise 인증해야 합니다.

설치 및 인증에 대한 자세한 내용은 GitHub Desktop 설정을(를) 참조하세요.

2부: 새 리포지토리 만들기

연결된 GitHub Desktop리포지토리가 없는 경우 "시작해 보겠습니다!"가 표시됩니다. 자습서 리포지토리를 만들고 복제하거나, 인터넷에서 기존 리포지토리를 복제하거나, 새 리포지토리를 만들거나, 하드 드라이브에서 기존 리포지토리를 추가하도록 선택할 수 있습니다.

"이제 시작하겠습니다!" 스크린샷 GitHub Desktop에서 보기.

자습서 리포지토리 만들기 및 복제

GitHub Desktop 사용을 연습하기 위한 첫 번째 프로젝트로 튜토리얼 리포지토리를 만들고 복제하는 것을 권장합니다.

자습서 리포지토리 만들기를 클릭합니다.
자습서의 안내에 따라 텍스트 편집기를 설치하고, 브랜치를 만들고, 파일을 편집하고, 커밋하고, GitHub에 게시한 다음 풀 리퀘스트를 여세요.

새 리포지토리 만들기

자습서 리포지토리를 만들고 복제하는 것을 원하지 않는 경우 새 리포지토리를 만들 수 있습니다.

하드 드라이브에서 새 리포지토리 만들기를 클릭합니다.
"새 리포지토리 만들기" 창에서 필드를 입력하고 원하는 옵션을 선택합니다.
- "이름"은 로컬과 GitHub 모두에서 리포지토리 이름을 정의합니다.
- “설명”은 리포지토리의 용도에 대한 자세한 정보를 제공하는 데 사용할 수 있는 선택적 필드입니다.
- “로컬 경로”는 컴퓨터에서 리포지토리의 위치를 설정합니다. 기본적으로 GitHub Desktop 문서 폴더 내에 GitHub 폴더를 만들어 리포지토리 __ 를 저장하지만 컴퓨터의 모든 위치를 선택할 수 있습니다. 새 리포지토리는 선택한 위치 내의 폴더가 됩니다. 예를 들어 리포지토리의 이름을 Tutorial로 지정하면 로컬 경로에 선택한 폴더 내에 _Tutorial_이라는 폴더가 생성됩니다. GitHub Desktop 는 다음에 새 리포지토리를 만들거나 복제할 때 선택한 위치를 기억합니다.
- README를 사용하여 이 리포지토리를 초기화하면 README.md 파일을 사용하여 초기 커밋이 생성됩니다. README는 사람들이 프로젝트의 목적을 이해하는 데 도움이 되므로 README를 선택하고 유용한 정보를 입력하는 것이 좋습니다. 누군가가 GitHub에서 리포지토리를 방문하면, README는 그들이 프로젝트에 대해 알아볼 때 가장 먼저 보게 되는 항목입니다. 자세한 내용은 리포지토리 README 파일에 관하여을(를) 참조하세요.
- Git 무시 드롭다운 메뉴를 사용하면 버전 제어에 저장하지 않으려는 로컬 리포지토리의 특정 파일을 무시하는 사용자 지정 파일을 추가할 수 있습니다. 사용할 특정 언어 또는 프레임워크가 있는 경우 사용 가능한 목록에서 옵션을 선택할 수 있습니다. 이제 막 시작하는 경우 이 선택을 건너뛸 수 있습니다. 자세한 내용은 Ignoring files(파일 무시)을(를) 참조하세요.
- 라이선스 드롭다운 메뉴를 사용하면 리포지토리의 LICENSE 파일에 오픈 소스 라이선스를 추가할 수 있습니다. 라이선스를 바로 추가하는 것에 대해 걱정할 필요가 없습니다. 사용 가능한 오픈 소스 라이선스 및 리포지토리에 라이선스를 추가하는 방법에 대한 자세한 내용은 리포지토리 라이선싱을(를) 참조하세요.
Create repository(리포지토리 만들기)를 클릭합니다.

3부: 탐색 GitHub Desktop

화면 상단의 파일 메뉴에서 GitHub Desktop에서 수행할 수 있는 설정과 작업에 액세스할 수 있습니다. 대부분의 작업에는 보다 효율적으로 작업하는 데 도움이 되는 바로 가기 키가 있습니다. 바로 가기 키의 전체 목록은 GitHub Desktop 바로 가기 키을(를) 참조하세요.

GitHub Desktop 리포지토리 막대

앱 맨 위에 GitHub Desktop 리포지토리의 현재 상태를 보여 주는 막대가 표시됩니다.

GitHub Desktop 앱의 스크린샷입니다. "hello-world" 리포지토리에 대한 세부 정보를 표시하는 모음이 창의 위쪽에 걸쳐 있으며 주황색 윤곽선으로 표시됩니다.

현재 리포지토리 에는 작업 중인 리포지토리의 이름이 표시됩니다. 현재 리포지토리를 클릭하여 .에서 다른 리포지토리로 전환할 수 있습니다GitHub Desktop.
현재 분기는 작업 중인 분기의 이름을 표시합니다. 현재 분기를 클릭하여 리포지토리의 모든 분기를 보거나, 다른 분기로 전환하거나, 새 분기를 만들 수 있습니다. 리포지토리에서 끌어오기 요청을 만든 후에는 현재 분기를 클릭하여 요청을 볼 수도 있습니다.
리포지토리 게시가 표시되는 이유는 아직 리포지토리를 GitHub에 게시하지 않았기 때문이며, 이는 다음 단계에서 나중에 수행하게 됩니다. 표시줄의 이 섹션은 현재 분기 및 리포지토리의 상태에 따라 변경됩니다. 로컬 리포지토리와 원격 리포지토리 간에 데이터를 교환할 수 있는 다양한 컨텍스트 종속 작업을 사용할 수 있습니다.

변경 내용 및 기록

왼쪽 사이드바에서 변경 내용 및 기록 보기를 찾을 수 있습니다.

GitHub Desktop 앱의 스크린샷입니다. 왼쪽의 사이드바에는 "Changes" 및 "History"라는 레이블이 지정된 탭이 주황색 윤곽선으로 표시됩니다.

변경 내용 보기에는 현재 분기의 파일에 적용되었지만 로컬 리포지토리에 커밋되지 않은 변경 내용이 표시됩니다. 하단에는 "요약" 및 "설명" 텍스트 상자가 있는 상자와 Commit to BRANCH 버튼이 있습니다. 여기서 새 변경 내용을 커밋합니다. BRANCH에 커밋 버튼은 동적이며, 변경 사항을 커밋할 브랜치를 표시합니다.
기록 보기에는 리포지토리의 현재 분기에 대한 이전 커밋이 표시됩니다. 리포지토리를 만들 때 만든 GitHub Desktop "초기 커밋"이 표시됩니다. 커밋 오른쪽에 리포지토리를 만들 때 선택한 옵션에 따라 .gitattributes, .gitignore, LICENSE 또는 README 파일이 표시됩니다. 각 파일을 클릭하여 해당 커밋의 파일에 대한 변경 내용인 해당 파일에 대한 diff를 볼 수 있습니다. diff는 파일의 전체 내용이 아니라 파일의 변경된 부분만 표시합니다.

4부: 내 리포지토리 게시하기 GitHub

새 리포지토리를 만들면 해당 리포지토리는 사용자의 컴퓨터에만 존재하며 해당 사용자만이 이 리포지토리에 액세스할 수 있습니다. 리포지토리를 게시하여 GitHub 여러 컴퓨터에서 동기화된 상태로 유지하고 다른 사용자가 액세스할 수 있도록 할 수 있습니다. 리포지토리를 게시하려면 로컬 변경 내용을 .에 푸시합니다 GitHub.

리포지토리 막대에서 리포지토리 게시를 클릭합니다.

리포지토리 표시줄의 스크린샷입니다. "리포지토리 게시"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.

"리포지토리 게시" 창에서 새 리포지토리에 대한 세부 정보를 입력합니다.
- GitHub Desktop 는 리포지토리를 만들 때 입력한 정보로 "이름" 및 "설명" 필드를 자동으로 채웁니다.
- 이 코드를 비공개로 유지하면 프로젝트를 볼 수 있는 사용자를 제어할 수 있습니다. 이 옵션을 선택하지 않은 상태로 두면 다른 사용자가 GitHub 코드를 볼 수 있습니다. 이 옵션을 선택하면 코드가 공개되지 않습니다.
- 조직 드롭다운 메뉴가 있는 경우 리포지토리를 사용자가 속한 특정 조직에 게시할 GitHub수 있습니다.
1. 리포지토리 게시를 클릭합니다.
2. GitHub 내에서 GitHub Desktop의 리포지토리에 접근할 수 있습니다. 파일 메뉴에서 리포지토리를 클릭한 다음 GitHub에서 보기를 클릭합니다. 이렇게 하면 기본 브라우저의 리포지토리로 바로 이동합니다.

5부: 변경 사항 생성, 커밋하기, 푸시하기

이제 리포지토리를 만들고 게시했으므로 이번에는 프로젝트를 변경하고 리포지토리에 대한 첫 번째 커밋 만들기를 시작해 보겠습니다.

내부에서 GitHub Desktop외부 편집기를 시작하려면 "GitHub Desktop" 메뉴 모음에서 리포지토리를 선택한 다음 편집기에서 열기를 클릭합니다. 자세한 내용은 GitHub Desktop에서 기본 편집기 구성하기을(를) 참조하세요.

Mac의 메뉴 모음 스크린샷입니다. 열려 있는 "리포지토리" 드롭다운 메뉴에서 커서가 파란색으로 강조 표시된 "Visual Studio Code에서 열기" 위로 이동합니다.

이전에 만든 README.md 파일을 약간 변경합니다. 프로젝트를 설명하는 정보(예: 역할 및 기능)를 추가할 수 있습니다. 변경 내용에 만족하면 텍스트 편집기에서 저장합니다.
에서 GitHub Desktop변경 내용 보기로 이동합니다. 파일 목록에 _README.md_가 표시됩니다. README.md 파일 왼쪽에 있는 확인란은 파일에 대한 변경 내용이 커밋의 일부임을 나타냅니다. 나중에 여러 파일을 변경할 수 있지만 일부 파일에 대해 변경한 내용만 커밋하려고 합니다. 파일 옆에 있는 확인란에 표시를 클릭하면 해당 파일이 커밋에 포함되지 않습니다.

사이드바의 "변경 내용" 탭 스크린샷입니다. "README.md" 파일의 왼쪽에는 선택한 확인란이 주황색 윤곽선으로 강조 표시됩니다.

변경 내용 목록 하단에 커밋 메시지를 입력합니다. 프로필 사진 오른쪽에 커밋에 대한 간단한 설명을 입력합니다. README.md 파일을 변경하기 때문에 “프로젝트의 목적에 대한 정보 추가”는 좋은 커밋 요약이 될 것입니다. 요약에는 커밋의 변경 내용에 대한 더 긴 설명을 입력할 수 있는 “설명” 텍스트 필드가 표시됩니다. 이를 통해 프로젝트 기록을 되돌아보고 변경된 이유를 이해할 수 있습니다. README.md 파일의 기본적인 업데이트를 하고 있으므로 설명을 건너뛸 수 있습니다.

사이드바의 "변경 내용" 탭 스크린샷입니다. 프로필 사진 오른쪽에는 커밋 메시지가 포함된 텍스트 필드가 주황색으로 표시됩니다.

커밋 메시지 아래에서 분기 이름에 커밋을 클릭합니다. 커밋 단추에는 현재 분기가 표시되므로 원하는 분기에 커밋해야 합니다.
GitHub의 원격 저장소에 변경 사항을 푸시하려면 Push origin을 클릭하세요.

‘리포포지토리’ 메뉴 모음의 스크린샷. "원본 푸시"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.

원본 푸시 단추는 리포지GitHub토리를 게시하기 위해 클릭한 것과 동일합니다. 이 단추는 Git 워크플로에서의 위치에 따라 상황별로 변경됩니다. 이제 Push origin라고 표시되고 그 옆에 1가 함께 표시되어, GitHub에 아직 푸시되지 않은 커밋이 1개 있음을 나타내야 합니다.
Push origin에서 "origin"은 변경 사항을 origin라는 원격 저장소로 푸시한다는 뜻이며, 이 경우 그 원격 저장소는 GitHub에 있는 프로젝트의 저장소입니다. 새 커밋을 GitHub에 푸시하기 전까지는 컴퓨터에 있는 프로젝트 리포지토리와 GitHub에 있는 프로젝트 리포지토리 사이에 차이가 있습니다. 이렇게 하면 로컬에서 작업하고 준비가 되었을 때만 변경 사항을 GitHub에 푸시할 수 있습니다.

변경 내용 보기 오른쪽 창에 다음에 수행할 수 있는 작업에 대한 제안이 표시됩니다. 브라우저에서 GitHub의 리포지토리를 열려면 GitHub에서 보기를 클릭합니다.

"로컬 변경 내용 없음" 화면의 스크린샷입니다. 제안 목록에서 "GitHub에서 보기"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.

브라우저에서 2개의 커밋을 클릭합니다. 이 리포지토리에 커밋 목록이 표시됩니다 GitHub. 첫 번째 커밋은 방금 만든 GitHub Desktop커밋이어야 합니다.

GitHub의 리포지터리 페이지 스크린샷. 파일 목록 위와 시계 아이콘 옆에는 "커밋 2개"라는 레이블이 지정된 링크가 주황색으로 표시됩니다.

결론

이제 리포지토리를 만들고, 리포지토리를 게시하고 GitHub, 커밋하고, 변경 내용을 GitHub푸시했습니다. 만들거나 협업하는 다른 프로젝트에 참여할 때 이 워크플로를 따를 수 있습니다.