Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

GitHub Codespaces에 대한 템플릿 리포지토리 설정

GitHub Codespaces에 사용할 템플릿 리포지토리를 설정하여 사람들이 프로젝트를 시작할 수 있도록 도울 수 있습니다.

소개

템플릿 리포지토리를 설정하면 사용자가 GitHub Codespaces에서 프레임워크, 라이브러리 또는 기타 프로젝트를 시작할 수 있습니다. 사용자는 리포지토리를 복제하거나 도구 또는 기타 종속성을 설치하는 것에 대해 걱정할 필요 없이 클라우드 기반 개발 환경에서 즉시 템플릿 파일 작업을 시작할 수 있습니다. 일부 구성을 사용하면 편집을 위해 이미 열려 있는 중요한 파일이 있는 codespace에서 사용자를 설정할 수 있으며, VS Code 웹 편집기 내의 미리 보기 브라우저 탭에서 이미 실행 중인 애플리케이션을 사용할 수 있습니다.

템플릿 리포지토리에 대한 읽기 권한이 있는 사용자는 GitHub의 리포지토리 페이지에서 codespace를 만들 수 있습니다. 기존 리포지토리를 템플릿으로 전환할 수 있으며 사용자가 템플릿 리포지토리에서 codespace를 만들 수 있도록 설정을 변경할 필요가 없습니다. 리포지토리를 템플릿으로 전환하는 방법에 대한 자세한 내용은 "템플릿 리포지토리 만들기"을 참조하세요.

서식 파일의 "새 codespace 만들기" 페이지로 직접 사용자를 안내하는 형식 https://github.com/codespaces/new?template_repository=OWNER/TEMPLATE-REPO 의 링크를 제공할 수 있습니다.

"이 템플릿 사용" 단추가 있는 "기본 React 웹 사이트"라는 템플릿 리포지토리에 대한 "새 codespace 만들기" 페이지의 스크린샷

예를 들어 프레임워크를 시작하기 위한 자습서에서 이 링크를 제공할 수 있습니다. 링크에서 를 템플릿 리포지토리의 이름(예monalisa/octo-template: )으로 바꿉 OWNER/TEMPLATE-REPO 있습니다.

누군가가 템플릿에서 codespace를 만들면 템플릿 리포지토리의 내용이 해당 codespace에 복제됩니다. 사용자가 준비가 되면 개인 계정에 속한 GitHub의 새 리포지토리에 작업을 게시할 수 있습니다. codespace에 대한 모든 사용 요금은 codespace를 만든 사용자에게 청구됩니다. 자세한 내용은 "템플릿에서 codespace 만들기"을 참조하세요.

템플릿 설명

템플릿이 없는 경우 템플릿 리포지토리에 대한 추가 정보 만들기를 만들어 템플릿의 목적과 템플릿을 시작하는 방법을 설명합니다. 자세한 내용은 "추가 정보에 대한 정보"을 참조하세요.

사용자가 링크를 따를 때 표시되는 "새 codespace 만들기" 페이지에 템플릿에 대한 간단한 설명이 https://github.com/codespaces/new?template_repository=OWNER/TEMPLATE-REPO 표시됩니다. 이 설명은 리포지토리를 만들 때 설정할 수 있는 설명 필드에서 가져옵니다. 언제든지 리포지토리의 페이지로 이동하고 페이지 오른쪽의 정보 섹션 옆에 있는 클릭하여 언제든지 이 설명을 편집할 수 있습니다.

리포지토리 페이지의 "정보" 섹션 스크린샷 설정 단추(기어 기호)는 진한 주황색 윤곽선으로 강조 표시됩니다.

시작 파일 추가

템플릿 리포지토리에는 일반적으로 사용자가 라이브러리, 프레임워크 또는 기타 기술을 빠르게 시작할 수 있도록 상용구 코드가 포함된 시작 파일이 포함되어 있습니다.

포함할 파일 종류에 대한 지침은 다음과 같이 GitHub Codespaces에 대한 공식 GitHub 템플릿에 포함된 시작 파일을 확인할 수 있습니다.

  1. github.com/codespaces "사용자 codespaces" 페이지로 이동합니다. 1. 템플릿의 전체 목록을 보려면 "빠른 시작 템플릿 탐색" 섹션에서 모두 보기를 클릭합니다.

    "빠른 시작 템플릿 탐색" 섹션의 스크린샷. "모두 보기"는 진한 주황색 윤곽선으로 강조 표시됩니다.

  2. 템플릿에 대한 파일이 포함된 템플릿 리포지토리를 보려면 템플릿의 이름을 클릭합니다.

    codespaces 페이지의 "빠른 시작 템플릿 탐색" 섹션의 스크린샷 템플릿 이름은 주황색 윤곽선으로 강조 표시됩니다.

개발 컨테이너 구성

템플릿 리포지토리에 개발 컨테이너 구성 파일을 추가하여 GitHub Codespaces와 함께 템플릿을 사용하는 사용자를 위한 개발 환경을 사용자 지정할 수 있습니다. Visual Studio Code의 미리 정의된 구성 설정 목록에서 선택하거나 사용자 고유 devcontainer.json 의 파일을 작성하여 사용자 지정 구성을 만들 수 있습니다. 구성 파일을 추가하지 않으면 기본 컨테이너 이미지가 사용됩니다. 자세한 내용은 "개발 컨테이너 소개" 및 "리포지토리에 개발 컨테이너 구성 추가.

참고: 사용자가 템플릿 리포지토리에서 이 템플릿 사용 단추에서 codespace를 만들 때 구성 중에서 선택할 수 없습니다. codespace는 리포지토리의 루트 또는 에 .devcontainer/devcontainer.json``.devcontainer.json 정의된 기본 구성을 기반으로 빌드됩니다.

사용자에게 템플릿에 대한 최상의 환경을 제공하기 위해 도구 및 사용자 지정을 사용하여 개발 컨테이너를 구성해야 합니다. 예를 들어 파일에서 다음을 수행합니다 devcontainer.json .

  • 속성을 사용하여 openFiles 템플릿에서 codespace를 만들 때 VS Code 웹 클라이언트에서 자동으로 열 파일 목록을 정의할 수 있습니다.
  • 템플릿에 웹 애플리케이션에 대한 파일이 포함된 경우 애플리케이션이 사용자의 codespace에서 자동으로 실행되도록 할 수 있습니다. 이 작업을 수행하려면 속성을 사용하여 postAttachCommand VS Code 웹 클라이언트가 codespace에 연결하는 즉시 로컬 서버에서 애플리케이션을 시작하는 스크립트를 실행하고 포트의 openPreview 속성을 설정 onAutoForward 하여 VS Code 웹 클라이언트에 포함된 간단한 브라우저에서 해당 포트에서 실행되는 애플리케이션을 표시할 수 있습니다.

React 템플릿에 대한 다음 구성 설정은 사용자의 편집기에서 파일을 열고app.js, (파일에 정의됨package.json) 를 실행 npm start 하여 로컬 서버를 시작하고, codespace의 미리 보기 브라우저 탭으로 포트 3000 를 전달합니다.

{
    "postAttachCommand": {
      "server": "npm start"
    },

    "portsAttributes": {
      "3000": {
        "label": "Application",
        "onAutoForward": "openPreview"
      }
    },

    "customizations": {
      "codespaces": {
        "openFiles": ["src/App.js"]
      }
    }
}

자세한 내용은 개발 컨테이너 웹 사이트의 "개요" 및 개발 컨테이너 사양 을 참조하세요.