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 de usuário 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 devcontainer.json na documentação do Visual Studio Code.
Você pode editar código, depurar e usar comandos do Git ao mesmo tempo que faz o desenvolvimento em um codespace com Visual Studio Code. For more information, see the Visual Studio 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. For more information, see "About Codespaces prebuilds."
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
-
No GitHub.com, navegue até a página principal do repositório.
-
No nome do repositório, use o menu suspenso "Branch", e selecione o branch para o qual você deseja criar um codespace.
-
No nome do repositório, use o menu suspenso Código de e na aba Codespaces de código, clique em Novo codespace.
Se você é integrante de uma organização e está criando um codespace em um repositório pertencente a essa organização, você poderá selecionar a opção de um tipo de máquina diferente. Na caixa de diálogo, escolha um tipo de máquina e, em seguida, clique em Criar codespace.
Note: 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."
After you connect your account on GitHub.com to the GitHub Codespaces extension, you can create a new codespace.
-
Em Visual Studio Code, na barra lateral esquerda, clique no ícone Remote Explorer.
-
Clique no ícone Adicionar e, em seguida, clique em Criar novo codespace.
-
Digite e, em seguida, clique no nome do repositório no qual você deseja desenvolver.
-
Clique no branch que você deseja desenvolver.
-
Clique no tipo de máquina na qual você deseja desenvolver.
Note: 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).
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 que está disponível depende do repositório, da sua conta de usuário 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.