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

소개

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

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

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

자습서를 완료하는 것이 좋지만 새 리포지토리를 만들어 GitHub Desktop(을)를 살펴보려는 경우 이 가이드에서는 GitHub Desktop(을)를 사용하여 Git 리포지토리에서 작업하는 방법을 안내합니다.

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

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

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

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

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

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

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

GitHub Desktop 사용을 연습하기 위해 첫 번째 프로젝트로 자습서 리포지토리를 만들고 복제하는 것이 좋습니다.

       **자습서 리포지토리 만들기**를 클릭합니다.

자습서의 프롬프트에 따라 텍스트 편집기를 설치하고, 분기를 만들고, 파일을 편집하고, 커밋하고, GitHub에 게시하고, 끌어오기 요청을 엽니다.

새 리포지토리 만들기

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

       **하드 드라이브에서 새 리포지토리 만들기**를 클릭합니다.

"새 리포지토리 만들기" 창에서 필드를 입력하고 원하는 옵션을 선택합니다.

"Name"에서는 로컬 및 GitHub에서 리포지토리의 이름을 정의합니다.
“설명”은 리포지토리의 용도에 대한 자세한 정보를 제공하는 데 사용할 수 있는 선택적 필드입니다.
“로컬 경로”는 컴퓨터에서 리포지토리의 위치를 설정합니다. 기본적으로 GitHub Desktop은 문서 폴더 내에 GitHub 폴더를 만들어 리포지토리를 저장하지만 컴퓨터의 모든 위치를 선택할 수 있습니다. 새 리포지토리는 선택한 위치 내의 폴더가 됩니다. 예를 들어 리포지토리의 이름을 Tutorial로 지정하면 로컬 경로에 선택한 폴더 내에 _Tutorial_이라는 폴더가 생성됩니다. GitHub Desktop은 다음에 새 리포지토리를 만들거나 복제할 때 선택한 위치를 기억합니다.

     **README를 사용하여 이 리포지토리를 초기화**하면 _README.md_ 파일을 사용하여 초기 커밋이 생성됩니다. README는 사람들이 프로젝트의 목적을 이해하는 데 도움이 되므로 README를 선택하고 유용한 정보를 입력하는 것이 좋습니다. 누군가가 GitHub에서 리포지토리를 방문하면 README가 프로젝트에 대해 배우는 첫 번째 요소가 됩니다. 자세한 내용은 [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)을(를) 참조하세요.

     **Git 무시** 드롭다운 메뉴를 사용하면 버전 제어에 저장하지 않으려는 로컬 리포지토리의 특정 파일을 무시하는 사용자 지정 파일을 추가할 수 있습니다. 사용할 특정 언어 또는 프레임워크가 있는 경우 사용 가능한 목록에서 옵션을 선택할 수 있습니다. 이제 막 시작하는 경우 이 선택을 건너뛸 수 있습니다. 자세한 내용은 [AUTOTITLE](/get-started/git-basics/ignoring-files)을(를) 참조하세요.

     **라이선스** 드롭다운 메뉴를 사용하면 리포지토리의 LICENSE 파일에 오픈 소스 라이선스를 추가할 수 있습니다. 라이선스를 바로 추가하는 것에 대해 걱정할 필요가 없습니다. 사용 가능한 오픈 소스 라이선스 및 리포지토리에 라이선스를 추가하는 방법에 대한 자세한 내용은 [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository)을(를) 참조하세요.

       **Create repository**(리포지토리 만들기)를 클릭합니다.

3부: GitHub Desktop 살펴보기

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

GitHub Desktop 리포지토리 모음

GitHub Desktop 앱 상단에 리포지토리의 현재 상태를 보여 주는 표시줄이 나타납니다.

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

        **현재 리포지토리** 에는 작업 중인 리포지토리의 이름이 표시됩니다. GitHub Desktop에서 **현재 리포지토리**를 클릭하여 다른 리포지토리로 전환할 수 있습니다.

        **현재 분기**는 작업 중인 분기의 이름을 표시합니다. 
        **현재 분기**를 클릭하여 리포지토리의 모든 분기를 보거나, 다른 분기로 전환하거나, 새 분기를 만들 수 있습니다. 리포지토리에서 끌어오기 요청을 만든 후에는 **현재 분기**를 클릭하여 요청을 볼 수도 있습니다.

        **Publish repository**는 아직 GitHub에 리포지토리를 게시하지 않았기 때문에 나타나는 작업으로, 다음 단계에서 수행하겠습니다. 표시줄의 이 섹션은 현재 분기 및 리포지토리의 상태에 따라 변경됩니다. 로컬 리포지토리와 원격 리포지토리 간에 데이터를 교환할 수 있는 다양한 컨텍스트 종속 작업을 사용할 수 있습니다.

변경 내용 및 기록

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

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

        **변경 내용** 보기에는 현재 분기의 파일에 적용되었지만 로컬 리포지토리에 커밋되지 않은 변경 내용이 표시됩니다. 하단에는 "요약" 및 "설명" 텍스트 상자가 있는 상자와 **Commit to BRANCH** 버튼이 있습니다. 여기서 새 변경 내용을 커밋합니다. 
        **BRANCH에 커밋** 버튼은 동적이며, 변경 사항을 커밋할 브랜치를 표시합니다.

        **기록** 보기에는 리포지토리의 현재 분기에 대한 이전 커밋이 표시됩니다. 리포지토리를 만들 때 GitHub Desktop에서 만든 “초기 커밋”이 표시됩니다. 커밋 오른쪽에 리포지토리를 만들 때 선택한 옵션에 따라 _.gitattributes_, _.gitignore_, LICENSE 또는 README 파일이 표시됩니다. 각 파일을 클릭하여 해당 커밋의 파일에 대한 변경 내용인 해당 파일에 대한 diff를 볼 수 있습니다. diff는 파일의 전체 내용이 아니라 파일의 변경된 부분만 표시합니다.

4부: GitHub에 리포지토리 게시

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

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

       ![리포지토리 표시줄의 스크린샷입니다. "리포지토리 게시"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/publish-repository.png)

"리포지토리 게시" 창에서 새 리포지토리에 대한 세부 정보를 입력합니다.

GitHub Desktop은 “이름” 및 “설명” 필드에 리포지토리를 만들 때 입력한 정보를 자동으로 입력합니다.

     **이 코드를 비공개로 유지**하면 프로젝트를 볼 수 있는 사용자를 제어할 수 있습니다. 이 옵션을 선택하지 않은 상태로 두면 GitHub의 다른 사용자가 코드를 볼 수 있습니다. 이 옵션을 선택하면 코드가 공개되지 않습니다.

     **Organization** 드롭다운 메뉴가 있는 경우 GitHub에서 소속 조직에 리포지토리를 게시할 수 있습니다.

    **리포지토리 게시**를 클릭합니다.

GitHub에서 GitHub Desktop의 리포지토리에 액세스할 수 있습니다. 파일 메뉴에서 리포지토리를 클릭한 다음 GitHub에서 보기를 클릭합니다. 이렇게 하면 기본 브라우저의 리포지토리로 바로 이동합니다.

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

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

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

       ![Mac의 메뉴 모음 스크린샷입니다. 열려 있는 "리포지토리" 드롭다운 메뉴에서 커서가 파란색으로 강조 표시된 "Visual Studio Code에서 열기" 위로 이동합니다. ](/assets/images/help/desktop/open-in-editor.png)

이전에 만든 README.md 파일을 약간 변경합니다. 프로젝트를 설명하는 정보(예: 역할 및 기능)를 추가할 수 있습니다. 변경 내용에 만족하면 텍스트 편집기에서 저장합니다.
GitHub Desktop에서 변경 내용 보기로 이동합니다. 파일 목록에 _README.md_가 표시됩니다. README.md 파일 왼쪽에 있는 확인란은 파일에 대한 변경 내용이 커밋의 일부임을 나타냅니다. 나중에 여러 파일을 변경할 수 있지만 일부 파일에 대해 변경한 내용만 커밋하려고 합니다. 파일 옆에 있는 확인란에 표시를 클릭하면 해당 파일이 커밋에 포함되지 않습니다.
```
       ![사이드바의 "변경 내용" 탭 스크린샷입니다. "README.md" 파일의 왼쪽에는 선택한 확인란이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/viewing-changes.png)
```

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

       ![사이드바의 "변경 내용" 탭 스크린샷입니다. 프로필 사진 오른쪽에는 커밋 메시지가 포함된 텍스트 필드가 주황색으로 표시됩니다.](/assets/images/help/desktop/commit-message.png)

커밋 메시지 아래에서 분기 이름에 커밋을 클릭합니다. 커밋 단추에는 현재 분기가 표시되므로 원하는 분기에 커밋해야 합니다.
GitHub에서 원격 리포지토리에 변경 내용을 푸시하려면 Push origin을 클릭합니다.
```
       ![‘리포포지토리’ 메뉴 모음의 스크린샷. "원본 푸시"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/push-to-origin.png)
```
* Push origin 단추는 GitHub에 리포지토리를 게시하기 위해 클릭한 단추와 동일합니다. 이 단추는 Git 워크플로에서의 위치에 따라 상황별로 변경됩니다. 이제 Push origin 옆에 1이 나타나 GitHub까지 푸시되지 않은 커밋이 1개 있음을 나타냅니다. * 원본 푸시의 "원본"은 변경 내용을 origin이라는 이름의 원격, 이 경우에는 GitHub의 프로젝트의 리포지토리로 푸시하고 있음을 의미합니다. GitHub에 새 커밋을 푸시할 때까지는 컴퓨터의 프로젝트 리포지토리와 GitHub의 프로젝트 리포지토리 간에 차이가 있습니다. 이렇게 할 경우 로컬에서 작업하고 준비가 되면 변경 내용을 GitHub에만 푸시할 수 있습니다.

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

       !["로컬 변경 내용 없음" 화면의 스크린샷입니다. 제안 목록에서 "GitHub에서 보기"라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/desktop/available-actions.png)

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

       ![GitHub의 리포지터리 페이지 스크린샷. 파일 목록 위와 시계 아이콘 옆에는 "커밋 2개"라는 레이블이 지정된 링크가 주황색으로 표시됩니다.](/assets/images/help/desktop/click-two-commits.png)

결론

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

추가 참고 자료

        [AUTOTITLE](/get-started/getting-started-with-git)

        [AUTOTITLE](/get-started/learning-about-github)

```
        [AUTOTITLE](/get-started)
```

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

이 기사에서