Managing GitHub Actions settings for a repository

You can disable or configure GitHub Actions for a specific repository.

Sobre as permissões do GitHub Actions para o seu repositório

Por padrão, GitHub Actions está habilitado em todos os repositórios e organizações. You can choose to disable GitHub Actions or limit them to local actions only, which means that people can only use actions that exist in your repository. Para mais informações sobre GitHub Actions, consulte "Sobre GitHub Actions."

É possível habilitar o GitHub Actions para seu repositório. Quando você habilita o GitHub Actions, os fluxos de trabalho são capazes de executar ações localizadas no repositório e em qualquer outro repositório público. Você pode desabilitar GitHub Actions para o seu repositório completamente. Quando desativar GitHub Actions, nenhum fluxo de trabalho é executado em seu repositório.

Como alternativa, você pode habilitar o GitHub Actions em seu repositório, mas limitar as ações que um fluxo de trabalho pode ser executado. Ao habilitar apenas ações locais, os fluxos de trabalho só podem executar ações localizadas em seu repositório, organização ou empresa.

Gerenciando as permissões do GitHub Actions para o seu repositório

É possível desabilitar todos os fluxos de trabalho para um repositório ou definir uma política que configura quais ações podem ser usadas em um repositório.

Se você escolher Permitir selecionar ações, ações locais são permitidas, e há opções adicionais para permitir outras ações específicas. Para obter mais informações, consulte "Permitir que ações específicas sejam executadas".

Ao permitir apenas ações locais, a política bloqueia todos os acessos a ações criadas por GitHub. Por exemplo, as ações/check-out não poderiam ser acessadas.

Nota: Talvez você não seja capaz de gerenciar essas configurações se sua organização tem uma política de substituição ou é gerenciada por uma conta corporativa que tem uma política de substituição. For more information, see "Disabling or limiting GitHub Actions for your organization" or "Enforcing GitHub Actions policies in your enterprise account."

  1. No GitHub, navegue até a página principal do repositório.
  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório
  3. Na barra lateral esquerda, clique em Actions (Ações).
  4. Em Permissões de ações, selecione uma opção. Definir política de ações para esta organização
  5. Clique em Salvar.

Permitir a execução de ações específicas

Quando você escolher Permitir selecionar ações, ações locais são permitidas, e há opções adicionais para permitir outras ações específicas:

  • Permitir ações criadas por GitHub: Você pode permitir que todas as ações criadas por GitHub sejam usadas por fluxos de trabalho. Actions created by GitHub are located in the actions and github organizations. For more information, see the actions and github organizations.

  • Allow Marketplace actions by verified creators: You can allow all GitHub Marketplace actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the badge is displayed next to the action in GitHub Marketplace.

  • Permitir ações específicas: Você pode restringir fluxos de trabalho para usar ações em organizações específicas e em repositórios.

    Para restringir o acesso a tags específicas ou commit SHAs de uma ação, use a mesma sintaxe <OWNER>/<REPO>@<TAG OR SHA> usada no fluxo de trabalho para selecionar a ação. Por exemplo, actions/javascript-action@v1.0.1 para selecionar uma tag ou actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 para selecionar um SHA. Para obter mais informações, consulte "Localizar e personalizar ações".

    Você pode usar o caractere * curinga para corresponder aos padrões. Por exemplo, para permitir todas as ações em organizações que começam com o space-org, você pode especificar space-org*/*. Para adicionar todas as ações aos repositórios que iniciam com octocat, você pode usar */octocat*@*. Para obter mais informações sobre o uso do curinga *, consulte "sintaxe de fluxo de trabalho para o GitHub Actions.

    Observação: A opção Permitir ações específicas só está disponível em repositórios públicos com o GitHub Free, GitHub Pro, GitHub Free para organizações ou plano de GitHub Team.

Este procedimento demonstra como adicionar ações específicas à lista de autorizações.

  1. No GitHub, navegue até a página principal do repositório.
  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório
  3. Na barra lateral esquerda, clique em Actions (Ações).
  4. Em Permissões de ações, selecione Permitir ações específicas e adicione as suas ações necessárias à lista. Adicionar ações para permitir lista
  5. Clique em Salvar.

Configurar a aprovação necessária para fluxos de trabalho de bifurcações públicas

Qualquer pessoa pode bifurcar um repositório público e, em seguida, enviar um pull request que proponha alterações nos fluxos de trabalho do repositório de GitHub Actions. Embora os fluxos de trabalho das bifurcações não tenham acesso a dados confidenciais como segredos, podem ser uma dor de cabeça para os mantenedores se forem modificados para fins abusivos.

Para ajudar a evitar isso, os fluxos de trabalho em pull requests para repositórios públicos de alguns contribuidores externos não serão executados automaticamente, e é possível que tenham de ser aprovados primeiro. Por padrão, todos os colaboradores iniciantes exigem aprovação para executar fluxos de trabalho.

Note: Workflows triggered by pull_request_target events are run in the context of the base branch. Since the base branch is considered trusted, workflows triggered by these events will always run, regardless of approval settings.

You can configure this behavior for a repository using the procedure below. A modificação desta configuração substitui a configuração definida no nível da organização ou empresa.

  1. No GitHub, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  3. Na barra lateral esquerda, clique em Actions (Ações).

  4. Em Bifurcar fluxos de trabalho de pull request de colaboradores externos, selecione a sua opção. As opções são listadas das menos restritivas para as mais restritivas.

    Configuração para aprovação de fluxos de trabalho das bifurcações públicas

  5. Clique em Salvar para aplicar as configurações.

Para obter mais informações sobre a aprovação de execuções de fluxo de trabalho para as quais esta política se aplica, consulte "Aprovando execuções de fluxo de trabalho a partir de bifurcações públicas".

Habilitar fluxos de trabalho para bifurcações privadas do repositório

Se você depende do uso das bifurcações dos seus repositórios privados, você pode configurar políticas que controlam como os usuários podem executar fluxos de trabalho em eventos pull_request. Available to private and internal repositories only, you can configure these policy settings for enterprises, organizations, or repositories. For enterprise accounts, the policies are applied to all repositories in all organizations.

  • Executar fluxos de trabalho de pull requests - Permite que os usuários executem fluxos de trabalho de pull requests, usando um GITHUB_TOKEN com permissão somente leitura e sem acesso a segredos.
  • Enviar tokens para fluxos de trabalho a partir de pull requests - Permite que os pull requests das bifurcações usem um GITHUB_TOKEN com permissão de gravação.
  • Envia segredos para fluxos de trabalho de pull requests - Disponibiliza todos os segredos para o pull request.

Configurar a política de bifurcação privada para um repositório

  1. No GitHub, navegue até a página principal do repositório.
  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório
  3. Na barra lateral esquerda, clique em Actions (Ações).
  4. Em Bifurcar fluxos de trabalho de pull request, selecione as suas opções. Por exemplo: Habilitar, desabilitar ou limitar ações para este repositório
  5. Clique em Salvar para aplicar as configurações.

Definir as permissões do GITHUB_TOKEN para o seu repositório

Você pode definir as permissões padrão concedidas ao GITHUB_TOKEN. Para obter mais informações sobre o GITHUB_TOKEN, consulte "Autenticação em um fluxo de trabalho". Você pode escolher entre um conjunto restrito de permissões como padrão ou configuração permissiva.

As permissões padrão também podem ser configuradas nas configurações da organização. Se o padrão mais restrito foi selecionado nas configurações da organização, a mesma opção será selecionada automaticamente nas configurações do repositório e a opção permissiva estará desabilitada.

Qualquer pessoa com acesso de gravação a um repositório pode modificar as permissões concedidas ao GITHUB_TOKEN, adicionar ou remover acesso, conforme necessário, editando a chave de permissões no arquivo do fluxo de trabalho. Para obter mais informações, consulte permissões.

Configurar as permissões padrão do GITHUB_TOKEN

  1. No GitHub, navegue até a página principal do repositório.
  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório
  3. Na barra lateral esquerda, clique em Actions (Ações).
  4. Em permissões do fluxo de trabalho, escolha se você quer que o GITHUB_TOKEN tenha acesso de leitura e gravação para todos os escopos, ou apenas acesso de leitura para o escopo do conteúdo. Definir permissões do GITHUB_TOKEN para este repositório

  5. Clique em Salvar para aplicar as configurações.

Allowing access to components in an internal repository

Observação: Os repositórios internos estão disponíveis com GitHub Enterprise Cloud e GitHub Enterprise Server 2.20+. Para obter mais informações, consulte os "Produtos do GitHub".

Members of your enterprise can use internal repositories to work on projects without sharing information publicly. For information, see "About repositories."

To configure whether workflows in an internal repository can be accessed from outside the repository:

  1. On GitHub, navigate to the main page of the internal repository.
  2. Under your repository name, click Settings.

    1. Na barra lateral esquerda, clique em **Actions** (Ações).

  3. Under Access, choose one of the access settings: Set the access to Actions components

  • Not accessible - Workflows in other repositories can't use workflows in this repository.
  • Accessible by any repository in the organization - Workflows in other repositories can use workflows in this repository as long as they are part of the same organization.
  • Accessible by any repository in the enterprise - Workflows in other repositories can use workflows in this repository as long as they are part of the same enterprise.
    1. Clique em Salvar para aplicar as configurações.

Configuring the retention period for GitHub Actions artifacts and logs in your repository

Você pode configurar o período de retenção para artefatos e registros de GitHub Actions no seu repositório.

Por padrão, os artefatos e arquivos de registro gerados pelos fluxos de trabalho são mantidos por 90 dias antes de ser excluídos automaticamente. É possível ajustar o período de retenção dependendo do tipo de repositório:

  • Para repositórios públicos: você pode alterar este período de retenção para qualquer lugar entre 1 dia e 90 dias.
  • Para repositórios privados, internos e GitHub Enterprise Server: você pode alterar este período de retenção para qualquer período entre 1 e 400 dias.

Ao personalizar o período de retenção, ele só se aplica a novos artefatos e arquivos de registro e não se aplica retroativamente aos objetos existentes. Para repositórios e organizações gerenciadas, o período máximo de retenção não pode exceder o limite definido pela organização gerenciadora ou pela empresa.

Você também pode definir um período de retenção personalizado para um artefato específico criado por um fluxo de trabalho. Para obter mais informações, consulte "Definir o período de retenção para um artefato".

Definir o período de retenção para um repositório

1. No GitHub, navegue até a página principal do repositório.

1. No nome do seu repositório, clique em **Configurações**. ![Botão de configurações do repositório](/assets/images/help/repository/repo-actions-settings.png)

1. Na barra lateral esquerda, clique em **Actions** (Ações).

1. Em **Tempo de retenção do artefato e registro**, digite um novo valor. 1. Clique em **Salvar** para aplicar a alteração.

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.