Skip to main content

Criar um codespace

Você pode criar um codespace para uma branch em um repositório para fazer o desenvolvimento on-line.

Codespaces are available for repositories owned by organizations using GitHub Team and GitHub Enterprise Cloud.

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. Para obter mais informações, consulte os "produtos do GitHub".

Sobre a criação do codespace

Você pode criar um codespace em GitHub.com, em Visual Studio Code, ou usando GitHub CLI. Cada espaço de código que criar só está disponível para você. Ninguém mais pode trabalhar no seu espaço de código.

Os codespaces são associados a um branch específico de um repositório e o repositório não pode estar vazio. Você pode criar mais de um código de espaço por repositório ou até mesmo por branch. No entanto, cada conta pessoal tem um limite de 10 codespaces. Se você atingiu o limite e deseja criar um novo espaço de código, você deve primeiro excluir um código. Para obter mais informações, consulte "Excluir um codespace".

Ao criar um codespace, várias etapas acontecem para criar e conectar você ao seu ambiente de desenvolvimento:

  • Etapa 1: A VM e o armazenamento são atribuídos ao seu codespace.
  • Etapa 2: O contêiner é criado e seu repositório é clonado.
  • Passo 3: Você pode conectar-se ao codespace.
  • Etapa 4: O codespace continua com a configuração pós-criação.

Para obter mais informações sobre o que acontece quando você cria um codespace, consulte "Aprofundamento".

Para obter mais informações sobre o ciclo de vida de um codespace, consulte "Ciclo de vida dos codespaces".

Se você quiser usar hooks do Git para o seu código, você deverá configurar hooks usando os scritps do ciclo de vida do de devcontainer.json lifecycle scripts, como postCreateCommand, durante a etapa 4. Uma vez que o seu contêiner de codespace é criado depois que o repositório é clonado, qualquer diretório de template do git configurado na imagem do contêiner não será aplicado ao seu codespace. Os Hooks devem ser instalados depois que o codespace for criado. Para obter mais informações sobre como usar postCreateCommand, consulte a referência do devcontainer.json na documentação de VS Code.

Você pode editar código, depurar e usar comandos do Git ao mesmo tempo que faz o desenvolvimento em um codespace com VS Code. For more information, see the VS Code documentation.

Você pode ver todos os códigos disponíveis que você criou em github.com/codespaces.

To speed up codespace creation, repository administrators can enable Codespaces prebuilds for a repository. Para obter mais informações, consulte "Sobre pré-compilações de Codespaces".

Acesso a Codespaces

Codespaces are available for repositories owned by organizations using GitHub Team and GitHub Enterprise Cloud.

Quando você tem acesso a Codespaces, você verá uma aba "Codespace" dentro do menu suspenso Código de ao visualizar um repositório.

Você terá acesso a codespaces nas seguintes condições:

  • Você é um integrante de uma organização que habilitou Codespaces e definiu um limite de gastos.
  • Um proprietário da organização concedeu a você acesso a Codespaces.
  • O repositório pertence à organização que habilitou Codespaces.

Observação: As pessoas que já aderiram ao beta com sua conta pessoal do GitHub não perderão acesso a Codespaces. No entanto, Codespaces para as pessoas, continuará sendo beta.

Os proprietários da organização podem permitir que todos os integrantes da organização criem codespaces, limitem a criação de códigos aos integrantes selecionados da organização ou desabilitem a criação de codespace. Para obter mais informações sobre como gerenciar o acesso aos codespaces dentro da sua organização, consulte "Habilitar codespace para usuários da sua organização".

Antes de Codespaces pode ser usado em uma organização, um proprietário ou gerente de cobrança deverá ter um limite de gastos. Para obter mais informações, consulte "Sobre limites de gastos para codespaces".

Se você deseja criar um codespace para um repositório pertencente à sua conta pessoal ou outro usuário e você tem permissão para criar repositórios em uma organização que habilitou Codespaces, você poderá criar uma bifurcação de repositórios pertencentes ao usuário na organização e, em seguida, criar um codespace para a bifurcação.

Criar um codespace

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No nome do repositório, use o menu suspenso "Branch", e selecione o branch para o qual você deseja criar um codespace.

    Menu suspenso do branch

  3. Clique no botão Código de e, em seguida, clique na aba Codespaces.

    Botão de codespace novo

  4. Crie o seu codespace, usando as opções padrão ou após a configuração das opções avançadas:

    • Usar as opções padrão

      Para criar um código com as opções padrão, clique em Criar codespace no BRANCH.

      Opcionalmente, antes de clicar em Criar codespace no BRANCH, você pode clicar na seta para baixo ao lado do botão para ver que tipo de máquina será usada no seu codespace.

      Ver o tipo de máquina padrão

      Observação: O tipo de máquina com os recursos mais baixos válidos para o repositório é selecionado por padrão.

    • Configurar opções

      Para configurar opções avançadas para o seu codespace como, por exemplo um tipo de máquina diferente ou um determinado arquivo devcontainer.json:

      1. Clique na seta para baixo ao lado do botão Criar codespace no BRANCH e, em seguida, clique em Configurar e criar codespace.

      2. Clique no botão Configurar e criar o codespace.

      3. Na página de opções do seu codespace, escolha suas opções preferidas entre os menus suspensos.

        Página de opções de codespace

        Observações

      4. Clique Iniciar sessão.

After you connect your account on GitHub.com to the GitHub Codespaces extension, you can create a new codespace. For more information about the GitHub Codespaces extension, see the VS Code Marketplace marketplace.

Observação: Atualmente, VS Code não permite que você escolha uma configuração de contêiner de desenvolvimento ao cria um codespace. Se você quiser escolher uma configuração de contêiner de desenvolvimento específica, use a interface web do GitHub para criar o seu codespace. For more information, click the Web browser tab at the top of this page.

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Click the Add icon: .

    A opção "Criar novo codespace" em Codespaces

  3. Type the name of the repository you want to develop in, then select it.

    Pesquisar um repositório para criar um novo Codespaces

  4. Clique no branch que você deseja desenvolver.

    Pesquisar um branch para criar um novo Codespaces

  5. Click the machine type you want to use.

    Tipos de instância para um novo Codespaces

    Observação: Your choice of available machine types may be limited by a policy configured for your organization, or by a minimum machine type specification for your repository. For more information, see "Restricting access to machine types" and "Setting a minimum specification for codespace machines."

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Para criar um novo codespace, use o subcomando gh create.

gh codespace create 

Solicita-se que você escolha um repositório, um branch e um tipo de máquina (se mais de um estiver disponível).

Observação: Atualmente, GitHub CLI não permite que você escolha uma configuração de contêiner de desenvolvimento ao cria um codespace. Se você quiser escolher uma configuração de contêiner de desenvolvimento específica, use a interface web do GitHub para criar o seu codespace. Para mais informações, clique na aba "Navegador da Web" na parte superior desta página.

Como alternativa, você pode usar sinalizadores para especificar algumas ou todas as opções:

gh codespace create -r owner/repo -b branch -m machine-type 

Substitua proprietário/repositório pelo identificador do repositório. Substitua branch pelo nome do branch ou o hash SHA completo do commit, que você deseja fazer check-out inicialmente no codespace. Se você usar o sinalizador -r sem o sinalizador b, o codespace será criado a partir do branch padrão.

Substitua machine-type por um identificador válido para um tipo de máquina disponível. Os identificadores são strings como: basicLinux32gb e standardLinux32gb. O tipo de máquina disponível depende do repositório, da sua conta pessoal e da sua localização. Se você digitar um tipo de máquina inválido ou indisponível, os tipos disponíveis serão mostrados na mensagem de erro. Se você omitir este sinalizador e mais de um tipo de máquina estiver disponível, será solicitado que você escolha uma na lista.

Para obter mais informações sobre esse comando, consulte o manual deGitHub CLI.