GitHub에 로컬로 호스트된 코드 추가

코드가 컴퓨터에 로컬로 저장되고 Git에서 추적되거나 버전 제어 시스템(VCS)에서 추적되지 않는 경우 GitHub CLI 또는 Git 명령을 사용하여 GitHub(으)로 코드를 가져올 수 있습니다.

Platform navigation

이 문서의 내용

GitHub에 기존 소스 코드 가져오기 정보

소스 코드를 GitHub(으)로 가져오면 다른 사용자와 프로젝트에서 함께 작업하고 코드를 쉽게 관리할 수 있습니다. GitHub을(를) 통해 공동 작업, 변경 내용 추적 및 작업을 구성할 수 있으므로 프로젝트를 더 간단하게 빌드하고 관리할 수 있습니다. 자세한 내용은 "GitHub 및 Git 정보"을(를) 참조하세요.

Warning

원격 리포지토리에 암호 또는 API 키 등의 중요한 정보를 절대 git add, commit, push하지 마세요. 이 정보를 이미 추가한 경우 "Removing sensitive data from a repository(리포지토리에서 중요한 데이터 제거)"을 참조하세요.

GitHub에 기존 소스 코드 추가

Git에서 추적하거나 VCS(버전 제어 시스템(VCS)에서 추적하지 않는 컴퓨터에 로컬로 저장된 소스 코드가 있는 경우 터미널에 명령을 입력하여 GitHub에 코드를 추가할 수 있습니다. Git 명령을 직접 입력하여 이 작업을 수행할 수 있습니다. 또는 GitHub CLI 또는 GitHub Desktop을(를) 사용할 수 있습니다.

GitHub CLI 사용

GitHub CLI는 컴퓨터의 명령줄에서 GitHub를 사용하기 위한 오픈 소스 도구입니다. GitHub CLI는 명령줄을 사용하여 GitHub에 기존 프로젝트를 추가하는 프로세스를 간소화할 수 있습니다. GitHub CLI에 대한 자세한 내용은 GitHub CLI 정보을(를) 참조하세요.

GitHub Desktop 사용

포인트 앤 클릭 사용자 인터페이스에 가장 익숙한 경우 대신 GitHub Desktop을(를) 사용하여 프로젝트를 추가하는 것을 고려해 보세요. 자세한 내용은 로컬 컴퓨터에서 GitHub Desktop으로 리포지토리 추가을(를) 참조하세요.

다른 VCS에서 리포지토리 변환

Mercurial, Subversion 또는 Team Foundation 버전 제어와 같은 다른 VCS에서 소스 코드를 추적하는 경우 프로젝트를 GitHub에 추가하기 전에 리포지토리를 Git으로 변환해야 합니다.

Git 리포지토리 초기화

로컬 호스팅 코드가 VCS에서 추적되지 않는 경우 첫 번째 단계는 Git 리포지토리를 초기화하는 것입니다. Git에서 프로젝트를 이미 추적한 경우 명령줄을 사용하여 Git 리포지토리 가져오기로 건너뜁니다.

  1. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  2. 프로젝트의 루트 디렉터리로 이동합니다.

  3. 로컬 디렉터리를 Git 리포지토리로 초기화합니다. 기본적으로 초기 분기를 main라고 합니다.

    Git 2.28.0 이상 버전을 사용하는 경우 기본 분기의 이름을 -b로 설정할 수 있습니다.

    git init -b main

    Git 2.27.1 이하 버전을 사용하는 경우 기본 분기의 이름을 git symbolic-ref으로 설정할 수 있습니다.

    git init && git symbolic-ref HEAD refs/heads/main

  4. 새 로컬 리포지토리에서 파일을 추가합니다. 그러면 파일이 첫 번째 커밋을 위해 스테이징됩니다.

    $ git add .
# Adds the files in the local repository and stages them for commit. 파일의 스테이징을 해제하려면 ‘git reset HEAD YOUR-FILE’을 사용합니다.

  5. 로컬 리포지토리에서 스테이징한 파일을 커밋합니다.

    $ git commit -m "First commit"
# Commits the tracked changes and prepares them to be pushed to a remote repository. 이 커밋을 제거하고 파일을 수정하려면 ‘git reset --soft HEAD~1’을 사용하여 파일을 다시 커밋하고 추가합니다.

명령줄을 사용하여 Git 리포지토리 가져오기

Git 리포지토리를 초기화한 후 GitHub CLI 또는 Git을 사용하여 GitHub에 리포지토리를 푸시할 수 있습니다.

GitHub CLI을(를) 사용하여 GitHub에 로컬 리포지토리 추가

  1. GitHub에서 프로젝트에 대한 리포지토리를 만들려면 gh repo create 하위 명령을 사용하세요. 메시지가 표시되면 GitHub에 기존 로컬 리포지토리 푸시를 선택하고 원하는 리포지토리 이름을 입력합니다. 프로젝트가 사용자 계정 대신 조직에 속하도록 하려면 ORGANIZATION-NAME/PROJECT-NAME을 사용하여 조직 이름과 프로젝트 이름을 지정합니다.

  2. 대화형 프롬프트의 안내를 따릅니다. 원격을 추가하고 리포지토리를 푸시하려면 원격을 추가하고 커밋을 현재 분기에 푸시하라는 메시지가 표시될 때 예를 확인합니다.

  3. 또는 모든 프롬프트를 건너뛰려면 --source 플래그가 있는 리포지토리의 경로를 제공하고 표시 유형 플래그(--public, --private 또는--internal)를 전달합니다. 예들 들어 gh repo create --source=. --public입니다. --remote 플래그를 사용하여 원격을 지정합니다. 커밋을 푸시하려면 --push 플래그를 전달합니다. 가능한 인수에 대한 자세한 내용은 GitHub CLI 설명서를 참조하세요.

Git을 사용하여 GitHub에 로컬 리포지토리 추가

Git을 사용하여 로컬 리포지토리를 GitHub에 추가하려면, 명령줄에서 GitHub에 인증해야 합니다. 자세한 내용은 GitHub에 대한 인증 정보을(를) 참조하세요.

  1. GitHub에 새 리포지토리를 만듭니다. 오류를 방지하려면 새 리포지토리를 ‘추가 정보’, 라이선스 또는 gitignore 파일로 초기화하지 마세요. 프로젝트가 GitHub에 푸시된 후 이러한 파일을 추가할 수 있습니다. 자세한 내용은 "새 리포지토리 만들기" 항목을 참조하세요.

  2. GitHub의 빠른 설정 페이지에서 리포지토리 상단에 있는 아이콘을 클릭하여 원격 리포지토리 URL을 복사합니다.

    리포지토리의 "빠른 설정" 헤더 스크린샷. 원격 URL 옆에는 두 개의 겹치는 사각형 아이콘이 주황색 윤곽선으로 강조 표시됩니다.

  3. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  4. 현재 작업 디렉터리를 로컬 프로젝트로 변경합니다.

  5. 로컬 리포지토리가 푸시될 원격 리포지토리의 URL을 추가하려면 다음 명령을 실행하세요. GitHub에서 REMOTE-URL을(를) 리포지토리의 전체 URL로 바꿉다.

    git remote add origin REMOTE-URL

    자세한 내용은 원격 리포지토리 관리을(를) 참조하세요.

  6. 원격 URL을 올바르게 설정했는지 확인하려면 다음 명령을 실행하세요.

    git remote -v

  7. 로컬 리포지토리의 변경 내용을 GitHub에 푸시하려면 다음 명령을 실행하세요.

    git push -u origin main

    사용자의 기본 분기 이름이 "main"이 아닌 경우 "main"을 사용자의 기본 분기 이름으로 바꿉니다. 자세한 내용은 분기 정보을(를) 참조하세요.

  1. GitHub에 새 리포지토리를 만듭니다. 오류를 방지하려면 새 리포지토리를 ‘추가 정보’, 라이선스 또는 gitignore 파일로 초기화하지 마세요. 프로젝트가 GitHub에 푸시된 후 이러한 파일을 추가할 수 있습니다. 자세한 내용은 "새 리포지토리 만들기" 항목을 참조하세요.

  2. GitHub의 빠른 설정 페이지에서 리포지토리 상단에 있는 아이콘을 클릭하여 원격 리포지토리 URL을 복사합니다.

    리포지토리의 "빠른 설정" 헤더 스크린샷. 원격 URL 옆에는 두 개의 겹치는 사각형 아이콘이 주황색 윤곽선으로 강조 표시됩니다.

  3. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  4. 현재 작업 디렉터리를 로컬 프로젝트로 변경합니다.

  5. 로컬 리포지토리가 푸시될 원격 리포지토리의 URL을 추가하려면 다음 명령을 실행하세요. GitHub에서 REMOTE-URL을(를) 리포지토리의 전체 URL로 바꿉다.

    git remote add origin REMOTE-URL

    자세한 내용은 원격 리포지토리 관리을(를) 참조하세요.

  6. 원격 URL을 올바르게 설정했는지 확인하려면 다음 명령을 실행하세요.

    git remote -v

  7. 로컬 리포지토리의 변경 내용을 GitHub에 푸시하려면 다음 명령을 실행하세요.

    git push origin main

    사용자의 기본 분기 이름이 "main"이 아닌 경우 "main"을 사용자의 기본 분기 이름으로 바꿉니다. 자세한 내용은 분기 정보을(를) 참조하세요.

  1. GitHub에 새 리포지토리를 만듭니다. 오류를 방지하려면 새 리포지토리를 ‘추가 정보’, 라이선스 또는 gitignore 파일로 초기화하지 마세요. 프로젝트가 GitHub에 푸시된 후 이러한 파일을 추가할 수 있습니다. 자세한 내용은 "새 리포지토리 만들기" 항목을 참조하세요.

  2. GitHub의 빠른 설정 페이지에서 리포지토리 상단에 있는 아이콘을 클릭하여 원격 리포지토리 URL을 복사합니다.

    리포지토리의 "빠른 설정" 헤더 스크린샷. 원격 URL 옆에는 두 개의 겹치는 사각형 아이콘이 주황색 윤곽선으로 강조 표시됩니다.

  3. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  4. 현재 작업 디렉터리를 로컬 프로젝트로 변경합니다.

  5. 로컬 리포지토리가 푸시될 원격 리포지토리의 URL을 추가하려면 다음 명령을 실행하세요. GitHub에서 REMOTE-URL을(를) 리포지토리의 전체 URL로 바꿉다.

    git remote add origin REMOTE-URL

    자세한 내용은 원격 리포지토리 관리을(를) 참조하세요.

  6. 원격 URL을 올바르게 설정했는지 확인하려면 다음 명령을 실행하세요.

    git remote -v

  7. 로컬 리포지토리의 변경 내용을 GitHub에 푸시하려면 다음 명령을 실행하세요.

    git push origin main

    사용자의 기본 분기 이름이 "main"이 아닌 경우 "main"을 사용자의 기본 분기 이름으로 바꿉니다. 자세한 내용은 분기 정보을(를) 참조하세요.

추가 참고 자료