Git 리포지토리 설정Set up a Git repository

Git은 모든 팀원이 동일한 문서를 동시에 작업할 수 있는 분산형 버전 제어 시스템입니다.Git is a distributed version control system that allows teams to work on the same documents simultaneously. 즉, 모든 파일을 포함하는 단일 서버가 있더라도 이 중앙 소스에서 리포지토리를 체크 아웃할 때마다 리포지토리 전체가 로컬 컴퓨터에 복제됩니다.This means there is a single server that contains all the files, but whenever a repository is checked out from this central source, the entire repository is cloned locally to your machine.

Git을 사용한 버전 제어를 제공하는 원격 호스트는 많지만 가장 일반적인 호스트는 GitHub입니다.There are many remote hosts that allow you to work with Git for version control, however the most common host is GitHub. 다음 예제에서는 GitHub 호스트를 사용하지만, Mac용 Visual Studio에서 어떤 Git 호스트를 사용해도 버전 제어를 수행할 수 있습니다.The following example uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac.

GitHub를 사용하려면 계정을 만들고 구성한 다음, 이 문서의 단계를 수행하세요.If you wish to use GitHub, make sure that you have an account created and configured before following the steps in this article.

GitHub에서 원격 리포지토리 만들기Creating a remote repo on GitHub

다음 예제에서는 GitHub 호스트를 사용하지만, Mac용 Visual Studio에서 어떤 Git 호스트를 사용해도 버전 제어를 수행할 수 있습니다.The following example uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac.

Git 리포지토리를 설정하려면 다음 단계를 수행하세요.To set up a Git repository, execute the following steps:

  1. github.com에서 새 Git 리포지토리를 만듭니다.Create a new Git repo at github.com:

    새 Git 리포지토리 만들기

  2. 리포지토리 이름, 설명, 개인 정보 보호를 설정합니다.Set Repo Name, description, and privacy. 리포지토리를 초기화하지 마세요.Do not initialize Repo. .gitignore 및 라이선스를 [없음]으로 설정합니다.Set .gitignore and license to None:

    Git 리포지토리 세부 사항 설정

  3. 다음 페이지에서는 직접 만든 리포지토리에 대한 HTTPS 또는 SSH 주소를 표시하고 복사하는 옵션을 제공합니다.The next page gives you an option to display and copy either the HTTPS or SSH address to the repo you have created:

    주소 보기 및 복사

    Mac용 Visual Studio에서 이 리포지토리를 가리키려면 HTTPS 주소가 필요합니다.You'll need the HTTPS address to point Visual Studio for Mac to this repo.

기존 프로젝트 게시Publishing an existing project

기존 프로젝트가 버전 제어에 아직 존재하지 않는 경우 다음 단계를 사용해 Git에서 이를 설정합니다.If you have an existing project that is not already in version control, use the following steps to set it up in Git:

.gitignore 파일을 사용하여 Git으로 추적하고 게시하는 폴더 및 파일을 제어합니다.Use a .gitignore file to control which folders and files are tracked and published with Git. 빌드 디렉터리, 이진 파일 또는 생성된 파일은 제외할 수 있습니다.You may want to exclude build directories, binaries, or generated files. GitHub docs on ignoring files(파일 무시에 대한 GitHub 문서)에서 자세히 알아보세요.Learn more in the GitHub docs on ignoring files.

  1. Mac용 Visual Studio의 솔루션 창에서 솔루션 이름을 선택합니다.Select the Solution name from the Solution Window in Visual Studio for Mac.

  2. 메뉴 모음에서 버전 제어 > 버전 제어에서 게시 를 선택하여 리포지토리 복제 대화 상자를 표시합니다.In the Menu bar, select Version Control > Publish in Version Control to display the Clone Repository dialog:

    Mac용 Visual Studio에서 체크 아웃 시작

    이 메뉴 항목이 메뉴에 표시되지 않으면 솔루션 이름을 선택했는지 확인합니다.If this menu item appears greyed out in the menu, make sure you have selected the Solution name.

  3. 등록된 항목에서 선택 탭을 선택하고 추가 단추를 누릅니다.Choose the Select from Registered tab and press the Add button:

    등록된 리포지토리 대화 상자를 추가합니다.

  4. 로컬에 표시하고 싶은 리포지토리 이름을 입력하고 3단계에서 복사한 URL을 붙여넣습니다.Enter the name of the repository as you would like it to display locally, and paste in the URL from step #3. [리포지토리 구성] 대화 상자가 다음과 같이 표시됩니다.Your Repository Configuration dialog should look similar to the following. [확인]을 누릅니다.Press OK:

    Git 세부 사항 입력 대화 상자

    SSH를 사용하여 Git에 연결할 수도 있습니다.It is also possible to use SSH to connect to Git.

  5. Git에 앱을 게시하려면 리포지토리를 선택하고 모듈 이름메시지 텍스트 필드가 둘 다 입력되었는지 확인합니다.To attempt to publish the app to Git, select the repository, and ensure that both Module Name and Message text fields are completed:

    Git에 프로젝트 게시

  6. 확인 을 클릭한 다음 경고 대화 상자에서 게시 를 클릭합니다.Click Okay, and then Publish from the alert dialog.

  7. Git 자격 증명 창에 GitHub 사용자 이름 및 암호를 입력합니다.In the Git Credentials window, enter your GitHub username and password.

참고

계정에 2단계 인증(2FA)이 사용 설정된 경우 암호 대신 사용되는 액세스 토큰을 만들어야 합니다.If your account has two-factor authentication (2FA) enabled, you will need to create an Access Token, which is used in place of a password. 액세스 토큰을 만들지 않은 경우에는 Git 액세스 토큰 설명서의 단계를 따르세요.If you have not created an access token, follow the steps in the Git Access Token documentation.

  1. 사용자 이름과 개인용 액세스 토큰을 입력하고 확인 을 누릅니다.Enter the username and Personal Access Token, and press Okay:

    Git에 대한 사용자 이름 및 암호 입력

  2. 몇 초 후에 솔루션이 초기 커밋과 함께 게시됩니다.After a few seconds, the Solution should be published with its initial commit. [버전 제어] 메뉴 항목을 찾아 게시되었는지 확인합니다. 이제 [버전 제어] 메뉴 항목이 다음과 같이 다양한 옵션으로 채워져 있어야 합니다.Confirm it has been published by browsing the Version Control menu item, which should now be populated with many options:

    버전 제어 메뉴

  3. 추가 변경을 시작하면 먼저 버전 제어 > 검토 및 커밋 메뉴를 사용하여 상태 보기를 엽니다.Once you start to make additional changes, first use the Version Control > Review and Commit menu to open status view. 변경 내용을 선택하여 커밋한 후 푸시 를 선택하여 변경 내용을 원격 리포지토리로 푸시합니다.After you've selected and committed changes, select Push to push the changes to the remote repository. 이렇게 하면 github.com에서 해당하는 모든 사용자가 변경 사항을 볼 수 있습니다.This will allow all appropriate users to view it on github.com:

    원격 리포지토리에 변경 사항 푸시

새 프로젝트 게시Publishing a new project

새 프로젝트 대화 상자를 사용하여 로컬 git 리포지토리로 새 프로젝트를 만들 수 있습니다.The new project dialog can be used to create a new project with a local git repository. 활성화하려면 다음 스크린샷에 표시된 대로 버전 제어에 git 사용 확인란을 선택합니다.To enable it, select the Use git for version control checkbox, as illustrated in the following screenshot. 이렇게 하면 리포지토리가 초기화되고 선택적 .gitignore 파일이 추가됩니다.This will initialize your repo and add an optional .gitignore file:

git 지원으로 새 프로젝트 만들기

새 GitHub 리포지토리로 새 로컬 리포지토리를 푸시하려면 다음 단계를 수행합니다.Follow the steps below to push your new local repository to a new GitHub repository:

참고

GitHub 리포지토리를 아직 만들지 않은 경우 GitHub에서 원격 리포지토리 만들기 섹션을 참조하세요.If you have not already created a GitHub repository, refer to the Creating a remote repo on GitHub section.

  1. 메뉴 모음에서 버전 제어 > 검토 및 커밋 으로 이동하여 첫 번째 커밋을 만듭니다.Create your first commit by going to Version Control > Review and Commit in the Menu Bar.

  2. 상태 탭에서 왼쪽 상단에 있는 커밋 을 선택합니다.In the Status tab, choose Commit in the top left.

  3. 커밋 메시지(예: "첫 번째" 커밋)를 작성한 다음, 커밋 을 클릭합니다.Write a commit message, for example "First Commit", then click on Commit:

    git 리포지토리에 초기 변경 사항 커밋

  4. 그런 다음, 메뉴 모음에서 버전 제어 > 분기 및 원격 관리 로 이동합니다.Next, in the Menu Bar go to Version Control > Manage Branches and Remotes.

  5. 원격 원본 탭으로 이동한 다음, 추가 를 클릭합니다.Go to the Remote Sources tab, then click Add.

  6. 원격 원본 창에서 이전에 만든 GitHub 리포지토리의 세부 정보를 추가하고 확인 을 클릭합니다.In the Remote Source window, add the details of your previously created GitHub repository and click OK:

    git 리포지토리용 원격 원본 구성

  7. Git 리포지토리 구성 창을 닫은 다음, 메뉴 모음에서 버전 제어 > 변경 내용 푸시 로 이동합니다.Close the Git Repository Configuration window, then in the Menu Bar go to Version Control > Push Changes.

  8. 리포지토리에 푸시 창에서 변경 내용 푸시 단추를 클릭합니다.In the Push to Repository window click on the Push Changes button:

    원격 리포지토리에 변경 내용 푸시

  9. 메시지가 표시되면 GitHub 사용자 이름과 암호를 입력합니다.When prompted, enter your GitHub username and password.

참고

계정에 2단계 인증(2FA)이 사용 설정된 경우 암호 대신 사용되는 액세스 토큰을 만들어야 합니다.If your account has two-factor authentication (2FA) enabled, you will need to create an Access Token, which is used in place of a password. 액세스 토큰을 만들지 않은 경우에는 Git 액세스 토큰 설명서의 단계를 따르세요.If you have not created an access token, follow the steps in the Git Access Token documentation.

Mac용 visual Studio는 이제 원격 GitHub 리포지토리에 변경 내용을 푸시합니다.Visual Studio for Mac will now push the changes to your remote GitHub repository:

푸시 작업이 성공적으로 완료되었습니다.

기존 리포지토리 복제Clone an existing repository

로컬 머신에는 없고 원격에만 존재하는 GitHub 리포지토리로 작업해야 하는 경우가 있습니다.It's likely that you'll have to work with a GitHub repo that exists only on the remote, not on your local machine. Mac용 Visual Studio를 사용하면 이 리포지토리를 신속하게 복제할 수 있습니다.Visual Studio for Mac allows you to clone this repo quickly. 다음 단계를 수행하여 컴퓨터로 복제합니다.Follow the steps below to clone it to your machine:

  1. 메뉴 모음에서 버전 제어 > 리포지토리 복제 를 선택합니다.In the Menu bar, select Version Control > Clone Repository:

  2. URL에 연결 탭이 표시됩니다.This displays the Connect with Url tab:

    세부 정보가 입력된 URL에 연결 탭

  3. 원격 리포지토리의 GitHub 페이지에서 복제 또는 다운로드 단추를 누르고 제공된 URL을 복사합니다.On the GitHub page of the remote repository, press the Clone or Download button and copy the URL provided:

    표시된 GitHub URL

  4. URL에 연결 탭에서 URL 입력 필드의 모든 텍스트를 바꿉니다. 그러면 2단계의 이미지에 나와 있는 것처럼 이 탭의 다른 대부분의 필드가 사용자에 맞게 채워집니다.Replace all the text in the URL entry field in the Connect with Url tab. This will populate most other fields in this tab for you, as illustrated in the image in step #2.

  5. 리포지토리를 복제할 디렉터리를 입력하고 복제 를 누릅니다.Enter the directory that you want to clone the repo into and press Clone.

참고

리포지토리 크기가 4GB 이상인 경우 문제가 발생할 수 있습니다.You may experience issues if the repo is over 4 GB in size.

문제 해결Troubleshooting

빈 원격 리포지토리로 프로젝트를 초기화하는 데 문제가 있을 경우 다음 단계를 시도하세요.If you have issues with initializing your project with an empty remote repository, you can try the following steps:

  1. 솔루션 폴더로 이동합니다.Go to your solution folder.
  2. Command + Shift + . 키를 눌러Press Command + Shift + . 숨겨진 파일과 폴더를 표시합니다.to show the hidden files and folders.
  3. .git 폴더가 있으면 삭제합니다.If there's a .git folder, delete it.
  4. gitignore 파일이 있으면 삭제합니다.If there's a gitignore file, delete it.
  5. Command + Shift + . 키를 눌러Press Command + Shift + . 파일과 폴더를 숨깁니다.to hide the files and folders.
  6. 솔루션을 Mac용 VS에서 엽니다.Open your solution in VS for Mac.
  7. 솔루션 창에서 솔루션 노드를 선택합니다.On the solution Window, select your solution node.
  8. [버전 제어] 메뉴를 찾아 버전 제어에서 게시 를 선택합니다.Browse to the Version Control menu and choose Publish in Version Control.
  9. 위의 연습 단계를 6단계부터 따라 수행합니다.Follow the steps of the above tutorial starting from the step 6.

참조See also