Skip to main content

리포지토리에 대한 codespace 만들기

리포지토리의 분기에 대한 Codespace를 만들어 온라인으로 개발할 수 있습니다.

리포지토리에 대한 codespace 만들기 정보

GitHub.com이나 Visual Studio Code에서 또는 GitHub CLI를 사용하여 codespace를 만들 수 있습니다. 이 문서의 탭을 사용하여 codespace를 만드는 각 방법에 대한 지침을 표시합니다.

새 프로젝트를 시작하는 경우 템플릿에서 codespace를 만들고 나중에 GitHub Enterprise Cloud의 리포지토리에 게시할 수 있습니다. 자세한 내용은 "템플릿에서 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 만들기

  1. GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 "분기" 드롭다운 메뉴를 사용하고 codespace를 만들려는 분기를 선택합니다.

    분기 드롭다운 메뉴

  3. 코드 단추를 클릭한 다음 Codespaces 탭을 클릭합니다.

    새 codespace 단추

    이 리포지토리에 대한 codespace를 조직 또는 해당 부모 엔터프라이즈에 청구할 수 있는 경우 codespace에 대한 비용을 지불할 사람을 알려주는 메시지가 BRANCH의 codespace 만들기 단추 아래에 표시됩니다.

  4. 기본 옵션을 사용하거나 고급 옵션을 구성한 후 codespace를 만듭니다.

    • 기본 옵션 사용

      기본 옵션을 사용하여 codespace를 만들려면 더하기 기호()를 클릭합니다. 또는 현재 이 리포지토리에 대한 codespace가 없는 경우 BRANCH에서 codespace 만들기를 클릭할 수 있습니다.

    • 옵션 구성

      다른 머신 유형 또는 특정 devcontainer.json 파일과 같은 codespace에 대한 고급 옵션을 구성하려면 다음을 수행합니다.

      1. Codespaces 탭의 오른쪽 위에 있는 줄임표(...)를 클릭하고 옵션을 사용하여 새로 만들기를 선택합니다.

        기본 머신 유형 보기

      2. codespace에 대한 옵션 페이지의 드롭다운 메뉴에서 원하는 옵션을 선택합니다.

        codespace 옵션 페이지

        참고 사항

        • 옵션 페이지에 책갈피를 지정하여 이 리포지토리 및 분기에 대한 codespace를 빠르게 만들 수 있습니다.
        • https://github.com/codespaces/new 페이지에서는 모든 리포지토리 및 분기에 대한 codespace를 빠르게 생성할 수 있습니다. 브라우저의 주소 표시줄에 codespace.new를 입력하면 이 페이지로 빠르게 이동할 수 있습니다.
        • devcontainer.json 파일에 대한 자세한 내용은 “개발 컨테이너 소개”를 참조하세요.
        • 머신 유형에 대한 자세한 내용은 “codespace에 대한 머신 유형 변경”을 참조하세요.
        • 사용 가능한 컴퓨터 유형의 선택은 여러 가지 요인에 의해 제한될 수 있습니다. 여기에는 조직에 대해 구성된 정책 또는 리포지토리에 대한 최소 컴퓨터 유형 사양이 포함될 수 있습니다. 자세한 내용은 “컴퓨터 유형에 대한 액세스 제한” 및 “codespace 컴퓨터에 대한 최소 사양 설정”을 참조하세요.
      3. codespace 만들기를 클릭합니다.

GitHub.com의 계정을 GitHub Codespaces 확장에 연결한 후 새 codespace를 만들 수 있습니다. GitHub Codespaces 확장에 대한 자세한 내용은 VS Code Marketplace를 참조하세요.

  1. VS Code의 왼쪽 사이드바에서 원격 탐색기 아이콘을 클릭합니다.

    Visual Studio Code의 원격 탐색기 아이콘

    참고: 원격 탐색기가 작업 표시줄에 표시되지 않는 경우:

    1. 명령 팔레트에 액세스합니다. 예를 들어 Shift+명령+P (Mac) / Ctrl+Shift+P (Windows/Linux)를 누릅니다.
    2. 다음을 입력합니다. codespaces
    3. Codespaces: Details를 클릭합니다.
  2. 추가 아이콘()을 클릭합니다.

    GitHub Codespaces에서 새 Codespace 만들기 옵션

  3. 개발하려는 리포지토리의 이름을 입력한 다음 선택합니다.

    리포지토리를 검색하여 새 codespace 만들기

    선택한 리포지토리가 조직 소유이고 조직에서 이 리포지토리에 대한 codespace를 조직 또는 해당 부모 엔터프라이즈에 청구하도록 구성한 경우 후속 프롬프트에 codespace에 대한 비용을 지불할 사람을 알려주는 메시지가 표시됩니다.

  4. 개발하려는 분기를 클릭합니다.

    분기를 검색하여 새 codespace 만들기

  5. 개발 컨테이너 구성 파일을 선택하라는 메시지가 표시되면 목록에서 파일을 선택합니다.

    GitHub Codespaces에 대한 개발 컨테이너 구성 파일 선택

  6. 사용할 머신 유형을 클릭합니다.

    새 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을 사용 가능한 머신 유형의 유효한 식별자로 바꿉니다. 식별자는 basicLinux32gbstandardLinux32gb와 같은 문자열입니다. 사용 가능한 머신 유형은 리포지토리, 개인 계정, 위치에 따라 다릅니다. 잘못되었거나 사용할 수 없는 머신 유형을 입력하면 오류 메시지에 사용 가능한 유형이 표시됩니다. 이 플래그를 생략했으며 둘 이상의 머신 유형을 사용할 수 있는 경우 목록에서 하나를 선택하라는 메시지가 표시됩니다.

이 명령의 옵션에 대한 자세한 내용은 GitHub CLI 설명서를 참조하세요.

추가 참고 자료