Introduction
A codespace is a development environment that's hosted in the cloud. You can customize your project for GitHub Codespaces by committing configuration files to your repository (often known as Configuration-as-Code), which creates a repeatable codespace configuration for all users of your project. See Основные сведения о контейнерах разработки.
Each codespace you create is hosted by GitHub in a Docker container, running on a virtual machine. You can choose from a selection of virtual machine types, from 2 cores, 8 GB RAM, and 32 GB storage, up to 32 cores, 64 GB RAM, and 128 GB storage.
By default, the codespace development environment is created from an Ubuntu Linux image that includes a selection of popular languages and tools, but you can use an image based on a Linux distribution of your choice and configure it for your particular requirements. Regardless of your local operating system, your codespace will run in a Linux environment. Windows and macOS are not supported operating systems for the remote development container.
You can connect to your codespaces from your browser, from Visual Studio Code, or by using GitHub CLI. When you connect, you are placed within the Docker container. You have limited access to the outer Linux virtual machine host.
Using GitHub Codespaces
To begin developing using cloud-based compute resources, you can create a codespace from a template or from any branch or commit in a repository. When you create a codespace from a template, you can start from a blank template or choose a template suitable for the work you're doing.
Сведения о начале работы с GitHub Codespacesсм. в разделе Quickstart for GitHub Codespaces. Дополнительные сведения о создании пространства кода см. в разделе [AUTOTITLE или Создание пространства кода на основе шаблона](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository). Если вы хотите вернуться к созданному пространству кода, см. раздел Открытие существующего пространства кода. Дополнительные сведения о том, как работает GitHub Codespaces, см. в разделе Deep dive into GitHub Codespaces.
Using codespaces owned by your personal account
All personal GitHub accounts have a monthly quota of free use of GitHub Codespaces included in the Free or Pro plan. You can get started using GitHub Codespaces on your personal account without changing any settings or providing payment details.
If you create a codespace from an organization-owned repository, use of the codespace will either be charged to the organization (if the organization is configured for this), or to your personal account.
Вы можете продолжать использовать GitHub Codespaces за пределами ежемесячно включенного хранилища и использования вычислений, предоставив сведения о платеже и установив ограничение расходов. См . раздел AUTOTITLE.
Using organization-owned codespaces
Owners of organizations on GitHub Team and GitHub Enterprise plans can pay for their members' and collaborators' use of GitHub Codespaces. This applies to codespaces created from repositories owned by the organization. See Выбор владельцев и оплаты пространств кода в вашей организации. You can set a spending limit for use of GitHub Codespaces on your organization or enterprise account. See Управление ограничением расходов для GitHub Codespaces.
If use of a codespace will be billed to an organization or enterprise, this is shown when the codespace is created. See Создание пространства кода для репозитория. Codespaces that are billed to an organization, or its parent enterprise, are owned by the organization and can be deleted by an organization owner. See Удаление codespace.
Возможность создавать пространства кода из репозиториев, принадлежащих организации, зависит от нескольких факторов, в том числе видимости репозитория и параметров организации или родительского предприятия. Дополнительные сведения см. в разделе Устранение неполадок при создании и удалении codespace.
Customizing GitHub Codespaces
To customize the runtimes and tools in your codespace, you can create one or more dev container configurations for your repository. Adding dev container configurations to your repository allows you to define a choice of different development environments that are appropriate for the work people will do in your repository.
If you create a codespace from a repository without any dev container configurations, GitHub Codespaces will clone your repository into an environment with the default dev container image that includes many tools, languages, and runtime environments. If you create a codespace from a template, you might start with some initial configuration on top of the default image. See Основные сведения о контейнерах разработки.
You can personalize aspects of your codespace environment by using a public dotfiles repository. You can use dotfiles to set shell aliases and preferences, or to install your personal preference of the tools you like to use. If you use GitHub Codespaces in the browser, or in Visual Studio Code, you can use Settings Sync to give your codespace editor the same settings, keyboard shortcuts, snippets, and extensions that you have set up in your local installation of Visual Studio Code.
See Настройка codespace.
Billing for Codespaces
For information on pricing, storage, and usage for GitHub Codespaces, see Сведения о выставлении счетов для GitHub Codespaces.
Note
Необходимо задать ненулевое ограничение расходов на личную, организацию или корпоративную учетную запись, прежде чем счет за использование учетной записи GitHub Codespaces.
По умолчанию все учетные записи имеют GitHub Codespaces лимит расходов в размере $0 USD. Это предотвращает создание новых пространств кода или открытие существующих пространств кода, если это приведет к оплачиваемой стоимости вашей личной, организации или корпоративной учетной записи. Для личная учетная запись, если у вас есть доступ к созданию пространства кода, вы можете сделать это, если учетная запись не достигла предела его ежемесячного использования. Для организаций и предприятий ограничение расходов по умолчанию означает, что, чтобы позволить людям создавать пространства кода, выставленные организации, или родительскому предприятиям, ограничение должно быть изменено на значение выше $ 0 USD.
Затраты на GitHub Codespaces всегда выставляются ежемесячно, даже если ваша учетная запись в противном случае выставляется ежегодно. For information on how organizations owners and billing managers can manage the spending limit for GitHub Codespaces for an organization, see Управление ограничением расходов для GitHub Codespaces.