Sobre as permissões do GitHub Actions para o seu repositório
Por padrão, depois de habilitar GitHub Actions em your enterprise, este está habilitado em todos os repositórios e organizações. You can choose to disable GitHub Actions or limit it to actions in your enterprise. Para mais informações sobre GitHub Actions, consulte "Sobre GitHub Actions."
É possível habilitar o GitHub Actions para seu repositório. When you enable GitHub Actions, workflows are able to run actions located within your repository and any other internal repository. Você pode desabilitar GitHub Actions para o seu repositório completamente. 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.
Gerenciando as permissões do GitHub Actions para o seu repositório
You can disable GitHub Actions for a repository, or set a policy that configures which actions can be used in the repository.
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. Para obter mais informações, consulte "Desabilitando ou limitando GitHub Actions para a sua organização" ou "Aplicando políticas para GitHub Actions na sua empresa".
-
No your enterprise, navegue até a página principal do repositório.
-
No nome do seu repositório, clique em Configurações.
-
In the left sidebar, click Actions.
-
Em "Permissões do Actions", selecione uma opção.
If you choose Allow select actions, actions within your enterprise are allowed, and there are additional options for allowing other specific actions. For more information, see "Allowing select actions to run."
- Clique em Salvar.
Allowing select actions to run
When you choose Allow select actions, local actions are allowed, and there are additional options for allowing other specific actions:
-
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 dogithub
. Para obter mais informações, consulte asações
e organizações dogithub
. -
Permitir ações do Marketplace por criadores verificados: Esta opção está disponível se você tiver GitHub Connect habilitado e configurado com GitHub Actions. Para obter mais informações, consulte "Habilitando o acesso automático às ações do GitHub.com usando o GitHub Connect. 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.
-
Allow specified actions: You can restrict workflows to use actions in specific organizations and repositories.
To restrict access to specific tags or commit SHAs of an action, use the same syntax used in the workflow to select the action.
- For an action, the syntax is
<OWNER>/<REPO>@<TAG OR SHA>
. For example, useactions/javascript-action@v1.0.1
to select a tag oractions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89
to select a SHA. Para obter mais informações, consulte "Localizar e personalizar ações".
Você pode usar o caractere
*
curinga para corresponder aos padrões. For example, to allow all actions in organizations that start withspace-org
, you can specifyspace-org*/*
. To allow all actions in repositories that start with octocat, you can use*/octocat**@*
. Para obter mais informações sobre o uso do curinga*
, consulte "sintaxe de fluxo de trabalho para o GitHub Actions. - For an action, the syntax is
This procedure demonstrates how to add specific actions to the allow list.
-
No your enterprise, navegue até a página principal do repositório.
-
No nome do seu repositório, clique em Configurações.
-
In the left sidebar, click Actions.
-
Under "Actions permissions", select Allow select actions and add your required actions to the list.
-
Clique em Salvar.
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
. Disponível apenas para e repositórios internos de, você pode configurar essas configurações de política para sua empresa, organizações ou repositórios.
Se uma política estiver desabilitada para uma organização empresa ou, ela não poderá ser habilitada para um repositório.
- 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
- No your enterprise, navegue até a página principal do repositório.
- No nome do seu repositório, clique em Configurações.
- In the left sidebar, click Actions.
- Em Bifurcar fluxos de trabalho de pull request, selecione as suas opções. Por exemplo:
- 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
. For more information about the GITHUB_TOKEN
, see "Automatic token authentication." You can choose a restricted set of permissions as the default, or apply permissive settings.
As permissões padrão também podem ser configuradas nas configurações da organização. If your repository belongs to an organization and a more restrictive default has been selected in the organization settings, the same option is 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
.
Configurar as permissões padrão do GITHUB_TOKEN
-
No your enterprise, navegue até a página principal do repositório.
-
No nome do seu repositório, clique em Configurações.
-
In the left sidebar, click Actions.
-
Em "Permissões do fluxo de trabalho", escolha se você quer o
GITHUB_TOKEN
para ter acesso de leitura e escrita para todos os escopos, ou apenas ler acesso para o escopoconteúdo
. -
Clique em Salvar para aplicar as configurações.
Configurar o período de retenção para artefatos e registros deGitHub Actions no seu repositório
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 privados e internos: você pode alterar este período de retenção entre 1 dia ou 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
- No your enterprise, navegue até a página principal do repositório.
- No nome do seu repositório, clique em Configurações.
- In the left sidebar, click Actions.
- Under Artifact and log retention, enter a new value.
- Clique em Salvar para aplicar a alteração.