리포지토리에 대한 codespace 만들기 정보
GitHub.com이나 Visual Studio Code에서 또는 GitHub CLI를 사용하여 codespace를 만들 수 있습니다. 이 문서의 탭을 사용하여 codespace를 만드는 각 방법에 대한 지침을 표시합니다.
새 프로젝트를 시작하는 경우 템플릿에서 codespace를 만들고 나중에 GitHub의 리포지토리에 게시할 수 있습니다. 자세한 내용은 "템플릿에서 codespace 만들기"를 참조하세요.
참고: JetBrains IDE를 사용하는 경우 GitHub CLI를 사용하여 codespace를 만들 수 있습니다. 그런 다음 JetBrains 게이트웨이 애플리케이션을 사용하여 JetBrains IDE에서 codespace를 열 수 있습니다. 자세한 내용은 "JetBrains IDE에서 Codespaces 사용"을 참조하세요.
개인 GitHub.com 계정에서 GitHub Codespaces을(를) 사용할 수 있으며, 무료 및 Pro 요금제의 계정에 대해 매월 무료 사용 할당량이 포함됩니다. 결제 세부 정보를 제공하고 지출 한도를 설정하여 월별 포함된 스토리지 및 컴퓨팅 사용량을 초과하여 GitHub Codespaces을(를) 계속 사용할 수 있습니다. 자세한 내용은 “GitHub Codespaces 청구 정보”를 참조하세요.
조직은 구성원과 외부 협력자가 조직의 비용으로 codespace를 만들고 사용할 수 있도록 할 수 있습니다. 자세한 내용은 “조직에 GitHub Codespaces 사용”을 참조하세요.
직접 만든 각 codespace는 자신만 사용할 수 있습니다. 그 외에는 다른 누구도 codespace에서 작업할 수 없습니다.
리포지토리에서 codespace를 만드는 경우 codespace는 비어 있을 수 없는 특정 분기와 연결됩니다. 리포지토리 또는 분기당 둘 이상의 codespace를 만들 수 있습니다.
github.com/codespaces에서 자신이 만든 사용 가능한 모든 codespace를 볼 수 있습니다.
codespace 만들기 프로세스
codespace를 만드는 경우 개발 환경을 만들고 연결하기 위해 여러 단계가 수행됩니다.
- 1단계: VM 및 스토리지가 codespace에 할당됩니다.
- 2단계: 컨테이너가 생성되고 리포지토리가 복제됩니다.
- 3단계: codespace에 연결할 수 있습니다.
- 4단계: codespace에서 생성 후 설정을 계속합니다.
codespace를 만들 때 수행되는 작업에 대한 자세한 내용은 “심층 분석”을 참조하세요.
codespace의 수명 주기에 대한 자세한 내용은 "codespace 수명 주기"를 참조하세요.
codespace에 Git 후크를 사용하려면 수명 주기 스크립트(예: postCreateCommand
)를 사용하여 devcontainer.json
후크를 설정해야 합니다. 이러한 항목은 위의 4단계에서 실행됩니다. 수명 주기 스크립트에 대한 자세한 내용은 개발 컨테이너 웹 사이트의 개발 컨테이너 사양 을 참조하세요. 리포지토리가 복제된 후 codespace 컨테이너가 생성되므로 컨테이너 이미지에서 구성된 git 템플릿 디렉터리는 codespace에 적용되지 않습니다. 대신, codespace가 생성된 후 후크를 설치해야 합니다.
VS Code를 사용하여 codespace에서 개발하는 동안 코드를 편집하고, 디버그하고, Git 명령을 사용할 수 있습니다. 자세한 내용은 VS Code 설명서를 참조하세요.
codespace 만들기 속도를 높이기 위해 리포지토리 관리자는 리포지토리에 대해 GitHub Codespaces 사전 빌드를 사용하도록 설정할 수 있습니다. 자세한 내용은 “GitHub Codespaces 사전 빌드 정보”를 참조하세요.
리포지토리에 대한 codespace 만들기
-
GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.
-
리포지토리 이름 아래에서 "분기" 드롭다운 메뉴를 사용하고 codespace를 만들려는 분기를 선택합니다.
-
코드 단추를 클릭한 다음 Codespaces 탭을 클릭합니다.
이 리포지토리에 대한 codespace를 조직 또는 해당 부모 엔터프라이즈에 청구할 수 있는 경우 codespace에 대한 비용을 지불할 사람을 알려주는 메시지가 BRANCH의 codespace 만들기 단추 아래에 표시됩니다.
-
기본 옵션을 사용하거나 고급 옵션을 구성한 후 codespace를 만듭니다.
-
기본 옵션 사용
기본 옵션을 사용하여 codespace를 만들려면 더하기 기호()를 클릭합니다. 또는 현재 이 리포지토리에 대한 codespace가 없는 경우 BRANCH에서 codespace 만들기를 클릭할 수 있습니다.
-
옵션 구성
다른 머신 유형 또는 특정
devcontainer.json
파일과 같은 codespace에 대한 고급 옵션을 구성하려면 다음을 수행합니다.-
Codespaces 탭의 오른쪽 위에 있는 줄임표(...)를 클릭하고 옵션을 사용하여 새로 만들기를 선택합니다.
-
codespace에 대한 옵션 페이지의 드롭다운 메뉴에서 원하는 옵션을 선택합니다.
참고 사항
- 옵션 페이지에 책갈피를 지정하여 이 리포지토리 및 분기에 대한 codespace를 빠르게 만들 수 있습니다.
- https://github.com/codespaces/new 페이지에서는 모든 리포지토리 및 분기에 대한 codespace를 빠르게 생성할 수 있습니다. 브라우저의 주소 표시줄에
codespace.new
를 입력하면 이 페이지로 빠르게 이동할 수 있습니다. devcontainer.json
파일에 대한 자세한 내용은 “개발 컨테이너 소개”를 참조하세요.- 머신 유형에 대한 자세한 내용은 “codespace에 대한 머신 유형 변경”을 참조하세요.
- 사용 가능한 컴퓨터 유형 선택은 여러 가지 요인으로 제한될 수 있습니다. 여기에는 조직에 대해 구성된 정책 또는 리포지토리에 대한 최소 컴퓨터 유형 사양이 포함될 수 있습니다. 자세한 내용은 “컴퓨터 유형에 대한 액세스 제한” 및 “codespace 컴퓨터에 대한 최소 사양 설정”을 참조하세요.
-
codespace 만들기를 클릭합니다.
-
-
GitHub.com의 계정을 GitHub Codespaces 확장에 연결한 후 새 codespace를 만들 수 있습니다. GitHub Codespaces 확장에 대한 자세한 내용은 VS Code Marketplace를 참조하세요.
-
VS Code의 왼쪽 사이드바에서 원격 탐색기 아이콘을 클릭합니다.
참고: 원격 탐색기가 작업 표시줄에 표시되지 않는 경우:
- 명령 팔레트에 액세스합니다. 예를 들어 Shift+명령+P (Mac) / Ctrl+Shift+P (Windows/Linux)를 누릅니다.
- 다음을 입력합니다.
codespaces
- Codespaces: Details를 클릭합니다.
-
추가 아이콘()을 클릭합니다.
-
개발하려는 리포지토리의 이름을 입력한 다음 선택합니다.
선택한 리포지토리가 조직 소유이고 조직에서 이 리포지토리에 대한 codespace를 조직 또는 해당 부모 엔터프라이즈에 청구하도록 구성한 경우 후속 프롬프트에 codespace 비용을 지불할 사용자를 알려주는 메시지가 표시됩니다.
-
개발하려는 분기를 클릭합니다.
-
개발 컨테이너 구성 파일을 선택하라는 메시지가 표시되면 목록에서 파일을 선택합니다.
-
사용할 머신 유형을 클릭합니다.
참고: 사용 가능한 컴퓨터 유형 선택은 여러 가지 요인으로 제한될 수 있습니다. 여기에는 조직에 대해 구성된 정책 또는 리포지토리에 대한 최소 컴퓨터 유형 사양이 포함될 수 있습니다. 자세한 내용은 “컴퓨터 유형에 대한 액세스 제한” 및 “codespace 컴퓨터에 대한 최소 사양 설정”을 참조하세요.
GitHub CLI에 대한 자세한 내용은 “GitHub CLI 정보”를 참조하세요.
새 codespace를 만들려면 gh codespace create
하위 명령을 사용합니다.
gh codespace create
리포지토리를 선택하라는 메시지가 표시됩니다. 이 리포지토리에 대한 codespace가 조직 또는 해당 부모 엔터프라이즈에 청구될 수 있는 경우 codespace에 대한 비용을 누가 지불할 것인지 알려주는 메시지가 표시됩니다. 그런 다음 분기, 개발 컨테이너 구성 파일(둘 이상의 사용 가능한 경우) 및 컴퓨터 유형(둘 이상의 사용 가능한 경우)을 선택하라는 메시지가 표시됩니다.
또는 플래그를 사용하여 다음 옵션을 일부 또는 모두 지정할 수 있습니다.
gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE
이 예에서는 owner/repo
를 리포지토리 식별자로 바꿉니다. branch
를 codespace에서 초기에 체크 아웃할 분기 이름 또는 커밋의 전체 SHA 해시로 바꿉니다. b
플래그 없이 -r
플래그를 사용하면 기본 분기에서 codespace가 생성됩니다.
path
을(를) 새 코드스페이스에 사용할 개발 컨테이너 구성 파일의 경로로 바꿉니다. 이 플래그를 생략했으며 둘 이상의 개발 컨테이너 파일을 사용할 수 있는 경우 목록에서 하나를 선택하라는 메시지가 표시됩니다. 개발 컨테이너 구성 파일에 대한 자세한 내용은 “개발 컨테이너 소개”를 참조하세요.
machine-type
을 사용 가능한 머신 유형의 유효한 식별자로 바꿉니다. 식별자는 basicLinux32gb
및 standardLinux32gb
와 같은 문자열입니다. 사용 가능한 머신 유형은 리포지토리, 개인 계정, 위치에 따라 다릅니다. 잘못되었거나 사용할 수 없는 머신 유형을 입력하면 오류 메시지에 사용 가능한 유형이 표시됩니다. 이 플래그를 생략했으며 둘 이상의 머신 유형을 사용할 수 있는 경우 목록에서 하나를 선택하라는 메시지가 표시됩니다.
이 명령의 옵션에 대한 자세한 내용은 GitHub CLI 설명서를 참조하세요.