docs/translations/pt-BR/content/codespaces/developing-in-codespaces/creating-a-codespace.md

title, intro, product, permissions, redirect_from, versions, type, topics, shortTitle

title	intro	product	permissions	redirect_from	versions	type	topics	shortTitle
Criar um codespace	Você pode criar um codespace para uma branch em um repositório para fazer o desenvolvimento on-line.	{% data reusables.gated-features.codespaces %}	{% data reusables.codespaces.availability %}	/github/developing-online-with-github-codespaces/creating-a-codespace /github/developing-online-with-codespaces/creating-a-codespace	fpt ghec * *	how_to	Codespaces Fundamentals Developer	Criar um codespace

Sobre a criação do codespace

Você pode criar um codespace em {% data variables.product.prodname_dotcom_the_website %}, em {% data variables.product.prodname_vscode %}, ou usando {% data variables.product.prodname_cli %}. {% data reusables.codespaces.codespaces-are-personal %}

Os codespaces são associados a um branch específico de um repositório e o repositório não pode estar vazio. {% data reusables.codespaces.concurrent-codespace-limit %} 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.

{% data reusables.codespaces.use-visual-studio-features %}

{% data reusables.codespaces.you-can-see-all-your-codespaces %}

{% data reusables.codespaces.prebuilds-crossreference %}

Acesso a {% data variables.product.prodname_codespaces %}

{% data reusables.codespaces.availability %}

Quando você tem acesso a {% data variables.product.prodname_codespaces %}, você verá uma aba "Codespace" dentro do menu suspenso ** Código de{% octicon "code" aria-label="The code icon" %} ** ao visualizar um repositório.

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

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

{% note %}

Observação: As pessoas que já aderiram ao beta com sua conta pessoal do {% data variables.product.prodname_dotcom %} não perderão acesso a {% data variables.product.prodname_codespaces %}. No entanto, {% data variables.product.prodname_codespaces %} para as pessoas, continuará sendo beta.

{% endnote %}

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 {% data variables.product.prodname_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 {% data variables.product.prodname_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

{% webui %}

{% data reusables.repositories.navigate-to-repo %}

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

   

2. Clique no botão Código de {% octicon "code" aria-label="The code icon" %} e, em seguida, clique na aba Codespaces.

   

3. 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.

     

     {% note %}

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

     {% endnote %}

   • 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.

        

        {% note %}

        Observações

        • Você pode favoritar a página de opções para criar rapidamente um codespace para este repositório e branch.
        • A página https://github.com/codespaces/nova fornece uma maneira rápida de criar um codespace para qualquer repositório e branch.
        • Para obter mais informações sobre o arquivo devcontainer.json, consulte "Introdução aos contêineres de desenvolvimento".
        • Para obter mais informações sobre os tipos de máquina, consulte "Alterando o tipo de máquina para seu codespace".
        • {% data reusables.codespaces.codespaces-machine-type-availability %}

        {% endnote %}

     4. Clique Iniciar sessão.

{% endwebui %}

{% vscode %}

{% data reusables.codespaces.creating-a-codespace-in-vscode %}

{% endvscode %}

{% cli %}

{% data reusables.cli.cli-learn-more %}

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).

{% note %}

Observação: Atualmente, {% data variables.product.prodname_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 {% data variables.product.prodname_dotcom %} para criar o seu codespace. Para mais informações, clique na aba "Navegador da Web" na parte superior desta página.

{% endnote %}

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

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

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 de{% data variables.product.prodname_cli %}.

{% endcli %}