Note
GitHub Codespaces는 octocorp.ghe.com
과 같은 GHE.com의 하위 도메인에서는 사용할 수 없습니다.
GitHub Codespaces 템플릿에 대한 정보
새 프로젝트를 시작하는 경우 템플릿에서 codespace를 만들어 개발 작업을 빠르게 시작할 수 있습니다. 클라우드 기반 개발 환경에서 프로젝트를 작업하고, 파일을 클라우드에 저장하고, 다른 사용자와 공유하거나 로컬 컴퓨터에 복제할 수 있는 새 원격 리포지토리에 작업을 게시할 수 있습니다.
빈 템플릿에서 시작하거나, React 또는 Jupyter Notebook과 같은 인기 있는 기술에 대해 GitHub이(가) 제공하는 템플릿을 선택하거나, GitHub의 템플릿 리포지토리에서 codespace를 시작할 수 있습니다.
참고: 관리형 사용자 계정이(가) 있는 경우 조직이나 기업에서 소유하고 지불한 codespace만 만들 수 있기 때문에 GitHub의 공용 템플릿을 GitHub Codespaces에 사용할 수 없습니다. 자세한 내용은 "Enterprise Managed Users 정보"을(를) 참조하세요.
빈 템플릿을 사용하면 클라우드 기반 컴퓨팅 리소스 및 기본 dev 컨테이너 이미지와 함께 미리 설치된 도구, 언어 및 런타임 환경에 액세스할 수 있는 빈 디렉터리로 시작합니다. 다른 템플릿을 사용하면 작업 중인 기술에 대한 시작 파일과 일반적으로 일부 사용자 지정 환경 구성이 포함된 추가 정보 파일, .gitignore
파일 및 개발 컨테이너 구성 파일과 같은 추가 파일을 얻을 수 있습니다. 개발 컨테이너 및 기본 이미지에 대한 자세한 내용은 "개발 컨테이너 소개"을(를) 참조하세요.
예를 들어 GitHub의 React 템플릿에서 codespace를 만드는 경우 작업 영역에 간단한 응용 프로그램에 대한 템플릿 파일(예: index.js
, app.js
및package.json
)이 포함됩니다. Codespace가 열린 직후 개발 서버가 자동으로 시작되고 VS Code 웹 클라이언트의 간단한 브라우저 탭에서 실행 중인 응용 프로그램을 볼 수 있습니다.
템플릿에 포함된 파일 및 구성은 템플릿 리포지토리에 정의됩니다. Codespace를 만들면 템플릿 리포지토리가 codespace에 복제됩니다. 그 후에는 링크가 끊기고 게시할 때까지 codespace가 원격 리포지토리에 연결되지 않습니다.
팁: 다른 사용자가 프레임워크, 라이브러리 또는 기타 프로젝트를 사용하기 시작할 수 있도록 GitHub Codespaces에 사용할 템플릿 리포지토리를 설정할 수 있습니다. 자세한 내용은 "GitHub Codespaces에 대한 템플릿 리포지토리 설정" 항목을 참조하세요.
GitHub 템플릿에서 codespace 만들기
빈 템플릿을 포함하여 GitHub에 의해 관리되는 템플릿을 "나의 codespace" 페이지에서 사용할 수 있습니다.
-
GitHub의 왼쪽 위 모서리에서 을(를) 선택하고 Codespaces를 클릭한 다음 github.com/codespaces "내 codespace" 페이지로 이동합니다.
-
템플릿의 전체 목록을 보려면 "빠른 시작 템플릿 탐색" 섹션에서 모두 보기를 클릭합니다.
-
필요에 따라 템플릿의 파일이 포함된 템플릿 리포지토리를 보려면 템플릿의 이름을 클릭합니다.
-
시작하려는 템플릿의 이름 아래에서 이 템플릿 사용을 클릭합니다.
템플릿에서 새 codespace를 만들 때 항상 Visual Studio Code 웹 클라이언트에서 열립니다. 지원되는 모든 편집기에서 기존 codespace를 다시 열 수 있습니다. 자세한 내용은 "기존 Codespace 열기"을(를) 참조하세요.
템플릿 리포지토리에서 codespace 만들기
템플릿 리포지토리에서 codespace를 만든 다음, 준비가 되면 새 리포지토리에 작업을 게시할 수 있습니다. 템플릿 리포지토리에 대한 자세한 내용은 "템플릿에서 리포지토리 만들기"을(를) 참조하세요.
-
GitHub에서 리포지토리의 기본 페이지로 이동합니다.
-
이 템플릿 사용을 클릭한 다음, codespace에서 열기를 클릭합니다.
참고: 템플릿 리포지토리의 유지 관리자이고 템플릿 리포지토리 자체에 변경 내용을 커밋하려는 경우 코드 드롭다운에서 codespace를 만들어야 합니다. 자세한 내용은 "리포지토리에 대한 codespace 만들기"을(를) 참조하세요.
템플릿에서 새 codespace를 만들 때 항상 Visual Studio Code 웹 클라이언트에서 열립니다. 지원되는 모든 편집기에서 기존 codespace를 다시 열 수 있습니다. 자세한 내용은 "기존 Codespace 열기"을(를) 참조하세요.
GitHub Enterprise Cloud에서 리포지토리에 게시
템플릿에서 만든 코드스페이스에서 작업하는 경우 작업은 클라우드의 가상 머신에 저장되지만 GitHub의 리포지토리에 저장되지 않습니다.
파일을 저장하고, codespace를 닫고 중지하고, 나중에 작업으로 돌아갈 수 있습니다. 일반적으로 Git은 미리 설치되며 작업 디렉터리는 GitHub의 빈 템플릿에서 시작하지 않는 한 Git 리포지토리로 자동 초기화됩니다. 즉, 파일 추가 및 커밋과 같은 로컬 원본 제어에 Git을 즉시 사용할 수 있습니다.
그러나 게시되지 않은 codespace를 삭제하거나 보존 기간 동안 사용되지 않은 상태로 유지되어 자동으로 삭제되는 경우, 작업도 삭제됩니다. 작업을 지속하고 다른 사용자가 프로젝트에서 작업할 수 있도록 하려면 GitHub의 리포지토리에 codespace를 게시해야 합니다.
참고: 게시되지 않은 codespace가 현재 조직에 청구되는 경우, codespace를 게시하면 codespace의 소유권 및 청구가 개인 계정으로 전송됩니다. "GitHub Codespaces 청구 관련 정보"을(를) 참조하세요.
VS Code에서 게시
codespace에서 작업하는 경우 VS Code 웹 클라이언트 또는 데스크톱 애플리케이션에서 게시할 수 있습니다.
-
작업 표시줄에서 Source Control(원본 제어) 보기를 클릭합니다.
-
변경 내용을 스테이징하려면 변경한 파일 옆 또는 여러 파일을 추가 또는 변경하고 모두 스테이징하려는 경우 Changes(변경 내용) 옆의 + 아이콘을 클릭합니다.
참고: GitHub의 빈 템플릿에서 시작하는 경우 디렉터리를 Git 리포지토리로 이미 초기화하지 않은 한 변경 내용 목록이 표시되지 않습니다. 빈 템플릿에서 만든 codespace를 게시하려면 "소스 제어" 보기에서 GitHub에 게시를 클릭한 다음 5단계로 건너뜁니다.
-
스테이징된 변경 사항을 커밋하려면 변경 내용을 설명하는 커밋 메시지를 입력한 다음 커밋을 클릭합니다.
-
분기 게시를 클릭합니다.
-
"리포지토리 이름" 드롭다운에서 새 리포지토리의 이름을 입력한 다음 GitHub 프라이빗 리포지토리에 게시를 선택하거나 GitHub 퍼블릭 리포지토리 게시를 선택합니다.
새 리포지토리의 소유자는 codespace를 만든 GitHub 계정이 됩니다.
-
필요에 따라 편집기의 오른쪽 아래 모서리에 나타나는 팝업에서 GitHub에서 열기를 클릭하여 GitHub에서 새 리포지토리를 봅니다.
Codespace가 게시되면 GitHub Codespaces 환경을 사용자 지정할 수 있는 다양한 옵션에 액세스할 수 있습니다. 이렇게 시작할 수 있는 작업의 예는 다음과 같습니다.
- Codespace의 머신 유형을 변경하여 수행 중인 작업에 적합한 리소스를 사용하도록 합니다("codespace에 대한 컴퓨터 유형 변경" 참조).
- GitHub에서 GPG를 자동으로 사용하여 codespace에서 만드는 커밋에 서명하도록 허용합니다("GitHub Codespaces 관련 GPG 확인 관리" 참조).
- Codespace와 비밀을 공유합니다("GitHub Codespaces에 대한 계정별 비밀 관리" 참조).
GitHub에서 게시
게시하지 않은 codespace는 GitHub의 "나의 codespace" 페이지에서 게시할 수 있습니다. 이 기능은 현재 브라우저에서 열려 있지 않은 codespace를 게시하려는 경우에 유용합니다. 이렇게 하면 작업이 리포지토리에 유지되지만 기존 codespace와 새 리포지토리가 연결되지 않습니다. 그러나 새 리포지토리로 이동하여 해당 위치에서 codespace를 만들 수 있으며, 이 codespace는 리포지토리에 연결됩니다.
-
GitHub의 왼쪽 위 모서리에서 을(를) 선택하고 Codespaces를 클릭한 다음 github.com/codespaces "내 codespace" 페이지로 이동합니다.
-
게시되지 않은 codespace 옆에 있는 줄임표(...)를 클릭한 다음 새 리포지토리에 게시를 선택합니다.
-
새 리포지토리의 이름을 선택하고, 공용 또는 개인용으로 설정한 다음, 리포지토리 만들기를 클릭합니다.
-
필요에 따라 새 리포지토리를 보려면 리포지토리 보기를 클릭합니다.