Permissões de fluxos de trabalho
100%

Integração contínua · Lição 7

Permissões de fluxos de trabalho

Aprenda a conceder a uma verificação rotineira de CI apenas o acesso ao repositório de que ela precisa.

Um job de CI pode executar comandos e também pode receber credenciais. Uma permissão determina o que essas credenciais podem ler ou alterar. Um job que só verifica a página normalmente precisa ler os arquivos de origem.

Como dar acesso de leitura à verificação

Este trecho do GitHub Actions restringe o token integrado do fluxo ao acesso de leitura ao conteúdo do repositório.

permissions:
  contents: read

O checkout e o teste local podem ler o repositório. Um job que publica um pacote precisa de permissão para outra operação em outro recurso. Dê a permissão de publicação ao job específico que precisa dela.

Um job lê a página e executa grep. Que permissão sobre o conteúdo do repositório ele precisa?

Como lidar com valores sensíveis

Um segredo é um valor como um token privado. Use o armazenamento de segredos da plataforma quando um job aprovado precisar de um. Mantenha as configurações comuns da página separadas dos segredos. Verificações rotineiras de um exemplo local devem funcionar sem credenciais de publicação.

Que valor deve ficar no armazenamento de segredos com acesso controlado?

Como manter os logs úteis

Outras pessoas podem ter acesso aos logs do fluxo. Registre a ação e seu resultado sem exibir valores secretos. Uma mensagem de falha pode indicar que faltava uma credencial obrigatória ou que o acesso foi negado. Informe o nome do job e a revisão à pessoa responsável para que ela possa investigar. Deixe o valor da credencial fora da mensagem.

Um job de publicação não consegue se autenticar. Que mensagem ajuda na investigação sem expor a credencial?

Como revisar um novo job

Uma proposta de fluxo verifica páginas em pull requests e acrescenta um job que publica um pacote. Os dois jobs precisam de permissões diferentes. Dê à verificação apenas a leitura de que precisa e reserve as permissões de publicação aprovadas para o job que publica de fato.

Que mudança na proposta atende melhor às necessidades dos dois jobs?

Lição concluída

Você concluiu Permissões de fluxos de trabalho

Agora você consegue avaliar as permissões necessárias em um pipeline de CI simples.

  • Ajuste as permissões do repositório à tarefa do job.

  • Guarde credenciais privadas em um local com acesso controlado.

  • Registre erros úteis sem exibir valores de credenciais.

Salve seu progresso

Crie uma conta gratuita para salvar esta lição e continuar em qualquer dispositivo.

Criar uma conta gratuita
Voltar para Integração contínua