Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Managing GitHub Actions settings for a repository

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

About GitHub Actions permissions for your repository

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. For more information about GitHub Actions, see "About GitHub Actions."

You can enable GitHub Actions for your repository. When you enable GitHub Actions, workflows are able to run actions located within your repository and any other public repository. You can disable GitHub Actions for your repository altogether. Quando desativar GitHub Actions, nenhum fluxo de trabalho é executado em seu repositório.

Alternatively, you can enable GitHub Actions in your repository but limit the actions a workflow can run. Ao habilitar apenas ações locais, os fluxos de trabalho só podem executar ações localizadas em seu repositório, organização ou empresa.

Managing GitHub Actions permissions for your repository

You can disable all workflows for a repository or set a policy that configures which actions can be used in a repository.

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. For example, the actions/checkout action would not be accessible.

Note: You might not be able to manage these settings if your organization has an overriding policy or is managed by an enterprise that has overriding policy. For more information, see "Disabling or limiting GitHub Actions for your organization" or "Enforcing policies for GitHub Actions in your enterprise."

  1. No GitHub.com, 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. In the left sidebar, click Actions.

  4. Under Actions permissions, select an option.

    Set actions policy for this organization

  5. Click Save.

Allowing specific actions to run

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. Ações criadas por GitHub estão localizadas em ações e nas organizações do github. Para obter mais informações, consulte as ações e organizações do github.

  • Permitir ações do Marketplace por criadores verificados: Você pode permitir que todas as ações de GitHub Marketplace criadas por criadores verificados sejam usadas por fluxos de trabalho. Quando o GitHub tiver verificado o criador da ação como uma organização parceira, o selo será exibido ao lado da ação em 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.com, 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. In the left sidebar, click Actions.

  4. Under Actions permissions, select Allow select actions and add your required actions to the list. Add actions to allow list

  5. Click Save.

Configuring required approval for workflows from public forks

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.

Nota: Fluxos de trabalho acionados por eventos de pull_request_target são executados no contexto do branch de base. Como o branc de base é considerado confiável, os fluxos de trabalho acionados por esses eventos sempre serão executados, independente das configurações de aprovação.

You can configure this behavior for a repository using the procedure below. Modifying this setting overrides the configuration set at the organization or enterprise level.

  1. No GitHub.com, 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. In the left sidebar, click Actions.

  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".

Enabling workflows for private repository forks

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 repositories only, you can configure these policy settings for organizations, or repositories.

If a policy is disabled for an organization, it cannot be enabled for a repository.

  • 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.

Configuring the private fork policy for a repository

  1. No GitHub.com, 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. In the left sidebar, click Actions.
  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.

Setting the permissions of the GITHUB_TOKEN for your repository

Você pode definir as permissões padrão concedidas ao GITHUB_TOKEN. For more information about the GITHUB_TOKEN, see "Automatic token authentication." Você pode escolher entre um conjunto restrito de permissões como padrão ou configuração permissiva.

The default permissions can also be configured in the organization settings. If the more restricted default has been selected in the organization settings, the same option is auto-selected in your repository settings and the permissive option is disabled.

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.

Configuring the default GITHUB_TOKEN permissions

  1. No GitHub.com, 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. In the left sidebar, click Actions.

  4. Under Workflow permissions, choose whether you want the GITHUB_TOKEN to have read and write access for all scopes, or just read access for the contents scope.

    Set GITHUB_TOKEN permissions for this repository

  5. Click Save to apply the settings.

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

You can configure the retention period for GitHub Actions artifacts and logs in your repository.

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.

  • For private repositories: you can change this retention period to anywhere between 1 day or 400 days.

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.

You can also define a custom retention period for a specific artifact created by a workflow. For more information, see "Setting the retention period for an artifact."

Setting the retention period for a repository

  1. No GitHub.com, 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. In the left sidebar, click Actions.
  4. Em Tempo de retenção do artefato e registro, digite um novo valor.
  5. Clique em Salvar para aplicar a alteração.