O que é um codespace?
Um codespace é um ambiente de desenvolvimento hospedado na nuvem. Você pode personalizar seu projeto para o GitHub Codespaces fazendo commit dos arquivos de configuração no seu repositório (geralmente conhecido como configuração como código), o que cria uma configuração de codespace repetível para todos os usuários do projeto.
Cada codespace criado é hospedado por GitHub em um contêiner do Docker em execução em uma máquina virtual. Você pode escolher entre uma seleção de tipos de máquina virtual, de 2 núcleos, 8 GB de RAM e 32 GB de armazenamento, até 32 núcleos, 64 GB de RAM e 128 GB de armazenamento.
Por padrão, os codespaces são criados com base em uma imagem do Ubuntu Linux que inclui uma seleção de linguagens e ferramentas populares, mas você pode usar uma imagem com base em uma distribuição do Linux de sua escolha e configurá-la para requisitos específicos. Independentemente do sistema operacional local, o codespace será executado em um ambiente Linux. Não há suporte para sistemas operacionais Windows e MacOS para o contêiner remoto.
Você pode se conectar aos seus codespaces por meio do navegador, por meio do Visual Studio Code, do aplicativo JetBrains Gateway ou usando a GitHub CLI. Ao se conectar, você é colocado dentro do contêiner do Docker. Você não tem acesso ao host externo da máquina virtual Linux.
Como usar o GitHub Codespaces
Para começar o desenvolvimento usando recursos de computação baseados na nuvem, crie um codespace com base em um modelo ou em qualquer branch ou faça commit em um repositório. Ao criar um codespace com base em um modelo, você pode começar com um modelo em branco ou escolher um modelo adequado para o trabalho que está fazendo.
Para começar a usar os GitHub Codespaces, confira "Guia de início rápido dos GitHub Codespaces". Para obter mais informações sobre como criar um codespace, confira "Como criar um codespace para um repositório" ou "Como criar um codespace com base em um modelo". Se você quiser retornar a um codespace que já criou, confira "Como abrir um codespace existente". Para saber como os GitHub Codespaces funcionam, confira "Aprofundamento nos GitHub Codespaces".
Como usar codespaces pertencentes à sua conta pessoal
Todas as contas pessoais do GitHub.com têm uma cota mensal de uso gratuito do GitHub Codespaces incluída no plano Gratuito ou Pro. Comece a usar o GitHub Codespaces na sua conta pessoal sem alterar nenhuma configuração ou fornecer detalhes de pagamento.
Você pode criar e usar um codespace para qualquer repositório que possa clonar. Também pode usar um modelo para criar codespaces que não estão inicialmente associados a um repositório. Se você criar um codespace por meio de um repositório de propriedade da organização, o uso do codespace será cobrado para a organização (se a organização estiver configurada para isso) ou para sua conta pessoal. Os codespaces criados com base em modelos são sempre cobrados na sua conta pessoal.
Você pode continuar usando o GitHub Codespaces além do uso mensal incluído de armazenamento e computação fornecendo detalhes de pagamento e definindo um limite de gastos. Para obter mais informações, confira "About billing for GitHub Codespaces".
Como usar codespaces de propriedade da organização
Os proprietários da organização podem habilitar o uso do GitHub Codespaces, faturável para a organização ou para a conta corporativa. Isso se aplica aos codespaces criados com base em repositórios pertencentes à organização. Para obter mais informações, confira "Como habilitar GitHub Codespaces para sua organização". Defina um limite de gastos para uso do GitHub Codespaces na sua organização ou na sua conta corporativa. Para obter mais informações, confira "Como gerenciar limites de gastos do GitHub Codespaces".
Se o uso de um codespace for cobrado para uma organização ou uma empresa, isso será mostrado quando o codespace for criado. Para obter mais informações, confira "Como criar um codespace para um repositório". Os codespaces cobrados de uma organização ou de sua empresa-mãe pertencem à organização e podem ser excluídos por um proprietário dela. Para obter mais informações, confira "Como excluir um codespace".
Como personalizar o GitHub Codespaces
Para personalizar os runtimes e as ferramentas em seu codespace, você pode criar uma ou mais configurações de contêiner de desenvolvimento para seu repositório. A adição de configurações de contêiner de desenvolvimento ao seu repositório permite que você defina uma escolha de diferentes ambientes de desenvolvimento apropriados para o trabalho que as pessoas farão em seu repositório.
Se você criar um codespace por meio de um repositório sem nenhuma configuração de contêiner de desenvolvimento, o GitHub Codespaces clonará seu repositório em um ambiente com a imagem de codespace padrão que inclui muitas ferramentas, linguagens e ambientes de execução. Se você criar um codespace com base em um modelo, poderá começar com uma configuração inicial baseada na imagem padrão. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento".
Personalize aspectos do ambiente do codespace usando um repositório de dotfiles público. Use dotfiles para definir aliases e preferências de shell ou para instalar sua preferência pessoal das ferramentas que deseja usar. Se você usar o GitHub Codespaces no navegador ou no Visual Studio Code, use a Sincronização de Configurações para fornecer ao editor de codespace as configurações, os atalhos de teclado, as extensões e os snippets idênticos que você configurou na instalação local do Visual Studio Code.
Para obter mais informações, confira "Como personalizar seu codespace".
Cobrança do Codespaces
Para obter informações sobre preços, armazenamento e uso dos GitHub Codespaces, confira "Sobre a cobrança dos GitHub Codespaces".
Nota: você precisa definir um limite de gastos diferente de zero em sua conta pessoal, organizacional ou corporativa antes que a conta possa ser cobrada pelo uso de GitHub Codespaces.
Por padrão, todas as contas têm um limite de gastos de US$ 0 para GitHub Codespaces. Isso impede que novos codespaces sejam criados ou que os codespaces existentes sejam abertos, se isso incorrer em um custo faturável para sua conta pessoal, corporativa ou da organização. Para contas pessoais, os codespaces sempre poderão ser criados e usados se a conta não tiver atingido o limite de uso mensal incluído. Para organizações e empresas, o limite de gastos padrão significa que, para permitir que as pessoas criem codespaces que são cobrados para a organização ou sua empresa-mãe, o limite precisa ser alterado para um valor acima de US$ 0.
Os custos de GitHub Codespaces são sempre cobrados mensalmente, mesmo que os outros itens de sua conta sejam cobrados anualmente. Para obter informações de como os proprietários de organizações e os gerentes de cobrança podem gerenciar o limite de gastos dod GitHub Codespaces de uma organização, confira "Como gerenciar o limite de gastos do GitHub Codespaces".