Skip to main content

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

GitHub Desktop(을)를 사용하여 명령줄을 사용하지 않고 Git 리포지토리를 만들고 관리할 수 있습니다.

소개

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

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

GitHub Desktop(을)를 설치하고 GitHub 또는 GitHub Enterprise에 로그인한 후 자습서 리포지토리를 만들고 복제할 수 있습니다. 이 자습서에서는 텍스트 편집기 설치, 분기 만들기, 커밋하기, GitHub.com에 푸시, 끌어오기 요청 열기 등 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 사용을 연습하기 위해 첫 번째 프로젝트로 자습서 리포지토리를 만들고 복제하는 것이 좋습니다.

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

새 리포지토리 만들기

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

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

3부: GitHub Desktop 탐색

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

GitHub Desktop 리포지토리 모음

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

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

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

변경 내용 및 기록

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

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

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

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

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

  1. 리포지토리리 모음에서 리포지토리 게시를 클릭합니다. 리포지토리 표시줄의 스크린샷입니다. "리포지토리 게시"라는 레이블이 지정된 단추가 주황색 윤곽선으로 강조 표시됩니다.
  2. "리포지토리 게시" 창에서 새 리포지토리에 대한 세부 정보를 입력합니다.
    • GitHub Desktop은 “이름” 및 “설명” 필드에 리포지토리를 만들 때 입력한 정보를 자동으로 입력합니다.
    • 이 코드를 비공개로 유지하면 프로젝트를 볼 수 있는 사용자를 제어할 수 있습니다. 이 옵션을 선택하지 않은 상태로 두면 GitHub의 다른 사용자가 코드를 볼 수 있습니다. 이 옵션을 선택하면 코드가 공개되지 않습니다.
    • 조직 드롭다운 메뉴가 있는 경우 GitHub에서 소속 조직에 리포지토리를 게시할 수 있습니다.
    1. 리포지토리 게시를 클릭합니다.
    2. GitHub Desktop에서 GitHub.com의 리포지토리에 액세스할 수 있습니다. 파일 메뉴에서 리포지토리를 클릭한 다음 GitHub에서 보기를 클릭합니다. 이렇게 하면 기본 브라우저의 리포지토리로 바로 이동합니다.

5부: 변경 내용 만들기, 커밋, 푸시

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

  1. GitHub Desktop에서 외부 편집기를 시작하려면 "GitHub Desktop" 메뉴 모음에서 리포지토리를 선택한 다음 편집기에서 열기를 클릭합니다. 자세한 내용은 "GitHub Desktop에서 커밋 순서 변경하기에서 기본 에디터 구성하기"을(를) 참조하세요. Mac의 메뉴 모음 스크린샷입니다. 열려 있는 "리포지토리" 드롭다운 메뉴에서 커서가 파란색으로 강조 표시된 "Visual Studio Code에서 열기" 위로 이동합니다.

  2. 이전에 만든 README.md 파일을 약간 변경합니다. 프로젝트를 설명하는 정보(예: 역할 및 기능)를 추가할 수 있습니다. 변경 내용에 만족하면 텍스트 편집기에서 저장합니다.

  3. GitHub Desktop에서 변경 내용 보기로 이동합니다. 파일 목록에 _README.md_가 표시됩니다. README.md 파일 왼쪽에 있는 확인란은 파일에 대한 변경 내용이 커밋의 일부임을 나타냅니다. 나중에 여러 파일을 변경할 수 있지만 일부 파일에 대해 변경한 내용만 커밋하려고 합니다. 파일 옆에 있는 확인란에 표시를 클릭하면 해당 파일이 커밋에 포함되지 않습니다. 사이드바의 "변경 내용" 탭 스크린샷입니다. "README.md" 파일의 왼쪽에는 선택한 확인란이 주황색 윤곽선으로 강조 표시됩니다.

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

  5. 커밋 메시지 아래에서 분기 이름에 커밋을 클릭합니다. 커밋 단추에는 현재 분기가 표시되므로 원하는 분기에 커밋해야 합니다.

  6. GitHub에서 원격 리포지토리에 변경 내용을 푸시하려면 ** 원본 푸시**를 클릭합니다. ‘리포포지토리’ 메뉴 모음의 스크린샷. "원본 푸시"라는 레이블이 지정된 단추가 주황색 윤곽선으로 강조 표시됩니다.

    • 원본 푸시 단추는 GitHub에 리포지토리를 게시하기 위해 클릭한 단추와 동일합니다. 이 단추는 Git 워크플로에서의 위치에 따라 상황별로 변경됩니다. 이제 Push origin 옆에 1(이)가 나타나 GitHub까지 푸시되지 않은 커밋이 1개 있음을 나타냅니다.
    • 원본 푸시의 “원본”은 변경 내용을 origin이라는 이름의 원격, 이 경우에는 GitHub.com의 프로젝트의 리포지토리로 푸시하고 있음을 의미합니다. GitHub에 새 커밋을 푸시할 때까지는 컴퓨터의 프로젝트 리포지토리와 GitHub.com의 프로젝트 리포지토리 간에 차이가 있습니다. 이렇게 할 경우 로컬에서 작업하고 준비가 되면 변경 내용을 GitHub.com에만 푸시할 수 있습니다.
  7. 변경 내용 보기 오른쪽 창에 다음에 수행할 수 있는 작업에 대한 제안이 표시됩니다. 브라우저에서 GitHub의 리포지토리를 열려면 GitHub에서 보기를 클릭합니다. "로컬 변경 내용 없음" 화면의 스크린샷입니다. 제안 목록에서 "GitHub에서 보기"라는 레이블이 지정된 단추가 주황색 윤곽선으로 강조 표시됩니다.

  8. 브라우저에서 커밋 2개를 클릭합니다. GitHub의 이 리포지토리에 커밋 목록이 표시됩니다. 첫 번째 커밋은 GitHub Desktop에서 방금 만든 커밋입니다. GitHub의 리포지터리 페이지 스크린샷. 파일 목록 위와 시계 아이콘 옆에는 "커밋 2개"라는 레이블이 지정된 링크가 주황색으로 표시됩니다.

결론

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

추가 참고 자료