Gerenciando pré-compilações

Verificando, alterando e excluindo suas configurações de pré-compilação

As pré-compilações que você configurar são criadas e atualizadas usando um fluxo de trabalho de GitHub Actions, gerenciado pelo serviço de Codespaces.

O fluxo de trabalho é acionado por estes eventos:

• Criando ou atualizando a configuração de pré-compilação
• Enviando por push um commit ou um pull request para um branch configurado para pré-compilações
• Acionando manualmente o fluxo de trabalho

As pessoas com acesso de administrador a um repositório podem verificar o progresso de pré-compilações, editar e excluir configurações de pré-criação.

Visualizando o progresso das pré-compilações

Você pode visualizar o status atual da última execução do fluxo de trabalho para cada configuração de pré-compilação que você definiu na página de Codespaces das configurações do repositório. Por exemplo, "Atualmente em execução" ou "Última execução 1 hora atrás".

Para ver a saída de registro para a última execução do fluxo de trabalho de pré-compilação, clique em Ver saída.

Ele exibe a saída da execução mais recente do fluxo de trabalho na aba Ações.

Como alternativa, para visualizar todas as execuções de fluxo de trabalho pré-compilado associadas a um branch especificada, clique no botão de retiências e selecione Visualizar execuções no menu suspenso.

Exibe o histórico de execução de fluxo de trabalho para pré-compilações para o branch associado.

Editando uma configuração de pré-compilação

1. Na página de Codespaces das configurações do repositório, clique nas reticências à direita da configuração de pré-compilação que você deseja editar.

2. No menu suspenso, clique em Editar.

   

3. Faça as alterações necessárias na configuração de pré-compilação e, em seguida, clique em Atualizar.

Excluir uma configuração de pré-compilação

A exclusão de uma configuração de pré-compilação também exclui todos os modelos de pré-compilação criados anteriormente para essa configuração. Como resultado, logo após você excluir uma configuração, as pré-compilações geradas por essa configuração não estarão disponíveis ao criar um novo codespace.

Depois que você excluir uma configuração de pré-compilação, as execuções do fluxo de trabalho que foram enfileirados ou iniciados ainda serão executadas. Elas serão listados no histórico de execução de fluxo de trabalho junto com execuções de fluxo de trabalho concluídas anteriormente.

1. Na página de Codespaces das configurações do repositório, clique nas reticências à direita da configuração de pré-compilação que você deseja excluir.

2. No menu suspenso, clique em Excluir.

   

3. Clique em OK para confirmar a exclusão.

Acionar pré-compilações manualmente

Pode ser útil acionar manualmente a execução de um fluxo de trabalho para uma configuração de pré-compilação. Geralmente, isso só é necessário se você estiver depurando um problema com o fluxo de trabalho para uma configuração de pré-compilação.

1. Na página de Codespaces das configurações do repositório, clique nas reticências à direita da configuração de pré-compilação cujo fluxo de trabalho você deseja acionar.

2. No menu suspenso, clique em Acionar manualmente.

   

Permitir que uma pré-compilação acesse recursos externos

Por padrão, o fluxo de trabalho de GitHub Actions para uma configuração de pré-compilação só pode acessar o próprio conteúdo do repositório. Seu projeto pode usar recursos adicionais para criar o ambiente de desenvolvimento, como arquivos em outros repositórios, pacotes, imagens GHCR e APIs. Para permitir que a sua configuração de pré-compilação acesse esses recursos, você deverá criar uma nova conta pessoal e, em seguida, usar esta conta para criar um token de acesso pessoal (PAT) com os escopos apropriados.

1. Crie uma nova conta pessoal em GitHub.

   Aviso: Embora você possa gerar o PAT usando a sua conta pessoal existente, é altamente recomendável que você crie uma nova conta com acesso apenas aos repositórios de destino necessários para seu cenário. Isso acontece porque a permissão do repositório do token de acesso concede acesso a todos os repositórios aos quais a conta tem acesso. Para obter mais informações, consulte "Inscrevendo-se para uma nova conta no GitHub" e "Fortalecimento da segurança para GitHub Actions".

2. Dê a nova conta acesso de leitura aos repositórios necessários. Para obter mais informações, consulte "Gerenciar o acesso de um indivíduo ao repositório de uma organização".

3. Enquanto estiver conectado à nova conta, crie um PAT com o escopo repo. Opcionalmente, se a pré-compilação tiver de fazer o download do GitHub Container registry, selecione também o escopo read:packages. Para obter mais informações, consulte "Criando um token de acesso pessoal."

   

   Se a pré-compilação usar um pacote do GitHub Container registry, você deverá conceder o novo acesso à nova conta ao pacote ou configurar o pacote para herdar as permissões de acesso do repositório que você está pré-compilando. Para obter mais informações, consulte "Configurar o controle de acesso e visibilidade de um pacote".

4. Copie a string do token. Você irá atribuir isto a um segredo de repositório de Codespaces.

5. Efetue novamente o login na conta com acesso de administrador ao repositório.

6. No repositório para o qual você deseja criar as pré-compilações de Codespaces, crie um novo segredo de repositório de Codespaces chamado CODESPACES_PREBUILD_TOKEN, dando-lhe o valor do token que você criou e copiou. Para obter mais informações, consulte "Gerenciando segredos criptografados para o seu repositório e organização para Codespaces".

O PAT será usado para todos os modelos de pré-compilação subsequentes criados para o seu repositório. Ao contrário de outros segredos do repositório de Codespaces, o segredo CODESPACES_PREBUILD_TOKEN é usado apenas para pré-compilação e não estará disponível para uso em codespaces criados a partir do seu repositório.

Leia mais

• "Solucionar problemas de pré-compilações"