New translation batch for pt (#25724)
* Add crowdin translations * Run script/i18n/homogenize-frontmatter.js * Run script/i18n/fix-translation-errors.js * Run script/i18n/lint-translation-files.js --check parsing * run script/i18n/reset-files-with-broken-liquid-tags.js --language=pt * run script/i18n/reset-known-broken-translation-files.js * Check in pt CSV report Co-authored-by: Peter Bengtsson <mail@peterbe.com>
This commit is contained in:
docubot
@@ -40,7 +40,6 @@ translations/pt-BR/content/packages/working-with-a-github-packages-registry/work
|
||||
translations/pt-BR/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md,broken liquid tags
|
||||
translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md,parsing error
|
||||
translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository.md,broken liquid tags
|
||||
translations/pt-BR/content/rest/reference/activity.md,broken liquid tags
|
||||
translations/pt-BR/content/rest/reference/enterprise-admin.md,Listed in localization-support#489
|
||||
translations/pt-BR/content/rest/reference/enterprise-admin.md,broken liquid tags
|
||||
translations/pt-BR/content/rest/reference/gists.md,Listed in localization-support#489
|
||||
@@ -55,8 +54,6 @@ translations/pt-BR/data/reusables/code-scanning/edit-workflow.md,broken liquid t
|
||||
translations/pt-BR/data/reusables/dashboard/access-org-dashboard.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/enterprise_management_console/badge_indicator.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/enterprise_site_admin_settings/business.md,Listed in localization-support#489
|
||||
translations/pt-BR/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md,Listed in localization-support#489
|
||||
translations/pt-BR/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md,Listed in localization-support#489
|
||||
translations/pt-BR/data/reusables/github-connect/send-contribution-counts-to-githubcom.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/package_registry/authenticate-packages.md,broken liquid tags
|
||||
translations/pt-BR/data/reusables/pages/decide-publishing-source.md,Listed in localization-support#489
|
||||
@@ -66,3 +63,4 @@ translations/pt-BR/data/reusables/repositories/deleted_forks_from_private_reposi
|
||||
translations/pt-BR/data/reusables/repositories/security-alerts-x-github-severity.md,Listed in localization-support#489
|
||||
translations/pt-BR/data/reusables/repositories/squash-and-rebase-linear-commit-hisitory.md,Listed in localization-support#489
|
||||
translations/pt-BR/data/reusables/repositories/suggest-changes.md,Listed in localization-support#489
|
||||
translations/pt-BR/data/reusables/rest-reference/activity/events.md,broken liquid tags
|
||||
|
||||
|
@@ -78,9 +78,9 @@ Este fluxo de trabalho executa os seguintes passos:
|
||||
|
||||
Os fluxos de trabalho inicial padrão são excelentes pontos de partida ao criar seu fluxo de trabalho de criação e teste, e você pode personalizar o fluxo de trabalho inicial para atender às necessidades do seu projeto.
|
||||
|
||||
{% data reusables.github-actions.example-github-runner %}
|
||||
{% data reusables.actions.example-github-runner %}
|
||||
|
||||
{% data reusables.github-actions.java-jvm-architecture %}
|
||||
{% data reusables.actions.java-jvm-architecture %}
|
||||
|
||||
## Criar e testar seu código
|
||||
|
||||
|
||||
@@ -83,9 +83,9 @@ Este fluxo de trabalho executa os seguintes passos:
|
||||
|
||||
Os fluxos de trabalho inicial padrão são excelentes pontos de partida ao criar seu fluxo de trabalho de criação e teste, e você pode personalizar o fluxo de trabalho inicial para atender às necessidades do seu projeto.
|
||||
|
||||
{% data reusables.github-actions.example-github-runner %}
|
||||
{% data reusables.actions.example-github-runner %}
|
||||
|
||||
{% data reusables.github-actions.java-jvm-architecture %}
|
||||
{% data reusables.actions.java-jvm-architecture %}
|
||||
|
||||
## Criar e testar seu código
|
||||
|
||||
|
||||
@@ -78,9 +78,9 @@ Este fluxo de trabalho executa os seguintes passos:
|
||||
|
||||
Os fluxos de trabalho inicial padrão são excelentes pontos de partida ao criar seu fluxo de trabalho de criação e teste, e você pode personalizar o fluxo de trabalho inicial para atender às necessidades do seu projeto.
|
||||
|
||||
{% data reusables.github-actions.example-github-runner %}
|
||||
{% data reusables.actions.example-github-runner %}
|
||||
|
||||
{% data reusables.github-actions.java-jvm-architecture %}
|
||||
{% data reusables.actions.java-jvm-architecture %}
|
||||
|
||||
## Criar e testar seu código
|
||||
|
||||
|
||||
@@ -73,7 +73,7 @@ jobs:
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
{% data reusables.github-actions.example-github-runner %}
|
||||
{% data reusables.actions.example-github-runner %}
|
||||
|
||||
## Especificar a versão do Node.js
|
||||
|
||||
@@ -204,7 +204,7 @@ steps:
|
||||
|
||||
### Exemplo do uso de um registro privado e de criação o arquivo .npmrc
|
||||
|
||||
{% data reusables.github-actions.setup-node-intro %}
|
||||
{% data reusables.actions.setup-node-intro %}
|
||||
|
||||
Para efetuar a autenticação com seu registro privado, você precisará armazenar seu token de autenticação npm como um segredo. Por exemplo, crie um repositório secreto denominado `NPM_TOKEN`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ Para obter uma lista completa das versões Xamarin SDK disponíveis nos executor
|
||||
* [macOS 10.15](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-10.15-Readme.md#xamarin-bundles)
|
||||
* [macOS 11](https://github.com/actions/virtual-environments/blob/main/images/macos/macos-11-Readme.md#xamarin-bundles)
|
||||
|
||||
{% data reusables.github-actions.macos-runner-preview %}
|
||||
{% data reusables.actions.macos-runner-preview %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
|
||||
@@ -47,13 +47,13 @@ Os contêineres Docker criam um pacote do ambiente com o código {% data variabl
|
||||
|
||||
Um contêiner Docker permite usar versões específicas de um sistema operacional, bem como as dependências, as ferramentas e o código. Para ações a serem executadas em uma configuração específica de ambiente, o Docker é a opção ideal porque permite personalizar o sistema operacional e as ferramentas. Por causa da latência para compilar e recuperar o contêiner, as ações de contêiner Docker são mais lentas que as ações JavaScripts.
|
||||
|
||||
As ações do contêiner Docker podem apenas ser executadas em executores com o sistema operacional Linux. {% data reusables.github-actions.self-hosted-runner-reqs-docker %}
|
||||
As ações do contêiner Docker podem apenas ser executadas em executores com o sistema operacional Linux. {% data reusables.actions.self-hosted-runner-reqs-docker %}
|
||||
|
||||
### Ações JavaScript
|
||||
|
||||
As ações do JavaScript podem ser executadas diretamente em uma máquina executora e separar o código de ação do ambiente usado para executar o código. Usar ações JavaScript simplifica o código da ação e é um processo mais rápido se comparado à opção do contêiner Docker.
|
||||
|
||||
{% data reusables.github-actions.pure-javascript %}
|
||||
{% data reusables.actions.pure-javascript %}
|
||||
|
||||
Se você estiver desenvolvendo um projeto Node.js, o kit de ferramentas {% data variables.product.prodname_actions %} fornecerá pacotes que você poderá usar para acelerar o desenvolvimento. Para obter mais informações, consulte o repositório [ações/conjuntos de ferramentas](https://github.com/actions/toolkit).
|
||||
|
||||
|
||||
@@ -23,7 +23,7 @@ Neste guia, você aprenderá os componentes básicos necessários para criar e u
|
||||
|
||||
Ao concluir este projeto, você entenderá como criar a sua própria ação composta e testá-la em um fluxo de trabalho.
|
||||
|
||||
{% data reusables.github-actions.context-injection-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
|
||||
@@ -27,9 +27,9 @@ Neste guia, você aprenderá os componentes básicos necessários para criar e u
|
||||
|
||||
Ao terminar esse projeto, você entenderá como criar sua própria ação de contêiner Docker e poderá testá-la em um fluxo de trabalho.
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-reqs-docker %}
|
||||
{% data reusables.actions.self-hosted-runner-reqs-docker %}
|
||||
|
||||
{% data reusables.github-actions.context-injection-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
|
||||
@@ -29,9 +29,9 @@ Este guia usa o módulo Node.js do kit de ferramentas {% data variables.product.
|
||||
|
||||
Ao terminar esse projeto, você entenderá como criar sua própria ação JavaScript e poderá testá-la em um fluxo de trabalho.
|
||||
|
||||
{% data reusables.github-actions.pure-javascript %}
|
||||
{% data reusables.actions.pure-javascript %}
|
||||
|
||||
{% data reusables.github-actions.context-injection-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
|
||||
@@ -105,7 +105,7 @@ Se você definir os `args` no arquivo de metadados da ação, os `args` irão su
|
||||
|
||||
Se você usar `CMD` no seu `arquivo Docker`, siga essas diretrizes:
|
||||
|
||||
{% data reusables.github-actions.dockerfile-guidelines %}
|
||||
{% data reusables.actions.dockerfile-guidelines %}
|
||||
|
||||
## Recursos compatíveis com o Linux
|
||||
|
||||
|
||||
@@ -272,7 +272,7 @@ Para obter mais informações, consulte "[`github context`](/actions/reference/c
|
||||
|
||||
**Opcional** Você pode usar o `if` condicional para evitar que uma etapa seja executada, a menos que uma condição seja atendida. Você pode usar qualquer contexto e expressão compatível para criar uma condicional.
|
||||
|
||||
{% data reusables.github-actions.expression-syntax-if %} Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions)".
|
||||
{% data reusables.actions.expression-syntax-if %} Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions)".
|
||||
|
||||
**Exemplo: Usando contextos**
|
||||
|
||||
@@ -441,7 +441,7 @@ runs:
|
||||
|
||||
`args` são usados em substituição à instrução `CMD` em um `Dockerfile`. Se você usar `CMD` no `Dockerfile`, use as diretrizes ordenadas por preferência:
|
||||
|
||||
{% data reusables.github-actions.dockerfile-guidelines %}
|
||||
{% data reusables.actions.dockerfile-guidelines %}
|
||||
|
||||
Se você precisar passar variáveis de ambiente para uma ação, certifique-se de que sua ação executa um shell de comando para realizar a substituição de variáveis. Por exemplo, se seu atributo `entrypoint` é definido como `"sh -c"`, os `args` serão executados em um terminal de comando. Como alternativa, se o seu `arquivo Docker` usar um `Entrypoint` para executar o mesmo comando (`"sh-c"`), os `Args` serão executado em um shell de comando.
|
||||
|
||||
|
||||
@@ -69,13 +69,13 @@ Os segredos armazenados em um ambiente só estão disponíveis para trabalhos de
|
||||
|
||||
## Criar um ambiente
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-environment %}
|
||||
{% data reusables.actions.permissions-statement-environment %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.sidebar-environment %}
|
||||
{% data reusables.github-actions.new-environment %}
|
||||
{% data reusables.github-actions.name-environment %}
|
||||
{% data reusables.actions.sidebar-environment %}
|
||||
{% data reusables.actions.new-environment %}
|
||||
{% data reusables.actions.name-environment %}
|
||||
1. Opcionalmente, especifique as pessoas ou equipes que devem aprovar os trabalhos do fluxo de trabalho que usam esse ambiente.
|
||||
1. Selecione **Revisores necessários**.
|
||||
1. Insira até até 6 pessoas ou equipes. Apenas um dos revisores precisam aprovar o trabalho para que prossiga.
|
||||
@@ -107,13 +107,13 @@ Quando um fluxo de trabalho faz referência a um ambiente, o ambiente aparecerá
|
||||
|
||||
## Excluir um ambiente
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-environment %}
|
||||
{% data reusables.actions.permissions-statement-environment %}
|
||||
|
||||
A exclusão de um ambiente apagará todos os segredos e regras de proteção associados ao ambiente. Todos os trabalhos que estejam atualmente em espera devido às regras de proteção do ambiente eliminado falharão automaticamente.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.sidebar-environment %}
|
||||
{% data reusables.actions.sidebar-environment %}
|
||||
1. Ao lado do ambiente que você deseja excluir, clique em {% octicon "trash" aria-label="The trash icon" %}.
|
||||
2. Clique em **Eu entendi, exclua este ambiente**.
|
||||
|
||||
|
||||
@@ -18,25 +18,25 @@ type: overview
|
||||
|
||||
## About self-hosted runners
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-description %} Self-hosted runners can be physical, virtual, in a container, on-premises, or in a cloud.
|
||||
{% data reusables.actions.self-hosted-runner-description %} Self-hosted runners can be physical, virtual, in a container, on-premises, or in a cloud.
|
||||
|
||||
You can add self-hosted runners at various levels in the management hierarchy:
|
||||
- Repository-level runners are dedicated to a single repository.
|
||||
- Organization-level runners can process jobs for multiple repositories in an organization.
|
||||
- Enterprise-level runners can be assigned to multiple organizations in an enterprise account.
|
||||
|
||||
Your runner machine connects to {% data variables.product.product_name %} using the {% data variables.product.prodname_actions %} self-hosted runner application. {% data reusables.github-actions.runner-app-open-source %} When a new version is released, the runner application automatically updates itself when a job is assigned to the runner, or within a week of release if the runner hasn't been assigned any jobs.
|
||||
Your runner machine connects to {% data variables.product.product_name %} using the {% data variables.product.prodname_actions %} self-hosted runner application. {% data reusables.actions.runner-app-open-source %} When a new version is released, the runner application automatically updates itself when a job is assigned to the runner, or within a week of release if the runner hasn't been assigned any jobs.
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-auto-removal %}
|
||||
{% data reusables.actions.self-hosted-runner-auto-removal %}
|
||||
|
||||
For more information about installing and using self-hosted runners, see "[Adding self-hosted runners](/github/automating-your-workflow-with-github-actions/adding-self-hosted-runners)" and "[Using self-hosted runners in a workflow](/github/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)."
|
||||
|
||||
## {% ifversion fpt or ghes %}Differences between {% data variables.product.prodname_dotcom %}-hosted and {% elsif ghae %}Characteristics of {% endif %}self-hosted runners
|
||||
## {% ifversion fpt or ghec or ghes %}Differences between {% data variables.product.prodname_dotcom %}-hosted and {% elsif ghae %}Characteristics of {% endif %}self-hosted runners
|
||||
|
||||
{% ifversion fpt or ghes %}
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
{% data variables.product.prodname_dotcom %}-hosted runners offer a quicker, simpler way to run your workflows, while self-hosted{% elsif ghae %}Self-hosted{% endif %} runners are a highly configurable way to run workflows in your own custom environment. {% ifversion ghae %}Self-hosted runners:{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes %}
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
**{% data variables.product.prodname_dotcom %}-hosted runners:**
|
||||
- Receive automatic updates for the operating system, preinstalled packages and tools, and the self-hosted runner application.
|
||||
- Are managed and maintained by {% data variables.product.prodname_dotcom %}.
|
||||
@@ -70,15 +70,15 @@ You can automatically increase or decrease the number of self-hosted runners in
|
||||
|
||||
There are some limits on {% data variables.product.prodname_actions %} usage when using self-hosted runners. These limits are subject to change.
|
||||
|
||||
{% data reusables.github-actions.usage-workflow-run-time %}
|
||||
{% data reusables.actions.usage-workflow-run-time %}
|
||||
- **Job queue time** - Each job for self-hosted runners can be queued for a maximum of 24 hours. If a self-hosted runner does not start executing the job within this limit, the job is terminated and fails to complete.
|
||||
{% data reusables.github-actions.usage-api-requests %}
|
||||
- **Job matrix** - {% data reusables.github-actions.usage-matrix-limits %}
|
||||
{% data reusables.github-actions.usage-workflow-queue-limits %}
|
||||
{% data reusables.actions.usage-api-requests %}
|
||||
- **Job matrix** - {% data reusables.actions.usage-matrix-limits %}
|
||||
{% data reusables.actions.usage-workflow-queue-limits %}
|
||||
|
||||
## Workflow continuity for self-hosted runners
|
||||
|
||||
{% data reusables.github-actions.runner-workflow-continuity %}
|
||||
{% data reusables.actions.runner-workflow-continuity %}
|
||||
|
||||
## Supported architectures and operating systems for self-hosted runners
|
||||
|
||||
@@ -224,7 +224,7 @@ codeload.github.com
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-security %}
|
||||
{% data reusables.actions.self-hosted-runner-security %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -26,7 +26,7 @@ For information on supported operating systems for self-hosted runners, or using
|
||||
{% ifversion not ghae %}
|
||||
{% warning %}
|
||||
|
||||
**Warning:** {% data reusables.github-actions.self-hosted-runner-security %}
|
||||
**Warning:** {% data reusables.actions.self-hosted-runner-security %}
|
||||
|
||||
For more information, see "[About self-hosted runners](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
|
||||
|
||||
@@ -40,18 +40,18 @@ You can add self-hosted runners to a single repository. To add a self-hosted run
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners-updated %}
|
||||
1. Click **New self-hosted runner**.
|
||||
{% data reusables.github-actions.self-hosted-runner-configure %}
|
||||
{% data reusables.actions.self-hosted-runner-configure %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners %}
|
||||
1. Under {% ifversion ghes > 3.1 or ghae or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}, click **Add runner**.
|
||||
{% data reusables.github-actions.self-hosted-runner-configure %}
|
||||
{% data reusables.actions.self-hosted-runner-configure %}
|
||||
{% endif %}
|
||||
{% data reusables.github-actions.self-hosted-runner-check-installation-success %}
|
||||
{% data reusables.actions.self-hosted-runner-check-installation-success %}
|
||||
|
||||
## Adding a self-hosted runner to an organization
|
||||
|
||||
@@ -60,21 +60,21 @@ You can add self-hosted runners at the organization level, where they can be use
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners-updated %}
|
||||
1. Click **New runner**.
|
||||
{% data reusables.github-actions.self-hosted-runner-configure %}
|
||||
{% data reusables.actions.self-hosted-runner-configure %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners %}
|
||||
1. Under {% ifversion ghes > 3.1 or ghae %}"Runners", click **Add new**, then click **New runner**.{% elsif ghes < 3.2 %}"Self-hosted runners", click **Add runner**."{% endif %}
|
||||
{% data reusables.github-actions.self-hosted-runner-configure %}
|
||||
{% data reusables.actions.self-hosted-runner-configure %}
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-check-installation-success %}
|
||||
{% data reusables.actions.self-hosted-runner-check-installation-success %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-public-repo-access %}
|
||||
{% data reusables.actions.self-hosted-runner-public-repo-access %}
|
||||
|
||||
## Adding a self-hosted runner to an enterprise
|
||||
|
||||
@@ -92,7 +92,7 @@ To add a self-hosted runner to an enterprise account, you must be an enterprise
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-runners-tab %}
|
||||
1. Click **New runner**.
|
||||
{% data reusables.github-actions.self-hosted-runner-configure %}
|
||||
{% data reusables.actions.self-hosted-runner-configure %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
To add a self-hosted runner at the enterprise level of {% data variables.product.product_location %}, you must be a site administrator.
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
@@ -100,11 +100,11 @@ To add a self-hosted runner at the enterprise level of {% data variables.product
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-runners-tab %}
|
||||
1. Click **Add new**, then click **New runner**.
|
||||
{% data reusables.github-actions.self-hosted-runner-configure %}
|
||||
{% data reusables.actions.self-hosted-runner-configure %}
|
||||
{% endif %}
|
||||
{% data reusables.github-actions.self-hosted-runner-check-installation-success %}
|
||||
{% data reusables.actions.self-hosted-runner-check-installation-success %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-public-repo-access %}
|
||||
{% data reusables.actions.self-hosted-runner-public-repo-access %}
|
||||
|
||||
### Making enterprise runners available to repositories
|
||||
|
||||
|
||||
@@ -49,22 +49,22 @@ Ao criar um grupo, você deverá escolher uma política que defina quais reposit
|
||||
{% ifversion ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-groups %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-groups %}
|
||||
1. Na seção "Grupos de executores", clique em **Novo grupo de executor**.
|
||||
{% data reusables.github-actions.runner-group-assign-policy-repo %}
|
||||
{% data reusables.actions.runner-group-assign-policy-repo %}
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Aviso**: {% indented_data_reference reusables.github-actions.self-hosted-runner-security spaces=3 %}
|
||||
**Aviso**: {% indented_data_reference reusables.actions.self-hosted-runner-security spaces=3 %}
|
||||
|
||||
Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
|
||||
|
||||
{% endwarning %}
|
||||
{% data reusables.github-actions.self-hosted-runner-create-group %}
|
||||
{% data reusables.actions.self-hosted-runner-create-group %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners %}
|
||||
1. Em {% ifversion ghes > 3.1 or ghae %}"Executores"{% elsif ghes < 3.2 %}"Executores auto-hospedados"{% endif %}, clique em **Adicionar novo** e, em seguida, **Novo grupo**.
|
||||
|
||||
|
||||
@@ -76,7 +76,7 @@ Ao criar um grupo, você deverá escolher uma política que defina quais reposit
|
||||
|
||||
**Aviso**
|
||||
|
||||
{% indented_data_reference reusables.github-actions.self-hosted-runner-security spaces=3 %}
|
||||
{% indented_data_reference reusables.actions.self-hosted-runner-security spaces=3 %}
|
||||
|
||||
Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
|
||||
|
||||
@@ -100,18 +100,18 @@ Ao criar um grupo, você deve escolher uma política que defina quais organizaç
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-runner-groups-tab %}
|
||||
1. Clique em **Novo grupo de executores**.
|
||||
{% data reusables.github-actions.runner-group-assign-policy-org %}
|
||||
{% data reusables.actions.runner-group-assign-policy-org %}
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Aviso**
|
||||
|
||||
{% indented_data_reference reusables.github-actions.self-hosted-runner-security spaces=3 %}
|
||||
{% indented_data_reference reusables.actions.self-hosted-runner-security spaces=3 %}
|
||||
|
||||
Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
|
||||
|
||||
{% endwarning %}
|
||||
{% data reusables.github-actions.self-hosted-runner-create-group %}
|
||||
{% data reusables.actions.self-hosted-runner-create-group %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
@@ -128,7 +128,7 @@ Ao criar um grupo, você deve escolher uma política que defina quais organizaç
|
||||
|
||||
**Aviso**
|
||||
|
||||
{% indented_data_reference reusables.github-actions.self-hosted-runner-security spaces=3 %}
|
||||
{% indented_data_reference reusables.actions.self-hosted-runner-security spaces=3 %}
|
||||
|
||||
Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
|
||||
|
||||
@@ -143,21 +143,21 @@ Ao criar um grupo, você deve escolher uma política que defina quais organizaç
|
||||
|
||||
Você pode atualizar a política de acesso de um grupo de executores ou renomear um grupo de executores.
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-groups-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-groups-selection %}
|
||||
{% data reusables.actions.self-hosted-runner-groups-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-groups-selection %}
|
||||
1. Modifique as opções de acesso ou altere o nome do grupo dp executor.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Aviso**
|
||||
|
||||
{% indented_data_reference reusables.github-actions.self-hosted-runner-security spaces=3 %}
|
||||
{% indented_data_reference reusables.actions.self-hosted-runner-security spaces=3 %}
|
||||
|
||||
Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)."
|
||||
|
||||
{% endwarning %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-configure-runner-group-access %}
|
||||
{% data reusables.actions.self-hosted-runner-configure-runner-group-access %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
@@ -179,7 +179,7 @@ Não foi possível encontrar nenhum grupo de executor auto-hospedado denominado
|
||||
|
||||
Se você não especificar o grupo de um executor durante o processo de registro, seus novos executores auto-hospedados são automaticamente atribuídos ao grupo padrão e poderão ser transferidos para outro grupo.
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-org-enterprise %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-org-enterprise %}
|
||||
{% ifversion ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
1. Na lista de "Executores", clique no executor que você deseja configurar.
|
||||
2. Selecione o menu suspenso do grupo do executor.
|
||||
@@ -195,7 +195,7 @@ Se você não especificar o grupo de um executor durante o processo de registro,
|
||||
Os executores auto-hospedados são retornados automaticamente ao grupo-padrão quando seu grupo é removido.
|
||||
|
||||
{% ifversion ghes > 3.1 or ghae or ghec %}
|
||||
{% data reusables.github-actions.self-hosted-runner-groups-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.self-hosted-runner-groups-navigate-to-repo-org-enterprise %}
|
||||
1. Na lista de grupos, à direita do grupo que você deseja excluir, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}.
|
||||
2. Para remover o grupo, clique em **Remover grupo**.
|
||||
3. Revise os avisos de confirmação e, em seguida, clique em **Remover este grupo de executores**.
|
||||
|
||||
@@ -21,10 +21,10 @@ shortTitle: Monitor & troubleshoot
|
||||
|
||||
## Checking the status of a self-hosted runner
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-management-permissions-required %}
|
||||
{% data reusables.actions.self-hosted-runner-management-permissions-required %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-repo-and-org %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-repo-and-org %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners %}
|
||||
1. Under {% ifversion fpt or ghes > 3.1 or ghae or ghec %}"Runners"{% else %}"Self-hosted runners"{% endif %}, you can view a list of registered runners, including the runner's name, labels, and status.
|
||||
|
||||
The status can be one of the following:
|
||||
@@ -46,12 +46,12 @@ For example:
|
||||
|
||||
{% mac %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-check-mac-linux %}
|
||||
{% data reusables.actions.self-hosted-runner-check-mac-linux %}
|
||||
|
||||
{% endmac %}
|
||||
{% linux %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-check-mac-linux %}
|
||||
{% data reusables.actions.self-hosted-runner-check-mac-linux %}
|
||||
|
||||
{% endlinux %}
|
||||
{% windows %}
|
||||
|
||||
@@ -21,54 +21,54 @@ shortTitle: Remover executores auto-hospedados
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.self-hosted-runner-removal-impact %}
|
||||
**Observação:** {% data reusables.actions.self-hosted-runner-removal-impact %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-auto-removal %}
|
||||
{% data reusables.actions.self-hosted-runner-auto-removal %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Para remover um executor auto-hospedado de um repositório de usuário, você deve ser o proprietário do repositório. Para um repositório da organização, você deve ser um proprietário da organização ou ter acesso de administrador ao repositório. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado. Para obter informações sobre como remover um executor auto-hospedado com a API REST, consulte "[Executores auto-hospedados](/rest/reference/actions#self-hosted-runners)."
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-reusing %}
|
||||
{% data reusables.actions.self-hosted-runner-reusing %}
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners-updated %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.github-actions.self-hosted-runner-removing-a-runner-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.actions.self-hosted-runner-removing-a-runner-updated %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.github-actions.self-hosted-runner-removing-a-runner %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.actions.self-hosted-runner-removing-a-runner %}
|
||||
{% endif %}
|
||||
|
||||
## Remover um executor de uma organização
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.self-hosted-runner-removal-impact %}
|
||||
**Observação:** {% data reusables.actions.self-hosted-runner-removal-impact %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-auto-removal %}
|
||||
{% data reusables.actions.self-hosted-runner-auto-removal %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Para remover um executor auto-hospedado de uma organização, você deve ser um proprietário da organização. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado. Para obter informações sobre como remover um executor auto-hospedado com a API REST, consulte "[Executores auto-hospedados](/rest/reference/actions#self-hosted-runners)."
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-reusing %}
|
||||
{% data reusables.actions.self-hosted-runner-reusing %}
|
||||
{% ifversion fpt or ghes > 3.3 or ghec %}
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners-updated %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.github-actions.self-hosted-runner-removing-a-runner-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.actions.self-hosted-runner-removing-a-runner-updated %}
|
||||
{% elsif ghes < 3.4 or ghae %}
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.github-actions.self-hosted-runner-removing-a-runner %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runners %}
|
||||
{% data reusables.actions.self-hosted-runner-removing-a-runner %}
|
||||
{% endif %}
|
||||
|
||||
## Remover um executor de uma empresa
|
||||
@@ -80,27 +80,27 @@ Se você usar
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.self-hosted-runner-removal-impact %}
|
||||
**Observação:** {% data reusables.actions.self-hosted-runner-removal-impact %}
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-auto-removal %}
|
||||
{% data reusables.actions.self-hosted-runner-auto-removal %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Para remover um executor auto-hospedado de uma empresa, você deverá ser um proprietário corporativo. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado. Para obter informações sobre como remover um executor auto-hospedado com a API REST, consulte os pontos de extremidade corporativos na [API REST de {% data variables.product.prodname_actions %}](/rest/reference/actions#self-hosted-runners).
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-reusing %}
|
||||
{% data reusables.actions.self-hosted-runner-reusing %}
|
||||
{% ifversion ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-runners-tab %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.github-actions.self-hosted-runner-removing-a-runner-updated %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.actions.self-hosted-runner-removing-a-runner-updated %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-runners-tab %}
|
||||
{% data reusables.github-actions.self-hosted-runner-removing-a-runner %}
|
||||
{% data reusables.actions.self-hosted-runner-removing-a-runner %}
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
|
||||
@@ -16,54 +16,54 @@ shortTitle: Executores de etiqueta
|
||||
|
||||
Para obter informações sobre como usar etiquetas para encaminhar trabalhos para tipos específicos de executores auto-hospedados, consulte "[Usando executores auto-hospedados em um fluxo de trabalho](/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow)."
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-management-permissions-required %}
|
||||
{% data reusables.actions.self-hosted-runner-management-permissions-required %}
|
||||
|
||||
## Criar etiquetas personalizadas
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-selection %}
|
||||
1. Na seção "Etiquetas", clique em {% octicon "gear" aria-label="The Gear icon" %}.
|
||||
1. No campo "Encontrar ou criar uma etiqueta", digite o nome da sua nova etiqueta e clique em **Criar nova etiqueta**. O rótulo personalizado é criado e atribuído ao executor auto-hospedado. É possível remover as etiquetas personalizadas dos executores auto-hospedados, mas não é possível excluí-las manualmente. {% data reusables.github-actions.actions-unused-labels %}
|
||||
1. No campo "Encontrar ou criar uma etiqueta", digite o nome da sua nova etiqueta e clique em **Criar nova etiqueta**. O rótulo personalizado é criado e atribuído ao executor auto-hospedado. É possível remover as etiquetas personalizadas dos executores auto-hospedados, mas não é possível excluí-las manualmente. {% data reusables.actions.actions-unused-labels %}
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.self-hosted-runner-list %}
|
||||
{% data reusables.github-actions.self-hosted-runner-list-group %}
|
||||
{% data reusables.github-actions.self-hosted-runner-labels-view-assigned-labels %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.self-hosted-runner-list %}
|
||||
{% data reusables.actions.self-hosted-runner-list-group %}
|
||||
{% data reusables.actions.self-hosted-runner-labels-view-assigned-labels %}
|
||||
1. No campo "Filtrar etiquetas", digite o nome da sua nova etiqueta e clique em **Criar nova etiqueta**. 
|
||||
|
||||
O rótulo personalizado é criado e atribuído ao executor auto-hospedado. É possível remover as etiquetas personalizadas dos executores auto-hospedados, mas não é possível excluí-las manualmente. {% data reusables.github-actions.actions-unused-labels %}
|
||||
O rótulo personalizado é criado e atribuído ao executor auto-hospedado. É possível remover as etiquetas personalizadas dos executores auto-hospedados, mas não é possível excluí-las manualmente. {% data reusables.actions.actions-unused-labels %}
|
||||
{% endif %}
|
||||
|
||||
## Atribuir uma etiqueta a um executor auto-hospedado
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.github-actions.runner-label-settings %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.actions.runner-label-settings %}
|
||||
1. Para atribuir uma etiqueta ao executor auto-hospedado, no campo "Localizar ou criar uma etiqueta", clique na etiqueta.
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.self-hosted-runner-list %}
|
||||
{% data reusables.github-actions.self-hosted-runner-list-group %}
|
||||
{% data reusables.github-actions.self-hosted-runner-labels-view-assigned-labels %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.self-hosted-runner-list %}
|
||||
{% data reusables.actions.self-hosted-runner-list-group %}
|
||||
{% data reusables.actions.self-hosted-runner-labels-view-assigned-labels %}
|
||||
1. Clique em uma etiqueta a ser atribuída ao seu executor auto-hospedado.
|
||||
{% endif %}
|
||||
|
||||
## Remover uma etiqueta personalizada de um executor auto-hospedado
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5091 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.github-actions.runner-label-settings %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.settings-sidebar-actions-runner-selection %}
|
||||
{% data reusables.actions.runner-label-settings %}
|
||||
1. No campo "Encontre ou crie uma etiqueta", as etiquetas atribuídas são marcadas com a
|
||||
Ícone de {% octicon "check" aria-label="The Check icon" %}. Clique em uma etiqueta marcada para cancelar a atribuição do seu executor auto-hospedado.
|
||||
{% elsif ghae or ghes < 3.4 %}
|
||||
{% data reusables.github-actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.self-hosted-runner-list %}
|
||||
{% data reusables.github-actions.self-hosted-runner-list-group %}
|
||||
{% data reusables.github-actions.self-hosted-runner-labels-view-assigned-labels %}
|
||||
1. Clique na etiqueta atribuída para removê-la do seu executor auto-hospedado. {% data reusables.github-actions.actions-unused-labels %}
|
||||
{% data reusables.actions.self-hosted-runner-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.self-hosted-runner-list %}
|
||||
{% data reusables.actions.self-hosted-runner-list-group %}
|
||||
{% data reusables.actions.self-hosted-runner-labels-view-assigned-labels %}
|
||||
1. Clique na etiqueta atribuída para removê-la do seu executor auto-hospedado. {% data reusables.actions.actions-unused-labels %}
|
||||
{% endif %}
|
||||
|
||||
## Usar o script de configuração para criar e atribuir rótulos
|
||||
|
||||
@@ -23,7 +23,7 @@ For information on creating custom and default labels, see "[Using labels with s
|
||||
|
||||
Labels allow you to send workflow jobs to specific types of self-hosted runners, based on their shared characteristics. For example, if your job requires a particular hardware component or software package, you can assign a custom label to a runner and then configure your job to only execute on runners with that label.
|
||||
|
||||
{% data reusables.github-actions.self-hosted-runner-labels-runs-on %}
|
||||
{% data reusables.actions.self-hosted-runner-labels-runs-on %}
|
||||
|
||||
For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)."
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ Você pode acessar contextos usando a sintaxe da expressão. Para obter mais inf
|
||||
`${{ <context> }}`
|
||||
{% endraw %}
|
||||
|
||||
{% data reusables.github-actions.context-injection-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
| Nome do contexto | Tipo | Descrição |
|
||||
| ---------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
@@ -59,7 +59,7 @@ Para usar a sintaxe de propriedade de desreferência, o nome da propriedade deve
|
||||
|
||||
### Determinar quando usar contextos
|
||||
|
||||
{% data reusables.github-actions.using-context-or-environment-variables %}
|
||||
{% data reusables.actions.using-context-or-environment-variables %}
|
||||
|
||||
### Disponibilidade do contexto
|
||||
|
||||
@@ -139,7 +139,7 @@ A tabela a seguir indica onde cada contexto e função especial pode ser utiliza
|
||||
|
||||
Você pode imprimir o conteúdo de contextos no registro para depuração. A função [`toJSON` ](/actions/learn-github-actions/expressions#tojson) é necessária para imprimir objetos do JSON no registro.
|
||||
|
||||
{% data reusables.github-actions.github-context-warning %}
|
||||
{% data reusables.actions.github-context-warning %}
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -170,8 +170,8 @@ jobs:
|
||||
|
||||
O contexto `github` context contém informações sobre a execução do fluxo de trabalho e sobre o evento que a acionou. Você também pode ler a maioria dos dados do `github` em variáveis de ambiente. Para obter mais informações sobre as variáveis de ambiente, consulte "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)".
|
||||
|
||||
{% data reusables.github-actions.github-context-warning %}
|
||||
{% data reusables.github-actions.context-injection-warning %}
|
||||
{% data reusables.actions.github-context-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
| Nome da propriedade | Tipo | Descrição |
|
||||
| -------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
@@ -194,9 +194,11 @@ O contexto `github` context contém informações sobre a execução do fluxo de
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %}
|
||||
| `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} | | `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} | | `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %}
|
||||
{%- endif %}
|
||||
| `github.path` | `string` | Caminho no executor no arquivo que define as variáveis do `PATH` do sistema a partir de comandos do fluxo de trabalho. Este arquivo é único para a etapa atual e é um arquivo diferente para cada etapa de um trabalho. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#adding-a-system-path)." | | `github.repository` | `string` | O proprietário e o nome do repositório. Por exemplo, `Codertocat/Hello-World`. | | `github.repository_owner` | `string` | O nome do proprietário do repositório. Por exemplo, `Codertocat`. | | `github.repositoryUrl` | `string` | A URL do Git para o repositório. Por exemplo, `git://github.com/codertocat/hello-world.git`. | | `github.retention_days` | `string` | O número de dias que os registros e artefatos da execução do fluxo de trabalho são mantidos. | | `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} | | `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %}
|
||||
| `github.path` | `string` | Caminho no executor no arquivo que define as variáveis do `PATH` do sistema a partir de comandos do fluxo de trabalho. Este arquivo é único para a etapa atual e é um arquivo diferente para cada etapa de um trabalho. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#adding-a-system-path)." | | `github.repository` | `string` | O proprietário e o nome do repositório. Por exemplo, `Codertocat/Hello-World`. | | `github.repository_owner` | `string` | O nome do proprietário do repositório. Por exemplo, `Codertocat`. | | `github.repositoryUrl` | `string` | A URL do Git para o repositório. Por exemplo, `git://github.com/codertocat/hello-world.git`. | | `github.retention_days` | `string` | O número de dias que os registros e artefatos da execução do fluxo de trabalho são mantidos. | | `github.run_id` | `string` | {% data reusables.actions.run_id_description %} | | `github.run_number` | `string` | {% data reusables.actions.run_number_description %}
|
||||
{%- ifversion fpt or ghec or ghes > 3.5 or ghae-issue-4722 %}
|
||||
| `github.run_attempt` | `string` | Um número exclusivo para cada tentativa de execução de um fluxo de trabalho específico em um repositório. Este número começa em 1 para a primeira tentativa de execução do fluxo de trabalho e aumenta a cada nova execução. | |{% endif %}| | `github.server_url` | `string` | O URL do servidor do GitHub. Por exemplo: `https://github.com`. | | `github.sha` | `string` | O SHA do commit que acionou a execução do fluxo de trabalho. | | `github.token` | `string` | Um token para efetuar a autenticação em nome do aplicativo instalado no seu repositório. Isso é funcionalmente equivalente ao segredo `GITHUB_TOKEN`. Para obter mais informações, consulte "[Autenticação automática de tokens](/actions/security-guides/automatic-token-authentication)". | | `github.workflow` | `string` | O nome do fluxo de trabalho. Se o fluxo de trabalho não determina um `name` (nome), o valor desta propriedade é o caminho completo do arquivo do fluxo de trabalho no repositório. | | `github.workspace` | `string` | O diretório de trabalho padrão no executor para as etapas e a localidade padrão do seu repositório ao usar a ação [`checkout`](https://github.com/actions/checkout). |
|
||||
| `github.run_attempt` | `string` | Um número exclusivo para cada tentativa de execução de um fluxo de trabalho específico em um repositório. Este número começa em 1 para a primeira tentativa de execução do fluxo de trabalho e aumenta a cada nova execução. |
|
||||
{%- endif %}
|
||||
| `github.server_url` | `string` | The URL of the GitHub server. Por exemplo: `https://github.com`. | | `github.sha` | `string` | O SHA do commit que acionou a execução do fluxo de trabalho. | | `github.token` | `string` | Um token para efetuar a autenticação em nome do aplicativo instalado no seu repositório. Isso é funcionalmente equivalente ao segredo `GITHUB_TOKEN`. Para obter mais informações, consulte "[Autenticação automática de tokens](/actions/security-guides/automatic-token-authentication)". | | `github.workflow` | `string` | O nome do fluxo de trabalho. Se o fluxo de trabalho não determina um `name` (nome), o valor desta propriedade é o caminho completo do arquivo do fluxo de trabalho no repositório. | | `github.workspace` | `string` | O diretório de trabalho padrão no executor para as etapas e a localidade padrão do seu repositório ao usar a ação [`checkout`](https://github.com/actions/checkout). |
|
||||
|
||||
### Exemplo de conteúdo do contexto `github`
|
||||
|
||||
@@ -512,7 +514,7 @@ O contexto `segredos` contém os nomes e valores de segredos disponíveis para a
|
||||
|
||||
`GITHUB_TOKEN` é um segredo que é criado automaticamente para cada execução de fluxo de trabalho, e é sempre incluído no contexto `segredos`. Para obter mais informações, consulte "[Autenticação automática de tokens](/actions/security-guides/automatic-token-authentication)".
|
||||
|
||||
{% data reusables.github-actions.secrets-redaction-warning %}
|
||||
{% data reusables.actions.secrets-redaction-warning %}
|
||||
|
||||
| Nome da propriedade | Tipo | Descrição |
|
||||
| ----------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
@@ -534,7 +536,7 @@ O conteúdo de exemplo do contexto dos `segredos` mostra o `GITHUB_TOKEN` autom
|
||||
|
||||
### Exemplo de uso do contexto dos `segredos`
|
||||
|
||||
{% data reusables.github-actions.github_token-input-example %}
|
||||
{% data reusables.actions.github_token-input-example %}
|
||||
|
||||
## Contexto `estratégia`
|
||||
|
||||
|
||||
@@ -147,7 +147,7 @@ As variáveis de ambiente padrão que os conjuntos de {% data variables.product.
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %}
|
||||
| `GITHUB_REF_NAME` | {% data reusables.actions.ref_name-description %} For example, `feature-branch-1`.| | `GITHUB_REF_PROTECTED` | {% data reusables.actions.ref_protected-description %} | | `GITHUB_REF_TYPE` | {% data reusables.actions.ref_type-description %}
|
||||
{%- endif %}
|
||||
| `GITHUB_REPOSITORY` | O nome do proprietário e do repositório. Por exemplo, `octocat/Hello-World`. | | `GITHUB_REPOSITORY_OWNER` | O nome do proprietário do repositório. Por exemplo, `octocat`. | | `GITHUB_RETENTION_DAYS` | O número de dias que os registros da execução do fluxo de trabalho e os artefatos são mantidos. Por exemplo, `90`. | | `GITHUB_RUN_ATTEMPT` | Um número único para cada tentativa da execução de um fluxo de trabalho particular em um repositório. Este número começa em 1 para a primeira tentativa de execução do fluxo de trabalho e aumenta a cada nova execução. Por exemplo, `3`. | | `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} Por exemplo, `1658821493`. | | `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} Por exemplo, `3`. | | `GITHUB_SERVER_URL`| A URL do servidor de {% data variables.product.product_name %} server. Por exemplo: `https://{% data variables.product.product_url %}`. | `GITHUB_SHA` | O SHA do commit que acionou o fluxo de trabalho. Por exemplo, `ffac537e6cbbf934b08745a378932722df287a53`. | | `GITHUB_WORKFLOW` | O nome do fluxo de trabalho. Por exemplo, `My test workflow`. Se o fluxo de trabalho não determinar um `nome`, o valor desta variável será o caminho completo do arquivo do fluxo de trabalho no repositório. | | `GITHUB_WORKSPACE` | O diretório de trabalho padrão no executor para as etapas e para a localidade padrão do seu repositório ao usar a ação [`checkout`](https://github.com/actions/checkout). Por exemplo, `/home/runner/work/my-repo-name/my-repo-name`. |
|
||||
| `GITHUB_REPOSITORY` | O nome do proprietário e do repositório. Por exemplo, `octocat/Hello-World`. | | `GITHUB_REPOSITORY_OWNER` | O nome do proprietário do repositório. Por exemplo, `octocat`. | | `GITHUB_RETENTION_DAYS` | O número de dias que os registros da execução do fluxo de trabalho e os artefatos são mantidos. Por exemplo, `90`. | | `GITHUB_RUN_ATTEMPT` | Um número único para cada tentativa da execução de um fluxo de trabalho particular em um repositório. Este número começa em 1 para a primeira tentativa de execução do fluxo de trabalho e aumenta a cada nova execução. Por exemplo, `3`. | | `GITHUB_RUN_ID` | {% data reusables.actions.run_id_description %} Por exemplo, `1658821493`. | | `GITHUB_RUN_NUMBER` | {% data reusables.actions.run_number_description %} Por exemplo, `3`. | | `GITHUB_SERVER_URL`| A URL do servidor de {% data variables.product.product_name %} server. Por exemplo: `https://{% data variables.product.product_url %}`. | `GITHUB_SHA` | O SHA do commit que acionou o fluxo de trabalho. Por exemplo, `ffac537e6cbbf934b08745a378932722df287a53`. | | `GITHUB_WORKFLOW` | O nome do fluxo de trabalho. Por exemplo, `My test workflow`. Se o fluxo de trabalho não determinar um `nome`, o valor desta variável será o caminho completo do arquivo do fluxo de trabalho no repositório. | | `GITHUB_WORKSPACE` | O diretório de trabalho padrão no executor para as etapas e para a localidade padrão do seu repositório ao usar a ação [`checkout`](https://github.com/actions/checkout). Por exemplo, `/home/runner/work/my-repo-name/my-repo-name`. |
|
||||
{%- if actions-runner-arch-envvars %}
|
||||
| `RUNNER_ARCH` | {% data reusables.actions.runner-arch-description %}
|
||||
{%- endif %}
|
||||
|
||||
@@ -25,9 +25,9 @@ Expressões são comumente usadas com a condicional `if` palavra-chave em um arq
|
||||
`${{ <expression> }}`
|
||||
{% endraw %}
|
||||
|
||||
{% data reusables.github-actions.expression-syntax-if %} Para obter mais informações sobre as condições `se`, consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idif)".
|
||||
{% data reusables.actions.expression-syntax-if %} Para obter mais informações sobre as condições `se`, consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idif)".
|
||||
|
||||
{% data reusables.github-actions.context-injection-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
#### Exemplo de expressão em uma condicional `if`
|
||||
|
||||
|
||||
@@ -254,7 +254,7 @@ Para entender como a cobrança funciona para {% data variables.product.prodname_
|
||||
|
||||
## Entrar em contato com o suporte
|
||||
|
||||
{% data reusables.github-actions.contacting-support %}
|
||||
{% data reusables.actions.contacting-support %}
|
||||
|
||||
## Leia mais
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ shortTitle: Cobrança do fluxo de trabalho & limites
|
||||
{% data reusables.repositories.about-github-actions %} Para obter mais informações, consulte "[Entendendo {% data variables.product.prodname_actions %}](/actions/learn-github-actions/understanding-github-actions){% ifversion fpt %}."{% elsif ghes or ghec %}" e "[Sobre {% data variables.product.prodname_actions %} para empresas](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises)."{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% data reusables.github-actions.actions-billing %} Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)".
|
||||
{% data reusables.actions.actions-billing %} Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)".
|
||||
{% else %}
|
||||
O uso do GitHub Actions é grátis para instâncias de {% data variables.product.prodname_ghe_server %} que usam executores auto-hospedados. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)."
|
||||
{% endif %}
|
||||
@@ -47,8 +47,8 @@ Existem alguns limites sobre o uso de {% data variables.product.prodname_actions
|
||||
{% endnote %}
|
||||
|
||||
- **Tempo de execução de tarefas ** - Cada trabalho em um fluxo de trabalho pode ser executado por até 6 horas de tempo de execução. Se um trabalho atingir esse limite, o trabalho será terminado e não será completado.
|
||||
{% data reusables.github-actions.usage-workflow-run-time %}
|
||||
{% data reusables.github-actions.usage-api-requests %}
|
||||
{% data reusables.actions.usage-workflow-run-time %}
|
||||
{% data reusables.actions.usage-api-requests %}
|
||||
- **Tarefas correntes** - O número de trabalhos simultâneos que você pode executar em sua conta depende do seu plano GitHub, conforme indicado na tabela a seguir. Se excedido, quaisquer tarefas adicionais serão colocadas na fila.
|
||||
|
||||
| Plano GitHub | Total de tarefas simultâneas | Máximo de tarefas macOS simultâneas |
|
||||
@@ -57,8 +57,8 @@ Existem alguns limites sobre o uso de {% data variables.product.prodname_actions
|
||||
| Pro | 40 | 5 |
|
||||
| Equipe | 60 | 5 |
|
||||
| Enterprise | 180 | 50 |
|
||||
- **Matriz de vagas** - {% data reusables.github-actions.usage-matrix-limits %}
|
||||
{% data reusables.github-actions.usage-workflow-queue-limits %}
|
||||
- **Matriz de vagas** - {% data reusables.actions.usage-matrix-limits %}
|
||||
{% data reusables.actions.usage-workflow-queue-limits %}
|
||||
|
||||
{% else %}
|
||||
Os limites de uso aplicam-se a executores auto-hospedados. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)."
|
||||
@@ -94,7 +94,7 @@ Para obter mais informações, consulte:
|
||||
|
||||
## Desativar ou limitar {% data variables.product.prodname_actions %} para o seu repositório ou organização
|
||||
|
||||
{% data reusables.github-actions.disabling-github-actions %}
|
||||
{% data reusables.actions.disabling-github-actions %}
|
||||
|
||||
Para obter mais informações, consulte:
|
||||
- "[Gerenciar configurações de {% data variables.product.prodname_actions %} para um repositório](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)"
|
||||
|
||||
@@ -22,7 +22,7 @@ shortTitle: Remover artefatos de fluxo de trabalho
|
||||
|
||||
{% data reusables.repositories.permissions-statement-write %}
|
||||
|
||||
{% data reusables.github-actions.artifact-log-retention-statement %}
|
||||
{% data reusables.actions.artifact-log-retention-statement %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.actions-tab %}
|
||||
|
||||
@@ -179,7 +179,7 @@ git:
|
||||
|
||||
O Travis CI e {% data variables.product.prodname_actions %} podem adicionar variáveis de ambiente personalizadas a uma matriz de teste, que permite que você faça referência à variável em uma etapa posterior.
|
||||
|
||||
Em {% data variables.product.prodname_actions %}, você pode usar a chave `incluir` para adicionar variáveis de ambiente personalizadas a uma matriz. {% data reusables.github-actions.matrix-variable-example %}
|
||||
Em {% data variables.product.prodname_actions %}, você pode usar a chave `incluir` para adicionar variáveis de ambiente personalizadas a uma matriz. {% data reusables.actions.matrix-variable-example %}
|
||||
|
||||
## Principais recursos em {% data variables.product.prodname_actions %}
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ miniTocMaxHeadingLevel: 3
|
||||
{% if github-runner-dashboard %}
|
||||
### Monitorando os seus trabalhos atuais na sua organização ou empresa
|
||||
|
||||
{% data reusables.github-actions.github-hosted-runners-check-concurrency %}
|
||||
{% data reusables.actions.github-hosted-runners-check-concurrency %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -15,12 +15,12 @@ versions:
|
||||
|
||||
Esses registros adicionais são habilitados pela definição dos segredos no repositório que contém o fluxo de trabalho. Portanto, aplicam-se os mesmos requisitos de permissão:
|
||||
|
||||
- {% data reusables.github-actions.permissions-statement-secrets-repository %}
|
||||
- {% data reusables.actions.permissions-statement-secrets-repository %}
|
||||
{% ifversion fpt or ghes > 3.0 or ghae or ghec %}
|
||||
- {% data reusables.github-actions.permissions-statement-secrets-environment %}
|
||||
- {% data reusables.actions.permissions-statement-secrets-environment %}
|
||||
{% endif %}
|
||||
- {% data reusables.github-actions.permissions-statement-secrets-organization %}
|
||||
- {% data reusables.github-actions.permissions-statement-secrets-api %}
|
||||
- {% data reusables.actions.permissions-statement-secrets-organization %}
|
||||
- {% data reusables.actions.permissions-statement-secrets-api %}
|
||||
|
||||
Para obter mais informações sobre segredos de configuração, consulte "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ Se a execução estiver concluída, será possível ver se o resultado teve êxi
|
||||
|
||||
O {% data variables.product.prodname_actions %} usa a API de Verificação para mostrar os status, resultados e logs de um fluxo de trabalho. O {% data variables.product.prodname_dotcom %} cria um novo conjunto de verificações para cada execução de fluxo de trabalho. O conjunto de verificações contêm uma execução de verificação para cada trabalho no fluxo de trabalho, e cada trabalho inclui etapas. As ações do {% data variables.product.prodname_actions %} são executadas como etapas no fluxo de trabalho. Para obter mais informações sobre a API de verificações, consulte "[Verificações](/rest/reference/checks)".
|
||||
|
||||
{% data reusables.github-actions.invalid-workflow-files %}
|
||||
{% data reusables.actions.invalid-workflow-files %}
|
||||
|
||||
## Exibir logs para diagnosticar falhas
|
||||
|
||||
|
||||
@@ -50,7 +50,7 @@ Neste guia, usaremos a ação `build-push-action` do Docker para criar a imagem
|
||||
|
||||
## Publicar imagens no Docker Hub
|
||||
|
||||
{% data reusables.github-actions.release-trigger-workflow %}
|
||||
{% data reusables.actions.release-trigger-workflow %}
|
||||
|
||||
No exemplo de fluxo de trabalho, nós usamos as ações de login do Docker `login-action` e `build-push-action` para construir a imagem do Docker e, se a construção for bem-sucedida, faça push da imagem construída para o Docker Hub.
|
||||
|
||||
@@ -110,7 +110,7 @@ O fluxo de trabalho acima verifica o repositório {% data variables.product.prod
|
||||
|
||||
## Publicar imagens em {% data variables.product.prodname_registry %}
|
||||
|
||||
{% data reusables.github-actions.release-trigger-workflow %}
|
||||
{% data reusables.actions.release-trigger-workflow %}
|
||||
|
||||
No exemplo abaixo, usamos a `login-action do Docker`{% ifversion fpt or ghec %}, `metadados-ação`,{% endif %} e ações de `build-push-action` para construir a imagem Docker e, se a criação for bem-sucedida, faça push da imagem criada para {% data variables.product.prodname_registry %}.
|
||||
|
||||
|
||||
@@ -23,7 +23,7 @@ shortTitle: Pacotes do Java com Gradle
|
||||
|
||||
## Introdução
|
||||
|
||||
{% data reusables.github-actions.publishing-java-packages-intro %}
|
||||
{% data reusables.actions.publishing-java-packages-intro %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
@@ -104,7 +104,7 @@ jobs:
|
||||
MAVEN_PASSWORD: {% raw %}${{ secrets.OSSRH_TOKEN }}{% endraw %}
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.gradle-workflow-steps %}
|
||||
{% data reusables.actions.gradle-workflow-steps %}
|
||||
1. Executa a ação [`gradle/gradle-build-action`](https://github.com/gradle/gradle-build-action) com o argumento `publicar` para fazer uma publicação no repositório do Maven `OSSRH`. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`.
|
||||
|
||||
Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
@@ -115,7 +115,7 @@ Cada vez que você criar uma nova versão, você poderá acionar um fluxo de tra
|
||||
|
||||
Você pode definir um novo repositório do Maven no bloco de publicação do _build.gradle_ que aponta para {% data variables.product.prodname_registry %}. Nessa configuração do repositório, também é possível aproveitar as variáveis de ambiente definidas na execução do fluxo de trabalho de CI. Você pode usar a variável de ambiente `GITHUB_ACTOR` como um nome de usuário e você pode definir a variável de ambiente `GITHUB_TOKEN` com seu segredo `GITHUB_TOKEN`.
|
||||
|
||||
{% data reusables.github-actions.github-token-permissions %}
|
||||
{% data reusables.actions.github-token-permissions %}
|
||||
|
||||
Por exemplo, se sua organização é denominado "octocat" e seu repositório é denominado de "hello-world", a configuração do {% data variables.product.prodname_registry %} no _build.gradle_ será parecida ao exemplo abaixo.
|
||||
|
||||
@@ -174,7 +174,7 @@ jobs:
|
||||
GITHUB_TOKEN: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.gradle-workflow-steps %}
|
||||
{% data reusables.actions.gradle-workflow-steps %}
|
||||
1. Executa a ação [`grades/gradle-build-action`](https://github.com/gradle/gradle-build-action) com o argumento `publicar` para publicar em {% data variables.product.prodname_registry %}. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}A chave de `permissões` especifica o acesso que o segredo `GITHUB_TOKEN` permitirá.{% endif %}
|
||||
|
||||
Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
@@ -255,7 +255,7 @@ jobs:
|
||||
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.gradle-workflow-steps %}
|
||||
{% data reusables.actions.gradle-workflow-steps %}
|
||||
1. Executa a ação [`grades/gradle-build`](https://github.com/gradle/gradle-build-action) com o argumento `publicar` para publicar no repositório do Maven `OSSRH` e em {% data variables.product.prodname_registry %}. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`. {% ifversion fpt or ghes > 3.1 or ghae or ghec %}A chave de `permissões` especifica o acesso que o segredo `GITHUB_TOKEN` permitirá.{% endif %}
|
||||
|
||||
Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
@@ -23,7 +23,7 @@ shortTitle: Pacotes Java com Maven
|
||||
|
||||
## Introdução
|
||||
|
||||
{% data reusables.github-actions.publishing-java-packages-intro %}
|
||||
{% data reusables.actions.publishing-java-packages-intro %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
@@ -105,7 +105,7 @@ Este fluxo de trabalho executa os seguintes passos:
|
||||
|
||||
1. Verifica uma cópia do repositório do projeto.
|
||||
1. Configura o Java JDK e o arquivo _settings.xml_ do Maven para adicionar autenticação ao repositório `ossrh` usando as variáveis de ambiente `MAVEN_USERNAME` e `MAVEN_PASSWORD`.
|
||||
1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
|
||||
1. {% data reusables.actions.publish-to-maven-workflow-step %}
|
||||
|
||||
Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
@@ -115,7 +115,7 @@ Cada vez que você criar uma nova versão, você poderá acionar um fluxo de tra
|
||||
|
||||
Neste fluxo de trabalho, você pode usar a ação `setup-java`. Esta ação instala a versão determinada do JDK no `PATH`, e também configura _settings.xml_ do Maven para a publicação {% data variables.product.prodname_registry %}. O _settings.xml_ gerado define a autenticação para um servidor com um `id` do `github`, usando a variável de ambiente `GITHUB_ACTOR` como o nome de usuário e a variável de ambiente `GITHUB_TOKEN` como a senha. A variável de ambiente `GITHUB_TOKEN` foi atribuída ao valor do segredo especial `GITHUB_TOKEN`.
|
||||
|
||||
{% data reusables.github-actions.github-token-permissions %}
|
||||
{% data reusables.actions.github-token-permissions %}
|
||||
|
||||
Para um projeto baseado no Maven, você pode usar essas configurações ao criar um repositório de distribuição no seu arquivo _pom.xml_ com um `id` do `github` que aponta para seu ponto final {% data variables.product.prodname_registry %}.
|
||||
|
||||
@@ -165,7 +165,7 @@ Este fluxo de trabalho executa os seguintes passos:
|
||||
|
||||
1. Verifica uma cópia do repositório do projeto.
|
||||
1. Configura o Java JDK e também configura automaticamente o arquivo _settings.xml_ do Maven para adicionar autenticação para o repositório do `github` do Maven para usar a variável de ambiente `GITHUB_TOKEN`.
|
||||
1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
|
||||
1. {% data reusables.actions.publish-to-packages-workflow-step %}
|
||||
|
||||
Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
@@ -218,8 +218,8 @@ Este fluxo de trabalho executa os seguintes passos:
|
||||
|
||||
1. Verifica uma cópia do repositório do projeto.
|
||||
1. Chama `setup-java` pela primeira vez. Isso configura o arquivo _settings.xml_ do Maven para o repositório `ossrh` e define as opções de autenticação para variáveis de ambiente definidas na próxima etapa.
|
||||
1. {% data reusables.github-actions.publish-to-maven-workflow-step %}
|
||||
1. {% data reusables.actions.publish-to-maven-workflow-step %}
|
||||
1. Chama `setup-java` pela segunda vez. Isso configura automaticamente o arquivo _settings.xml_ do Maven para {% data variables.product.prodname_registry %}.
|
||||
1. {% data reusables.github-actions.publish-to-packages-workflow-step %}
|
||||
1. {% data reusables.actions.publish-to-packages-workflow-step %}
|
||||
|
||||
Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
@@ -43,7 +43,7 @@ Você também pode achar útil ter um entendimento básico do seguinte:
|
||||
|
||||
Os campos `nome` e `versão` no arquivo *package.json* cria um identificador único que os registros usam para vincular seu pacote a um registro. Você pode adicionar um resumo para página de listagem do pacote ao incluir um campo `descrição` no arquivo *package.json*. Para obter mais informações, consulte "[Criando um pacote package.json](https://docs.npmjs.com/creating-a-package-json-file)" e "[Criando módulos Node.js](https://docs.npmjs.com/creating-node-js-modules)" na documentação do npm.
|
||||
|
||||
Quando um arquivo *.npmrc* local existe e tem um valor de `registro` especificado, o comando `publicação do npm` usa o registro configurado no arquivo *.npmrc*. {% data reusables.github-actions.setup-node-intro %}
|
||||
Quando um arquivo *.npmrc* local existe e tem um valor de `registro` especificado, o comando `publicação do npm` usa o registro configurado no arquivo *.npmrc*. {% data reusables.actions.setup-node-intro %}
|
||||
|
||||
Você pode especificar a versão do Node.js instalada no executor usando a ação `setup-node`.
|
||||
|
||||
@@ -115,7 +115,7 @@ No entanto, se você fornecer a chave `repositório`, o repositório nessa chave
|
||||
|
||||
### Efetuar a autenticação no repositório de destino
|
||||
|
||||
Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. {% data reusables.github-actions.github-token-permissions %}
|
||||
Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. {% data reusables.actions.github-token-permissions %}
|
||||
|
||||
Se você quiser publicar seu pacote em um repositório diferente, você deverá usar um token de acesso pessoal (PAT) que tenha permissão para escrever pacotes no repositório de destino. Para obter mais informações, consulte "[Criar um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)" e "[Segredos criptografados](/actions/reference/encrypted-secrets)".
|
||||
|
||||
|
||||
@@ -39,11 +39,11 @@ Você pode usar o `GITHUB_TOKEN` ao usar a sintaxe padrão para fazer referênci
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.github-actions.actions-do-not-trigger-workflows %}
|
||||
{% data reusables.actions.actions-do-not-trigger-workflows %}
|
||||
|
||||
### Exemplo 1: Passar o `GITHUB_TOKEN` como uma entrada
|
||||
|
||||
{% data reusables.github-actions.github_token-input-example %}
|
||||
{% data reusables.actions.github_token-input-example %}
|
||||
|
||||
### Exemplo 2: chamando a API REST
|
||||
|
||||
@@ -121,7 +121,7 @@ Você pode ver as permissões que o `GITHUB_TOKEN` tem para uma tarefa específi
|
||||
|
||||
Você pode usar a chave de `permissões` no seu arquivo de fluxo de trabalho para modificar as permissões para o `GITHUB_TOKEN` para um fluxo de trabalho inteiro ou para trabalhos individuais. Isso permite que você configure as permissões mínimas necessárias para um fluxo de trabalho ou trabalho. Quando a chave `permissions` for usada, todas as permissões não especificadas são configuradas como sem acesso, com exceção do escopo de `metadados`, que sempre recebe acesso de leitura.
|
||||
|
||||
{% data reusables.github-actions.forked-write-permission %}
|
||||
{% data reusables.actions.forked-write-permission %}
|
||||
|
||||
Os dois exemplos de fluxo de trabalho anteriores neste artigo mostram a chave de `permissões` usada no nível de fluxo de trabalho e no nível de trabalho. Em [Exemplo 1](#example-1-passing-the-github_token-as-an-input) as duas permissões são especificadas para todo o fluxo de trabalho. No [Exemplo 2](#example-2-calling-the-rest-api) de acesso de gravação é concedido para um único escopo para um único trabalho.
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ versions:
|
||||
|
||||
Os segredos são variáveis de ambiente criptografadas que você cria em uma organização{% ifversion fpt or ghes > 3.0 or ghae or ghec %}, repositório ou ambiente do repositório{% else %} ou repositório{% endif %}. Os segredos que você cria estão disponíveis para utilização nos fluxos de trabalho em {% data variables.product.prodname_actions %}. {% data variables.product.prodname_dotcom %} usa uma [caixa selada libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) para ajudar a garantir que os segredos sejam criptografados antes de chegarem a {% data variables.product.prodname_dotcom %} e permaneçam criptografados até que você os use em um fluxo de trabalho.
|
||||
|
||||
{% data reusables.github-actions.secrets-org-level-overview %}
|
||||
{% data reusables.actions.secrets-org-level-overview %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.0 or ghae or ghec %}
|
||||
Para segredos armazenados no nível do ambiente, você pode habilitar os revisores necessários para controlar o acesso aos segredos. Um trabalho de fluxo de trabalho não pode acessar segredos de ambiente até que a aprovação seja concedida por aprovadores necessários.
|
||||
@@ -53,7 +53,7 @@ Para disponibilizar um segredo para uma ação, você deve configurá-lo como um
|
||||
|
||||
Você pode usar e ler segredos encriptados em um arquivo de fluxo de trabalho se tiver permissão para editar o arquivo. Para obter mais informações, consulte "[Permissões de acesso em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)."
|
||||
|
||||
{% data reusables.github-actions.secrets-redaction-warning %}
|
||||
{% data reusables.actions.secrets-redaction-warning %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.0 or ghae or ghec %}
|
||||
Os segredos da organização e do repositório são lidos quando uma execução de fluxo de trabalho é enfileirada e os segredos de ambiente são lidos quando um trabalho que faz referência ao ambiente é iniciado.
|
||||
@@ -73,13 +73,13 @@ Ao gerar credenciais, recomendamos que você conceda as permissões mínimas pos
|
||||
|
||||
## Criar segredos encriptados para um repositório
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-repository %}
|
||||
{% data reusables.actions.permissions-statement-secrets-repository %}
|
||||
|
||||
{% webui %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
1. Clique em **Novo segredo do repositório**.
|
||||
1. Digite um nome para o seu segredo na caixa de entrada **Nome**.
|
||||
1. Insira o valor para o seu segredo.
|
||||
@@ -113,13 +113,13 @@ Para listar todos os segredos para o repositório, use o subcomando da lista `gh
|
||||
|
||||
## Criar segredos criptografados para um ambiente
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-environment %}
|
||||
{% data reusables.actions.permissions-statement-secrets-environment %}
|
||||
|
||||
{% webui %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.sidebar-environment %}
|
||||
{% data reusables.actions.sidebar-environment %}
|
||||
1. Clique no ambiente ao qual você deseja adicionar um segredo.
|
||||
2. Em **Segredos do ambiente**, clique em **Adicionar segredo**.
|
||||
3. Digite um nome para o seu segredo na caixa de entrada **Nome**.
|
||||
@@ -150,13 +150,13 @@ gh secret list --env <em>environment-name</em>
|
||||
|
||||
Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios.
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-organization %}
|
||||
{% data reusables.actions.permissions-statement-secrets-organization %}
|
||||
|
||||
{% webui %}
|
||||
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
1. Clique em **Novo segredo da organização**.
|
||||
1. Digite um nome para o seu segredo na caixa de entrada **Nome**.
|
||||
1. Insira o **Valor** para o seu segredo.
|
||||
@@ -209,7 +209,7 @@ Você pode verificar quais políticas de acesso são aplicadas a um segredo na s
|
||||
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
1. A lista de segredos inclui quaisquer permissões e políticas configuradas. Por exemplo: 
|
||||
1. Para obter mais detalhes sobre as permissões configuradas para cada segredo, clique em **Atualizar**.
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ Os contêineres de serviço são contêineres Docker que fornecem uma forma simp
|
||||
|
||||
Você pode configurar os contêineres de serviço para cada trabalho em um fluxo de trabalho. {% data variables.product.prodname_dotcom %} cria um novo contêiner Docker para cada serviço configurado no fluxo de trabalho e destrói o contêiner de serviço quando o trabalho é concluído. As etapas em um trabalho podem comunicar-se com todos os contêineres de serviço que fazem parte do mesmo trabalho.
|
||||
|
||||
{% data reusables.github-actions.docker-container-os-support %}
|
||||
{% data reusables.actions.docker-container-os-support %}
|
||||
|
||||
## Comunicar-se com os contêineres de serviço
|
||||
|
||||
|
||||
@@ -24,11 +24,11 @@ topics:
|
||||
|
||||
Este guia mostra exemplos de fluxo de trabalho que configuram um contêiner de serviço usando a imagem `postgres` do Docker Hub. O fluxo de trabalho executa um script que se conecta ao serviço do PostgreSQL, cria uma tabela e, em seguida, preenche-a com dados. Para testar se o fluxo de trabalho cria e preenche a tabela do PostgreSQL, o script imprime os dados da tabela para o console.
|
||||
|
||||
{% data reusables.github-actions.docker-container-os-support %}
|
||||
{% data reusables.actions.docker-container-os-support %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
{% data reusables.github-actions.service-container-prereqs %}
|
||||
{% data reusables.actions.service-container-prereqs %}
|
||||
|
||||
Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% data variables.product.prodname_actions %} e PostgreSQL. Para obter mais informações, consulte:
|
||||
|
||||
@@ -37,9 +37,9 @@ Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% da
|
||||
|
||||
## Executar trabalhos em contêineres
|
||||
|
||||
{% data reusables.github-actions.container-jobs-intro %}
|
||||
{% data reusables.actions.container-jobs-intro %}
|
||||
|
||||
{% data reusables.github-actions.copy-workflow-file %}
|
||||
{% data reusables.actions.copy-workflow-file %}
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -95,9 +95,9 @@ jobs:
|
||||
|
||||
### Configurar o trabalho executor
|
||||
|
||||
{% data reusables.github-actions.service-container-host %}
|
||||
{% data reusables.actions.service-container-host %}
|
||||
|
||||
{% data reusables.github-actions.postgres-label-description %}
|
||||
{% data reusables.actions.postgres-label-description %}
|
||||
|
||||
```yaml{:copy}
|
||||
trabalhos:
|
||||
@@ -127,7 +127,7 @@ trabalhos:
|
||||
|
||||
### Configurar as etapas
|
||||
|
||||
{% data reusables.github-actions.service-template-steps %}
|
||||
{% data reusables.actions.service-template-steps %}
|
||||
|
||||
```yaml{:copy}
|
||||
steps:
|
||||
@@ -153,7 +153,7 @@ steps:
|
||||
POSTGRES_PORT: 5432
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.postgres-environment-variables %}
|
||||
{% data reusables.actions.postgres-environment-variables %}
|
||||
|
||||
O nome do host do serviço do PostgreSQL é a etiqueta que você configurou no seu fluxo de trabalho, nesse caso, `postgres`. Uma vez que os contêineres do Docker na mesma rede da ponte definida pelo usuário abrem todas as portas por padrão, você poderá acessar o contêiner de serviço na porta-padrão 5432 do PostgreSQL.
|
||||
|
||||
@@ -161,7 +161,7 @@ O nome do host do serviço do PostgreSQL é a etiqueta que você configurou no s
|
||||
|
||||
Ao executar um trabalho diretamente na máquina executora, você deverá mapear as portas no contêiner de serviço com as portas no host do Docker. Você pode acessar os contêineres de serviço do host do Docker usando `localhost` e o número da porta do host do Docker.
|
||||
|
||||
{% data reusables.github-actions.copy-workflow-file %}
|
||||
{% data reusables.actions.copy-workflow-file %}
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -219,9 +219,9 @@ jobs:
|
||||
|
||||
### Configurar o trabalho executor
|
||||
|
||||
{% data reusables.github-actions.service-container-host-runner %}
|
||||
{% data reusables.actions.service-container-host-runner %}
|
||||
|
||||
{% data reusables.github-actions.postgres-label-description %}
|
||||
{% data reusables.actions.postgres-label-description %}
|
||||
|
||||
O fluxo de trabalho mapeia a porta 5432 no contêiner de serviço do PostgreSQL com o host do Docker. Para obter mais informações sobre a palavra-chave `portas`, consulte "[Sobre contêineres de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)".
|
||||
|
||||
@@ -254,7 +254,7 @@ trabalhos:
|
||||
|
||||
### Configurar as etapas
|
||||
|
||||
{% data reusables.github-actions.service-template-steps %}
|
||||
{% data reusables.actions.service-template-steps %}
|
||||
|
||||
```yaml{:copy}
|
||||
steps:
|
||||
@@ -280,9 +280,9 @@ steps:
|
||||
POSTGRES_PORT: 5432
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.postgres-environment-variables %}
|
||||
{% data reusables.actions.postgres-environment-variables %}
|
||||
|
||||
{% data reusables.github-actions.service-container-localhost %}
|
||||
{% data reusables.actions.service-container-localhost %}
|
||||
|
||||
## Testar o contêiner de serviço do PostgreSQL
|
||||
|
||||
@@ -290,7 +290,7 @@ Você pode testar o seu fluxo de trabalho usando o seguinte script, que se conec
|
||||
|
||||
Você pode modificar o *client.js* para incluir qualquer operação do PostgreSQL exigida pelo seu fluxo de trabalho. Neste exemplo, o script conecta-se ao serviço do PostgreSQL, adiciona uma tabela ao banco de dados `postgres`, insere alguns dados de espaço reservado e recupera os dados.
|
||||
|
||||
{% data reusables.github-actions.service-container-add-script %}
|
||||
{% data reusables.actions.service-container-add-script %}
|
||||
|
||||
```javascript{:copy}
|
||||
const { Client } = require('pg');
|
||||
|
||||
@@ -24,11 +24,11 @@ topics:
|
||||
|
||||
Este guia mostra os exemplos do seu fluxo de trabalho que configuram um contêiner de serviço usando a imagem `redis` do Docker Hub. O fluxo de trabalho executa um script para criar um cliente Redis e preencher os dados do cliente. Para testar se o fluxo de trabalho cria e preenche o cliente Redis, o script imprime os dados do cliente no console.
|
||||
|
||||
{% data reusables.github-actions.docker-container-os-support %}
|
||||
{% data reusables.actions.docker-container-os-support %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
{% data reusables.github-actions.service-container-prereqs %}
|
||||
{% data reusables.actions.service-container-prereqs %}
|
||||
|
||||
Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% data variables.product.prodname_actions %} e Redis. Para obter mais informações, consulte:
|
||||
|
||||
@@ -37,9 +37,9 @@ Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% da
|
||||
|
||||
## Executar trabalhos em contêineres
|
||||
|
||||
{% data reusables.github-actions.container-jobs-intro %}
|
||||
{% data reusables.actions.container-jobs-intro %}
|
||||
|
||||
{% data reusables.github-actions.copy-workflow-file %}
|
||||
{% data reusables.actions.copy-workflow-file %}
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -92,9 +92,9 @@ trabalhos:
|
||||
|
||||
### Configurar o trabalho do contêiner
|
||||
|
||||
{% data reusables.github-actions.service-container-host %}
|
||||
{% data reusables.actions.service-container-host %}
|
||||
|
||||
{% data reusables.github-actions.redis-label-description %}
|
||||
{% data reusables.actions.redis-label-description %}
|
||||
|
||||
```yaml{:copy}
|
||||
trabalhos:
|
||||
@@ -121,7 +121,7 @@ trabalhos:
|
||||
|
||||
### Configurar as etapas
|
||||
|
||||
{% data reusables.github-actions.service-template-steps %}
|
||||
{% data reusables.actions.service-template-steps %}
|
||||
|
||||
```yaml{:copy}
|
||||
etapas:
|
||||
@@ -146,7 +146,7 @@ etapas:
|
||||
REDIS_PORT: 6379
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.redis-environment-variables %}
|
||||
{% data reusables.actions.redis-environment-variables %}
|
||||
|
||||
O nome do host do serviço Redis é a etiqueta que você configurou no seu fluxo de trabalho, nesse caso `redis`. Uma vez que os contêineres do Docker na mesma rede da ponte definida pelo usuário abrem todas as portas por padrão, você poderá acessar o contêiner de serviço na porta-padrão 6379 do Redis.
|
||||
|
||||
@@ -154,7 +154,7 @@ O nome do host do serviço Redis é a etiqueta que você configurou no seu fluxo
|
||||
|
||||
Ao executar um trabalho diretamente na máquina executora, você deverá mapear as portas no contêiner de serviço com as portas no host do Docker. Você pode acessar os contêineres de serviço do host do Docker usando `localhost` e o número da porta do host do Docker.
|
||||
|
||||
{% data reusables.github-actions.copy-workflow-file %}
|
||||
{% data reusables.actions.copy-workflow-file %}
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -209,9 +209,9 @@ trabalhos:
|
||||
|
||||
### Configurar o trabalho executor
|
||||
|
||||
{% data reusables.github-actions.service-container-host-runner %}
|
||||
{% data reusables.actions.service-container-host-runner %}
|
||||
|
||||
{% data reusables.github-actions.redis-label-description %}
|
||||
{% data reusables.actions.redis-label-description %}
|
||||
|
||||
O fluxo de trabalho mapeia a porta 6379 no contêiner de serviço do Redis com o host do Docker. Para obter mais informações sobre a palavra-chave `portas`, consulte "[Sobre contêineres de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)".
|
||||
|
||||
@@ -241,7 +241,7 @@ trabalhos:
|
||||
|
||||
### Configurar as etapas
|
||||
|
||||
{% data reusables.github-actions.service-template-steps %}
|
||||
{% data reusables.actions.service-template-steps %}
|
||||
|
||||
```yaml{:copy}
|
||||
etapas:
|
||||
@@ -267,9 +267,9 @@ etapas:
|
||||
REDIS_PORT: 6379
|
||||
```
|
||||
|
||||
{% data reusables.github-actions.redis-environment-variables %}
|
||||
{% data reusables.actions.redis-environment-variables %}
|
||||
|
||||
{% data reusables.github-actions.service-container-localhost %}
|
||||
{% data reusables.actions.service-container-localhost %}
|
||||
|
||||
## Testar o contêiner de serviço Redis
|
||||
|
||||
@@ -277,7 +277,7 @@ Você pode testar o seu fluxo de trabalho usando o script a seguir, que cria um
|
||||
|
||||
Você pode modificar o *client.js* para incluir qualquer operação necessária para o seu fluxo de trabalho. Neste exemplo, o script cria a instância do cliente Redis, cria uma tabela, adiciona dados de espaços reservados e, em seguida, recupera os dados.
|
||||
|
||||
{% data reusables.github-actions.service-container-add-script %}
|
||||
{% data reusables.actions.service-container-add-script %}
|
||||
|
||||
```javascript{:copy}
|
||||
const redis = require("redis");
|
||||
|
||||
@@ -29,7 +29,7 @@ Você pode especificar o tipo de executor para cada trabalho em um fluxo de trab
|
||||
|
||||
{% ifversion not ghes %}
|
||||
|
||||
{% data reusables.github-actions.runner-app-open-source %}
|
||||
{% data reusables.actions.runner-app-open-source %}
|
||||
|
||||
### Hosts da nuvem para os executores hospedados em {% data variables.product.prodname_dotcom %}
|
||||
|
||||
@@ -39,7 +39,7 @@ O {% data variables.product.prodname_dotcom %} hospeda executores do Linux e Win
|
||||
|
||||
### Continuidade do fluxo de trabalho para executores hospedados em {% data variables.product.prodname_dotcom %}
|
||||
|
||||
{% data reusables.github-actions.runner-workflow-continuity %}
|
||||
{% data reusables.actions.runner-workflow-continuity %}
|
||||
|
||||
Além disso, se a execução do fluxo de trabalho entrar na fila com sucesso, mas não foi processado por um executor hospedado em {% data variables.product.prodname_dotcom %} dentro de 45 minutos, a execução do fluxo de trabalho na fila será descartada.
|
||||
|
||||
@@ -61,7 +61,7 @@ Especificação de hardware para máquinas virtuais do macOS:
|
||||
- 14 GB de memória RAM
|
||||
- 14 GB de espaço de disco SSD
|
||||
|
||||
{% data reusables.github-actions.supported-github-runners %}
|
||||
{% data reusables.actions.supported-github-runners %}
|
||||
|
||||
Lista de registros de fluxo de trabalho do executor usado para executar um trabalho. Para obter mais informações, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)".
|
||||
|
||||
|
||||
@@ -13,8 +13,8 @@ shortTitle: Monitorando seus trabalhos atuais
|
||||
|
||||
Você pode obter uma lista de todos os trabalhos atualmente em execução em executores hospedados em {% data variables.product.prodname_dotcom %} na sua organização ou empresa.
|
||||
|
||||
{% data reusables.github-actions.github-hosted-runners-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.github-hosted-runners-table-entry %}
|
||||
{% data reusables.actions.github-hosted-runners-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.github-hosted-runners-table-entry %}
|
||||
1. Revise a seção "Trabalhos Ativos", que contém uma lista com todos os trabalhos em execução atualmente nos executores hospedados em {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
|
||||
@@ -25,6 +25,6 @@ Os executores hospedados em {% data variables.product.prodname_dotcom %} permite
|
||||
|
||||
O procedimento seguinte demonstra como verificar o número máximo de trabalhos simultâneos que pode ser executado.
|
||||
|
||||
{% data reusables.github-actions.github-hosted-runners-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.github-actions.github-hosted-runners-table-entry %}
|
||||
{% data reusables.actions.github-hosted-runners-navigate-to-repo-org-enterprise %}
|
||||
{% data reusables.actions.github-hosted-runners-table-entry %}
|
||||
1. Revise a seção "Uso de todos os trabalhos", que lista o número de trabalhos ativos e o número máximo de trabalhos que você pode executar. Neste exemplo, `9` trabalhos estão atualmente em execução em um total de `180`. 
|
||||
|
||||
@@ -20,5 +20,5 @@ miniTocMaxHeadingLevel: 4
|
||||
{% if github-runner-dashboard %}
|
||||
## Monitorando os seus trabalhos atuais na sua organização ou empresa
|
||||
|
||||
{% data reusables.github-actions.github-hosted-runners-check-concurrency %}
|
||||
{% data reusables.actions.github-hosted-runners-check-concurrency %}
|
||||
{% endif %}
|
||||
|
||||
@@ -37,7 +37,7 @@ Alguns eventos têm vários tipos de atividades. Para esses eventos, você pode
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando as regras de proteção de branch no repositório do fluxo de trabalho são alteradas. Para obter mais informações sobre as regras de proteção de branches, consulte "[Sobre branches protegidos](/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)". Para informações sobre as APIs das regras de proteção de branch, consulte "[BranchProtectionRule](/graphql/reference/objects#branchprotectionrule)" na documentação da API do GraphQL ou "[Branches](/rest/reference/branches)" na documentação da API REST.
|
||||
|
||||
@@ -64,7 +64,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando ocorre a atividade relacionada a uma execução de verificação. Uma execução de verificação é um teste individual que faz parte de um conjunto de verificações. Para obter informações, consulte "[Primeiros passos com a API de Verificações](/rest/guides/getting-started-with-the-checks-api)". Para informações sobre as APIs de verificação, consulte "[CheckRun](/graphql/reference/objects#checkrun)" na documentação da API do GraphQL ou "[Verificações](/rest/reference/checks#runs)" na documentação da API REST.
|
||||
|
||||
@@ -88,7 +88,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -133,7 +133,7 @@ on:
|
||||
| ---------------------------------------------------------------------------------------- | ------------------ | ------------------------------ | ------------- |
|
||||
| [`delete`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#delete) | n/a | Último commit no branch padrão | Branch padrão |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -199,7 +199,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% data reusables.webhooks.discussions-webhooks-beta %}
|
||||
|
||||
@@ -225,7 +225,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% data reusables.webhooks.discussions-webhooks-beta %}
|
||||
|
||||
@@ -247,7 +247,7 @@ on:
|
||||
| ------------------------------------------------------------------------------------------ | ------------------ | ------------------------------ | ------------- |
|
||||
| [`bifurcação`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#fork) | n/a | Último commit no branch padrão | Branch padrão |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando alguém bifurca um repositório. Para obter informações sobre a API REST, consulte "[Criar uma bifurcação](/rest/reference/repos#create-a-fork)".
|
||||
|
||||
@@ -264,7 +264,7 @@ on:
|
||||
| ---------------------------------------------------------------------------------------- | ------------------ | ------------------------------ | ------------- |
|
||||
| [`gollum`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#gollum) | n/a | Último commit no branch padrão | Branch padrão |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando alguém cria ou atualiza uma página wiki. Para obter mais informações, consulte "[Sobre wikis](/communities/documenting-your-project-with-wikis/about-wikis)."
|
||||
|
||||
@@ -287,7 +287,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando um problema ou comentário de pull request é criado, editado ou excluído. Para informação sobre as APIs de comentário de problema, consulte "[IssueComment](/graphql/reference/objects#issuecomment)" na documentação da API do GraphQL ou "[Comentários do problema](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment)" na documentação da API REST.
|
||||
|
||||
@@ -344,7 +344,7 @@ jobs:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando um problema no repositório do fluxo de trabalho é criado ou modificado. Para atividade relacionada a comentários em uma issue, use o evento [`issue_comment`](#issue_comment). Para obter mais informações sobre os problemas, consulte "[Sobre os problemas](/issues/tracking-your-work-with-issues/about-issues)". Para informações sobre as APIs do problema, consulte "[Problema](/graphql/reference/objects#issue)" na documentação da API do GraphQL ou "[Problemas](/rest/reference/issues)" na documentação da API REST.
|
||||
|
||||
@@ -368,7 +368,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando uma etiqueta no repositório do fluxo de trabalho é criada ou modificada. Para obter mais informações sobre etiquetas, consulte "[Gerenciar etiquetas](/issues/using-labels-and-milestones-to-track-work/managing-labels)". Para obter informações sobre a API da etiqueta, consulte "[Etiqueta](/graphql/reference/objects#label)" na documentação da API do GraphQL ou "[Etiquetas](/rest/reference/issues#labels)" na documentação da API REST.
|
||||
|
||||
@@ -394,7 +394,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando um marco no repositório do fluxo de trabalho é criado ou modificado. Para obter mais informações sobre marcos, consulte "[Sobre marcos](/issues/using-labels-and-milestones-to-track-work/about-milestones)". Para informações sobre as APIs do marco, consulte "[Marco](/graphql/reference/objects#milestone)" na documentação da API do GraphQL ou "[Marcos](/rest/reference/issues#milestones)" na documentação da API REST.
|
||||
|
||||
@@ -414,7 +414,7 @@ on:
|
||||
| ------------------------------------------------------------------------------------------------ | ------------------ | ------------------------------ | ------------ |
|
||||
| [`page_build`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#page_build) | n/a | Último commit no branch padrão | n/a |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando alguém faz push em um branch que é a fonte de publicação para {% data variables.product.prodname_pages %}, se o {% data variables.product.prodname_pages %} estiver habilitado no repositório. Para obter mais informações sobre fontes de publicação {% data variables.product.prodname_pages %}, consulte "[Configurando uma fonte de publicação para o site do GitHub Pages](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source)". Para obter informações sobre a API REST, consulte "[Páginas](/rest/reference/repos#pages)".
|
||||
|
||||
@@ -437,7 +437,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -475,7 +475,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -513,7 +513,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -545,7 +545,7 @@ on:
|
||||
| ----------------------------------------------------------------------------------------- | ------------------ | ------------------------------ | ------------- |
|
||||
| [`público`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#public) | n/a | Último commit no branch padrão | Branch padrão |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando o repositório do fluxo de trabalho é alterado de privado para público. Para obter informações sobre a API REST, consulte "[Editar repositórios](/rest/reference/repos#edit)".
|
||||
|
||||
@@ -625,7 +625,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.branch-paths-filter %} Por exemplo, o fluxo de trabalho a seguir será executado somente quando um pull request que inclui uma mudança para um arquivo (`.js`) do JavaScript for aberto em um branch cujo nome começa com `releases/`:
|
||||
**Note:** {% data reusables.actions.branch-paths-filter %} For example, the following workflow will only run when a pull request that includes a change to a JavaScript (`.js`) file is opened on a branch whose name starts with `releases/`:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -670,7 +670,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.branch-paths-filter %} Por exemplo, o fluxo de trabalho a seguir será executado somente quando um pull request que inclui uma mudança para um arquivo (`.js`) do JavaScript for aberto em um branch cujo nome começa com `releases/`:
|
||||
**Note:** {% data reusables.actions.branch-paths-filter %} For example, the following workflow will only run when a pull request that includes a change to a JavaScript (`.js`) file is opened on a branch whose name starts with `releases/`:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -828,7 +828,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.branch-paths-filter %} Por exemplo, o fluxo de trabalho a seguir será executado somente quando um pull request que inclui uma mudança para um arquivo (`.js`) do JavaScript for aberto em um branch cujo nome começa com `releases/`:
|
||||
**Note:** {% data reusables.actions.branch-paths-filter %} For example, the following workflow will only run when a pull request that includes a change to a JavaScript (`.js`) file is opened on a branch whose name starts with `releases/`:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -873,7 +873,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.branch-paths-filter %} Por exemplo, o fluxo de trabalho a seguir será executado somente quando um pull request que inclui uma mudança para um arquivo (`.js`) do JavaScript for aberto em um branch cujo nome começa com `releases/`:
|
||||
**Note:** {% data reusables.actions.branch-paths-filter %} For example, the following workflow will only run when a pull request that includes a change to a JavaScript (`.js`) file is opened on a branch whose name starts with `releases/`:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -950,7 +950,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.branch-paths-filter %} Por exemplo, o fluxo de trabalho a seguir será executado somente quando um push que inclui uma mudança para um arquivo (`.js`) do JavaScript é feito em um branch cujo nome começa com `releases/`:
|
||||
**Note:** {% data reusables.actions.branch-paths-filter %} For example, the following workflow will only run when a push that includes a change to a JavaScript (`.js`) file is made to a branch whose name starts with `releases/`:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -991,7 +991,7 @@ on:
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.github-actions.branch-paths-filter %} Por exemplo, o fluxo de trabalho a seguir será executado somente quando um push que inclui uma mudança para um arquivo (`.js`) do JavaScript é feito em um branch cujo nome começa com `releases/`:
|
||||
**Note:** {% data reusables.actions.branch-paths-filter %} For example, the following workflow will only run when a push that includes a change to a JavaScript (`.js`) file is made to a branch whose name starts with `releases/`:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -1016,7 +1016,7 @@ on:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando uma atividade relacionada ao {% data variables.product.prodname_registry %} ocorre no seu repositório. Para obter mais informações, consulte "[Documentação do {% data variables.product.prodname_registry %}](/packages)".
|
||||
|
||||
@@ -1068,7 +1068,7 @@ on:
|
||||
| ---------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------ | ------------- |
|
||||
| [repository_dispatch](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#repository_dispatch) | Personalizado | Último commit no branch padrão | Branch padrão |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Você pode usar a API do {% data variables.product.product_name %} para acionar um evento do webhook denominado [`repository_dispatch`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#repository_dispatch) quando quiser acionar um fluxo de trabalho para uma atividade que ocorre fora do {% data variables.product.product_name %}. Para obter mais informações, consulte "[Criar um evento de envio do repositório](/rest/reference/repos#create-a-repository-dispatch-event)".
|
||||
|
||||
@@ -1160,7 +1160,7 @@ As notificações de fluxos de trabalho agendados são enviadas ao usuário que
|
||||
| ---------------------------------------------------------------------------------------- | ------------------ | ------------------------------ | ------------ |
|
||||
| [`status`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads/#status) | n/a | Último commit no branch padrão | n/a |
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando o status do commit de Git é alterado. Por exemplo, os commits podem ser marcados como `erro`, `falha`, `pendente` ou `sucesso`. Se você quiser fornecer mais informações sobre a mudança de status, você deverá usar o evento [`check_run`](#check_run). Para obter informações sobre as APIs de status do commit, consulte "[Status](/graphql/reference/objects#statue)" na documentação da API do GraphQL ou "[Status](/rest/reference/commits#commit-statuses)" na documentação da API REST.
|
||||
|
||||
@@ -1201,7 +1201,7 @@ jobs:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
Executa o fluxo de trabalho quando o repositório do fluxo de trabalho é favoritado. Para obter informações sobre as APIs do pull request, consulte "[addStar](/graphql/reference/mutations#addstar)" na documentação da API do GraphQL ou "[Marcando como favorito](/rest/reference/activity#starring)" na documentação da API REST.
|
||||
|
||||
@@ -1343,7 +1343,7 @@ jobs:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.github-actions.branch-requirement %}
|
||||
{% data reusables.actions.branch-requirement %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -50,11 +50,11 @@ Você pode gerenciar seus segredos centralmente dentro de uma organização e, e
|
||||
|
||||
Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios.
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-organization %}
|
||||
{% data reusables.actions.permissions-statement-secrets-organization %}
|
||||
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
1. Clique em **Novo segredo**.
|
||||
1. Digite um nome para o seu segredo na caixa de entrada **Nome**.
|
||||
1. Insira o **Valor** para o seu segredo.
|
||||
|
||||
@@ -26,7 +26,7 @@ topics:
|
||||
|
||||
Os artefatos permitem que você persista com os dados após um trabalho ter sido concluído e compartilhe os dados com outro trabalho no mesmo fluxo de trabalho. Um artefato é um arquivo ou uma coleção de arquivos produzidos durante a execução de um fluxo de trabalho. Por exemplo, você pode usar artefatos para salvar a sua criação e testar a saída após uma conclusão da execução do fluxo de trabalho. {% data reusables.actions.reusable-workflow-artifacts %}
|
||||
|
||||
{% data reusables.github-actions.artifact-log-retention-statement %} O período de retenção para um pull request reinicia toda vez que alguém fizer um push de um novo commit para o pull request.
|
||||
{% data reusables.actions.artifact-log-retention-statement %} The retention period for a pull request restarts each time someone pushes a new commit to the pull request.
|
||||
|
||||
Esses são alguns dos artefatos comuns cujo upload você pode fazer:
|
||||
|
||||
@@ -37,7 +37,7 @@ Esses são alguns dos artefatos comuns cujo upload você pode fazer:
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
Armazenar artefatos consome espaço de armazenamento em {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} Para mais informações, consulte "[Gerenciando cobrança para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)".
|
||||
Armazenar artefatos consome espaço de armazenamento em {% data variables.product.product_name %}. {% data reusables.actions.actions-billing %} For more information, see "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)."
|
||||
|
||||
{% else %}
|
||||
|
||||
|
||||
@@ -41,7 +41,7 @@ As etapas a seguir ocorrem para acionar a execução de um fluxo de trabalho:
|
||||
|
||||
### Acionando um fluxo de trabalho a partir de um fluxo de trabalho
|
||||
|
||||
{% data reusables.github-actions.actions-do-not-trigger-workflows %} Para obter mais informações, consulte "[Efetuando a autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)".
|
||||
{% data reusables.actions.actions-do-not-trigger-workflows %} For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)."
|
||||
|
||||
Se você deseja acionar um fluxo de trabalho de dentro de uma execução de fluxo de trabalho, você pode usar um token de acesso pessoal em vez de `GITHUB_TOKEN` para acionar eventos que exigem um token. Você deverá criar um token de acesso pessoal e armazená-lo como um segredo. Para minimizar seus custos de uso {% data variables.product.prodname_actions %}, certifique-se de que você não cria execução de fluxo de trabalho recursivo ou não intencional. Para obter mais informações sobre a criação de um token de acesso pessoal, consulte[Criando um token de acesso pessoal](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." Para mais informações sobre como armazenar um token de acesso pessoal como segredo, consulte "[Criar e armazenar segredos criptografados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
|
||||
|
||||
@@ -89,23 +89,23 @@ Use a chave `on` para especificar quais eventos acionam o seu fluxo de trabalho.
|
||||
|
||||
### Using a single event
|
||||
|
||||
{% data reusables.github-actions.on-single-example %}
|
||||
{% data reusables.actions.on-single-example %}
|
||||
|
||||
### Using multiple events
|
||||
|
||||
{% data reusables.github-actions.on-multiple-example %}
|
||||
{% data reusables.actions.on-multiple-example %}
|
||||
|
||||
### Using activity types and filters with multiple events
|
||||
|
||||
É possível usar tipos de atividade e filtros para controlar ainda mais quando o fluxo de trabalho será executado. Para obter mais informações, consulte [Usando tipos de atividade do evento](#using-event-activity-types) e [Usando filtros](#using-filters). {% data reusables.github-actions.actions-multiple-types %}
|
||||
É possível usar tipos de atividade e filtros para controlar ainda mais quando o fluxo de trabalho será executado. Para obter mais informações, consulte [Usando tipos de atividade do evento](#using-event-activity-types) e [Usando filtros](#using-filters). {% data reusables.actions.actions-multiple-types %}
|
||||
|
||||
## Usando tipos de atividade do evento
|
||||
|
||||
{% data reusables.github-actions.actions-activity-types %}
|
||||
{% data reusables.actions.actions-activity-types %}
|
||||
|
||||
## Using filters
|
||||
|
||||
{% data reusables.github-actions.actions-filters %}
|
||||
{% data reusables.actions.actions-filters %}
|
||||
|
||||
### Usando filtros para direcionar branches específicos para eventos de pull request
|
||||
|
||||
@@ -125,7 +125,7 @@ Use a chave `on` para especificar quais eventos acionam o seu fluxo de trabalho.
|
||||
|
||||
## Definindo entradas para fluxos de trabalho acionados manualmente
|
||||
|
||||
{% data reusables.github-actions.workflow-dispatch-inputs %}
|
||||
{% data reusables.actions.workflow-dispatch-inputs %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}
|
||||
## Definindo entradas, saídas e segredos para fluxos de trabalho reutilizáveis
|
||||
|
||||
@@ -173,7 +173,7 @@ Um booleano que especifica se o segredo deve ser fornecido.
|
||||
|
||||
## `on.workflow_dispatch.inputs`
|
||||
|
||||
{% data reusables.github-actions.workflow-dispatch-inputs %}
|
||||
{% data reusables.actions.workflow-dispatch-inputs %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
## `permissões`
|
||||
@@ -318,7 +318,7 @@ Identificador exclusivo da etapa. Você pode usar `id` para fazer referência à
|
||||
|
||||
Você pode usar a condicional `if` para evitar que uma etapa trabalho seja executada a não ser que determinada condição seja atendida. Você pode usar qualquer contexto e expressão compatível para criar uma condicional.
|
||||
|
||||
{% data reusables.github-actions.expression-syntax-if %} Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions)".
|
||||
{% data reusables.actions.expression-syntax-if %} Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions)".
|
||||
|
||||
#### Exemplo: Usando contextos
|
||||
|
||||
@@ -759,7 +759,7 @@ strategy:
|
||||
|
||||
## `jobs.<job_id>.container`
|
||||
|
||||
{% data reusables.github-actions.docker-container-os-support %}
|
||||
{% data reusables.actions.docker-container-os-support %}
|
||||
|
||||
{% data reusables.actions.jobs.section-running-jobs-in-a-container %}
|
||||
|
||||
@@ -789,7 +789,7 @@ strategy:
|
||||
|
||||
## `jobs.<job_id>.services`
|
||||
|
||||
{% data reusables.github-actions.docker-container-os-support %}
|
||||
{% data reusables.actions.docker-container-os-support %}
|
||||
|
||||
Usado para hospedar contêineres de serviço para um trabalho em um fluxo de trabalho. Contêineres de serviço são úteis para a criação de bancos de dados ou serviços armazenamento em cache como o Redis. O executor cria automaticamente uma rede do Docker e gerencia o ciclo de vida dos contêineres do serviço.
|
||||
|
||||
|
||||
@@ -115,7 +115,7 @@ Permite encontrar o identificador universalmente exclusivo (UUID) do seu nó em
|
||||
```
|
||||
|
||||
{% ifversion ghes %}
|
||||
Permite isentar uma lista de usuários do limite de taxa de da API. Para obter mais informações, consulte "[Recursos na API REST](/rest/overview/resources-in-the-rest-api#rate-limiting)".
|
||||
Permite isentar uma lista de usuários do limite de taxa de da API. A hard limit of 120,000 requests will still apply to these users. Para obter mais informações, consulte "[Recursos na API REST](/rest/overview/resources-in-the-rest-api#rate-limiting)".
|
||||
|
||||
``` shell
|
||||
$ ghe-config app.github.rate-limiting-exempt-users "<em>hubot</em> <em>github-actions</em>"
|
||||
|
||||
@@ -70,4 +70,4 @@ Para restrições no nível da instância que usam o Azure NSGs, entre em contat
|
||||
|
||||
## Usar {% data variables.product.prodname_actions %} com uma lista endereços IP permitidos
|
||||
|
||||
{% data reusables.github-actions.ip-allow-list-self-hosted-runners %}
|
||||
{% data reusables.actions.ip-allow-list-self-hosted-runners %}
|
||||
|
||||
@@ -12,6 +12,16 @@ topics:
|
||||
- Enterprise
|
||||
---
|
||||
|
||||
{% ifversion ghes < 3.3 %}
|
||||
{% note %}
|
||||
|
||||
**Observação:** {% data reusables.enterprise.upgrade-ghes-for-actions %}
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
## Sobre {% data variables.product.prodname_actions %} para empresas
|
||||
|
||||
Com {% data variables.product.prodname_actions %}, você pode melhorar a produtividade do desenvolvedor automatizando todas as fases do fluxo de trabalho de desenvolvimento de software da sua empresa.
|
||||
|
||||
| Tarefa | Mais informações |
|
||||
@@ -23,18 +33,29 @@ Com {% data variables.product.prodname_actions %}, você pode melhorar a produti
|
||||
|
||||
{% data variables.product.prodname_actions %} ajuda a sua equipe a trabalhar mais rápido e em escala. Quando grandes repositórios começam a usar o {% data variables.product.prodname_actions %}, as equipes fazem merge de um número significativamente maior de pull requests por dia, e os pull requests são mesclados muito mais rapidamente. Para obter mais informações, consulte "[Gravação e envio mais rápido de código](https://octoverse.github.com/writing-code-faster/#scale-through-automation)" no estado do Octoverse.
|
||||
|
||||
{% data variables.product.prodname_actions %} também fornece maior controle sobre implantações. Por exemplo, você pode usar ambientes para exigir aprovação para um trabalho prosseguir ou restringir quais branches podem acionar um fluxo de trabalho, ou limitar o acesso a segredos.{% ifversion ghec or ghae-issue-4856 %} Se os seus fluxos de trabalho precisarem acessar recursos de um provedor de nuvem compatível com o OpenID Connect (OIDC), você poderá configurar seus fluxos de trabalho para efetuar a autenticação diretamente no provedor de nuvem. Isso permitirá que você pare de armazenar credenciais como segredos de longa duração e irá fornecer outros benefícios de segurança. Para obter mais informações, consulte[Sobre segurança fortalecida com OpenID Connect](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)."{% endif %}
|
||||
Você pode criar suas próprias automações exclusivas ou você pode usar e adaptar os fluxos de trabalho do nosso ecossistema de mais de 10, 00 ações construídas por líderes do setor e pela comunidade de código aberto. Para obter mais informações, consulte "[Localizar e personalizar ações](/actions/learn-github-actions/finding-and-customizing-actions)".
|
||||
|
||||
{% data variables.product.prodname_actions %} é intuitivo para o desenvolvedor, pois está integrado diretamente à experiência familiar de {% data variables.product.product_name %}.
|
||||
|
||||
Você pode criar suas próprias automações exclusivas ou você pode usar e adaptar os fluxos de trabalho do nosso ecossistema de mais de 10, 00 ações construídas por líderes do setor e pela comunidade de código aberto. Para obter mais informações, consulte "[Localizar e personalizar ações](/actions/learn-github-actions/finding-and-customizing-actions)".
|
||||
|
||||
{% ifversion ghec %}Você pode desfrutar da conveniência de executores hospedados em {% data variables.product.company_short %}, que são mantidos e atualizados por {% data variables.product.company_short %} ou você{% else %}{% endif %} pode controlar a sua própria infraestrutura privada de CI/CD usando executores auto-hospedados. Os executores auto-hospedados permitem que você determine o ambiente exato e os recursos que completam suas compilações, testes e implantações sem expor o seu ciclo de desenvolvimento de software à internet. Para obter mais informações, consulte {% ifversion ghec %}"[Sobre executores auto-hospedados em {% data variables.product.company_short %}](/actions/using-github-hosted-runners/about-github-hosted-runners)" e {% endif %} "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)."
|
||||
|
||||
{% data variables.product.prodname_actions %} provides greater control over deployments. Por exemplo, você pode usar ambientes para exigir aprovação para um trabalho prosseguir ou restringir quais branches podem acionar um fluxo de trabalho, ou limitar o acesso a segredos.{% ifversion ghec or ghae-issue-4856 %} Se os seus fluxos de trabalho precisarem acessar recursos de um provedor de nuvem compatível com o OpenID Connect (OIDC), você poderá configurar seus fluxos de trabalho para efetuar a autenticação diretamente no provedor de nuvem. OIDC provides security benefits such as eliminating the need to store credentials as long-lived secrets. Para obter mais informações, consulte[Sobre segurança fortalecida com OpenID Connect](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)."{% endif %}
|
||||
|
||||
{% data variables.product.prodname_actions %} também inclui ferramentas para governar o ciclo de desenvolvimento de software da sua empresa e atender às obrigações de conformidade. Para obter mais informações, consulte "[Aplicar políticas para {% data variables.product.prodname_actions %} na sua empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise)".
|
||||
|
||||
## About getting started with {% data variables.product.prodname_actions %}
|
||||
|
||||
{% data reusables.actions.introducing-enterprise %}
|
||||
|
||||
{% data reusables.actions.migrating-enterprise %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
{% data reusables.actions.ghes-actions-not-enabled-by-default %} After you finish planning, you can follow the instructions for enabling {% data variables.product.prodname_actions %}. For example, you may need to upgrade the CPU and memory resources for {% data variables.product.product_location %}. Para obter mais informações, consulte "[Primeiros passos com {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server)".
|
||||
|
||||
{% else %}
|
||||
After you finish planning, you can follow the instructions for getting started with {% data variables.product.prodname_actions %}. For more information, see {% ifversion ghec %}"[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_cloud %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud)."{% elsif ghae %}"[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_managed %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae)."{% endif %}
|
||||
{% endif %}
|
||||
|
||||
Para saber mais sobre como você pode fazer a adoção de {% data variables.product.prodname_actions %} com sucesso para sua empresa, siga o caminho de aprendizado "[Adotando {% data variables.product.prodname_actions %} para a sua empresa](/admin/guides#adopt-github-actions-for-your-enterprise)".
|
||||
|
||||
## Leia mais
|
||||
|
||||
|
||||
@@ -26,7 +26,7 @@ Este artigo explica como os administradores do site podem configurar {% data var
|
||||
|
||||
{% data reusables.enterprise.upgrade-ghes-for-actions %}
|
||||
|
||||
Por padrão, {% data variables.product.prodname_actions %} não está habilitado para {% data variables.product.prodname_ghe_server %}. Você precisará determinar se a sua instância tem recursos adequados de CPU e memória para administrar a carga do {% data variables.product.prodname_actions %} sem causar perda de desempenho, e possivelmente aumentar esses recursos. Você também deverá decidir qual provedor de armazenamento você usará para o armazenamento do blob necessário para armazenar os artefatos gerados pela execução do fluxo de trabalho. Em seguida, você irá habilitar {% data variables.product.prodname_actions %} para a sua empresa, gerenciar permissões de acesso e adicionar executores auto-hospedados para executar fluxos de trabalho.
|
||||
{% data reusables.actions.ghes-actions-not-enabled-by-default %} You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from {% data variables.product.prodname_actions %} without causing performance loss, and possibly increase those resources. Você também deverá decidir qual provedor de armazenamento você usará para o armazenamento do blob necessário para armazenar os artefatos gerados pela execução do fluxo de trabalho. Em seguida, você irá habilitar {% data variables.product.prodname_actions %} para a sua empresa, gerenciar permissões de acesso e adicionar executores auto-hospedados para executar fluxos de trabalho.
|
||||
|
||||
{% data reusables.actions.introducing-enterprise %}
|
||||
|
||||
|
||||
@@ -85,6 +85,12 @@ Sempre que seus desenvolvedores de fluxo de trabalho quiserem usar uma ação qu
|
||||
|
||||
Você deve planejar como você gerenciará os recursos necessários para usar o {% data variables.product.prodname_actions %}.
|
||||
|
||||
{% ifversion ghes %}
|
||||
### Hardware requirements
|
||||
|
||||
You may need to upgrade the CPU and memory resources for {% data variables.product.product_location %} to handle the load from {% data variables.product.prodname_actions %} without causing performance loss. For more information, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-requirements)."
|
||||
{% endif %}
|
||||
|
||||
### Executores
|
||||
|
||||
Os fluxos de trabalho de {% data variables.product.prodname_actions %}} exigem executores.{% ifversion ghec %} Você pode escolher usar executores hospedados em {% data variables.product.prodname_dotcom %} ou executores auto-hospedados. Os executores hospedados em {% data variables.product.prodname_dotcom %} são convenientes porque são gerenciados por {% data variables.product.company_short %}, que administram a manutenção e atualizações para você. No entanto você deverá considerar os executores auto-hospedados se você precisar executar um fluxo de trabalho que terá acesso aos recursos por trás de seu firewall ou você quiser ter mais controle sobre os recursos, configuração, ou localização geográfica das máquinas dos seus executores. Para obter mais informações, consulte "[Sobre executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/using-github-hosted-runners/about-github-hosted-runners)" e "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners).{% else %} Você deverá hospedar seus próprios executores instalando o aplicativo de executor auto-hospedado em {% data variables.product.prodname_actions %} nas suas próprias máquinas. Para obter mais informações, consulte "[Sobre executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)."{% endif %}
|
||||
@@ -111,7 +117,7 @@ Você deve configurar o armazenamento externo de blob para estes artefatos. Esco
|
||||
|
||||
{% ifversion ghec or ghes %}
|
||||
|
||||
{% data reusables.github-actions.artifact-log-retention-statement %}
|
||||
{% data reusables.actions.artifact-log-retention-statement %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -136,5 +136,6 @@ includeGuides:
|
||||
- /admin/user-management/requiring-two-factor-authentication-for-an-organization
|
||||
- /admin/user-management/suspending-and-unsuspending-users
|
||||
- /admin/overview/creating-an-enterprise-account
|
||||
- /admin/user-management/managing-organizations-in-your-enterprise/restoring-a-deleted-organization
|
||||
---
|
||||
|
||||
|
||||
@@ -71,7 +71,7 @@ Você pode optar por desativar {% data variables.product.prodname_actions %} par
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.github-actions.change-retention-period-for-artifacts-logs %}
|
||||
{% data reusables.actions.change-retention-period-for-artifacts-logs %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -88,7 +88,7 @@ Você pode aplicar políticas para controlar como {% data variables.product.prod
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.github-actions.workflows-from-public-fork-setting %}
|
||||
{% data reusables.actions.workflows-from-public-fork-setting %}
|
||||
|
||||
{% data reusables.actions.workflow-run-approve-link %}
|
||||
|
||||
@@ -98,16 +98,16 @@ Você pode aplicar políticas para controlar como {% data variables.product.prod
|
||||
|
||||
### Aplicando uma política para bifurcar pull requests em repositórios privados
|
||||
|
||||
{% data reusables.github-actions.private-repository-forks-overview %}
|
||||
{% data reusables.actions.private-repository-forks-overview %}
|
||||
|
||||
Se uma política for habilitada para uma empresa, ela poderá ser desabilitada seletivamente em organizações individuais ou repositórios. Se uma política estiver desabilitada para uma empresa, as organizações individuais ou repositórios não poderão habilitá-la.
|
||||
|
||||
{% data reusables.github-actions.private-repository-forks-options %}
|
||||
{% data reusables.actions.private-repository-forks-options %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.actions-tab %}
|
||||
{% data reusables.github-actions.private-repository-forks-configure %}
|
||||
{% data reusables.actions.private-repository-forks-configure %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -115,11 +115,11 @@ Se uma política for habilitada para uma empresa, ela poderá ser desabilitada s
|
||||
|
||||
## Aplicando uma política de permissões de fluxo de trabalho na sua empresa
|
||||
|
||||
{% data reusables.github-actions.workflow-permissions-intro %}
|
||||
{% data reusables.actions.workflow-permissions-intro %}
|
||||
|
||||
Você pode definir as permissões padrão para o `GITHUB_TOKEN` nas configurações para sua empresa, organizações ou repositórios. Se você escolher a opção restrita como padrão nas configurações da empresa, isto impedirá que a configuração mais permissiva seja escolhida nas configurações da organização ou repositório.
|
||||
|
||||
{% data reusables.github-actions.workflow-permissions-modifying %}
|
||||
{% data reusables.actions.workflow-permissions-modifying %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
|
||||
@@ -116,7 +116,7 @@ Você também pode configurar endereços IP permitidos para uma organização in
|
||||
|
||||
### Usar {% data variables.product.prodname_actions %} com uma lista endereços IP permitidos
|
||||
|
||||
{% data reusables.github-actions.ip-allow-list-self-hosted-runners %}
|
||||
{% data reusables.actions.ip-allow-list-self-hosted-runners %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -126,9 +126,11 @@ Você também pode configurar endereços IP permitidos para uma organização in
|
||||
|
||||
Você pode usar as autoridades de certificados SSH (CA) para permitir que os integrantes de qualquer organização pertencente à sua empresa acessem os repositórios da organização usando certificados SSH que você fornecer. {% data reusables.organizations.can-require-ssh-cert %} Para obter mais informações, consulte "[Sobre autoridades certificadas de SSH](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities)".
|
||||
|
||||
{% data reusables.organizations.add-extension-to-cert %}
|
||||
|
||||
### Adicionar uma autoridade certificada de SSH
|
||||
|
||||
{% data reusables.organizations.add-extension-to-cert %}
|
||||
If you require SSH certificates for your enterprise, enterprise members should use a special URL for Git operations over SSH. Para obter mais informações, consulte "[Sobre autoridades certificadas SSH](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities#about-ssh-urls-with-ssh-certificates)".
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
|
||||
@@ -27,6 +27,7 @@ children:
|
||||
- /streaming-the-audit-logs-for-organizations-in-your-enterprise-account
|
||||
- /removing-users-from-teams-and-organizations
|
||||
- /removing-organizations-from-your-enterprise
|
||||
- /restoring-a-deleted-organization
|
||||
- /managing-projects-using-jira
|
||||
- /continuous-integration-using-jenkins
|
||||
shortTitle: Gerenciar organizações
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: Restoring a deleted organization
|
||||
intro: 'You can partially restore an organization that was previously deleted on {% data variables.product.product_location %}.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Administrator
|
||||
- Enterprise
|
||||
- Organizations
|
||||
shortTitle: Restore organization
|
||||
permissions: 'Site administers can restore an organization on {% data variables.product.product_name %}.'
|
||||
---
|
||||
|
||||
## About organization restoration
|
||||
|
||||
You can use the site admin dashboard to restore an organization that was previously deleted on {% data variables.product.product_location %}, as long as the audit log Elasticsearch indices contain the data for the `org.delete` event.
|
||||
|
||||
Immediately after you restore an organization, the organization will not be exactly the same as it was prior to the deletion. You'll have to manually restore any repositories that were owned by the organization. Para obter mais informações, consulte "[Restaurar um repositório excluído](/admin/user-management/managing-repositories-in-your-enterprise/restoring-a-deleted-repository)".
|
||||
|
||||
You can also use the audit log to help you manually re-add teams and organization members. For more information, see "[Restoring members and teams](#restoring-members-and-teams)."
|
||||
|
||||
## Restoring an organization
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
1. Under "Search users, organizations, enterprises, teams, repositories, gists, and applications", search for the organization.
|
||||
|
||||
|
||||
|
||||
1. Under "Deleted accounts", to the right of the organization you want to restore, select the {% octicon "kebab-horizontal" aria-label="The edit icon" %} dropdown menu, then click **Recreate**.
|
||||
|
||||
|
||||
|
||||
## Restoring members and teams
|
||||
|
||||
You can use the audit log to find a list of the previous members and teams of the organization, then recreate them manually. For more information about using the audit log, see "[Auditing users across your enterprise](/admin/user-management/managing-users-in-your-enterprise/auditing-users-across-your-enterprise)."
|
||||
|
||||
In all the search phrases below, replace ORGANIZATION with the name of the organization and TEAM with the name of the team.
|
||||
|
||||
### Restoring organization members
|
||||
|
||||
1. To find all users who were added to and removed from the organization, search the audit log for `action:org.add_member org:ORGANIZATION` and `action:org.remove_member org:ORGANIZATION`.
|
||||
1. Manually add to the organization each user that should still be a member. For more information, see "[Adding people to your organization](/organizations/managing-membership-in-your-organization/adding-people-to-your-organization)."
|
||||
|
||||
### Restoring teams
|
||||
|
||||
1. To find each team name, search the audit log for `action:team.create org:ORGANIZATION`.
|
||||
1. Manually recreate the team. For more information, see "[Creating a team](/organizations/organizing-members-into-teams/creating-a-team)."
|
||||
1. To find the members that have been added to each team, search for `action:team.add_member team:"ORGANIZATION/TEAM"`.
|
||||
1. Manually re-add the team members. For more information, see "[Adding organization members to a team](/organizations/organizing-members-into-teams/adding-organization-members-to-a-team)."
|
||||
1. To find the repositories that the team was granted access to, search for `action:team.add_repository team:"ORGANIZATION/TEAM"`.
|
||||
1. To find the access level that the team was granted for each repository, search for `action:team.update_repository_permission team:"ORGANIZATION/TEAM"`.
|
||||
1. Manually give the team access again. Para obter mais informações, consulte "[Gerenciando o acesso da equipe ao repositório de uma organização](/organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository)".
|
||||
@@ -28,7 +28,12 @@ shortTitle: Chaves GPG existentes
|
||||
{% data reusables.gpg.list-keys-with-note %}
|
||||
3. Verifique a saída do comando para ver se você tem um par de chaves GPG.
|
||||
* Se não houver pares de chaves GPG ou se você não quiser usar as que estiverem disponíveis para assinatura de commits e tags, [gere outra chave GPG](/articles/generating-a-new-gpg-key).
|
||||
* Se houver um par de chaves GPG e você quiser usá-lo para assinar commits e tags, [adicione a chave GPG à sua conta do GitHub](/articles/adding-a-new-gpg-key-to-your-github-account).
|
||||
* If there's an existing GPG key pair and you want to use it to sign commits and tags, you can display the public key using the following command, substituting in the GPG key ID you'd like to use. Neste exemplo, o ID da chave GPG é `3AA5C34371567BD2`:
|
||||
```shell
|
||||
$ gpg --armor --export <em>3AA5C34371567BD2</em>
|
||||
# Prints the GPG key ID, in ASCII armor format
|
||||
```
|
||||
You can then [add your GPG key to your GitHub account](/articles/adding-a-new-gpg-key-to-your-github-account).
|
||||
|
||||
## Leia mais
|
||||
|
||||
|
||||
@@ -45,6 +45,12 @@ Se você tiver várias chaves GPG, precisará informar ao Git qual deve ser usad
|
||||
$ if [ -r ~/.bash_profile ]; then echo 'export GPG_TTY=$(tty)' >> ~/.bash_profile; \
|
||||
else echo 'export GPG_TTY=$(tty)' >> ~/.profile; fi
|
||||
```
|
||||
1. Optionally, to prompt you to enter a PIN or passphrase when required, install `pinentry-mac`. For example, using [Homebrew](https://brew.sh/):
|
||||
```shell
|
||||
$ brew install pinentry-mac
|
||||
$ echo "pinentry-program $(which pinentry-mac)" >> ~/.gnupg/gpg-agent.conf
|
||||
$ killall gpg-agent
|
||||
```
|
||||
|
||||
{% data reusables.gpg.x-509-key %}
|
||||
|
||||
|
||||
@@ -16,9 +16,9 @@ shortTitle: Cobrança para o GitHub Actions
|
||||
|
||||
## Sobre a cobrança do {% data variables.product.prodname_actions %}
|
||||
|
||||
{% data reusables.github-actions.actions-billing %}
|
||||
{% data reusables.actions.actions-billing %}
|
||||
|
||||
{% data reusables.github-actions.actions-spending-limit-brief %} Para obter mais informações, consulte "[Sobre limites de gastos](#about-spending-limits)".
|
||||
{% data reusables.actions.actions-spending-limit-brief %} Para obter mais informações, consulte "[Sobre limites de gastos](#about-spending-limits)".
|
||||
|
||||
{% ifversion ghec %}
|
||||
Se você comprou {% data variables.product.prodname_enterprise %} por meio de um Contrato da Microsoft Enterprise, você pode conectar o ID da sua assinatura do Azure à sua conta corporativa para habilitar e pagar pelo uso de {% data variables.product.prodname_actions %} além dos valores incluindo na sua conta. Para obter mais informações, consulte "[Conectar uma assinatura do Azure à sua empresa](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)".
|
||||
@@ -99,7 +99,7 @@ Se uso de {% data variables.product.prodname_actions %} compartilha a data de co
|
||||
|
||||
## Sobre limites de gastos
|
||||
|
||||
{% data reusables.github-actions.actions-spending-limit-detailed %}
|
||||
{% data reusables.actions.actions-spending-limit-detailed %}
|
||||
|
||||
Para obter informações sobre como gerenciar e alterar o limite de gastos da sua conta, consulte "[Gerenciar seu limite de gastos para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)".
|
||||
|
||||
|
||||
@@ -19,9 +19,9 @@ shortTitle: Limites de gastos para ações
|
||||
|
||||
## Sobre sintaxe limites de gastos para o {% data variables.product.prodname_actions %}
|
||||
|
||||
{% data reusables.github-actions.actions-billing %}
|
||||
{% data reusables.actions.actions-billing %}
|
||||
|
||||
{% data reusables.github-actions.actions-spending-limit-brief %}
|
||||
{% data reusables.actions.actions-spending-limit-brief %}
|
||||
|
||||
{% data reusables.actions.actions-packages-set-spending-limit %} Para obter mais informações sobre os preços para uso de {% data variables.product.prodname_actions %}, consulte "[Sobre cobrança para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)".
|
||||
|
||||
|
||||
@@ -43,7 +43,7 @@ Proprietários de organizações e gestores de faturamento podem visualizar o us
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota:** Os detalhes de faturamento para contas corporativas não resumem os minutos de uso para cada sistema operacional. {% data reusables.github-actions.enterprise-billing-details %}
|
||||
**Nota:** Os detalhes de faturamento para contas corporativas não resumem os minutos de uso para cada sistema operacional. {% data reusables.actions.enterprise-billing-details %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
||||
@@ -42,7 +42,7 @@ Proprietários de organizações e gestores de faturamento podem visualizar o us
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota:** Os detalhes de faturamento para contas corporativas somente resumem o uso de dados de armazenamento por organização. {% data reusables.github-actions.enterprise-billing-details %}
|
||||
**Nota:** Os detalhes de faturamento para contas corporativas somente resumem o uso de dados de armazenamento por organização. {% data reusables.actions.enterprise-billing-details %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
||||
@@ -64,3 +64,44 @@ Deve-se sempre designar um endereço como o destinatário principal. O endereço
|
||||
1. Para inserir o usuário na lista, clique em **Editar**. 
|
||||
1. À direita do endereço de e-mail, use o menu suspenso "Editar" e clique em **Remover**. 
|
||||
1. Revise a instrução de confirmação e clique em **Remover**.
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Setting your enterprise's billing email
|
||||
|
||||
Your enterprise's billing email is where {% data variables.product.product_name %} sends receipts and other billing-related communication. The email address does not need to be unique to the enterprise account.
|
||||
|
||||
Only enterprise members with the owner or billing manager role can access or change billing settings for your enterprise. For more information, see "[Managing users in your enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)."
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.billing-tab %}
|
||||
1. Click **Billing emails**.
|
||||
2. Under "Email recipients", to the right of the billing email address, click **Edit**. 
|
||||
2. Insira um endereço de e-mail válido e clique **Atualizar**. 
|
||||
|
||||
## Managing additional recipients for your enterprise's billing email
|
||||
|
||||
Se você tiver usuários que desejem receber relatórios de cobrança, você poderá adicionar seus endereços de e-mail como destinatários de e-mail de cobrança.
|
||||
|
||||
Only enterprise members with the owner or billing manager role can access or change billing settings for your enterprise. For more information, see "[Managing users in your enterprise](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)."
|
||||
|
||||
### Adicionar um destinatário para notificações de cobrança
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.billing-tab %}
|
||||
1. Click **Billing emails**.
|
||||
2. Under "Email recipients", to the right of the billing email address, click **Add**. 
|
||||
3. Digite o endereço de e-mail do destinatário e, em seguida, clique em **Adicionar**. 
|
||||
|
||||
### Remover um destinatário das notificações de cobrança
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.billing-tab %}
|
||||
1. Click **Billing emails**.
|
||||
2. Em "Destinatários de e-mail", encontre o endereço de e-mail que deseja remover.
|
||||
3. Para inserir o usuário na lista, clique em **Editar**. 
|
||||
4. À direita do endereço de e-mail, use o menu suspenso "Editar" e clique em **Remover**. 
|
||||
5. Revise a instrução de confirmação e clique em **Remover**.
|
||||
{% endif %}
|
||||
|
||||
@@ -86,7 +86,11 @@ jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
permissions:
|
||||
security-events: write{% endif %}
|
||||
# required for all workflows
|
||||
security-events: write
|
||||
# only required for workflows in private repositories
|
||||
actions: read
|
||||
contents: read{% endif %}
|
||||
steps:
|
||||
# This step checks out a copy of your repository.
|
||||
- name: Checkout repository
|
||||
@@ -123,7 +127,11 @@ jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
permissions:
|
||||
security-events: write{% endif %}
|
||||
# required for all workflows
|
||||
security-events: write
|
||||
# only required for workflows in private repositories
|
||||
actions: read
|
||||
contents: read{% endif %}
|
||||
steps:
|
||||
- uses: actions/checkout@v2
|
||||
- name: Run npm install
|
||||
|
||||
@@ -44,11 +44,11 @@ O nome de um segredo de {% data variables.product.prodname_dependabot %}:
|
||||
|
||||
## Adicionar um repositório secreto para {% data variables.product.prodname_dependabot %}
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-repository %}
|
||||
{% data reusables.actions.permissions-statement-secrets-repository %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
{% data reusables.dependabot.dependabot-secrets-button %}
|
||||
1. Clique em **Novo segredo do repositório**.
|
||||
1. Digite um nome para o seu segredo na caixa de entrada **Nome**.
|
||||
@@ -63,11 +63,11 @@ O nome de um segredo de {% data variables.product.prodname_dependabot %}:
|
||||
|
||||
Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios.
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-organization %}
|
||||
{% data reusables.actions.permissions-statement-secrets-organization %}
|
||||
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
{% data reusables.dependabot.dependabot-secrets-button %}
|
||||
1. Clique em **Novo segredo da organização**.
|
||||
1. Digite um nome para o seu segredo na caixa de entrada **Nome**.
|
||||
|
||||
@@ -51,7 +51,7 @@ Para criar segredos para um repositório da organização, você deve ter acesso
|
||||
|
||||
Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios.
|
||||
|
||||
{% data reusables.github-actions.permissions-statement-secrets-organization %}
|
||||
{% data reusables.actions.permissions-statement-secrets-organization %}
|
||||
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
@@ -68,7 +68,7 @@ Você pode verificar quais políticas de acesso são aplicadas a um segredo na s
|
||||
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.github-actions.sidebar-secret %}
|
||||
{% data reusables.actions.sidebar-secret %}
|
||||
1. A lista de segredos inclui quaisquer permissões e políticas configuradas. Por exemplo: 
|
||||
1. Para obter mais detalhes sobre as permissões configuradas para cada segredo, clique em **Atualizar**.
|
||||
|
||||
|
||||
@@ -89,7 +89,7 @@ Além dos recursos disponíveis no {% data variables.product.prodname_free_team
|
||||
|
||||
{% data variables.product.company_short %} realiza a cobrança para {% data variables.product.prodname_team %} por usuário. Para obter mais informações, consulte "[Sobre os preços por usuário]({% ifversion not fpt %}/free-pro-team@latest{% endif %}/billing/managing-billing-for-your-github-account/about-per-user-pricing){% ifversion fpt %}. "{% else %}" na documentação dos planos Grátis, Pro, & Equipe.{% endif %}
|
||||
|
||||
{% data reusables.github-actions.actions-billing %}
|
||||
{% data reusables.actions.actions-billing %}
|
||||
|
||||
## {% data variables.product.prodname_enterprise %}
|
||||
|
||||
|
||||
@@ -82,4 +82,4 @@ Para mais informações sobre como criar uma lista de permissões para uma {% da
|
||||
|
||||
## Usar {% data variables.product.prodname_actions %} com uma lista endereços IP permitidos
|
||||
|
||||
{% data reusables.github-actions.ip-allow-list-self-hosted-runners %}
|
||||
{% data reusables.actions.ip-allow-list-self-hosted-runners %}
|
||||
|
||||
@@ -28,9 +28,15 @@ Por exemplo, você pode desenvolver um sistema interno que emite um novo certifi
|
||||
Integrantes da organização podem usar os certificados assinados para autenticação mesmo que você tenha aplicado o logon único SAML. A menos que você exija certificados SSH, os integrantes podem continuar a usar outros meios de autenticação para acessar os recursos da organização no Git, como o nome de usuário e senha deles, tokens de acesso pessoais e outras chaves SSH próprias.
|
||||
{% endif %}
|
||||
|
||||
Os integrantes não poderão usar seus certificados para acessar bifurcações dos seus repositórios que são propriedade das contas de usuário.
|
||||
Members will not be able to use their certificates to access forks of your repositories that are owned by their personal accounts.
|
||||
|
||||
Para evitar erros de autenticação, os integrantes da organização devem usar uma URL especial que inclua o ID da organização para clonar repositórios usando certificados assinados. Qualquer pessoa com acesso de leitura no repositório pode localizar essa URL na página do repositório. Para obter mais informações, consulte "[Clonar um repositório](/articles/cloning-a-repository)".
|
||||
## About SSH URLs with SSH certificates
|
||||
|
||||
If your organization requires SSH certificates, to prevent authentication errors, organization members should use a special URL that includes the organization ID when performing Git operations over SSH. This special URL allows the client and server to more easily negotiate which key on the member's computer should be used for authentication. If a member uses the normal URL, which starts with `git@github.com`, the SSH client might offer the wrong key, causing the operation to fail.
|
||||
|
||||
Anyone with read access to the repository can find this URL by selecting the **Code** dropdown menu on the main page of the repository, then clicking **Use SSH**.
|
||||
|
||||
If your organization doesn't require SSH certificates, members can continue to use their own SSH keys, or other means of authentication. In that case, either the special URL or the normal URL, which starts with `git@github.com`, will work.
|
||||
|
||||
## Emitindo certificados
|
||||
|
||||
|
||||
@@ -20,9 +20,11 @@ Proprietários da organização podem gerenciar as autoridades certificadas (CA,
|
||||
|
||||
Você pode permitir que os integrantes acessem os repositórios da organização com certificados SSH fornecidos por você, adicionando um CA SSH à organização. {% data reusables.organizations.can-require-ssh-cert %} Para obter mais informações, consulte "[Sobre autoridades certificadas de SSH](/articles/about-ssh-certificate-authorities)".
|
||||
|
||||
{% data reusables.organizations.add-extension-to-cert %}
|
||||
|
||||
## Adicionar uma autoridade certificada de SSH
|
||||
|
||||
{% data reusables.organizations.add-extension-to-cert %}
|
||||
If you require SSH certificates for your enterprise, enterprise members should use a special URL for Git operations over SSH. Para obter mais informações, consulte "[Sobre autoridades certificadas SSH](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities#about-ssh-urls-with-ssh-certificates)".
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
|
||||
@@ -21,4 +21,4 @@ shortTitle: Configurar período de retenção
|
||||
{% data reusables.organizations.navigate-to-org %}
|
||||
{% data reusables.organizations.org_settings %}
|
||||
{% data reusables.organizations.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.change-retention-period-for-artifacts-logs %}
|
||||
{% data reusables.actions.change-retention-period-for-artifacts-logs %}
|
||||
|
||||
@@ -12,7 +12,7 @@ versions:
|
||||
topics:
|
||||
- Organizations
|
||||
- Teams
|
||||
shortTitle: Excluir conta da organização
|
||||
shortTitle: Delete organization
|
||||
---
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
@@ -26,7 +26,15 @@ shortTitle: Excluir conta da organização
|
||||
|
||||
## 1. Fazer backup do conteúdo da organização
|
||||
|
||||
Depois que você exclui uma organização, o GitHub **não pode restaurar o conteúdo que você tem lá**. Portanto, antes de excluir sua organização, certifique-se de ter uma cópia de todos os repositórios, wikis, problemas e quadros de projetos da conta.
|
||||
{% ifversion not ghes %} After you delete an organization, {% data variables.product.company_short %} **cannot restore your content**. Therefore, before{% else %}Before{% endif %} you delete your organization, make sure you have a copy of all repositories, wikis, issues, and project boards from the account.
|
||||
|
||||
{% ifversion ghes %}
|
||||
{% note %}
|
||||
|
||||
**Note:** If necessary, a site administrator for {% data variables.product.product_location %} may be able to partially restore a deleted organization. For more information, see "[Restoring a deleted organization](/admin/user-management/managing-organizations-in-your-enterprise/restoring-a-deleted-organization)."
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
## 2. Excluir a organização
|
||||
|
||||
|
||||
@@ -19,11 +19,11 @@ shortTitle: Desativar ou limitar ações
|
||||
|
||||
## Sobre as permissões de {% data variables.product.prodname_actions %} para a sua organização
|
||||
|
||||
{% data reusables.github-actions.disabling-github-actions %} Para mais informações sobre {% data variables.product.prodname_actions %}, consulte "[Sobre {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)."
|
||||
{% data reusables.actions.disabling-github-actions %} Para mais informações sobre {% data variables.product.prodname_actions %}, consulte "[Sobre {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)."
|
||||
|
||||
Você pode habilitar o {% data variables.product.prodname_actions %} para todos os repositórios da sua organização. {% data reusables.github-actions.enabled-actions-description %} Você pode desabilitar {% data variables.product.prodname_actions %} para todos os repositórios da sua organização. {% data reusables.github-actions.disabled-actions-description %}
|
||||
Você pode habilitar o {% data variables.product.prodname_actions %} para todos os repositórios da sua organização. {% data reusables.actions.enabled-actions-description %} Você pode desabilitar {% data variables.product.prodname_actions %} para todos os repositórios da sua organização. {% data reusables.actions.disabled-actions-description %}
|
||||
|
||||
Como alternativa, você pode habilitar o {% data variables.product.prodname_actions %} para todos os repositórios na sua organização e limitar as ações que um fluxo de trabalho pode executar. {% data reusables.github-actions.enabled-local-github-actions %}
|
||||
Como alternativa, você pode habilitar o {% data variables.product.prodname_actions %} para todos os repositórios na sua organização e limitar as ações que um fluxo de trabalho pode executar. {% data reusables.actions.enabled-local-github-actions %}
|
||||
|
||||
## Gerenciar as permissões de {% data variables.product.prodname_actions %} para a sua organização
|
||||
|
||||
@@ -68,7 +68,7 @@ Você pode configurar esse comportamento para uma organização seguindo o proce
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
{% data reusables.organizations.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.workflows-from-public-fork-setting %}
|
||||
{% data reusables.actions.workflows-from-public-fork-setting %}
|
||||
|
||||
{% data reusables.actions.workflow-run-approve-link %}
|
||||
{% endif %}
|
||||
@@ -76,28 +76,28 @@ Você pode configurar esse comportamento para uma organização seguindo o proce
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
## Habilitar fluxos de trabalho para bifurcações privadas do repositório
|
||||
|
||||
{% data reusables.github-actions.private-repository-forks-overview %}
|
||||
{% data reusables.actions.private-repository-forks-overview %}
|
||||
|
||||
{% ifversion ghec or ghae or ghes %}Se uma política estiver desabilitada para uma empresa, ela não poderá ser habilitada para as organizações.{% endif %} Se uma política estiver desabilitada para uma organização, ela não poderá ser habilitada para repositórios. Se uma organização habilitar uma política, a política poderá ser desabilitada para repositórios individuais.
|
||||
|
||||
{% data reusables.github-actions.private-repository-forks-options %}
|
||||
{% data reusables.actions.private-repository-forks-options %}
|
||||
|
||||
### Configurar a política de bifurcação privada para uma organização
|
||||
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
{% data reusables.organizations.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.private-repository-forks-configure %}
|
||||
{% data reusables.actions.private-repository-forks-configure %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
## Definindo as permissões do `GITHUB_TOKEN` para a sua organização
|
||||
|
||||
{% data reusables.github-actions.workflow-permissions-intro %}
|
||||
{% data reusables.actions.workflow-permissions-intro %}
|
||||
|
||||
Você pode definir as permissões padrão para o `GITHUB_TOKEN` nas configurações para a sua organização ou repositórios. Se você escolher a opção restrita como padrão nas configurações da sua organização, a mesma opção será selecionada automaticamente nas configurações dos repositórios na organização, e a opção permissiva ficará desabilitada. Se sua organização pertence a uma conta {% data variables.product.prodname_enterprise %} e o padrão mais restrito foi selecionado nas configurações corporativas, você não poderá de escolher o padrão mais permissivo nas configurações da organização.
|
||||
|
||||
{% data reusables.github-actions.workflow-permissions-modifying %}
|
||||
{% data reusables.actions.workflow-permissions-modifying %}
|
||||
|
||||
### Configurar as permissões padrão do `GITHUB_TOKEN`
|
||||
|
||||
|
||||
@@ -13,6 +13,7 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Pull requests
|
||||
permissions: People with write access for a forked repository can sync the fork to the upstream repository.
|
||||
---
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
@@ -20,8 +21,8 @@ topics:
|
||||
## Sincronizando uma bifurcação a partir da interface de usuário da web
|
||||
|
||||
1. Em {% data variables.product.product_name %}, acesse a página principal do repositório bifurcado que você deseja sincronizar com o repositório upstream.
|
||||
1. Selecione o menu suspenso **Buscar a upstream**. 
|
||||
1. Revise as informações sobre os commits do repositório upstream e, em seguida, clique em **Buscar e merge**. 
|
||||
2. Selecione o menu suspenso **Buscar a upstream**. 
|
||||
3. Revise as informações sobre os commits do repositório upstream e, em seguida, clique em **Buscar e merge**. 
|
||||
|
||||
Se as alterações do repositório a upstream gerarem conflitos, {% data variables.product.company_short %} solicitará a criação de um pull request para resolver os conflitos.
|
||||
|
||||
@@ -33,6 +34,7 @@ Para poder sincronizar a bifurcação com o repositório upstream, você deve [c
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
2. Altere o diretório de trabalho atual referente ao seu projeto local.
|
||||
3. Obtenha os branches e os respectivos commits do repositório upstream. Os commits para `BRANCHNAME` serão armazenados no branch local `upstream/BRANCHNAME`.
|
||||
|
||||
```shell
|
||||
$ git fetch upstream
|
||||
> remote: Counting objects: 75, done.
|
||||
@@ -42,12 +44,16 @@ Para poder sincronizar a bifurcação com o repositório upstream, você deve [c
|
||||
> From https://{% data variables.command_line.codeblock %}/<em>ORIGINAL_OWNER</em>/<em>ORIGINAL_REPOSITORY</em>
|
||||
> * [new branch] main -> upstream/main
|
||||
```
|
||||
|
||||
4. Faça o checkout do branch padrão local da sua bifurcação - neste caso, nós usamos o `principal`.
|
||||
|
||||
```shell
|
||||
$ git checkout main
|
||||
> Switched to branch 'main'
|
||||
```
|
||||
|
||||
5. Faça merge das alterações do branch padrão upstream - nesse caso, `upstream/main` - no seu branch padrão local. Isso coloca o branch padrão da bifurcação em sincronia com o repositório upstream, sem perder as alterações locais.
|
||||
|
||||
```shell
|
||||
$ git merge upstream/main
|
||||
> Updating a422352..5fdff0f
|
||||
|
||||
@@ -6,6 +6,7 @@ redirect_from:
|
||||
- /github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order
|
||||
- /github/committing-changes-to-your-project/about-commits
|
||||
- /github/committing-changes-to-your-project/creating-and-editing-commits/about-commits
|
||||
- /pull-requests/committing-changes-to-your-project/viewing-and-comparing-commits/commit-branch-and-tag-labels
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -24,5 +25,20 @@ Também é possível criar um commit em nome de uma organização. Para obter ma
|
||||
|
||||
O rebase permite que você altere uma série de commits e pode modificar a ordem dos commits na sua linha do tempo. Para obter mais informações, consulte "[Sobre o rebase do git](/github/getting-started-with-github/about-git-rebase)".
|
||||
|
||||
## About commit branches and tag labels
|
||||
|
||||
You can see which branch a commit is on by looking at the labels beneath the commit on the commit page.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.navigate-to-commit-page %}
|
||||
1. Navegue até o commit clicando no link da mensagem do commit. 
|
||||
2. To see what branch the commit is on, check the label below the commit message. 
|
||||
|
||||
If your commit is not on the default branch (`main`), the label will show the branches which contain the commit. If the commit is part of an unmerged pull request, you can click the link to go to the pull request.
|
||||
|
||||
Assim que o commit estiver no branch padrão, todas as tags que contêm o commit serão mostradas e o branch padrão será o único branch listado. For more information on tags, see "[Git Basics - Tagging](https://git-scm.com/book/en/v2/Git-Basics-Tagging)" in the Git documentation.
|
||||
|
||||
|
||||
|
||||
## Leia mais
|
||||
- "[Fazer commit e revisar alterações no seu projeto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project#about-commits)" em {% data variables.product.prodname_desktop %}
|
||||
|
||||
@@ -1,27 +0,0 @@
|
||||
---
|
||||
title: Fazer commit de etiquetas de tag e branch
|
||||
intro: Você pode ver facilmente em qual branch um commit está observando as etiquetas abaixo do commit na página do commit.
|
||||
redirect_from:
|
||||
- /articles/commit-branch-and-tag-labels
|
||||
- /github/committing-changes-to-your-project/commit-branch-and-tag-labels
|
||||
- /github/committing-changes-to-your-project/viewing-and-comparing-commits/commit-branch-and-tag-labels
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
shortTitle: Branch & etiquetas de tag
|
||||
---
|
||||
|
||||
Se seu commit não estiver no branch padrão, um indicador mostrará os branches que contêm o commit. Se o commit fizer parte de uma pull request sem merge, ele mostrará um link.
|
||||
|
||||
|
||||
|
||||
Assim que o commit estiver no branch padrão, todas as tags que contêm o commit serão mostradas e o branch padrão será o único branch listado.
|
||||
|
||||
|
||||
|
||||
## Leia mais
|
||||
|
||||
* "[Assinar commits](/articles/signing-commits)"
|
||||
* "[Assinar tags](/articles/signing-tags)"
|
||||
@@ -10,7 +10,6 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /commit-branch-and-tag-labels
|
||||
- /comparing-commits
|
||||
- /differences-between-commit-views
|
||||
shortTitle: Visualizar & comparar commits
|
||||
|
||||
@@ -11,7 +11,7 @@ topics:
|
||||
redirect_from:
|
||||
- /github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository
|
||||
- /github/administering-a-repository/managing-repository-settings/enabling-or-disabling-github-discussions-for-a-repository
|
||||
shortTitle: Discussões
|
||||
shortTitle: Discussions
|
||||
---
|
||||
|
||||
## Habilitar ou desabilitar {% data variables.product.prodname_discussions %} no seu repositório
|
||||
|
||||
@@ -24,11 +24,11 @@ shortTitle: Manage GitHub Actions settings
|
||||
|
||||
## About {% data variables.product.prodname_actions %} permissions for your repository
|
||||
|
||||
{% data reusables.github-actions.disabling-github-actions %} For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)."
|
||||
{% data reusables.actions.disabling-github-actions %} For more information about {% data variables.product.prodname_actions %}, see "[About {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/about-github-actions)."
|
||||
|
||||
You can enable {% data variables.product.prodname_actions %} for your repository. {% data reusables.github-actions.enabled-actions-description %} You can disable {% data variables.product.prodname_actions %} for your repository altogether. {% data reusables.github-actions.disabled-actions-description %}
|
||||
You can enable {% data variables.product.prodname_actions %} for your repository. {% data reusables.actions.enabled-actions-description %} You can disable {% data variables.product.prodname_actions %} for your repository altogether. {% data reusables.actions.disabled-actions-description %}
|
||||
|
||||
Alternatively, you can enable {% data variables.product.prodname_actions %} in your repository but limit the actions a workflow can run. {% data reusables.github-actions.enabled-local-github-actions %}
|
||||
Alternatively, you can enable {% data variables.product.prodname_actions %} in your repository but limit the actions a workflow can run. {% data reusables.actions.enabled-local-github-actions %}
|
||||
|
||||
## Managing {% data variables.product.prodname_actions %} permissions for your repository
|
||||
|
||||
@@ -78,34 +78,34 @@ You can configure this behavior for a repository using the procedure below. Modi
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.repositories.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.workflows-from-public-fork-setting %}
|
||||
{% data reusables.actions.workflows-from-public-fork-setting %}
|
||||
|
||||
{% data reusables.actions.workflow-run-approve-link %}
|
||||
{% endif %}
|
||||
|
||||
## Enabling workflows for private repository forks
|
||||
|
||||
{% data reusables.github-actions.private-repository-forks-overview %}
|
||||
{% data reusables.actions.private-repository-forks-overview %}
|
||||
|
||||
If a policy is disabled for an {% ifversion ghec or ghae or ghes %}enterprise or{% endif %} organization, it cannot be enabled for a repository.
|
||||
|
||||
{% data reusables.github-actions.private-repository-forks-options %}
|
||||
{% data reusables.actions.private-repository-forks-options %}
|
||||
|
||||
### Configuring the private fork policy for a repository
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.repositories.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.private-repository-forks-configure %}
|
||||
{% data reusables.actions.private-repository-forks-configure %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
## Setting the permissions of the `GITHUB_TOKEN` for your repository
|
||||
|
||||
{% data reusables.github-actions.workflow-permissions-intro %}
|
||||
{% data reusables.actions.workflow-permissions-intro %}
|
||||
|
||||
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.
|
||||
|
||||
{% data reusables.github-actions.workflow-permissions-modifying %}
|
||||
{% data reusables.actions.workflow-permissions-modifying %}
|
||||
|
||||
### Configuring the default `GITHUB_TOKEN` permissions
|
||||
|
||||
@@ -152,4 +152,4 @@ You can also define a custom retention period for a specific artifact created by
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.repositories.settings-sidebar-actions %}
|
||||
{% data reusables.github-actions.change-retention-period-for-artifacts-logs %}
|
||||
{% data reusables.actions.change-retention-period-for-artifacts-logs %}
|
||||
|
||||
@@ -18,5 +18,6 @@ children:
|
||||
- /libraries
|
||||
- /openapi-description
|
||||
- /endpoints-available-for-github-apps
|
||||
- /permissions-required-for-github-apps
|
||||
---
|
||||
|
||||
|
||||
@@ -3,6 +3,7 @@ title: Permissões necessárias para os aplicativos GitHub
|
||||
intro: 'Você pode encontrar as permissões necessárias para cada ponto de extremidade compatível com {% data variables.product.prodname_github_app %}.'
|
||||
redirect_from:
|
||||
- /v3/apps/permissions
|
||||
- /rest/reference/permissions-required-for-github-apps
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -13,93 +13,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
|
||||
A API de {% data variables.product.prodname_actions %} permite que você gerencie {% data variables.product.prodname_actions %} usando a API REST. {% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} exige permissões mencionadas em cada ponto de extremidade. Para obter mais informações, consulte "[Documentação do {% data variables.product.prodname_actions %}](/actions)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Artefatos
|
||||
|
||||
A API de Artefatos permite que você faça o download, exclua e recupere informações sobre artefatos de fluxo de trabalho. {% data reusables.actions.about-artifacts %} Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'artifacts' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% ifversion fpt or ghes > 2.22 or ghae or ghec %}
|
||||
## Permissões
|
||||
|
||||
A API de Permissões permite que você defina permissões para quais empresas, organizações e repositórios podem executar {% data variables.product.prodname_actions %}, e quais ações podem ser executadas.{% ifversion fpt or ghec or ghes %} Para obter mais informações, consulte "[Limites de uso, cobrança e administração](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)".{% endif %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'permissions' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
{% endif %}
|
||||
|
||||
## Segredos
|
||||
|
||||
A API Segredos permite criar, atualizar, excluir e recuperar informações sobre segredos criptografados. {% data reusables.actions.about-secrets %} Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} deve ter a permissão `segredos` para usar esta API. Os usuários autenticados devem ter acesso de colaborador em um repositório para criar, atualizar ou ler segredos.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'secrets' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Executores auto-hospedados
|
||||
|
||||
{% data reusables.actions.ae-self-hosted-runners-notice %}
|
||||
|
||||
A API de executores auto-hospedados permite que você registre, visualize e exclua executores auto-hospedados. {% data reusables.actions.about-self-hosted-runners %} Para obter mais informações, consulte "[Hospedando seus próprios executores](/actions/hosting-your-own-runners)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} deve ter a permissão de administração `` para repositórios ou a permissão `organization_self_hosted_runners` para as organizações. Os usuários autenticados devem ter acesso de administrador a repositórios ou organizações ou ao escopo `manage_runners:corporativo` para que as empresas usem esta API.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'self-hosted-runners' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Grupos de runner auto-hospedados
|
||||
|
||||
{% data reusables.actions.ae-self-hosted-runners-notice %}
|
||||
|
||||
A API dos Grupos de Runners auto-hospedados permite que você gerencie grupos de runners auto-hospedados. Para obter mais informações, consulte "[Gerenciando acesso a runners auto-hospedados usando grupos](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} deve ter a permissão de administração `` para repositórios ou a permissão `organization_self_hosted_runners` para as organizações. Os usuários autenticados devem ter acesso de administrador a repositórios ou organizações ou ao escopo `manage_runners:corporativo` para que as empresas usem esta API.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'self-hosted-runner-groups' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Fluxos de trabalho
|
||||
|
||||
A API de fluxos de trabalho permite que você veja fluxos de trabalho para um repositório. {% data reusables.actions.about-workflows %} Para obter mais informações, consulte "[Automatizando seu fluxo de trabalho com o GitHub Actions](/actions/automating-your-workflow-with-github-actions)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'workflows' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Trabalhos de fluxo de trabalho
|
||||
|
||||
A API de Trabalhos de Fluxo de Trabalho permite que você visualize logs e trabalhos de fluxo de trabalho. {% data reusables.actions.about-workflow-jobs %} Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para GitHub Actions](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'workflow-jobs' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Execução de fluxo de trabalho
|
||||
|
||||
A API de execução de fluxo de trabalho permite que você visualize, execute novamente, cancele e visualize os logs para executar o fluxo de trabalho. {% data reusables.actions.about-workflow-runs %} Para obter mais informações, consulte "[Gerenciando uma execução de fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/managing-a-workflow-run)".
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data reusables.actions.actions-app-actions-permissions-api %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'workflow-runs' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/actions
|
||||
-->
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Activity
|
||||
intro: 'The Activity API allows you to list events and feeds and manage notifications, starring, and watching for the authenticated user.'
|
||||
title: Atividade
|
||||
intro: 'A API de atividade permite que você liste eventos, alimenta e gerencia notificações, favoritos e inspeciona o usuário autenticado.'
|
||||
redirect_from:
|
||||
- /v3/activity
|
||||
versions:
|
||||
@@ -13,186 +13,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Events
|
||||
|
||||
The Events API is a read-only API to the {% data variables.product.prodname_dotcom %} events. These events power the various activity streams on the site.
|
||||
|
||||
The Events API can return different types of events triggered by activity on {% data variables.product.product_name %}. For more information about the specific events that you can receive from the Events API, see "[{% data variables.product.prodname_dotcom %} Event types](/developers/webhooks-and-events/github-event-types)." An events API for repository issues is also available. For more information, see the "[Issue Events API](/rest/reference/issues#events)."
|
||||
|
||||
Events are optimized for polling with the "ETag" header. If no new events have been triggered, you will see a "304 Not Modified" response, and your current rate limit will be untouched. There is also an "X-Poll-Interval" header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header.
|
||||
|
||||
``` shell
|
||||
$ curl -I {% data variables.product.api_url_pre %}/users/tater/events
|
||||
> HTTP/2 200
|
||||
> X-Poll-Interval: 60
|
||||
> ETag: "a18c3bded88eb5dbb5c849a489412bf3"
|
||||
|
||||
# The quotes around the ETag value are important
|
||||
$ curl -I {% data variables.product.api_url_pre %}/users/tater/events \
|
||||
$ -H 'If-None-Match: "a18c3bded88eb5dbb5c849a489412bf3"'
|
||||
> HTTP/2 304
|
||||
> X-Poll-Interval: 60
|
||||
```
|
||||
|
||||
Only events created within the past 90 days will be included in timelines. Events older than 90 days will not be included (even if the total number of events in the timeline is less than 300).
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'events' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Feeds
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'feeds' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
### Example of getting an Atom feed
|
||||
|
||||
To get a feed in Atom format, you must specify the `application/atom+xml` type in the `Accept` header. For example, to get the Atom feed for GitHub security advisories:
|
||||
|
||||
curl -H "Accept: application/atom+xml" https://github.com/security-advisories
|
||||
|
||||
#### Response
|
||||
|
||||
```shell
|
||||
HTTP/2 200
|
||||
```
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" xml:lang="en-US">
|
||||
<id>tag:github.com,2008:/security-advisories</id>
|
||||
<link rel="self" type="application/atom+xml" href="https://github.com/security-advisories.atom"/>
|
||||
<title>GitHub Security Advisory Feed</title>
|
||||
<author>
|
||||
<name>GitHub</name>
|
||||
</author>
|
||||
<updated>2019-01-14T19:34:52Z</updated>
|
||||
<entry>
|
||||
<id>tag:github.com,2008:GHSA-abcd-12ab-23cd</id>
|
||||
<published>2018-07-26T15:14:52Z</published>
|
||||
<updated>2019-01-14T19:34:52Z</updated>
|
||||
<title type="html">[GHSA-abcd-12ab-23cd] Moderate severity vulnerability that affects Octoapp</title>
|
||||
<category term="NPM"/>
|
||||
<content type="html">
|
||||
<p>Octoapp node module before 4.17.5 suffers from a Modification of Assumed-Immutable Data (MAID) vulnerability via defaultsDeep, merge, and mergeWith functions, which allows a malicious user to modify the prototype of "Object" via <strong>proto</strong>, causing the addition or modification of an existing property that will exist on all objects.</p>
|
||||
<p><strong>Affected Packages</strong></p>
|
||||
|
||||
<dl>
|
||||
<dt>Octoapp</dt>
|
||||
<dd>Ecosystem: npm</dd>
|
||||
<dd>Severity: moderate</dd>
|
||||
<dd>Versions: &lt; 4.17.5</dd>
|
||||
<dd>Fixed in: 4.17.5</dd>
|
||||
</dl>
|
||||
|
||||
<p><strong>References</strong></p>
|
||||
|
||||
<ul>
|
||||
<li>https://nvd.nist.gov/vuln/detail/CVE-2018-123</li>
|
||||
</ul>
|
||||
|
||||
</content>
|
||||
</entry>
|
||||
</feed>
|
||||
```
|
||||
|
||||
## Notifications
|
||||
|
||||
Users receive notifications for conversations in repositories they watch including:
|
||||
|
||||
* Issues and their comments
|
||||
* Pull Requests and their comments
|
||||
* Comments on any commits
|
||||
|
||||
Notifications are also sent for conversations in unwatched repositories when the user is involved including:
|
||||
|
||||
* **@mentions**
|
||||
* Issue assignments
|
||||
* Commits the user authors or commits
|
||||
* Any discussion in which the user actively participates
|
||||
|
||||
All Notification API calls require the `notifications` or `repo` API scopes. Doing this will give read-only access to some issue and commit content. You will still need the `repo` scope to access issues and commits from their respective endpoints.
|
||||
|
||||
Notifications come back as "threads". A thread contains information about the current discussion of an issue, pull request, or commit.
|
||||
|
||||
Notifications are optimized for polling with the `Last-Modified` header. If there are no new notifications, you will see a `304 Not Modified` response, leaving your current rate limit untouched. There is an `X-Poll-Interval` header that specifies how often (in seconds) you are allowed to poll. In times of high server load, the time may increase. Please obey the header.
|
||||
|
||||
``` shell
|
||||
# Add authentication to your requests
|
||||
$ curl -I {% data variables.product.api_url_pre %}/notifications
|
||||
HTTP/2 200
|
||||
Last-Modified: Thu, 25 Oct 2012 15:16:27 GMT
|
||||
X-Poll-Interval: 60
|
||||
|
||||
# Pass the Last-Modified header exactly
|
||||
$ curl -I {% data variables.product.api_url_pre %}/notifications
|
||||
$ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT"
|
||||
> HTTP/2 304
|
||||
> X-Poll-Interval: 60
|
||||
```
|
||||
|
||||
### Notification reasons
|
||||
|
||||
When retrieving responses from the Notifications API, each payload has a key titled `reason`. These correspond to events that trigger a notification.
|
||||
|
||||
Here's a list of potential `reason`s for receiving a notification:
|
||||
|
||||
Reason Name | Description
|
||||
------------|------------
|
||||
`assign` | You were assigned to the issue.
|
||||
`author` | You created the thread.
|
||||
`comment` | You commented on the thread.
|
||||
`ci_activity` | A {% data variables.product.prodname_actions %} workflow run that you triggered was completed.
|
||||
`invitation` | You accepted an invitation to contribute to the repository.
|
||||
`manual` | You subscribed to the thread (via an issue or pull request).
|
||||
`mention` | You were specifically **@mentioned** in the content.
|
||||
`review_requested` | You, or a team you're a member of, were requested to review a pull request.{% ifversion fpt or ghec %}
|
||||
`security_alert` | {% data variables.product.prodname_dotcom %} discovered a [security vulnerability](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies) in your repository.{% endif %}
|
||||
`state_change` | You changed the thread state (for example, closing an issue or merging a pull request).
|
||||
`subscribed` | You're watching the repository.
|
||||
`team_mention` | You were on a team that was mentioned.
|
||||
|
||||
Note that the `reason` is modified on a per-thread basis, and can change, if the `reason` on a later notification is different.
|
||||
|
||||
For example, if you are the author of an issue, subsequent notifications on that issue will have a `reason` of `author`. If you're then **@mentioned** on the same issue, the notifications you fetch thereafter will have a `reason` of `mention`. The `reason` remains as `mention`, regardless of whether you're ever mentioned again.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'notifications' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Starring
|
||||
|
||||
Repository starring is a feature that lets users bookmark repositories. Stars are shown next to repositories to show an approximate level of interest. Stars have no effect on notifications or the activity feed.
|
||||
|
||||
### Starring vs. Watching
|
||||
|
||||
In August 2012, we [changed the way watching
|
||||
works](https://github.com/blog/1204-notifications-stars) on {% data variables.product.prodname_dotcom %}. Many API
|
||||
client applications may be using the original "watcher" endpoints for accessing
|
||||
this data. You can now start using the "star" endpoints instead (described
|
||||
below). For more information, see the [Watcher API Change post](https://developer.github.com/changes/2012-09-05-watcher-api/) and the "[Repository Watching API](/rest/reference/activity#watching)."
|
||||
|
||||
### Custom media types for starring
|
||||
|
||||
There is one supported custom media type for the Starring REST API. When you use this custom media type, you will receive a response with the `starred_at` timestamp property that indicates the time the star was created. The response also has a second property that includes the resource that is returned when the custom media type is not included. The property that contains the resource will be either `user` or `repo`.
|
||||
|
||||
application/vnd.github.v3.star+json
|
||||
|
||||
For more information about media types, see "[Custom media types](/rest/overview/media-types)."
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'starring' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Watching
|
||||
|
||||
Watching a repository registers the user to receive notifications on new discussions, as well as events in the user's activity feed. For simple repository bookmarks, see "[Repository starring](/rest/reference/activity#starring)."
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'watching' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/activity
|
||||
-->
|
||||
|
||||
@@ -13,66 +13,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% data reusables.apps.general-apps-restrictions %}
|
||||
|
||||
Esta página lista os pontos de extremidade que você pode acessar enquanto autenticado como um aplicativo GitHub. Consulte "[Efetuar a autenticação como um aplicativo GitHub](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)" para saber mais.
|
||||
|
||||
Quando autenticado como um aplicativo GitHub, a API dos aplicativos GitHub permite que você obtenha informações de alto nível sobre um aplicativo GitHub, bem como informações específicas sobre instalações de um aplicativo.
|
||||
|
||||
Você pode acessar os pontos de extremidade da API v3 de REST enquanto autenticado como um aplicativo GitHub. Estes pontos de extremidade têm uma seção de "Observação" que contém um ponto que diz "Funciona com aplicativos GitHub". Você também pode acessar esses pontos de extremidade enquanto estiver autenticado como usuário.
|
||||
|
||||
Um subconjunto de pontos de extremidade da API v2 de REST exige autenticação como uma instalação do aplicativo GitHub. Consulte [Instalações](/rest/reference/apps#installations) para obter uma lista desses pontos de extremidade.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## API de aplicativos do OAuth
|
||||
|
||||
Você pode usar esta API para gerenciar os tokens do OAuth que um aplicativo OAuth usa para acessar as contas das pessoas em {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'oauth-applications' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Instalações
|
||||
|
||||
A API de instalações permite que você obtenha informações sobre as instalações do seu aplicativo GitHub e execute ações nessas instalações. Uma _instalação_ refere-se a qualquer usuário ou conta de organização que instalou o aplicativo. Para obter informações sobre como efetuar a autenticação como uma instalação e limitar o acesso a repositórios específicos, consulte "[Efetuar a autenticação como uma instalação](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)".
|
||||
|
||||
Para listar todas as instalações do aplicativo GitHub para uma organização, consulte "[Listar instalações de aplicativos para uma organização](/rest/reference/orgs#list-app-installations-for-an-organization)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'installations' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## Marketplace
|
||||
|
||||
Para obter mais informações sobre {% data variables.product.prodname_marketplace %}, consulte "[GitHub Marketplace](/marketplace/)".
|
||||
|
||||
A API de {% data variables.product.prodname_marketplace %} permite que você veja quais clientes estão usando um plano de preços, as compras de um cliente e se uma conta tem uma assinatura ativa.
|
||||
|
||||
### Fazer testes com pontos de extremidades de amostra
|
||||
|
||||
Esta API inclui pontos de extremidade que permitem que você [teste o seu {% data variables.product.prodname_github_app %}](/marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps/) com **dados de amostra**. Os dados do de amostra têm código rígido, dados falsos e não serão alterados com base em assinaturas reais.
|
||||
|
||||
Para fazer teste com dados de amostra, use um pontos de extremidade de amostra no lugar da sua contraparte de produção. Isso permite que você teste se a lógica da API é bem-sucedida antes de anunciar {% data variables.product.prodname_github_apps %} em {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
Certifique-se de substituir pontos de extremidades de amostra pelos pontos de extremidades de produção antes de implantar seu {% data variables.product.prodname_github_app %}.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'marketplace' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 2.22 or ghae or ghec %}
|
||||
## Webhooks
|
||||
|
||||
O webhook de {% data variables.product.prodname_github_app %} permite que você receba cargas `POST` de HTTP sempre que certos eventos ocorrerem para um aplicativo. {% data reusables.webhooks.webhooks-rest-api-links %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'webhooks' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/apps
|
||||
-->
|
||||
|
||||
@@ -10,8 +10,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
Você pode obter informações de cobrança para uma empresa. Para obter mais informações, consulte a API REST "[{% data variables.product.prodname_dotcom %} administração de Enterprise](/rest/reference/enterprise-admin#billing)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/billing
|
||||
-->
|
||||
|
||||
@@ -12,11 +12,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Branches protegidos
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'branch-protection' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/branches
|
||||
-->
|
||||
|
||||
@@ -13,26 +13,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
Você pode criar os aplicativos que realizam integração contínua, linting ou serviços de varredura de código e fornecem feedback detalhado sobre commits. Para mais informações, consulte "[Começar com a API de verificações](/rest/guides/getting-started-with-the-checks-api)" e "[Criar testes de CI com a API de verificações](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Execuções de verificação
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'runs' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## conjuntos de verificações
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** Um aplicativo GitHub recebe apenas um evento [`check_suite`](/webhooks/event-payloads/#check_suite) por SHA de commit SHA, mesmo se você fizer push do SHA do commit para mais de um branch. Para descobrir quando um SHA do commit é enviado para um branch, você pode assinar os eventos do branch [`criar`](/webhooks/event-payloads/#create).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'suites' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/checks
|
||||
-->
|
||||
|
||||
@@ -17,20 +17,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% data reusables.code-scanning.beta %}
|
||||
|
||||
A API de {% data variables.product.prodname_code_scanning %} permite que você recupere e atualize alertas de {% data variables.product.prodname_code_scanning %} alertas de um repositório. Você pode usar os pontos de extremidade para criar relatórios automatizados para os alertas de {% data variables.product.prodname_code_scanning %} em uma organização ou fazer upload dos resultados de análise gerados usando as ferramentas off-line de {% data variables.product.prodname_code_scanning %}. Para obter mais informações, consulte "[Encontrar vulnerabilidades e erros de segurança no seu código](/github/finding-security-vulnerabilities-and-errors-in-your-code).
|
||||
|
||||
{% ifversion fpt or ghes > 3.0 or ghae or ghec %}
|
||||
### Tipo de mídia personalizada para {% data variables.product.prodname_code_scanning %}
|
||||
|
||||
Existe um tipo de mídia personalizada com suporte para a API REST de {% data variables.product.prodname_code_scanning %}.
|
||||
|
||||
application/sarif+json
|
||||
|
||||
Você pode usar isso com solicitações de `GET` enviadas para o ponto de extremidade `/analyes/{analysis_id}`. Para obter mais informações sobre esta operação, consulte "[Obter uma análise de {% data variables.product.prodname_code_scanning %} para um repositório](#get-a-code-scanning-analysis-for-a-repository)". Ao usar este tipo de mídia com esta operação, a resposta inclui um subconjunto dos dados reais que foram enviados para a análise especificada, em vez do resumo da análise que é retornada quando você usa o tipo de mídia padrão. A resposta também inclui dados adicionais como as propriedades `github/alertNumber` e `github/alertUrl`. Os dados estão formatados como [SARIF versão 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html).
|
||||
|
||||
Para obter mais informações, consulte "[Tipos de mídia](/rest/overview/media-types)".
|
||||
{% endif %}
|
||||
|
||||
{% include rest_operations_at_current_path %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/code-scanning
|
||||
-->
|
||||
|
||||
@@ -14,6 +14,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
Você pode usar a API de Códigos de Conduta para recuperar informações sobre o código de conduta de um repositório. Para obter o código de conduta de um repositório, use o ponto de extremidade "[Obter um repositório](/rest/reference/repos#get-a-repository).
|
||||
|
||||
{% include rest_operations_at_current_path %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/codes-of-conduct
|
||||
-->
|
||||
|
||||
@@ -10,24 +10,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% data reusables.codespaces.codespaces-api-beta-note %}
|
||||
|
||||
A API de {% data variables.product.prodname_codespaces %} permite que você gerencie {% data variables.product.prodname_codespaces %} usando a API REST. Esta API está disponível para usuários autenticados e aplicativos OAuth, mas não para aplicativos GitHub. Para obter mais informações, consulte "[{% data variables.product.prodname_codespaces %}](/codespaces)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Máquinas
|
||||
A API de Máquinas permite que um usuário determine quais tipos de máquina estão disponíveis para criar um codespace, seja em um determinado repositório ou como um usuário autenticado. Para obter mais informações, consulte "[Sobre tipos de máquinas](/codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace#about-machine-types)".
|
||||
|
||||
Você também pode usar essas informações alterando a máquina de um codespace existente, atualizando a propriedade `máquina`. A atualização da máquina ocorrerá na próxima vez que o codespace for reiniciado. Para obter mais informações, consulte "["Mudar o tipo de máquina para seu codespace](/codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace)."
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'machines' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Segredos
|
||||
A API de Segredos permite que um usuário crie, liste e exclua segredos (como tokens de acesso para serviços de nuvem), além de atribuir segredos para repositórios aos quais o usuário tem acesso. Estes segredos são disponibilizados para o codespace em tempo de execução. Para obter mais informações, consulte "[Gerenciar segredos criptografados para seus codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)".
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'secrets' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/codespaces
|
||||
-->
|
||||
|
||||
@@ -12,20 +12,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Convites
|
||||
|
||||
A API de Convites do Repositório permite que usuários ou serviços externos convidem outros usuários para colaborar em um repositório. Os usuários convidados (ou serviços externos em nome dos usuários convidados) podem optar por aceitar ou recusar os convites.
|
||||
|
||||
Observe que o [Escopo OAuth](/developers/apps/scopes-for-oauth-apps) `repo:invite` concede acesso direcionado aos convites **sem** conceder também acesso ao código do repositório. enquanto o escopo `repo` concede permissão ao código e aos convites convites.
|
||||
|
||||
### Convidar um usuário para um repositório
|
||||
|
||||
Use o ponto de extremidade da API para adicionar um colaborador. Para obter mais informações, consulte "[Adicionar um colaborador de repositório](/rest/reference/collaborators#add-a-repository-collaborator)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'invitations' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/collaborators
|
||||
-->
|
||||
|
||||
@@ -12,41 +12,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Comentários de commit
|
||||
|
||||
### Tipos de mídia personalizados para comentários de commit
|
||||
|
||||
Estes são os tipos de mídia compatíveis com os comentários do commit. Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/rest/overview/media-types).
|
||||
|
||||
application/vnd.github-commitcomment.raw+json
|
||||
application/vnd.github-commitcomment.text+json
|
||||
application/vnd.github-commitcomment.html+json
|
||||
application/vnd.github-commitcomment.full+json
|
||||
|
||||
Para obter mais informações, consulte "[tipos de mídia personalizados](/rest/overview/media-types)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'comments' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Status do commit
|
||||
|
||||
A API de status permite que serviços externos marquem commits com status de `erro`, `falha`, `pendente` ou `sucesso`, o que é refletido em pull requests que envolvem esses commits.
|
||||
|
||||
Os status também podem incluir uma `descrição` opcional e `target_url`, e é altamente recomendável fornecê-los, pois tornam o status muito mais útil na interface de usuário do GitHub.
|
||||
|
||||
Como exemplo, um uso comum é para serviços de integração contínua para marcar commits como criações que passam ou que falham usando o status. O `target_url` seria a URL completa para a saída da criação, e a `descrição` seria o resumo de alto nível do que aconteceu com a criação.
|
||||
|
||||
Os status podem incluir um `contexto` para indicar qual serviço está fornecendo esse status. Por exemplo, você pode fazer com que o seu serviço de integração contínua faça push status com um contexto de `ci`, e uma ferramenta de auditoria de segurança faça push dos status com um contexto de `segurança`. Você pode usar [Obter o status combinado para uma referência específica](/rest/reference/commits#get-the-combined-status-for-a-specific-reference) para recuperar todo o status de um commit.
|
||||
|
||||
Observe que o `escopo do OAuth` [repo:status](/developers/apps/scopes-for-oauth-apps) concede acesso direcionado a status **sem** conceder acesso ao código do repositório, enquanto o escopo `repo` concede permissão para o código e para status.
|
||||
|
||||
Se você está desenvolvendo um aplicativo GitHub e deseja fornecer informações mais detalhadas sobre um serviço externo, você deverá usar a [API de verificação](/rest/reference/checks).
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'statuses' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/commits
|
||||
-->
|
||||
|
||||
@@ -10,10 +10,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
A API de segredos {% data variables.product.prodname_dependabot %} permite criar, atualizar, excluir e recuperar informações sobre segredos criptografados. {% data reusables.actions.about-secrets %} Para obter mais informações, consulte "[Gerenciar segredos criptografados para o dependabot](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/managing-encrypted-secrets-for-dependabot)."
|
||||
|
||||
{% data reusables.actions.actions-authentication %} {% data variables.product.prodname_github_apps %} deve ter a permissão `dependabot_secrets` para usar esta API. Os usuários autenticados devem ter acesso de colaborador em um repositório para criar, atualizar ou ler segredos.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'secrets' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/dependabot
|
||||
-->
|
||||
|
||||
@@ -12,81 +12,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
As implantações são solicitações para implantar um ref específico (branch, SHA, tag). O GitHub envia um [ evento de `implantação`](/developers/webhooks-and-events/webhook-events-and-payloads#deployment) pelo qual os serviços externos podem ouvir e atuar quando novas implantações são criadas. As implantações permitem que os desenvolvedores e as organizações construam ferramentas associadas em torno de implantações sem ter que se preocupar com os detalhes de implementação da entrega de diferentes tipos de aplicativos (p. ex., web, nativo).
|
||||
|
||||
Os status de implantação externos permitem marcar implantações com `error`, `failure`, `pending`, `in_progress`, `queued` ou `success` afirmar que os sistemas que estão escutando os eventos [`deployment_status`](/developers/webhooks-and-events/webhook-events-and-payloads#deployment_status) podem consumir.
|
||||
|
||||
Os status de implantação também podem incluir uma `descrição` opcional e `log_url`, que são altamente recomendados porque tornam o status de implantação mais útil. O `log_url` é a URL completa para a saída de implantação e a `descrição` é um resumo de alto nível do que aconteceu com a implantação.
|
||||
|
||||
O GitHub envia os eventos de `implantação` e `deployment_status` quando novas implantações de status de implantação são criadas. Esses eventos permitem que as integrações de terceiros recebam resposta para solicitações de implantação e atualizem o status de implantação conforme o progresso é feito.
|
||||
|
||||
Abaixo está um diagrama de sequência sobre para como essas interações funcionariam.
|
||||
|
||||
```
|
||||
+---------+ +--------+ +-----------+ +-------------+
|
||||
| Tooling | | GitHub | | 3rd Party | | Your Server |
|
||||
+---------+ +--------+ +-----------+ +-------------+
|
||||
| | | |
|
||||
| Create Deployment | | |
|
||||
|--------------------->| | |
|
||||
| | | |
|
||||
| Deployment Created | | |
|
||||
|<---------------------| | |
|
||||
| | | |
|
||||
| | Deployment Event | |
|
||||
| |---------------------->| |
|
||||
| | | SSH+Deploys |
|
||||
| | |-------------------->|
|
||||
| | | |
|
||||
| | Deployment Status | |
|
||||
| |<----------------------| |
|
||||
| | | |
|
||||
| | | Deploy Completed |
|
||||
| | |<--------------------|
|
||||
| | | |
|
||||
| | Deployment Status | |
|
||||
| |<----------------------| |
|
||||
| | | |
|
||||
```
|
||||
|
||||
Tenha em mente que o GitHub nunca terá acesso aos seus servidores. Cabe à sua integração de terceiros interagir com os eventos de implantação. Vários sistemas podem ouvir eventos de implantação, e cabe a cada um desses sistemas decidir se serão responsáveis por retirar o código dos seus servidores, criar código nativo, etc.
|
||||
|
||||
Observe que o `repo_deployment` [OAuth escopo](/developers/apps/scopes-for-oauth-apps) concede acesso direcionado a implantações e status **sem** conceder acesso ao código do repositório, enquanto os es escopos {% ifversion not ghae %}`public_repo` e{% endif %}`repositório` também concedem permissão para codificar.
|
||||
|
||||
### Implantações inativas
|
||||
|
||||
Ao definir o estado de uma implantação como `sucesso`, todas as implantações de ambiente de não produção e não transitórios anteriores no mesmo nome do ambiente irão tornar-se `inativas`. Para evitar isso, você pode definir `auto_inactive` como `falso` ao criar o status de implantação.
|
||||
|
||||
Você pode informar que um ambiente transitório não existe mais definindo seu `estado` como `inativo`. Definir o `estado` como `inativo` mostra a implantação como `destruída` em {% data variables.product.prodname_dotcom %} e remove o acesso a ela.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Status da implantação
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'statuses' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Chaves de implantação
|
||||
|
||||
{% data reusables.repositories.deploy-keys %}
|
||||
|
||||
Chaves de implantação podem ser configuradas usando os seguintes pontos de extremidades da API ou usando o GitHub. Para saber como configurar as chaves de implantação no GitHub, consulte "[Gerenciar chaves de implantação](/developers/overview/managing-deploy-keys)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'keys' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
## Ambientes
|
||||
|
||||
A API de Ambientes permite que você crie, configure e exclua ambientes. Para obter mais informações sobre ambientes, consulte "[Usando ambientes para implantação](/actions/deployment/using-environments-for-deployment)". Para gerenciar segredos de ambiente, consulte "[Segredos](/rest/reference/actions#secrets)".
|
||||
|
||||
{% data reusables.gated-features.environments %}
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'environments' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
{% endif %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/deployments
|
||||
-->
|
||||
|
||||
@@ -14,4 +14,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
{% include rest_operations_at_current_path %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/emojis
|
||||
-->
|
||||
|
||||
@@ -16,309 +16,6 @@ miniTocMaxHeadingLevel: 3
|
||||
shortTitle: Enterprise administration
|
||||
---
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** This article applies to {% data variables.product.prodname_ghe_cloud %}. To see the {% data variables.product.prodname_ghe_managed %} or {% data variables.product.prodname_ghe_server %} version, use the **{% data ui.pages.article_version %}** drop-down menu.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
### Endpoint URLs
|
||||
|
||||
REST API endpoints{% ifversion ghes %}—except [Management Console](#management-console) API endpoints—{% endif %} are prefixed with the following URL:
|
||||
|
||||
```shell
|
||||
{% data variables.product.api_url_pre %}
|
||||
```
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
When endpoints include `{enterprise}`, replace `{enterprise}` with the handle for your enterprise account, which is included in the URL for your enterprise settings. For example, if your enterprise account is located at `https://github.com/enterprises/octo-enterprise`, replace `{enterprise}` with `octo-enterprise`.
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
[Management Console](#management-console) API endpoints are only prefixed with a hostname:
|
||||
|
||||
```shell
|
||||
http(s)://<em>hostname</em>/
|
||||
```
|
||||
{% endif %}
|
||||
{% ifversion ghae or ghes %}
|
||||
### Authentication
|
||||
|
||||
Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** {% ifversion ghes %}(which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) {% endif %}or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% ifversion ghes %}
|
||||
OAuth tokens must have the `site_admin` [OAuth scope](/developers/apps/scopes-for-oauth-apps#available-scopes) when used with Enterprise-specific endpoints.{% endif %}
|
||||
|
||||
Enterprise administration API endpoints are only accessible to authenticated {% data variables.product.product_name %} site administrators{% ifversion ghes %}, except for the [Management Console](#management-console) API, which requires the [Management Console password](/enterprise/admin/articles/accessing-the-management-console/){% endif %}.
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes %}
|
||||
### Version information
|
||||
|
||||
The current version of your enterprise is returned in the response header of every API:
|
||||
`X-GitHub-Enterprise-Version: {{currentVersion}}.0`
|
||||
You can also read the current version by calling the [meta endpoint](/rest/reference/meta/).
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.2 or ghae-issue-5528 %}
|
||||
|
||||
## Audit log
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'audit-log' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 %}
|
||||
## Billing
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'billing' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes %}
|
||||
## Admin stats
|
||||
|
||||
The Admin Stats API provides a variety of metrics about your installation. *It is only available to [authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `404` response if they try to access it.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'admin-stats' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes > 2.22 %}
|
||||
|
||||
## Announcements
|
||||
|
||||
The Announcements API allows you to manage the global announcement banner in your enterprise. For more information, see "[Customizing user messages for your enterprise](/admin/user-management/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner)."
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'announcement' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes %}
|
||||
|
||||
## Global webhooks
|
||||
|
||||
Global webhooks are installed on your enterprise. You can use global webhooks to automatically monitor, respond to, or enforce rules for users, organizations, teams, and repositories on your enterprise. Global webhooks can subscribe to the [organization](/developers/webhooks-and-events/webhook-events-and-payloads#organization), [user](/developers/webhooks-and-events/webhook-events-and-payloads#user), [repository](/developers/webhooks-and-events/webhook-events-and-payloads#repository), [team](/developers/webhooks-and-events/webhook-events-and-payloads#team), [member](/developers/webhooks-and-events/webhook-events-and-payloads#member), [membership](/developers/webhooks-and-events/webhook-events-and-payloads#membership), [fork](/developers/webhooks-and-events/webhook-events-and-payloads#fork), and [ping](/developers/webhooks-and-events/about-webhooks#ping-event) event types.
|
||||
|
||||
*This API is only available to [authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `404` response if they try to access it. To learn how to configure global webhooks, see [About global webhooks](/enterprise/admin/user-management/about-global-webhooks).
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'global-webhooks' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
## LDAP
|
||||
|
||||
You can use the LDAP API to update account relationships between a {% data variables.product.product_name %} user or team and its linked LDAP entry or queue a new synchronization.
|
||||
|
||||
With the LDAP mapping endpoints, you're able to update the Distinguished Name (DN) that a user or team maps to. Note that the LDAP endpoints are generally only effective if your {% data variables.product.product_name %} appliance has [LDAP Sync enabled](/enterprise/admin/authentication/using-ldap). The [Update LDAP mapping for a user](#update-ldap-mapping-for-a-user) endpoint can be used when LDAP is enabled, even if LDAP Sync is disabled.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'ldap' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes %}
|
||||
## License
|
||||
|
||||
The License API provides information on your Enterprise license. *It is only available to [authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `404` response if they try to access it.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'license' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
## Management console
|
||||
|
||||
The Management Console API helps you manage your {% data variables.product.product_name %} installation.
|
||||
|
||||
{% tip %}
|
||||
|
||||
You must explicitly set the port number when making API calls to the Management Console. If TLS is enabled on your enterprise, the port number is `8443`; otherwise, the port number is `8080`.
|
||||
|
||||
If you don't want to provide a port number, you'll need to configure your tool to automatically follow redirects.
|
||||
|
||||
You may also need to add the [`-k` flag](http://curl.haxx.se/docs/manpage.html#-k) when using `curl`, since {% data variables.product.product_name %} uses a self-signed certificate before you [add your own TLS certificate](/enterprise/admin/guides/installation/configuring-tls/).
|
||||
|
||||
{% endtip %}
|
||||
|
||||
### Authentication
|
||||
|
||||
You need to pass your [Management Console password](/enterprise/admin/articles/accessing-the-management-console/) as an authentication token to every Management Console API endpoint except [`/setup/api/start`](#create-a-github-enterprise-server-license).
|
||||
|
||||
Use the `api_key` parameter to send this token with each request. For example:
|
||||
|
||||
```shell
|
||||
$ curl -L 'https://<em>hostname</em>:<em>admin_port</em>/setup/api?api_key=<em>your-amazing-password</em>'
|
||||
```
|
||||
|
||||
You can also use standard HTTP authentication to send this token. For example:
|
||||
|
||||
```shell
|
||||
$ curl -L -u "api_key:<em>your-amazing-password</em>" 'https://<em>hostname</em>:<em>admin_port</em>/setup/api'
|
||||
```
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'management-console' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes %}
|
||||
## Organizations
|
||||
|
||||
The Organization Administration API allows you to create organizations on your enterprise. *It is only available to [authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `404` response if they try to access it.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'orgs' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
## Organization pre-receive hooks
|
||||
|
||||
The Organization Pre-receive Hooks API allows you to view and modify
|
||||
enforcement of the pre-receive hooks that are available to an organization.
|
||||
|
||||
### Object attributes
|
||||
|
||||
| Name | Type | Description |
|
||||
|----------------------------------|-----------|-----------------------------------------------------------|
|
||||
| `name` | `string` | The name of the hook. |
|
||||
| `enforcement` | `string` | The state of enforcement for the hook on this repository. |
|
||||
| `allow_downstream_configuration` | `boolean` | Whether repositories can override enforcement. |
|
||||
| `configuration_url` | `string` | URL for the endpoint where enforcement is set. |
|
||||
|
||||
Possible values for *enforcement* are `enabled`, `disabled` and`testing`. `disabled` indicates the pre-receive hook will not run. `enabled` indicates it will run and reject
|
||||
any pushes that result in a non-zero status. `testing` means the script will run but will not cause any pushes to be rejected.
|
||||
|
||||
`configuration_url` may be a link to this endpoint or this hook's global
|
||||
configuration. Only site admins are able to access the global configuration.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'org-pre-receive-hooks' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
## Pre-receive environments
|
||||
|
||||
The Pre-receive Environments API allows you to create, list, update and delete environments for pre-receive hooks. *It is only available to [authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `404` response if they try to access it.
|
||||
|
||||
### Object attributes
|
||||
|
||||
#### Pre-receive Environment
|
||||
|
||||
| Name | Type | Description |
|
||||
|-----------------------|-----------|----------------------------------------------------------------------------|
|
||||
| `name` | `string` | The name of the environment as displayed in the UI. |
|
||||
| `image_url` | `string` | URL to the tarball that will be downloaded and extracted. |
|
||||
| `default_environment` | `boolean` | Whether this is the default environment that ships with {% data variables.product.product_name %}. |
|
||||
| `download` | `object` | This environment's download status. |
|
||||
| `hooks_count` | `integer` | The number of pre-receive hooks that use this environment. |
|
||||
|
||||
#### Pre-receive Environment Download
|
||||
|
||||
| Name | Type | Description |
|
||||
|-----------------|----------|---------------------------------------------------------|
|
||||
| `state` | `string` | The state of the most recent download. |
|
||||
| `downloaded_at` | `string` | The time when the most recent download started. |
|
||||
| `message` | `string` | On failure, this will have any error messages produced. |
|
||||
|
||||
Possible values for `state` are `not_started`, `in_progress`, `success`, `failed`.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'pre-receive-environments' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
## Pre-receive hooks
|
||||
|
||||
The Pre-receive Hooks API allows you to create, list, update and delete pre-receive hooks. *It is only available to
|
||||
[authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `404` response if they try to access it.
|
||||
|
||||
### Object attributes
|
||||
|
||||
#### Pre-receive Hook
|
||||
|
||||
| Name | Type | Description |
|
||||
|----------------------------------|-----------|-----------------------------------------------------------------|
|
||||
| `name` | `string` | The name of the hook. |
|
||||
| `script` | `string` | The script that the hook runs. |
|
||||
| `script_repository` | `object` | The GitHub repository where the script is kept. |
|
||||
| `environment` | `object` | The pre-receive environment where the script is executed. |
|
||||
| `enforcement` | `string` | The state of enforcement for this hook. |
|
||||
| `allow_downstream_configuration` | `boolean` | Whether enforcement can be overridden at the org or repo level. |
|
||||
|
||||
Possible values for *enforcement* are `enabled`, `disabled` and`testing`. `disabled` indicates the pre-receive hook will not run. `enabled` indicates it will run and reject
|
||||
any pushes that result in a non-zero status. `testing` means the script will run but will not cause any pushes to be rejected.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'pre-receive-hooks' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
## Repository pre-receive hooks
|
||||
|
||||
The Repository Pre-receive Hooks API allows you to view and modify
|
||||
enforcement of the pre-receive hooks that are available to a repository.
|
||||
|
||||
### Object attributes
|
||||
|
||||
| Name | Type | Description |
|
||||
|---------------------|----------|-----------------------------------------------------------|
|
||||
| `name` | `string` | The name of the hook. |
|
||||
| `enforcement` | `string` | The state of enforcement for the hook on this repository. |
|
||||
| `configuration_url` | `string` | URL for the endpoint where enforcement is set. |
|
||||
|
||||
Possible values for *enforcement* are `enabled`, `disabled` and`testing`. `disabled` indicates the pre-receive hook will not run. `enabled` indicates it will run and reject any pushes that result in a non-zero status. `testing` means the script will run but will not cause any pushes to be rejected.
|
||||
|
||||
`configuration_url` may be a link to this repository, it's organization owner or global configuration. Authorization to access the endpoint at `configuration_url` is determined at the owner or site admin level.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'repo-pre-receive-hooks' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae or ghes %}
|
||||
## Users
|
||||
|
||||
The User Administration API allows you to suspend{% ifversion ghes %}, unsuspend, promote, and demote{% endif %}{% ifversion ghae %} and unsuspend{% endif %} users on your enterprise. *It is only available to [authenticated](/rest/overview/resources-in-the-rest-api#authentication) site administrators.* Normal users will receive a `403` response if they try to access it.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'users' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
{% endif %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/enterprise-admin
|
||||
-->
|
||||
@@ -13,44 +13,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
### Authentication
|
||||
|
||||
You can read public gists {% ifversion ghae or ghes %}and create them for anonymous users without a token.{% else %} anonymously, but you must be signed into GitHub to create gists.{% endif %} To read or write gists on a user's behalf, you need the gist OAuth scope and a token. For more information, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps)."
|
||||
|
||||
<!-- When an OAuth client does not have the gists scope, the API will return a 404 "Not Found" response regardless of the validity of the credentials. The API will return a 401 "Bad credentials" response if the gists scope was given to the application but the credentials are invalid. -->
|
||||
|
||||
### Truncation
|
||||
|
||||
The Gist API provides up to one megabyte of content for each file in the gist. Each file returned for a gist through the API has a key called `truncated`. If `truncated` is `true`, the file is too large and only a portion of the contents were returned in `content`.
|
||||
|
||||
If you need the full contents of the file, you can make a `GET` request to the URL specified by `raw_url`. Be aware that for files larger than ten megabytes, you'll need to clone the gist via the URL provided by `git_pull_url`.
|
||||
|
||||
In addition to a specific file's contents being truncated, the entire files list may be truncated if the total number exceeds 300 files. If the top level `truncated` key is `true`, only the first 300 files have been returned in the files list. If you need to fetch all of the gist's files, you'll need to clone the gist via the URL provided by `git_pull_url`.
|
||||
|
||||
### Custom media types for gists
|
||||
|
||||
These are the supported media types for fetching gist contents.
|
||||
|
||||
application/vnd.github.VERSION.raw
|
||||
application/vnd.github.VERSION.base64
|
||||
|
||||
For more information, see "[Media types](/rest/overview/media-types)."
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Comments
|
||||
|
||||
### Custom media types for Gist comments
|
||||
|
||||
These are the supported media types for gist comments.
|
||||
|
||||
application/vnd.github.VERSION.raw
|
||||
application/vnd.github.VERSION.base64
|
||||
|
||||
For more information about media types, see "[Custom media types](/rest/overview/media-types)."
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'comments' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/gists
|
||||
-->
|
||||
@@ -14,57 +14,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
A API do banco de dados do Git dá acesso para ler e gravar objetos do Git sem processamento no seu banco de dados do Git no {% data variables.product.product_name %} e para listar e atualizar suas referências (cabeçalhos de branch e etiquetas). Para obter mais informações sobre como usar a API do banco de dados do Git, consulte "[Começar com a API de dados do Git](/rest/guides/getting-started-with-the-git-database-api)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% unless operation.subcategory %}{% include rest_operation %}{% endunless %}
|
||||
{% endfor %}
|
||||
|
||||
## Blobs
|
||||
|
||||
Um blob (objeto binário grande) do Git é o tipo de objeto usado para armazenar o conteúdo de cada arquivo em um repositório. O hash SHA-1 do arquivo é calculado e armazenado no objeto do blob. Estes pontos de extremidade permitem ler e escrever [objetos do blob](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects) em seu banco de dados d Git em {% data variables.product.product_name %}. Os blobs aproveitam [esses tipos de mídia personalizados](#custom-media-types-for-blobs). Você pode ler mais sobre o uso de tipos de mídia na API [aqui](/rest/overview/media-types).
|
||||
|
||||
### Tipos de mídia personalizados para os blobs
|
||||
|
||||
Estes são os tipos de mídia compatíveis com blobs.
|
||||
|
||||
application/json
|
||||
application/vnd.github.VERSION.raw
|
||||
|
||||
Para obter mais informações, consulte "[Tipos de mídia](/rest/overview/media-types)".
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'blobs' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Commits
|
||||
|
||||
Um commit do Git é um instantâneo da hierarquia ([árvore do Git](/rest/reference/git#trees)) e o conteúdo dos arquivos ([Blob do Git](/rest/reference/git#blobs)) em um repositório do Git. Estes pontos de extremidade permitem ler e escrever [objetos de commit](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Commit-Objects) no seu banco de dados do Git em {% data variables.product.product_name %}.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'commits' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Referências
|
||||
|
||||
Uma referência do Git (`git ref`) é apenas um arquivo que contém um hash SHA-1 do commit do Git. Ao referir-se a um commit do Git, você pode usar a referência do Git, que é um nome fácil de lembrar, em vez do hash. A referência do Git pode ser reescrita para apontar para um novo commit. Um branch é apenas uma referência do Git que armazena o novo hash de commit do Git. Estes pontos de extremidade permitem ler e escrever [referências](https://git-scm.com/book/en/v1/Git-Internals-Git-References) para o seu banco de dados do Git em {% data variables.product.product_name %}.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'refs' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Tags
|
||||
|
||||
Uma tag do Git é semelhante a uma [Referência do Git](/rest/reference/git#refs), mas o commit do Git para o qual ela aponta nunca muda. As tags do Git são úteis quando você deseja apontar para versões específicas. Esses pontos de extremidade permitem ler e escrever [tags dos objetos](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags) em seu banco de dados Git em {% data variables.product.product_name %}. A API de tags do Git é compatível apenas com [objetos de tags anotadas](https://git-scm.com/book/en/v1/Git-Internals-Git-References#Tags), não tags leves.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'tags' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
## Árvores
|
||||
|
||||
Um objeto da árvore do Git cria a hierarquia entre arquivos em um repositório do Git. Você pode usar o objeto da árvore do Git para criar a relação entre diretórios e os arquivos que eles contêm. Estes pontos de extremidade permitem que você leia e escreva [objetos de árvore](https://git-scm.com/book/en/v1/Git-Internals-Git-Objects#Tree-Objects) em seu banco de dados do Git em {% data variables.product.product_name %}.
|
||||
|
||||
{% for operation in currentRestOperations %}
|
||||
{% if operation.subcategory == 'trees' %}{% include rest_operation %}{% endif %}
|
||||
{% endfor %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/git
|
||||
-->
|
||||
|
||||
@@ -13,14 +13,6 @@ topics:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
Ao criar um novo repositório em {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %} por meio da API, você pode especificar um [.gitignore template](/github/getting-started-with-github/ignoring-files) para que seja aplicado ao repositório após a criação. A API de modlos do .gitignore lista e recupera modelos do repositório de [.gitignore](https://github.com/github/gitignore) de {% data variables.product.product_name %}.
|
||||
|
||||
### Tipos de mídia personalizados para gitignore
|
||||
|
||||
Você pode usar este tipo de mídia personalizada ao obter um modelo de gitignore.
|
||||
|
||||
application/vnd.github.VERSION.raw
|
||||
|
||||
Para obter mais informações, consulte "[Tipos de mídia](/rest/overview/media-types)".
|
||||
|
||||
{% include rest_operations_at_current_path %}
|
||||
<!--
|
||||
Operations are automatically generated. Markdown for this page is located in data/reusables/rest-reference/gitignore
|
||||
-->
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user