{"meta":{"title":"Como criar um codespace para um repositório","intro":"Você pode criar um codespace para uma branch em um repositório para fazer o desenvolvimento on-line.","product":"Codespaces","breadcrumbs":[{"href":"/pt/codespaces","title":"Codespaces"},{"href":"/pt/codespaces/developing-in-a-codespace","title":"Desenvolver em um codespace"},{"href":"/pt/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository","title":"Criar um codespace para um repositório"}],"documentType":"article"},"body":"# Como criar um codespace para um repositório\n\nVocê pode criar um codespace para uma branch em um repositório para fazer o desenvolvimento on-line.\n\n## Sobre como criar um codespace para um repositório\n\nVocê pode criar um codespace no GitHub, no Visual Studio Code, ou usando a GitHub CLI. Use as guias neste artigo para ver instruções de cada uma dessas maneiras de criar um codespace.\n\nVocê pode usar GitHub Codespaces em sua conta pessoal do GitHub, com a cota de uso gratuito incluída a cada mês para contas nos planos Gratuito e Pro. 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. Confira [Cobrança do GitHub Codespaces](/pt/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).\n\nAs organizações podem permitir que membros e colaboradores externos criem e usem codespaces às custas da organização. Para saber mais, confira [Como escolher quem tem a propriedade e paga pelos codespaces em sua organização](/pt/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization).\n\nA capacidade de criar codespaces com base em repositórios de propriedade da organização depende de vários fatores, como a visibilidade do repositório e as configurações da organização ou da empresa-mãe. Para saber mais, confira [Solucionar problemas de criação e exclusão de codespaces](/pt/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces#no-access-to-create-a-codespace).\n\nAo iniciar um novo projeto, você pode criar um codespace com base em um modelo e publicá-lo mais tarde em um repositório no GitHub. Para saber mais, consulte [Como criar um codespace com base em um modelo](/pt/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template).\n\nSe você criar um codespace com base em um repositório, o codespace será associado a um branch específico, que não poderá estar vazio. Você pode criar mais de um código de espaço por repositório ou até mesmo por branch.\n\nVocê poderá ver todos os codespaces disponíveis que criou na página \"Seus codespaces\". Para exibir essa página, no canto superior esquerdo do GitHub, selecione e clique ** Codespaces**. Isso leva você para [github.com/codespaces](https://github.com/codespaces).\n\n### O processo de criação do codespace\n\nAo criar um codespace, várias etapas acontecem para criar e conectar você ao seu ambiente de desenvolvimento:\n\n* Etapa 1: A VM e o armazenamento são atribuídos ao seu codespace.\n* Etapa 2: O contêiner é criado e seu repositório é clonado.\n* Passo 3: Você pode conectar-se ao codespace.\n* Etapa 4: O codespace continua com a configuração pós-criação.\n\nPara saber mais sobre o que acontece quando você cria um codespace, confira [Aprofundamento de GitHub Codespaces](/pt/codespaces/about-codespaces/deep-dive).\n\nPara saber mais sobre o ciclo de vida de um codespace, confira [Noções básicas sobre o ciclo de vida do codespace](/pt/codespaces/about-codespaces/understanding-the-codespace-lifecycle).\n\nCaso deseje usar ganchos do Git para o codespace, configure os ganchos usando os scripts de ciclo de vida `devcontainer.json`, como `postCreateCommand`. Eles são executados durante a etapa 4, acima. Para obter informações sobre os scripts de ciclo de vida, confira a [especificação de contêineres de desenvolvimento](https://containers.dev/implementors/json_reference/#lifecycle-scripts) no site de contêineres de desenvolvimento. Como o contêiner de desenvolvimento para o seu codespace é criado depois que o repositório é clonado, qualquer [diretório de modelo do Git](https://git-scm.com/docs/git-init#_template_directory) configurado na imagem de contêiner de desenvolvedor não se aplicará ao seu codespace. Os Hooks devem ser instalados depois que o codespace for criado.\n\nVocê pode editar código, depurar e usar comandos do Git ao mesmo tempo que faz o desenvolvimento em um codespace com VS Code. Para obter mais informações, confira a [documentação do VS Code](https://code.visualstudio.com/docs).\n\nPara acelerar a criação de codespaces, os administradores de repositório podem habilitar pré-builds do GitHub Codespaces em um repositório. Para saber mais, confira [Sobre as pré-compilações do GitHub Codespaces](/pt/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds).\n\n## Como criar um codespace para um repositório\n\n
\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. No nome do repositório, selecione o menu suspenso do branch, que é rotulado com o nome do branch atual e clique no branch para o qual você deseja criar um codespace.\n\n ![Captura de tela do menu suspenso do branch expandido, listando vários branches. O menu suspenso \"tronco\", mostrado com um ícone de branch, está contornado em laranja.](/assets/images/help/codespaces/branch-drop-down.png)\n\n3. Clique no botão ** Code** e na guia **Codespaces**.\n\n Uma mensagem é exibida na parte inferior da caixa de diálogo informando quem pagará pelo codespace.\n\n ![Captura de tela da caixa de diálogo Codespaces. A mensagem mostrando quem pagará pelo codespace é realçada com um contorno laranja escuro.](/assets/images/help/codespaces/who-will-pay.png)\n\n4. Crie seu codespace, usando as opções padrão ou depois de configurar opções avançadas:\n\n * ```\n **Usar as opções padrão**\n ```\n\n Para criar um codespace usando as opções padrão, clique em .

\n\n * ```\n **Configurar opções avançadas**\n ```\n\n Para configurar opções avançadas para seu codespace, como um tipo de computador diferente ou um arquivo específico `devcontainer.json`:\n\n 1. No canto superior direito da guia **Codespaces**, selecione e clique em **Novo com opções**.\n\n ![Captura de tela da lista suspensa de opções na guia \"Codespaces\", com a opção \"Novo com opções\" realçada.](/assets/images/help/codespaces/default-machine-type.png)\n\n 2. Na página de opções do codespace, escolha as opções da sua preferência nos menus suspensos.\n\n ![Captura de tela da página de opções avançadas com botões para \"Branch\", \"Configuração do contêiner de desenvolvimento\", \"Região\" e \"Tipo de computador\".](/assets/images/help/codespaces/advanced-options.png)\n\n A página de opções também pode exibir os nomes de um ou mais segredos que recomendamos que você crie nas configurações do Codespaces. Para obter mais informações, consulte [Segredos recomendados](#recommended-secrets).\n\n > \\[!NOTE]\n >\n > * Você pode adicionar a página de opções aos favoritos para obter uma forma rápida de criar um codespace para esse repositório e esse branch.\n > * A página fornece uma forma rápida de criar um codespace para qualquer repositório e ramificação. Você pode acessar essa página rapidamente digitando `codespace.new` na barra de endereços do navegador.\n > * Para obter mais informações sobre os arquivos de configuração do contêiner de desenvolvimento, consulte [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n > * Para saber mais sobre os tipos de máquina, consulte [Alterando o tipo de máquina para seu codespace](/pt/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types).\n > * Sua escolha de tipos de computador disponíveis pode ser limitada por vários fatores. Esses fatores podem incluir uma política configurada para a organização ou uma especificação mínima de tipo de computador para o repositório. Para saber mais, confira [Restringindo o acesso aos tipos de máquina](/pt/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) e [Definindo uma especificação mínima para máquinas de codespaces](/pt/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines).\n\n 3. Clique em **Criar codespace**.\n\n## Segredos recomendados\n\nOs nomes de segredos definidos pelo usuário podem ser exibidos na página de opções avançadas quando você cria um codespace. Isso acontecerá se os segredos recomendados tiverem sido especificados na configuração de contêiner de desenvolvimento selecionada. Para saber mais, confira [Como especificar segredos recomendados para um repositório](/pt/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository).\n\nScreenshot of the \"Create codespace\" page with four recommended secrets highlighted with a dark orange outline.\n\nRecomenda-se inserir valores para esses segredos de ambiente de desenvolvimento, quando você receber uma solicitação para fazer isso, porque é provável que o projeto vá precisar de valores para esses segredos. No entanto, o fornecimento de valores não é necessário para que você crie um codespace. Você poderá definir esses segredos no codespace, se preferir.\n\nSe você inserir um valor para um segredo recomendado, o segredo estará disponível no novo codespace. Quando você clica em **Criar codespace**, o segredo também é adicionado às suas configurações pessoais do Codespaces, ou seja, você não precisará inserir um valor para o segredo no futuro ao criar um codespace para esse repositório.\n\nSe o nome de um segredo for mostrado com uma caixa de seleção indisponível para seleção e nenhuma caixa de entrada, isso ocorrerá porque você já tem um segredo desse nome definido nas configurações pessoais do Codespaces, e você o associou a esse repositório. Se você criar um segredo desse nome, mas não o associar a esse repositório, a caixa de seleção estará disponível para seleção e, ao fazer isso, você poderá atualizar suas configurações para adicionar a associação.\n\nCaso deseje alterar o valor de um segredo previamente selecionado, faça isso nas suas configurações pessoais do Codespaces em [github.com/settings/codespaces](https://github.com/settings/codespaces). Para saber mais, confira [Gerenciando seus segredos específicos da conta no GitHub Codespaces](/pt/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces).\n\n
\n\n
\n\nVocê poderá criar um codespace após conectar sua conta no GitHub à extensão do GitHub Codespaces. Para obter mais informações sobre a extensão GitHub Codespaces, veja o [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces).\n\n1. No VS Code, na barra de Atividades, clique no ícone do Gerenciador Remoto.\n\n ![Captura de tela da Barra de Atividades. O ícone da barra lateral do \"Gerenciador Remoto\" (um retângulo sobreposto por um círculo) está realçado com um contorno laranja.](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n > \\[!NOTE]\n > Se o Remote Explorer não for exibido na barra Activity:\n >\n > 1. Abra a paleta de comandos. Por exemplo, pressionando Shift+Command+P (no Mac) / Ctrl+Shift+P (no Windows/Linux).\n > 2. Digite: `details`.\n > 3. Clique em **Codespaces: detalhes**.\n\n2. Passe o mouse sobre a barra lateral do \"Gerenciador Remoto\" e clique em .\n\n ![Captura de tela da barra lateral do \"Gerenciador Remoto\" para GitHub Codespaces. A dica de ferramenta \"Criar Novo Codespace\" é exibida ao lado do botão de sinal de adição.](/assets/images/help/codespaces/create-codespace-vscode.png)\n\n3. Na caixa de texto, digite o nome do repositório no qual você deseja desenvolver e selecione-o.\n\n ![Captura de tela de \"octo-org/he\" inserida na caixa de texto e uma lista de quatro repositórios que começam com essa cadeia de caracteres.](/assets/images/help/codespaces/choose-repository-vscode.png)\n\n Uma mensagem é exibida no lado direito dos prompts subsequentes informando quem pagará pelo codespace.\n\n ![Captura de tela de um prompt para um branch, com a mensagem \"Uso pago pelo hubwriter\".](/assets/images/help/codespaces/who-will-pay-vscode.png)\n\n4. Clique no branch que você deseja desenvolver.\n\n5. Se solicitado a escolher um arquivo de configuração de contêiner de desenvolvimento, escolha um arquivo na lista.\n\n6. Clique no tipo de computador que você quer usar.\n\n > \\[!NOTE]\n > Sua escolha de tipos de computador disponíveis pode ser limitada por vários fatores. Esses fatores podem incluir uma política configurada para a organização ou uma especificação mínima de tipo de computador para o repositório. Para saber mais, confira [Restringindo o acesso aos tipos de máquina](/pt/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) e [Definindo uma especificação mínima para máquinas de codespaces](/pt/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines).\n\n
\n\n
\n\n> \\[!NOTE]\n> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).\n\nPara criar um codespace, use o subcomando `gh codespace create`.\n\n```shell\ngh codespace create\n```\n\nSerá solicitado que você escolha um repositório. Uma mensagem é exibida informando quem pagará pelo codespace. Depois será solicitado que você escolha um branch, um arquivo de configuração do contêiner de desenvolvimento (se mais de um estiver disponível) e um tipo de computador (se mais de um estiver disponível).\n\nComo alternativa, você pode usar sinalizadores para especificar algumas ou todas as opções:\n\n```shell\ngh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE\n```\n\nNeste exemplo, substitua `owner/repo` pelo identificador do repositório. Substitua `branch` pelo nome do branch ou pelo hash do SHA completo do commit do qual você deseja fazer check-out inicialmente no codespace. Se você usar o sinalizador `-r` sem o sinalizador `b`, o codespace será criado com base no branch padrão.\n\nSubstitua `path` pelo caminho para o arquivo de configuração do contêiner de desenvolvimento que você deseja usar para o novo codespace. Se você omitir esse sinalizador e mais de um tipo de máquina estiver disponível, deverá escolher uma na lista. Para saber mais sobre o arquivo de configuração do contêiner de desenvolvimento, consulte [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n\nSubstitua `machine-type` por um identificador válido para um tipo de computador disponível. Os identificadores são cadeias de caracteres como: `basicLinux32gb` e `standardLinux32gb`. O tipo de máquina que está 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.\n\nPara obter detalhes completos das opções para esse comando, confira [o manual do GitHub CLI](https://cli.github.com/manual/gh_codespace_create).\n\n
\n\n## Leitura adicional\n\n* [Como abrir um codespace existente](/pt/codespaces/developing-in-a-codespace/opening-an-existing-codespace)\n* [Como facilitar a criação rápida e a retomada de codespaces](/pt/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces)\n* [Pontos de acesso da API REST para organizações Codespaces](/pt/rest/codespaces/organizations)"}