{"meta":{"title":"Solução de problemas de pré-compilações","intro":"Você pode usar as pré-compilações para acelerar a criação de codespaces. Este artigo fornece etapas de solução de problemas para problemas comuns com pré-compilações.","product":"Codespaces","breadcrumbs":[{"href":"/pt/codespaces","title":"Codespaces"},{"href":"/pt/codespaces/troubleshooting","title":"Solução de problemas"},{"href":"/pt/codespaces/troubleshooting/troubleshooting-prebuilds","title":"Pré-compilações de Codespaces"}],"documentType":"article"},"body":"# Solução de problemas de pré-compilações\n\nVocê pode usar as pré-compilações para acelerar a criação de codespaces. Este artigo fornece etapas de solução de problemas para problemas comuns com pré-compilações.\n\nPara obter mais informações sobre as GitHub Codespaces pré-compilações, consulte [Pré-construindo seus codespaces](/pt/codespaces/prebuilding-your-codespaces).\n\n## Verificando se um codespace foi originado a partir de um prebuild?\n\nAo criar um codespace, você pode escolher o tipo de máquina virtual que deseja usar. Se um pré-compilado estiver disponível para o tipo de máquina virtual, \" Pré-compilado pronto\" será mostrado ao lado dele.\n\n\n\nSe você tiver a preferência do editor GitHub Codespaces definida como \"Visual Studio Code para Web\", a página \"Configurar seu codespace\" mostrará a mensagem \"Codespace predefinido encontrado\" se um pré-build estiver em uso.\n\n\n\nDa mesma forma, se a preferência do editor for \"VS Code\", o terminal integrado conterá a mensagem \"Você está em um codespace pré-compilado definido pela configuração de pré-compilação do seu repositório\" ao criar um novo codespace. Para saber mais, confira [Definindo seu editor padrão para GitHub Codespaces](/pt/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces).\n\nDepois de criar um codespace, você pode verificar se ele foi criado a partir de um pré-compilado executando o seguinte GitHub CLI comando no terminal:\n\n```shell copy\ngh api /user/codespaces/$CODESPACE_NAME --jq .prebuild\n```\n\nIsso retornará `true` se o codespace tiver sido criado com um pré-build.\n\nComo alternativa, se GitHub CLI (`gh`) não estiver instalado, você poderá usar o seguinte comando, que retornará `createFromPrebuild` se o codespace tiver sido criado a partir de um pré-compilado:\n\n```shell copy\ncat /workspaces/.codespaces/shared/environment-variables.json | jq '.ACTION_NAME'\n```\n\n## Verificando o uso de pré-compilação\n\nVocê pode verificar se um repositório está usando pré-compilados na página \"Codespaces\" das configurações do repositório.\n\nVocê pode verificar quanto espaço de armazenamento foi consumido por prebuilds no seu ciclo de cobrança atual examinando os dados de cobrança da sua conta pessoal ou da sua organização. Você também pode gerar um relatório de uso para ver quais repositórios têm usado pré-compilações. Para saber mais, confira [Como exibir o uso de licenças e produtos mensuráveis](/pt/billing/how-tos/products/view-productlicense-use).\n\n## A etiqueta \"Prebuild Ready\" às vezes está faltando\n\nNote que, às vezes, quando você cria um novo codespace a partir de uma ramificação ativada por uma pré-build, o rótulo \"Pré-build de pronto\" não é exibido na caixa de diálogo para escolher um tipo de computador. Isto significa que pré-compilações não estão disponíveis no momento.\n\nPor padrão, cada vez que você enviar um branch de pré-compilação habilitado por push, a pré-compilação será atualizada. Se o push envolver uma alteração na configuração do contêiner de desenvolvimento, enquanto a atualização estiver em andamento, o rótulo \" Pré-compilado pronto\" será removido da lista de tipos de computador. Durante esse tempo, você ainda pode criar codespaces sem uma pré-compilação. Se necessário, você pode reduzir as ocasiões em que as pré-compilações estão indisponíveis para um repositório, definindo que a pré-compilação seja atualizada somente quando você fizer uma alteração nos arquivos de configuração do contêiner de desenvolvimento ou apenas em um agendamento personalizado. Para saber mais, confira [Configurando as pré-compilações](/pt/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds).\n\nSe seu branch não estiver especificamente habilitado para pré-compilações, ele ainda poderá se beneficiar de pré-compilações se tiver sido criado a partir de um branch habilitado para pré-compilações. No entanto, se a configuração do contêiner de desenvolvimento for alterada no seu branch, de modo que não seja igual à configuração no branch de base, as pré-compilações não estarão mais disponíveis em seu branch.\n\nVerifique estes itens se o rótulo \"Pré-build de pronto\" não aparecer para uma ramificação específica:\n\n* Confirme que existe uma configuração de pré-compilação para este branch. Se você não for administrador do repositório, entre em contato com um para confirmar.\n* Confirme que a configuração de pré-compilação inclui sua região.\n* Verifique se uma alteração para a configuração do contêiner de desenvolvimento foi enviada por push para o branch habilitado pela pré-compilação recentemente. Se sim, você geralmente terá que esperar até que a execução do fluxo de trabalho de pré-compilação para este push seja concluída antes que as pré-compilações estejam disponíveis novamente.\n* Se nenhuma alteração de configuração tiver sido feita recentemente, vá para a guia **Ações** do repositório, clique **Codespaces em Prebuilds** na lista de fluxos de trabalho e verifique se as execuções de fluxo de trabalho pré-compilados para o branch estão sendo bem-sucedidas. Se as execuções mais recentes de um fluxo de trabalho falharem e uma ou mais dessas execuções com falha contiverem alterações na configuração do contêiner de desenvolvimento, não haverá pré-compilações disponíveis para o branch associado.\n\n## Alguns recursos não podem ser acessados em codespaces criados usando um prebuild\n\nSe o arquivo de configuração `devcontainer.json` de uma configuração de prebuild especificar que as permissões de acesso a outros repositórios são necessárias, o administrador do repositório deverá autorizar essas permissões quando criar ou atualizar a configuração de prebuild. Se o administrador não conceder todas as permissões solicitadas, haverá uma chance de que possam ocorrer problemas no prebuild e em codespaces criados com base nesse prebuild. Isso será verdadeiro mesmo que o usuário que criar um codespace com base nesse prebuild *conceder* todas as permissões quando for solicitado a fazê-lo.\n\n## Solução de problemas de execuções de fluxo de trabalho com falha para pré-compilações\n\n### Aumentando o GitHub Actions limite de gastos\n\nOs pré-builds são criados e atualizados usando GitHub Actions. Seus fluxos de trabalho pré-compilados falharão se você tiver usado todos os seus GitHub Actions minutos e atingido o limite de gastos. Se isso ocorrer, você poderá aumentar o GitHub Actions limite de gastos para permitir a execução dos fluxos de trabalho. Para saber mais, confira [Definir orçamentos para controlar gastos com produtos limitados](/pt/billing/how-tos/set-up-budgets).\n\n### Como autorizar permissões de acesso\n\nSe o arquivo de configuração `devcontainer.json` de uma configuração de prebuild for atualizado para especificar que as permissões de acesso a outros repositórios são necessárias e um administrador de repositório não tiver sido solicitado a autorizar essas permissões para a configuração de prebuild, o fluxo de trabalho de prebuild poderá falhar. Tente atualizar a configuração de prebuild, sem fazer nenhuma alteração. Se, quando você clicar em **Atualizar**, a página de autorização for exibida, verifique se as permissões solicitadas são apropriadas e, nesse caso, autorize a solicitação. Para saber mais, confira [Gerenciando pré-compilações](/pt/codespaces/prebuilding-your-codespaces/managing-prebuilds#editing-a-prebuild-configuration) e [Gerenciar o acesso a outros repositórios em seu codespace](/pt/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces#setting-additional-repository-permissions).\n\nSe o fluxo de trabalho para uma configuração de pré-compilação estiver falhando, você poderá desabilitar a configuração de pré-compilação temporariamente enquanto investiga. Para saber mais, confira [Gerenciando pré-compilações](/pt/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration).\n\n### Como evitar o uso de prebuilds desatualizados\n\nPor padrão, se o fluxo de trabalho predefinição mais recente falhar, uma predefinição anterior da mesma combinação de repositório, branch e arquivo de configuração `devcontainer.json` será usada para criar codespaces. Esse comportamento é chamado de otimização de predefinição.\n\nRecomendamos manter a otimização de predefinição habilitada, pois ela ajuda a garantir que os codespaces possam ser criados rapidamente mesmo quando não houver uma predefinição atualizada disponível. No entanto, como administrador de repositório, você poderá desabilitar a otimização de predefinição se os codespaces predefinidos não acompanharem o estado atual do branch. Se você desativar a otimização de prebuild, os codespaces para a combinação relevante de repositório, branch e arquivo `devcontainer.json` serão criados sem um prebuild, caso o fluxo de trabalho de prebuild mais recente tenha falhado ou esteja em execução no momento.\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n\n3. Na barra lateral, em \"Código, planejamento e automação\", clique em **Codespaces**.\n\n4. À direita da configuração de predefinição afetada, selecione as reticências ( **...** ) e clique em **Editar**.\n\n \n\n5. Role até a parte inferior da página em \"Editar configuração\" e clique em **Mostrar opções avançadas**.\n\n \n\n6. Se tiver certeza de que deseja desabilitar a configuração padrão, selecione **Desabilitar otimização de predefinição**.\n\n \n\n7. Para salvar a alteração, clique em **Atualizar**.\n\n## Leitura adicional\n\n* [Configurando as pré-compilações](/pt/codespaces/prebuilding-your-codespaces/configuring-prebuilds)\n* [Gerenciando pré-compilações](/pt/codespaces/prebuilding-your-codespaces/managing-prebuilds)"}