New translation batch for pt (#27616)
* Add crowdin translations * Run script/i18n/homogenize-frontmatter.js * Run script/i18n/fix-translation-errors.js * Run script/i18n/lint-translation-files.js --check rendering * run script/i18n/reset-files-with-broken-liquid-tags.js --language=pt * run script/i18n/reset-known-broken-translation-files.js Co-authored-by: Rachael Sewell <rachmari@github.com>
This commit is contained in:
docubot
@@ -49,7 +49,7 @@ Também é possível ver se o proprietário da empresa tem uma função específ
|
||||
| Proprietário corporativo | Proprietário da organização | Capaz de configurar as configurações da organização e gerenciar o acesso aos recursos da organização por meio de equipes, etc. |
|
||||
| Proprietário corporativo | Integrante da organização | Capaz de acessar recursos e conteúdos da organização, como repositórios, sem acesso às configurações da organização. |
|
||||
|
||||
Para revisar todas as funções de uma organização, consulte "[Funções em uma organização](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)". {% ifversion ghec %} Um membro da organização também pode ter uma função personalizada para um repositório específico. Para obter mais informações, consulte "[Gerenciando funções de repositórios personalizados para uma organização](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)".{% endif %}
|
||||
Para revisar todas as funções de uma organização, consulte "[Funções em uma organização](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)". {% if custom-repository-roles %} Um membro da organização também pode ter uma função personalizada para um repositório específico. Para obter mais informações, consulte "[Gerenciando funções de repositórios personalizados para uma organização](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)".{% endif %}
|
||||
|
||||
Para obter mais informações sobre a função de proprietário da empresa, consulte "[Funções em uma empresa](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise#enterprise-owner)".
|
||||
|
||||
|
||||
@@ -22,7 +22,7 @@ shortTitle: Criar & testar Java & Gradle
|
||||
|
||||
## Introdução
|
||||
|
||||
Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Gradle. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para memorizar arquivos e fazer o upload de artefatos a partir da execução de um fluxo de trabalho.
|
||||
Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Gradle. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. You can extend your CI workflow to {% if actions-caching %}cache files and{% endif %} upload artifacts from a workflow run.
|
||||
|
||||
{% ifversion ghae %}
|
||||
{% data reusables.actions.self-hosted-runners-software %}
|
||||
@@ -110,12 +110,16 @@ steps:
|
||||
arguments: -b ci.gradle package
|
||||
```
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
## Memorizar dependências
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, as dependências de construção podem ser armazenadas em cache para acelerar a execução do seu fluxo de trabalho. Após uma execução bem-sucedida, a ação `gradle/gradle-build-action` armazena em cache partes importantes do diretório inicial do usuário do Gradle. Em trabalhos futuros, o cache será restaurado para que os scripts de compilação não precisem ser recalculados e as dependências não precisem ser baixadas a partir de repositórios remotos de pacotes.
|
||||
Your build dependencies can be cached to speed up your workflow runs. Após uma execução bem-sucedida, a ação `gradle/gradle-build-action` armazena em cache partes importantes do diretório inicial do usuário do Gradle. Em trabalhos futuros, o cache será restaurado para que os scripts de compilação não precisem ser recalculados e as dependências não precisem ser baixadas a partir de repositórios remotos de pacotes.
|
||||
|
||||
O cache é habilitado por padrão ao usar a ação `grades/gradle-build-action`. Para obter mais informações, consulte [`gradle/gradle-build-action`](https://github.com/gradle/gradle-build-action#caching).
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Empacotar dados do fluxo de trabalho como artefatos
|
||||
|
||||
Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. 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)".
|
||||
|
||||
@@ -22,7 +22,7 @@ shortTitle: Criar & testar o Java com o Maven
|
||||
|
||||
## Introdução
|
||||
|
||||
Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando a ferramenta de gerenciamento de projeto do software Maven. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para memorizar arquivos e fazer o upload de artefatos a partir da execução de um fluxo de trabalho.
|
||||
Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando a ferramenta de gerenciamento de projeto do software Maven. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. You can extend your CI workflow to {% if actions-caching %}cache files and{% endif %} upload artifacts from a workflow run.
|
||||
|
||||
{% ifversion ghae %}
|
||||
{% data reusables.actions.self-hosted-runners-software %}
|
||||
@@ -99,9 +99,11 @@ steps:
|
||||
run: mvn --batch-mode --update-snapshots verify
|
||||
```
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
## Memorizar dependências
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você poderá armazenar em cache suas dependências para acelerar as execuções do seu fluxo de trabalho. Após a conclusão bem-sucedida, o seu repositório local do Maven será armazenado na infraestrutura do GitHub Actions. Para os fluxos de trabalho futuros, a cache será restaurada para que as dependências não precisem ser baixadas dos repositórios remotos do Maven. Você pode armazenar dependências simplesmente usando a ação [`setup-java`](https://github.com/marketplace/actions/setup-java-jdk) ou pode usar a ação [`cache` ](https://github.com/actions/cache) para uma configuração mais avançada e personalizada.
|
||||
Você pode armazenar as suas dependências para acelerar as execuções do seu fluxo de trabalho. After a successful run, your local Maven repository will be stored in a cache. Para os fluxos de trabalho futuros, a cache será restaurada para que as dependências não precisem ser baixadas dos repositórios remotos do Maven. Você pode armazenar dependências simplesmente usando a ação [`setup-java`](https://github.com/marketplace/actions/setup-java-jdk) ou pode usar a ação [`cache` ](https://github.com/actions/cache) para uma configuração mais avançada e personalizada.
|
||||
|
||||
```yaml{:copy}
|
||||
steps:
|
||||
@@ -118,6 +120,8 @@ steps:
|
||||
|
||||
Este fluxo de trabalho salvará o conteúdo do repositório local do Maven, localizado no diretório `.m2` do diretório inicial do executor. A chave da cache será o conteúdo em hash do _pom.xml_. Portanto, as alterações em _pom.xml_ invalidarão a cache.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Empacotar dados do fluxo de trabalho como artefatos
|
||||
|
||||
Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. 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)".
|
||||
|
||||
@@ -120,7 +120,7 @@ steps:
|
||||
run: dotnet add package Newtonsoft.Json --version 12.0.1
|
||||
```
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% if actions-caching %}
|
||||
|
||||
### Memorizar dependências
|
||||
|
||||
|
||||
@@ -136,7 +136,7 @@ Se você não especificar uma versão do Node.js, o {% data variables.product.pr
|
||||
|
||||
Executores hospedados em {% data variables.product.prodname_dotcom %} têm gerenciadores de dependências npm e Yarn instalados. Você pode usar o npm e o Yarn para instalar dependências no seu fluxo de trabalho antes de criar e testar seu código. Os executores do Windows e Linux hospedados em {% data variables.product.prodname_dotcom %} também têm o Grunt, Gulp, e Bower instalado.
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você também poderá armazenar em cache dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
{% if actions-caching %}You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up workflows](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)."{% endif %}
|
||||
|
||||
### Exemplo de uso do npm
|
||||
|
||||
@@ -228,9 +228,11 @@ O exemplo acima cria um arquivo *.npmrc* com o conteúdo a seguir:
|
||||
always-auth=true
|
||||
```
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
### Exemplo de memorização de dependências
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você pode armazenar em cache e restaurar as dependências usando a ação [`setup-node`](https://github.com/actions/setup-node).
|
||||
You can cache and restore the dependencies using the [`setup-node` action](https://github.com/actions/setup-node).
|
||||
|
||||
O exemplo a seguir armazena dependências do npm.
|
||||
|
||||
@@ -278,7 +280,9 @@ steps:
|
||||
- run: pnpm test
|
||||
```
|
||||
|
||||
Se você tiver um requisito personalizado ou precisar de melhores controles para cache, você poderá usar a ação [`cache`](https://github.com/marketplace/actions/cache). Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Dependências de cache para acelerar fluxos de trabalho</a>".
|
||||
Se você tiver um requisito personalizado ou precisar de melhores controles para cache, você poderá usar a ação [`cache`](https://github.com/marketplace/actions/cache). Para obter mais informações, consulte "[Memorizar dependências para acelerar fluxos de trabalho](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Criar e testar seu código
|
||||
|
||||
|
||||
@@ -104,7 +104,7 @@ Executores hospedados em {% data variables.product.prodname_dotcom %} têm Power
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você também poderá armazenar em cache dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
{% if actions-caching %}You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up workflows](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)."{% endif %}
|
||||
|
||||
Por exemplo, o trabalho a seguir instala os módulos `SqlServer` e `PSScriptAnalyzer`:
|
||||
|
||||
@@ -128,9 +128,11 @@ jobs:
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
### Memorizar dependências
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você poderá armazenar em cache dependências do PowerShell usando uma chave única, o que permite que você restaure as dependências para futuros fluxos de trabalho com a ação [`cache`](https://github.com/marketplace/actions/cache). Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
Você pode armazenar em cache dependências do PowerShell usando uma chave única, o que lhe permite restaurar as dependências para futuros fluxos de trabalho com a ação [`cache`](https://github.com/marketplace/actions/cache). Para obter mais informações, consulte "[Memorizar dependências para acelerar fluxos de trabalho](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)".
|
||||
|
||||
O PowerShell armazena suas dependências em diferentes locais, dependendo do sistema operacional do executor. Por exemplo, o `caminho` local usado no exemplo do Ubuntu a seguir será diferente para um sistema operacional Windows.
|
||||
|
||||
@@ -151,6 +153,8 @@ steps:
|
||||
Install-Module SqlServer, PSScriptAnalyzer -ErrorAction Stop
|
||||
```
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Testar seu código
|
||||
|
||||
Você pode usar os mesmos comandos usados localmente para criar e testar seu código.
|
||||
|
||||
@@ -197,7 +197,7 @@ Recomendamos usar `setup-python` para configurar a versão do Python usada nos s
|
||||
|
||||
Os executores hospedados em {% data variables.product.prodname_dotcom %} têm instalado o gerenciador do pacote pip. Você pode usar o pip para instalar dependências do registro de pacotes do PyPI antes de criar e testar o seu código. Por exemplo, o YAML abaixo instala ou atualiza o instalador de pacotes `pip` e as os pacotes `setuptools` e `wheel`.
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você também poderá armazenar em cache dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
{% if actions-caching %}You can also cache dependencies to speed up your workflow. For more information, see "[Caching dependencies to speed up workflows](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)."{% endif %}
|
||||
|
||||
```yaml{:copy}
|
||||
steps:
|
||||
@@ -227,9 +227,11 @@ steps:
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
### Memorizar dependências
|
||||
|
||||
Ao usar executores hospedados em {% data variables.product.prodname_dotcom %}, você pode armazenar em cache e restaurar as dependências usando a ação [`setup-python`](https://github.com/actions/setup-python).
|
||||
You can cache and restore the dependencies using the [`setup-python` action](https://github.com/actions/setup-python).
|
||||
|
||||
O exemplo a seguir armazena dependências para pip.
|
||||
|
||||
@@ -244,10 +246,12 @@ steps:
|
||||
- run: pip test
|
||||
```
|
||||
|
||||
Por padrão, a ação `setup-python` busca o arquivo de dependência (`requirements.txt` para pip ou `Pipfile.lock` para pipenv) em todo o repositório. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Armazenando em cache as dependências de pacotes</a>" nas ações README do `setup-python`.
|
||||
Por padrão, a ação `setup-python` busca o arquivo de dependência (`requirements.txt` para pip ou `Pipfile.lock` para pipenv) em todo o repositório. For more information, see "[Caching packages dependencies](https://github.com/actions/setup-python#caching-packages-dependencies)" in the `setup-python` README.
|
||||
|
||||
Se você tiver um requisito personalizado ou precisar de melhores controles para cache, você poderá usar a ação [`cache`](https://github.com/marketplace/actions/cache). O Pip armazena dependências em diferentes locais, dependendo do sistema operacional do executor. O caminho que você precisa efetuar o armazenamento em cache pode ser diferente do exemplo do Ubuntu acima, dependendo do sistema operacional que você usa. Para obter mais informações, consulte [Exemplos de armazenamento em cache do Python](https://github.com/actions/cache/blob/main/examples.md#python---pip) no repositório de ação `cache`.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Testar seu código
|
||||
|
||||
Você pode usar os mesmos comandos usados localmente para criar e testar seu código.
|
||||
|
||||
@@ -144,9 +144,11 @@ steps:
|
||||
- run: bundle install
|
||||
```
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
### Memorizar dependências
|
||||
|
||||
Se você estiver usando executores hospedados em {% data variables.product.prodname_dotcom %}, as ações do `setup-ruby` fornecem um método para lidar automaticamente com o cache dos seus gems entre as execuções.
|
||||
As ações `setup-ruby` fornecem um método para lidar automaticamente com o cache dos seus gems entre as execuções.
|
||||
|
||||
Para habilitar o cache, defina o seguinte.
|
||||
|
||||
@@ -159,11 +161,11 @@ steps:
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
Isso irá configurar o bundler para instalar seus gems em `vendor/cache`. Para cada execução bem sucedida do seu fluxo de trabalho, esta pasta será armazenada em cache por Ações e baixada novamente para subsequentes execuções de fluxo de trabalho. São usados um hash do seu gemfile.lock e versão do Ruby como a chave de cache. Se você instalar qualquer novo gem, ou mudar uma versão, o cache será invalidado e o bundler fará uma nova instalação.
|
||||
Isso irá configurar o bundler para instalar seus gems em `vendor/cache`. For each successful run of your workflow, this folder will be cached by {% data variables.product.prodname_actions %} and re-downloaded for subsequent workflow runs. São usados um hash do seu gemfile.lock e versão do Ruby como a chave de cache. Se você instalar qualquer novo gem, ou mudar uma versão, o cache será invalidado e o bundler fará uma nova instalação.
|
||||
|
||||
**Fazer armazenamento em cache sem o setup-ruby**
|
||||
|
||||
Para maior controle sobre o cache, se você estiver usando executores hospedados em {% data variables.product.prodname_dotcom %}, você poderá usar a ação `actions/cache` diretamente. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
For greater control over caching, you can use the `actions/cache` action directly. Para obter mais informações, consulte "[Memorizar dependências para acelerar fluxos de trabalho](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)".
|
||||
|
||||
```yaml
|
||||
steps:
|
||||
@@ -195,6 +197,8 @@ steps:
|
||||
bundle install --jobs 4 --retry 3
|
||||
```
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Matriz que testa o seu código
|
||||
|
||||
O exemplo a seguir da matriz testa todas as versões estáveis e versões principais de MRI, JRuby e TruffleRuby no Ubuntu e no macOS.
|
||||
|
||||
@@ -75,7 +75,7 @@ Antes de começar, você criará um repositório em {% ifversion ghae %}{% data
|
||||
outputs:
|
||||
random-number:
|
||||
description: "Random number"
|
||||
value: ${{ steps.random-number-generator.outputs.random-id }}
|
||||
value: ${{ steps.random-number-generator.outputs.random-number }}
|
||||
runs:
|
||||
using: "composite"
|
||||
steps:
|
||||
|
||||
@@ -286,7 +286,7 @@ steps:
|
||||
|
||||
**Exemplo: Usando funções de verificação de status**
|
||||
|
||||
A função `my backup step` somente é executada quando houver falha uma ação composta da etapa anterior do trabalho. Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions#job-status-check-functions)".
|
||||
A função `my backup step` somente é executada quando houver falha uma ação composta da etapa anterior do trabalho. Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions#status-check-functions)".
|
||||
|
||||
```yaml
|
||||
steps:
|
||||
|
||||
@@ -31,7 +31,7 @@ Você pode configurar seu fluxo de trabalho do CD para ser executado quando ocor
|
||||
|
||||
{% data variables.product.prodname_actions %} fornece funcionalidades que dão mais controle sobre implantações. Por exemplo, você pode usar ambientes para exigir aprovação para um trabalho prosseguir, restringir quais branches podem acionar um fluxo de trabalho, ou limitar o acesso a segredos. {% ifversion fpt or ghae or ghes > 3.1 or ghec %}Você pode usar a simultaneidade para limitar o pipeline do CD a um máximo de uma implantação em andamento e uma implantação pendente. {% endif %}Para obter mais informações sobre essas funcionalidades, consulte "[Implantando com GitHub Actions](/actions/deployment/deploying-with-github-actions)" e "[Usando ambientes para implantação](/actions/deployment/using-environments-for-deployment)".
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
## Usando o OpenID Connect para acessar os recursos da nuvem
|
||||
|
||||
|
||||
@@ -26,7 +26,7 @@ Este guia explica como usar {% data variables.product.prodname_actions %} para c
|
||||
|
||||
Em cada novo push para o `principal` no seu repositório de {% data variables.product.company_short %}, as compilações de fluxo de trabalho de {% data variables.product.prodname_actions %} e cria e faz push de uma nova imagem de contêiner para o Amazon ECR e, em seguida, implementa uma nova definição de tarefa para o Amazon ECS.
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e implantar um contêiner Docker no [Azure App Service](https://azure.microsoft.com/services/app-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e implantar um projeto Java no [Azure App Service](https://azure.microsoft.com/services/app-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e implantar um projeto .NET no [Azure App Service](https://azure.microsoft.com/services/app-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar, testar e implantar um projeto Node.js no [Azure App Service](https://azure.microsoft.com/services/app-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e implantar um projeto PHP no [Azure App Service](https://azure.microsoft.com/services/app-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e implantar um projeto Python no [Azure App Service](https://azure.microsoft.com/services/app-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e publicar um projeto no [Azure Kubernetes Service](https://azure.microsoft.com/services/kubernetes-service/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ topics:
|
||||
|
||||
Este guia explica como usar {% data variables.product.prodname_actions %} para criar e implantar um aplicativo web nos [Azure Static Web Apps](https://azure.microsoft.com/services/app-service/static/).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -26,7 +26,7 @@ Este guia explica como usar {% data variables.product.prodname_actions %} para c
|
||||
|
||||
O GKE é um serviço de cluster gerenciado do Kubernetes pelo Google Cloud que pode hospedar suas cargas de trabalho containerizadas na nuvem ou em seu próprio centro de dados. Para obter mais informações, consulte [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine).
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
@@ -66,11 +67,14 @@ O exemplo a seguir do token do OIDC usa um assunto (`sub`) que faz referência a
|
||||
"jti": "example-id",
|
||||
"sub": "repo:octo-org/octo-repo:environment:prod",
|
||||
"environment": "prod",
|
||||
"aud": "https://github.com/octo-org",
|
||||
"aud": "{% ifversion ghes %}https://HOSTNAME{% else %}https://github.com{% endif %}/octo-org",
|
||||
"ref": "refs/heads/main",
|
||||
"sha": "example-sha",
|
||||
"repository": "octo-org/octo-repo",
|
||||
"repository_owner": "octo-org",
|
||||
"actor_id": "12",
|
||||
"repository_id": "74",
|
||||
"repository_owner_id": "65",
|
||||
"run_id": "example-run-id",
|
||||
"run_number": "10",
|
||||
"run_attempt": "2",
|
||||
@@ -81,22 +85,25 @@ O exemplo a seguir do token do OIDC usa um assunto (`sub`) que faz referência a
|
||||
"event_name": "workflow_dispatch",
|
||||
"ref_type": "branch",
|
||||
"job_workflow_ref": "octo-org/octo-automation/.github/workflows/oidc.yml@refs/heads/main",
|
||||
"iss": "https://token.actions.githubusercontent.com",
|
||||
"iss": "{% ifversion ghes %}https://HOSTNAME/_services/token{% else %}https://token.actions.githubusercontent.com{% endif %}",
|
||||
"nbf": 1632492967,
|
||||
"exp": 1632493867,
|
||||
"iat": 1632493567
|
||||
}
|
||||
```
|
||||
|
||||
Para ver todas as reivindicações compatíveis com o provedor do OIDC de {% data variables.product.prodname_dotcom %}, revise as entradas `claims_supported` em https://token.actions.githubusercontent.com/.well-known/openid-configuration.
|
||||
To see all the claims supported by {% data variables.product.prodname_dotcom %}'s OIDC provider, review the `claims_supported` entries at
|
||||
{% ifversion ghes %}`https://HOSTNAME/_services/token/.well-known/openid-configuration`{% else %}https://token.actions.githubusercontent.com/.well-known/openid-configuration{% endif %}.
|
||||
|
||||
O token inclui as reivindicações padrão de audiência, emissor e assunto:
|
||||
|
||||
| Reivindicação | Descrição |
|
||||
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `aud` | _(Audiência)_ por padrão, esta é a URL do proprietário do repositório, como a organização proprietária do repositório. Esta é a única reivindicação que pode ser personalizada. Você pode definir um público personalizado com um comando de conjunto de ferramentas: [`core.getIDToken(audience)`](https://www.npmjs.com/package/@actions/core/v/1.6.0) |
|
||||
| `iss` | _(Emissor)_ O emissor do token do OIDC: `https://token.actions.githubusercontent.com` |
|
||||
| `sub` | _(Assunto)_ Define o assunto indicado para ser validado pelo provedor da nuvem. Esta configuração é essencial para garantir que os tokens de acesso sejam apenas alocados de forma previsível. |
|
||||
| Reivindicação | Descrição |
|
||||
| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `aud` | _(Audiência)_ por padrão, esta é a URL do proprietário do repositório, como a organização proprietária do repositório. Esta é a única reivindicação que pode ser personalizada. Você pode definir um público personalizado com um comando de conjunto de ferramentas: [`core.getIDToken(audience)`](https://www.npmjs.com/package/@actions/core/v/1.6.0) |
|
||||
| `iss` | _(Issuer)_ The issuer of the OIDC token: |
|
||||
| {% ifversion ghes %}`https://HOSTNAME/_services/token`{% else %}`https://token.actions.githubusercontent.com`{% endif %} | |
|
||||
| | |
|
||||
| `sub` | _(Assunto)_ Define o assunto indicado para ser validado pelo provedor da nuvem. Esta configuração é essencial para garantir que os tokens de acesso sejam apenas alocados de forma previsível. |
|
||||
|
||||
O token do OIDC também inclui reivindicações padrão adicionais:
|
||||
|
||||
@@ -112,22 +119,25 @@ O token do OIDC também inclui reivindicações padrão adicionais:
|
||||
|
||||
O token também inclui reivindicações personalizadas fornecidas por {% data variables.product.prodname_dotcom %}:
|
||||
|
||||
| Reivindicação | Descrição |
|
||||
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `actor` | A conta pessoal que iniciou a execução do fluxo de trabalho. |
|
||||
| `base_ref` | O branch de destino do pull request na execução de um fluxo de trabalho. |
|
||||
| `ambiente` | O nome do ambiente usado pelo trabalho. |
|
||||
| `event_name` | Nome do evento que acionou a execução do fluxo de trabalho. |
|
||||
| `head_ref` | O branch de origem do pull request na execução de um fluxo de trabalho. |
|
||||
| `job_workflow_ref` | Este é o caminho ref para o fluxo de trabalho reutilizável usado por este trabalho. Para obter mais informações, consulte "["Usando o OpenID Connect com fluxos de trabalho reutilizáveis"](/actions/deployment/security-hardening-your-deployments/using-openid-connect-with-reusable-workflows). |
|
||||
| `ref` | _(Referência)_ A ref do git que acionou a execução do fluxo de trabalho. |
|
||||
| `ref_type` | O tipo de `ref`, por exemplo: "branch". |
|
||||
| `repositório` | O repositório de onde o fluxo de trabalho está sendo executado. |
|
||||
| `repository_owner` | O nome da organização em que o `repositório` é armazenado. |
|
||||
| `run_id` | O ID da execução do fluxo de trabalho que acionou o fluxo de trabalho. |
|
||||
| `run_number` | O número de vezes que este fluxo de trabalho foi executado. |
|
||||
| `run_attempt` | O número de vezes que este fluxo de trabalho foi executado. |
|
||||
| `fluxo de trabalho` | Nome do fluxo de trabalho. |
|
||||
| Reivindicação | Descrição |
|
||||
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `actor` | A conta pessoal que iniciou a execução do fluxo de trabalho. |
|
||||
| `actor_id` | The ID of personal account that initiated the workflow run. |
|
||||
| `base_ref` | O branch de destino do pull request na execução de um fluxo de trabalho. |
|
||||
| `ambiente` | O nome do ambiente usado pelo trabalho. |
|
||||
| `event_name` | Nome do evento que acionou a execução do fluxo de trabalho. |
|
||||
| `head_ref` | O branch de origem do pull request na execução de um fluxo de trabalho. |
|
||||
| `job_workflow_ref` | Este é o caminho ref para o fluxo de trabalho reutilizável usado por este trabalho. Para obter mais informações, consulte "["Usando o OpenID Connect com fluxos de trabalho reutilizáveis"](/actions/deployment/security-hardening-your-deployments/using-openid-connect-with-reusable-workflows). |
|
||||
| `ref` | _(Referência)_ A ref do git que acionou a execução do fluxo de trabalho. |
|
||||
| `ref_type` | O tipo de `ref`, por exemplo: "branch". |
|
||||
| `repositório` | O repositório de onde o fluxo de trabalho está sendo executado. |
|
||||
| `repository_id` | The ID of the repository from where the workflow is running. |
|
||||
| `repository_owner` | O nome da organização em que o `repositório` é armazenado. |
|
||||
| `repository_owner_id` | The ID of the organization in which the `repository` is stored. |
|
||||
| `run_id` | O ID da execução do fluxo de trabalho que acionou o fluxo de trabalho. |
|
||||
| `run_number` | O número de vezes que este fluxo de trabalho foi executado. |
|
||||
| `run_attempt` | O número de vezes que este fluxo de trabalho foi executado. |
|
||||
| `fluxo de trabalho` | Nome do fluxo de trabalho. |
|
||||
|
||||
### Definir condições de confiança em funções de nuvem usando as reivindicações do OIDC
|
||||
|
||||
@@ -199,12 +209,12 @@ Você pode criar um assunto que filtra uma tag específica. Neste exemplo, a exe
|
||||
|
||||
Para configurar o assunto no relacionamento de confiança do seu provedor de nuvem, você deve adicionar a string de assunto à sua configuração de confiança. Os exemplos a seguir demonstram como vários provedores de nuvem podem aceitar o mesmo assunto `repo:octo-org/octo-repo:ref:refs/heads/demo-branch` de diferentes maneiras:
|
||||
|
||||
| | |
|
||||
| --------------------- | ------------------------------------------------------------------------------------------------- |
|
||||
| Amazon Web Services | `"token.actions.githubusercontent.com:sub": "repo:octo-org/octo-repo:ref:refs/heads/demo-branch"` |
|
||||
| Azure | `repo:octo-org/octo-repo:ref:refs/heads/demo-branch` |
|
||||
| Google Cloud Platform | `(assertion.sub=='repo:octo-org/octo-repo:ref:refs/heads/demo-branch')` |
|
||||
| HashiCorp Vault | `bound_subject="repo:octo-org/octo-repo:ref:refs/heads/demo-branch"` |
|
||||
| | |
|
||||
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Amazon Web Services | `"{% ifversion ghes %}HOSTNAME/_services/token{% else %}token.actions.githubusercontent.com{% endif %}:sub": "repo:octo-org/octo-repo:ref:refs/heads/demo-branch"` |
|
||||
| Azure | `repo:octo-org/octo-repo:ref:refs/heads/demo-branch` |
|
||||
| Google Cloud Platform | `(assertion.sub=='repo:octo-org/octo-repo:ref:refs/heads/demo-branch')` |
|
||||
| HashiCorp Vault | `bound_subject="repo:octo-org/octo-repo:ref:refs/heads/demo-branch"` |
|
||||
|
||||
Para obter mais informações, consulte os guias listados em "[Habilitando o OpenID Connect para o seu provedor de nuvem](#enabling-openid-connect-for-your-cloud-provider)".
|
||||
|
||||
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
@@ -31,7 +32,7 @@ Este guia explica como configurar o AWS para confiar no OIDC de {% data variable
|
||||
|
||||
Para adicionar o provedor OIDC de {% data variables.product.prodname_dotcom %} ao IAM, consulte a [documentação AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html).
|
||||
|
||||
- Para a URL do provedor: Use `https://token.actions.githubusercontent.com`
|
||||
- For the provider URL: Use {% ifversion ghes %}`https://HOSTNAME/_services/token`{% else %}`https://token.actions.githubusercontent.com`{% endif %}
|
||||
- Para o "público": Use `sts.amazonaws.com` se você estiver usando a [ação oficial](https://github.com/aws-actions/configure-aws-credentials).
|
||||
|
||||
### Configurando a função e a política de confiança
|
||||
@@ -42,9 +43,9 @@ Edite o relacionamento de confiança para adicionar o campo `sub` às condiçõe
|
||||
|
||||
```json{:copy}
|
||||
"Condition": {
|
||||
"StringEquals": {
|
||||
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
|
||||
"token.actions.githubusercontent.com:sub": "repo:octo-org/octo-repo:ref:refs/heads/octo-branch"
|
||||
"ForAllValues:StringEquals": {
|
||||
"{% ifversion ghes %}HOSTNAME/_services/token{% else %}token.actions.githubusercontent.com{% endif %}:aud": "sts.amazonaws.com",
|
||||
"{% ifversion ghes %}HOSTNAME/_services/token{% else %}token.actions.githubusercontent.com{% endif %}:sub": "repo:octo-org/octo-repo:ref:refs/heads/octo-branch"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
@@ -39,7 +40,7 @@ Orientação adicional para a configuração do provedor de identidade:
|
||||
|
||||
- Para aumentar a segurança, verifique se você revisou ["Configurando a confiança do OIDC com a nuvem"](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-oidc-trust-with-the-cloud). Por exemplo, consulte ["Configurar o assunto no seu provedor de nuvem"](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-subject-in-your-cloud-provider).
|
||||
- Para a conta de serviço estar disponível para configuração, ela deverá ser atribuída à função `roles/iam.workloadIdentityUser`. Para obter mais informações, consulte [a documentação do GCP](https://cloud.google.com/iam/docs/workload-identity-federation?_ga=2.114275588.-285296507.1634918453#conditions).
|
||||
- A URL do emissor a usar: `https://token.actions.githubusercontent.com`
|
||||
- The Issuer URL to use: {% ifversion ghes %}`https://HOSTNAME/_services/token`{% else %}`https://token.actions.githubusercontent.com`{% endif %}
|
||||
|
||||
## Atualizar o seu fluxo de trabalho de {% data variables.product.prodname_actions %}
|
||||
|
||||
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
@@ -32,8 +33,8 @@ Este guia fornece uma visão geral sobre como configurar o cofre HashiCorp para
|
||||
Para usar OIDC com oHashiCorp Vault, você deverá adicionar uma configuração de confiança ao provedor do OIDC de {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte a [documentação](https://www.vaultproject.io/docs/auth/jwt) do HashiCorp Vault.
|
||||
|
||||
Configure o cofre para aceitar tokens web do JSON (JWT) para a autenticação:
|
||||
- Para o `oidc_discovery_url`, use `https://token.actions.githubusercontent.com`
|
||||
- Para `bound_issuer`, use `https://token.actions.githubusercontent.com`
|
||||
- For the `oidc_discovery_url`, use {% ifversion ghes %}`https://HOSTNAME/_services/token`{% else %}`https://token.actions.githubusercontent.com`{% endif %}
|
||||
- For `bound_issuer`, use {% ifversion ghes %}`https://HOSTNAME/_services/token`{% else %}`https://token.actions.githubusercontent.com`{% endif %}
|
||||
- Certifique-se de que `bound_subject` esteja corretamente definido para seus requisitos de segurança. Para obter mais informações, consulte ["Configurar a confiança do OIDC com a nuvem"](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-oidc-trust-with-the-cloud) e [`hashicorp/vault-action`](https://github.com/hashicorp/vault-action).
|
||||
|
||||
## Atualizar o seu fluxo de trabalho de {% data variables.product.prodname_actions %}
|
||||
|
||||
@@ -6,6 +6,7 @@ versions:
|
||||
fpt: '*'
|
||||
ghae: issue-4856
|
||||
ghec: '*'
|
||||
ghes: '>=3.5'
|
||||
children:
|
||||
- /about-security-hardening-with-openid-connect
|
||||
- /configuring-openid-connect-in-amazon-web-services
|
||||
|
||||
@@ -45,11 +45,14 @@ Por exemplo, o token do OIDC a seguir é para um trabalho que fazia parte de um
|
||||
{
|
||||
"jti": "example-id",
|
||||
"sub": "repo:octo-org/octo-repo:environment:prod",
|
||||
"aud": "https://github.com/octo-org",
|
||||
"aud": "{% ifversion ghes %}https://HOSTNAME{% else %}https://github.com{% endif %}/octo-org",
|
||||
"ref": "refs/heads/main",
|
||||
"sha": "example-sha",
|
||||
"repository": "octo-org/octo-repo",
|
||||
"repository_owner": "octo-org",
|
||||
"actor_id": "12",
|
||||
"repository_id": "74",
|
||||
"repository_owner_id": "65",
|
||||
"run_id": "example-run-id",
|
||||
"run_number": "10",
|
||||
"run_attempt": "2",
|
||||
@@ -60,7 +63,7 @@ Por exemplo, o token do OIDC a seguir é para um trabalho que fazia parte de um
|
||||
"event_name": "workflow_dispatch",
|
||||
"ref_type": "branch",
|
||||
"job_workflow_ref": "octo-org/octo-automation/.github/workflows/oidc.yml@refs/heads/main",
|
||||
"iss": "https://token.actions.githubusercontent.com",
|
||||
"iss": "{% ifversion ghes %}https://HOSTNAME/_services/token{% else %}https://token.actions.githubusercontent.com{% endif %}",
|
||||
"nbf": 1632492967,
|
||||
"exp": 1632493867,
|
||||
"iat": 1632493567
|
||||
|
||||
@@ -147,7 +147,11 @@ 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.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. O valor do commit deste SHA depende do evento que acionou o fluxo de trabalho. Para obter mais informações, consulte [Eventos que acionam fluxos de trabalho](/actions/using-workflows/events-that-trigger-workflows). 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. O valor do commit deste SHA depende do evento que acionou o fluxo de trabalho. Para obter mais informações, consulte [Eventos que acionam fluxos de trabalho](/actions/using-workflows/events-that-trigger-workflows). Por exemplo, `ffac537e6cbbf934b08745a378932722df287a53`. |
|
||||
{%- if actions-job-summaries %}
|
||||
| `GITHUB_STEP_SUMMARY` | The path on the runner to the file that contains job summaries from workflow commands. Este arquivo é único para a etapa atual e alterações para cada etapa de um trabalho. For example, `/home/rob/runner/_layout/_work/_temp/_runner_file_commands/step_summary_1cb22d7f-5663-41a8-9ffc-13472605c76c`. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/using-workflows/workflow-commands-for-github-actions#adding-a-job-summary)." |
|
||||
{%- endif %}
|
||||
| `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 %}
|
||||
|
||||
@@ -70,4 +70,10 @@ gh run watch
|
||||
|
||||
Ao usar a API REST, você configura as `entradas` e `ref` como parâmetros do texto da solicitação. Se as entradas forem omitidas, serão usados os valores-padrão definidos no arquivo de fluxo de trabalho.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** You can define up to 10 `inputs` for a `workflow_dispatch` event.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Para obter mais informações sobre o uso da API REST, consulte o "[Criar um evento de envio de fluxo de trabalho](/rest/reference/actions/#create-a-workflow-dispatch-event)".
|
||||
|
||||
@@ -27,12 +27,12 @@ A reexecução de um fluxo de trabalho{% if re-run-jobs %} ou trabalhos em um fl
|
||||
{% data reusables.repositories.actions-tab %}
|
||||
{% data reusables.repositories.navigate-to-workflow %}
|
||||
{% data reusables.repositories.view-run %}
|
||||
{% ifversion fpt or ghes > 3.2 or ghae-issue-4721 or ghec %}
|
||||
{% ifversion fpt or ghes > 3.4 or ghae-issue-4721 or ghec %}
|
||||
1. No canto superior direito do fluxo de trabalho, use o menu suspenso **Reexecutar trabalhos** e selecione **Reexecutar todos os trabalhos**.
|
||||
|
||||
Se nenhum trabalho falhar, você não verá o menu suspenso **Reexecutar trabalhos**. Em vez disso, clique em **Reexecutar todos os trabalhos**. 
|
||||
{% endif %}
|
||||
{% ifversion ghes < 3.3 or ghae %}
|
||||
{% ifversion ghes < 3.5 or ghae %}
|
||||
1. No canto superior direito do fluxo de trabalho, use o menu suspenso **Reexecutar trabalhos** e selecione **Reexecutar todos os trabalhos**. 
|
||||
{% endif %}
|
||||
|
||||
@@ -109,7 +109,7 @@ gh run rerun --job <em>job-id</em>
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.2 or ghae-issue-4721 or ghec %}
|
||||
{% ifversion fpt or ghes > 3.4 or ghae-issue-4721 or ghec %}
|
||||
## Revisando execuções de workflows anteriores
|
||||
|
||||
Você pode ver os resultados de suas tentativas anteriores de executar um fluxo de trabalho. Você também pode visualizar execuções de workflows anteriores do fluxo de trabalho usando a API. Para obter mais informações, consulte ["Obter uma execução de workflow"](/rest/reference/actions#get-a-workflow-run).
|
||||
|
||||
@@ -82,6 +82,8 @@ Para obter mais informações, consulte "[Usar variáveis de ambiente](/actions/
|
||||
|
||||
O CircleCI e o {% data variables.product.prodname_actions %} fornecem um método para armazenar arquivos de cache no arquivo de configuração manualmente.
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
Abaixo, há um exemplo da sintaxe para cada sistema.
|
||||
|
||||
<table class="d-block">
|
||||
@@ -119,7 +121,11 @@ GitHub Actions
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
O cache de {% data variables.product.prodname_actions %} só é aplicável para repositórios hospedados em {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
{% else %}
|
||||
|
||||
{% data reusables.actions.caching-availability %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% data variables.product.prodname_actions %} não tem o equivalente ao Docker Layer Caching (DLC) do CircleCI.
|
||||
|
||||
|
||||
@@ -309,6 +309,8 @@ Para obter mais informações, consulte "[Variáveis de ambiente](/actions/refer
|
||||
|
||||
GitLab CI/CD e {% data variables.product.prodname_actions %} fornecem um método no arquivo de configuração para armazenar os arquivos do fluxo de trabalho manualmente.
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
Abaixo, há um exemplo da sintaxe para cada sistema:
|
||||
|
||||
<table class="d-block">
|
||||
@@ -359,7 +361,11 @@ jobs:
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
O cache de {% data variables.product.prodname_actions %} só é aplicável para repositórios hospedados em {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
{% else %}
|
||||
|
||||
{% data reusables.actions.caching-availability %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Artefatos
|
||||
|
||||
|
||||
@@ -302,7 +302,11 @@ jobs:
|
||||
|
||||
## Memorizar dependências
|
||||
|
||||
O Travis CI e {% data variables.product.prodname_actions %} permitem que você armazene as as dependências em cache manualmente para reutilização posterior. Esse exemplo demonstra a sintaxe do cache para cada sistema.
|
||||
O Travis CI e {% data variables.product.prodname_actions %} permitem que você armazene as as dependências em cache manualmente para reutilização posterior.
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
Esse exemplo demonstra a sintaxe do cache para cada sistema.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
@@ -337,7 +341,11 @@ cache: npm
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
O cache de {% data variables.product.prodname_actions %} só é aplicável para repositórios hospedados em {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Memorizar dependências para acelerar fluxos de trabalho</a>".
|
||||
{% else %}
|
||||
|
||||
{% data reusables.actions.caching-availability %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Exemplos de tarefas comuns
|
||||
|
||||
|
||||
@@ -80,7 +80,7 @@ on:
|
||||
jobs:
|
||||
push_to_registry:
|
||||
name: Push Docker image to Docker Hub
|
||||
runs-on: ubuntu-latest
|
||||
runs-on: {% ifversion ghes %}[self-hosted]{% else %}ubuntu-latest{% endif %}
|
||||
steps:
|
||||
- name: Check out the repo
|
||||
uses: {% data reusables.actions.action-checkout %}
|
||||
@@ -110,12 +110,16 @@ O fluxo de trabalho acima verifica o repositório {% data variables.product.prod
|
||||
|
||||
## Publicar imagens em {% data variables.product.prodname_registry %}
|
||||
|
||||
{% ifversion ghes > 3.4 %}
|
||||
{% data reusables.package_registry.container-registry-ghes-beta %}
|
||||
{% endif %}
|
||||
|
||||
{% 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 %}.
|
||||
In the example workflow below, we use the Docker `login-action`{% ifversion fpt or ghec %}, `metadata-action`,{% endif %} and `build-push-action` actions to build the Docker image, and if the build succeeds, push the built image to {% data variables.product.prodname_registry %}.
|
||||
|
||||
As opções de `login-action` de login necessárias para {% data variables.product.prodname_registry %} são:
|
||||
* `registry`: Deve ser definido como {% ifversion fpt or ghec %}`ghcr.io`{% else %}`docker.pkg.github.com`{% endif %}.
|
||||
* `registry`: Must be set to {% ifversion fpt or ghec %}`ghcr.io`{% elsif ghes > 3.4 %}`{% data reusables.package_registry.container-registry-hostname %}`{% else %}`docker.pkg.github.com`{% endif %}.
|
||||
* `nome de usuário`: Você pode usar o contexto {% raw %}`${{ github.actor }}`{% endraw %} para usar automaticamente o nome de usuário que acionou a execução do fluxo de trabalho. Para obter mais informações, consulte "[Contextos](/actions/learn-github-actions/contexts#github-context)".
|
||||
* `senha`: Você pode usar o segredo `GITHUB_TOKEN` gerado automaticamente para a senha. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)".
|
||||
|
||||
@@ -124,13 +128,17 @@ A opção `metadata-action` obrigatória para {% data variables.product.prodname
|
||||
* `imagens`: O espaço do nome e o nome da imagem Docker que você está criando.
|
||||
{% endif %}
|
||||
|
||||
As opções de `build-push-action` necessárias para {% data variables.product.prodname_registry %} são:{% ifversion fpt or ghec %}
|
||||
The `build-push-action` options required for {% data variables.product.prodname_registry %} are:{% ifversion fpt or ghec %}
|
||||
* `contexto`: Define o contexto da criação como o conjunto de arquivos localizados no caminho especificado.{% endif %}
|
||||
* `push`: Se definido como `verdadeiro`, a imagem será enviada por push para o registo se for criada com êxito.{% ifversion fpt or ghec %}
|
||||
* `tags` e `etiquetas`: são preenchidas pela saída de `metadados`.{% else %}
|
||||
* `tags`: Deve ser definido no formato `docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION`. Por exemplo, para uma imagem denominada `octo-image` armazenada em {% data variables.product.prodname_dotcom %} em `http://github. om/octo-org/octo-repo`, a opção `tags` deve estar definida como `docker.pkg.github.com/octo-org/octo-repo/octo-image:latest`. Você pode definir uma única tag, conforme mostrado abaixo, ou especificar várias tags em uma lista.{% endif %}
|
||||
* `tags`: Must be set in the format {% ifversion ghes > 3.4 %}`{% data reusables.package_registry.container-registry-hostname %}/OWNER/REPOSITORY/IMAGE_NAME:VERSION`.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
For example, for an image named `octo-image` stored on {% data variables.product.prodname_ghe_server %} at `https://HOSTNAME/octo-org/octo-repo`, the `tags` option should be set to `{% data reusables.package_registry.container-registry-hostname %}/octo-org/octo-repo/octo-image:latest`{% else %}`docker.pkg.github.com/OWNER/REPOSITORY/IMAGE_NAME:VERSION`.
|
||||
|
||||
For example, for an image named `octo-image` stored on {% data variables.product.prodname_dotcom %} at `http://github.com/octo-org/octo-repo`, the `tags` option should be set to `docker.pkg.github.com/octo-org/octo-repo/octo-image:latest`{% endif %}. Você pode definir uma única tag, conforme mostrado abaixo, ou especificar várias tags em uma lista.{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.4 %}
|
||||
{% data reusables.package_registry.publish-docker-image %}
|
||||
|
||||
O fluxo de trabalho acima é acionado por um push para o branch da "versão". Ele verifica o repositório GitHub e usa `login-action` para fazer login no {% data variables.product.prodname_container_registry %}. Em seguida, extrai etiquetas e tags para a imagem do Docker. Finalmente, ele usa a ação `de build-push-action` para criar a imagem e publicá-la no {% data variables.product.prodname_container_registry %}.
|
||||
@@ -172,11 +180,15 @@ jobs:
|
||||
{% ifversion ghae %}docker.YOUR-HOSTNAME.com{% else %}docker.pkg.github.com{% endif %}{% raw %}/${{ github.repository }}/octo-image:${{ github.event.release.tag_name }}{% endraw %}
|
||||
```
|
||||
|
||||
O fluxo de trabalho acima faz o check-out do repositório {% data variables.product.prodname_dotcom %}, usa o `login-action` para efetuar o login no registro e, em seguida, usa a ação `build-push-action` para criar uma imagem Docker com base no `arquivo Docker` do seu repositório; fazer push da imagem para o registro Docker e aplicar o commit SHA e a versão como tags de imagem.
|
||||
The above workflow checks out the {% data variables.product.product_name %} repository, uses the `login-action` to log in to the registry, and then uses the `build-push-action` action to: build a Docker image based on your repository's `Dockerfile`; push the image to the Docker registry, and apply the commit SHA and release version as image tags.
|
||||
{% endif %}
|
||||
|
||||
## Publicar imagens no Docker Hub e {% data variables.product.prodname_registry %}
|
||||
|
||||
{% ifversion ghes > 3.4 %}
|
||||
{% data reusables.package_registry.container-registry-ghes-beta %}
|
||||
{% endif %}
|
||||
|
||||
Em um único fluxo de trabalho, você pode publicar sua imagem Docker em vários registros usando as ações de `login-action` e `build-push-action` para cada registro.
|
||||
|
||||
O fluxo de trabalho a seguir usa os passos das seções anteriores ("[Publicar imagens no Docker Hub](#publishing-images-to-docker-hub)e "[Publicar imagens para {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)") para criar um único fluxo de trabalho que faz push em ambos os registros.
|
||||
@@ -193,7 +205,7 @@ on:
|
||||
jobs:
|
||||
push_to_registries:
|
||||
name: Push Docker image to multiple registries
|
||||
runs-on: ubuntu-latest{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
runs-on: {% ifversion ghes %}[self-hosted]{% else %}ubuntu-latest{% endif %}{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
permissions:
|
||||
packages: write
|
||||
contents: read{% endif %}
|
||||
@@ -207,10 +219,10 @@ jobs:
|
||||
username: {% raw %}${{ secrets.DOCKER_USERNAME }}{% endraw %}
|
||||
password: {% raw %}${{ secrets.DOCKER_PASSWORD }}{% endraw %}
|
||||
|
||||
- name: Log in to the {% ifversion fpt or ghec %}Container{% else %}Docker{% endif %} registry
|
||||
- name: Log in to the {% ifversion fpt or ghec or ghes > 3.4 %}Container{% else %}Docker{% endif %} registry
|
||||
uses: docker/login-action@f054a8b539a109f9f41c372932f1ae047eff08c9
|
||||
with:
|
||||
registry: {% ifversion fpt or ghec %}ghcr.io{% elsif ghae %}docker.YOUR-HOSTNAME.com{% else %}docker.pkg.github.com{% endif %}
|
||||
registry: {% ifversion fpt or ghec %}ghcr.io{% elsif ghae %}docker.YOUR-HOSTNAME.com{% elsif ghes > 3.4 %}{% data reusables.package_registry.container-registry-hostname %}{% else %}docker.pkg.github.com{% endif %}
|
||||
username: {% raw %}${{ github.actor }}{% endraw %}
|
||||
password: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %}
|
||||
|
||||
@@ -220,7 +232,7 @@ jobs:
|
||||
with:
|
||||
images: |
|
||||
my-docker-hub-namespace/my-docker-hub-repository
|
||||
{% ifversion fpt or ghec %}ghcr.io/{% raw %}${{ github.repository }}{% endraw %}{% elsif ghae %}{% raw %}docker.YOUR-HOSTNAME.com/${{ github.repository }}/my-image{% endraw %}{% else %}{% raw %}docker.pkg.github.com/${{ github.repository }}/my-image{% endraw %}{% endif %}
|
||||
{% ifversion fpt or ghec or ghes > 3.4 %}{% data reusables.package_registry.container-registry-hostname %}/{% raw %}${{ github.repository }}{% endraw %}{% elsif ghae %}{% raw %}docker.YOUR-HOSTNAME.com/${{ github.repository }}/my-image{% endraw %}{% else %}{% raw %}docker.pkg.github.com/${{ github.repository }}/my-image{% endraw %}{% endif %}
|
||||
|
||||
- name: Build and push Docker images
|
||||
uses: docker/build-push-action@ad44023a93711e3deb337508980b4b5e9bcdc5dc
|
||||
@@ -231,4 +243,4 @@ jobs:
|
||||
labels: {% raw %}${{ steps.meta.outputs.labels }}{% endraw %}
|
||||
```
|
||||
|
||||
O fluxo de trabalho acima faz checkout do repositório {% data variables.product.prodname_dotcom %} usa o `login-action` duas vezes para fazer login em ambos os registros e gerar etiquetas com a ação `metadata-action`. Em seguida, a ação `build-push-action` cria e faz push da imagem do Docker para o Docker Hub e, posteriormente, o {% ifversion fpt or ghec %}{% data variables.product.prodname_container_registry %}{% else %}regstro do Docker{% endif %}.
|
||||
The above workflow checks out the {% data variables.product.product_name %} repository, uses the `login-action` twice to log in to both registries and generates tags and labels with the `metadata-action` action. Then the `build-push-action` action builds and pushes the Docker image to Docker Hub and the {% ifversion fpt or ghec or ghes > 3.4 %}{% data variables.product.prodname_container_registry %}{% else %}Docker registry{% endif %}.
|
||||
|
||||
@@ -25,7 +25,7 @@ Os segredos são variáveis de ambiente criptografadas que você cria em uma org
|
||||
|
||||
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.
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -159,7 +159,7 @@ Para obter mais informações, consulte "[Sobre {% data variables.product.prodna
|
||||
|
||||
Para ajudar a mitigar o risco de um token exposto, considere restringir as permissões atribuídas. Para obter mais informações, consulte "[Modificar as permissões para o GITHUB_TOKEN](/actions/reference/authentication-in-a-workflow#modifying-the-permissions-for-the-github_token)".
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
|
||||
## Usando o OpenID Connect para acessar os recursos da nuvem
|
||||
|
||||
@@ -291,7 +291,7 @@ Um executor auto-hospedado pode ser adicionado aos vários níveis na sua hierar
|
||||
- Se cada equipe gerenciar seus próprios corredores hospedados, a recomendação será adicionar os executores ao mais alto nível de propriedade da equipe. Por exemplo, se cada equipe possui sua própria organização, será mais simples se os executores também forem adicionados ao nível da organização.
|
||||
- Você também pode adicionar executores no nível de repositório, mas isso adicionará uma sobrecarga de gerenciamento e também aumentará o número de executores necessários já que você não pode compartilhar executores entre repositórios.
|
||||
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 %}
|
||||
{% ifversion fpt or ghec or ghae-issue-4856 or ghes > 3.4 %}
|
||||
### Efetuando a autenticação para seu provedor de nuvem
|
||||
|
||||
Se você está usando {% data variables.product.prodname_actions %} para implantar para um provedor da nuvem, ou pretender usar o HashiCorp Vault para o gerenciamento de segredos, recomenda-se que você use o OpenID Connect para criar tokens de acesso com escopos bem definidos, curtos e para as execuções do seu fluxo de trabalho. Para obter mais informações, consulte[Sobre o enrijecimento da segurança com o OpenID Connect](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)".
|
||||
|
||||
@@ -124,10 +124,10 @@ jobs:
|
||||
|
||||
For more information, see "[Using a matrix for your jobs](/actions/using-jobs/using-a-matrix-for-your-jobs)."
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% if actions-caching %}
|
||||
### Memorizar dependências
|
||||
|
||||
Executores hospedados em {% data variables.product.prodname_dotcom %} são iniciados como ambientes novos para cada trabalho. Portanto, se os seus trabalhos reutilizam dependências regularmente, você pode considerar fazer armazenamento em cache desses arquivos para ajudar a melhorar o desempenho. Após a criação do armazenamento em cache, ele fica disponível para todos os fluxos de trabalho no mesmo repositório.
|
||||
If your jobs regularly reuse dependencies, you can consider caching these files to help improve performance. Após a criação do armazenamento em cache, ele fica disponível para todos os fluxos de trabalho no mesmo repositório.
|
||||
|
||||
Este exemplo demonstra como armazenar em cache o diretório `~/.npm`:
|
||||
|
||||
|
||||
@@ -9,22 +9,20 @@ redirect_from:
|
||||
- /actions/guides/caching-dependencies-to-speed-up-workflows
|
||||
- /actions/advanced-guides/caching-dependencies-to-speed-up-workflows
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
feature: actions-caching
|
||||
type: tutorial
|
||||
topics:
|
||||
- Workflows
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
## Sobre a memorização das dependências do fluxo de trabalho
|
||||
|
||||
As execuções do fluxo de trabalho geralmente reutilizam as mesmas saídas ou dependências baixadas de uma execução para outra. Por exemplo, as ferramentas de gerenciamento de pacotes e de dependência, como, por exemplo, Maven, Gradle, npm e Yarn mantêm uma cache local de dependências baixadas.
|
||||
|
||||
Os trabalhos nos executores hospedados em {% data variables.product.prodname_dotcom %} começam em um ambiente virtual limpo e devem baixar as dependências todas as vezes, o que gera uma maior utilização da rede, maior tempo de execução e aumento dos custos. Para ajudar a acelerar o tempo que leva para recrear esses arquivos, {% data variables.product.prodname_dotcom %} pode memorizar as dependências que você usa frequentemente nos fluxos de trabalho.
|
||||
{% ifversion fpt or ghec %} Jobs on {% data variables.product.prodname_dotcom %}-hosted runners start in a clean virtual environment and must download dependencies each time, causing increased network utilization, longer runtime, and increased cost. {% endif %}To help speed up the time it takes to recreate files like dependencies, {% data variables.product.prodname_dotcom %} can cache files you frequently use in workflows.
|
||||
|
||||
Para memorizar as dependências para um trabalho, você precisará usar a ação `cache` do {% data variables.product.prodname_dotcom %}. A ação recupera uma cache identificada por uma chave única. Para obter mais informações, consulte [`ações/cache`](https://github.com/actions/cache).
|
||||
|
||||
Se você estiver armazenando em cache os gerentes de pacotes listados abaixo, considere usar as respectivas ações de setup-*, que exigem praticamente nenhuma configuração e são fáceis de usar.
|
||||
To cache dependencies for a job, you can use {% data variables.product.prodname_dotcom %}'s [`cache` action](https://github.com/actions/cache). The action creates and restores a cache identified by a unique key. Alternatively, if you are caching the package managers listed below, using their respective setup-* actions requires minimal configuration and will create and restore dependency caches for you.
|
||||
|
||||
<table>
|
||||
<thead>
|
||||
@@ -36,62 +34,59 @@ Se você estiver armazenando em cache os gerentes de pacotes listados abaixo, co
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>npm, yarn, pnpm</td>
|
||||
<td><a href="https://github.com/actions/setup-node">setup-node</a></td>
|
||||
<td><a href="https://github.com/actions/setup-node#caching-global-packages-data">setup-node</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>pip, pipenv</td>
|
||||
<td><a href="https://github.com/actions/setup-python">setup-python</a></td>
|
||||
<td><a href="https://github.com/actions/setup-python#caching-packages-dependencies">setup-python</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>gradle, maven</td>
|
||||
<td><a href="https://github.com/actions/setup-java">setup-java</a></td>
|
||||
<td><a href="https://github.com/actions/setup-java#caching-packages-dependencies">setup-java</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>ruby gems</td>
|
||||
<td><a href="https://github.com/ruby/setup-ruby">setup-ruby</a></td>
|
||||
<td><a href="https://github.com/ruby/setup-ruby#caching-bundle-install-automatically">setup-ruby</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Alerta**: Recomendamos que você não armazene nenhuma informação confidencial na cache dos repositórios públicos. Por exemplo, as informações confidenciais podem incluir tokens de acesso ou credenciais de login armazenadas em um arquivo no caminho da cache. Além disso, os programas de interface da linha de comando (CLI) como o `login do Docker` pode salvar as credenciais de acesso em um arquivo de configuração. Qualquer pessoa com acesso de leitura pode criar um pull request em um repositório e acessar o conteúdo da cache. As bifurcações de um repositório também podem criar pull requests no branch-base e acessar as caches no branch-base.
|
||||
**Warning**: {% ifversion fpt or ghec %}Be mindful of the following when using caching with {% data variables.product.prodname_actions %}:
|
||||
|
||||
* {% endif %}We recommend that you don't store any sensitive information in the cache. Por exemplo, as informações confidenciais podem incluir tokens de acesso ou credenciais de login armazenadas em um arquivo no caminho da cache. Além disso, os programas de interface da linha de comando (CLI) como o `login do Docker` pode salvar as credenciais de acesso em um arquivo de configuração. Anyone with read access can create a pull request on a repository and access the contents of a cache. As bifurcações de um repositório também podem criar pull requests no branch-base e acessar as caches no branch-base.
|
||||
{%- ifversion fpt or ghec %}
|
||||
* When using self-hosted runners, caches from workflow runs are stored on {% data variables.product.company_short %}-owned cloud storage. A customer-owned storage solution is only available with {% data variables.product.prodname_ghe_server %}.
|
||||
{%- endif %}
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
## Comparando artefatos e memorização de dependência
|
||||
{% data reusables.actions.comparing-artifacts-caching %}
|
||||
|
||||
Os artefatos são similares, pois fornecem a habilidade de armazenar arquivos em {% data variables.product.prodname_dotcom %}, mas cada recurso oferece usos diferentes e não podem ser usados de forma intercambiável.
|
||||
|
||||
- Use a memorização quando desejar reutilizar os arquivos que não mudam com frequência entre trabalhos ou execuções de fluxos de trabalho.
|
||||
- Use artefatos quando desejar salvar arquivos produzidos por um trabalho a ser visualizado após a conclusão de um fluxo de trabalho. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)".
|
||||
For more information on workflow run artifacts, see "[Persisting workflow data using artifacts](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)."
|
||||
|
||||
## Restrições para acessar uma cache
|
||||
|
||||
Com `v2` da ação da `cache`, você pode acessar a cache nos fluxos de trabalho ativados por qualquer evento que tem um `GITHUB_REF`. Se você estiver usando `v1` da ação da `cache`, você só poderá acessar a cache em fluxos de trabalho ativados por eventos de `push` e `pull_request`, exceto para o evento `fechado` de `pull_request`. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)".
|
||||
|
||||
Um fluxo de trabalho pode acessar e restaurar um cache criado no branch atual, no branch de base (incluindo branches base de repositórios bifurcados) ou no branch-padrão (geralmente `principal`). Por exemplo, um cache criado no branch-padrão pode ser acessado a partir de qualquer pull request. Além disso, se o branch `feature-b` tiver o branch de base `feature-a`, um fluxo de trabalho acionado em `feature-b` teria acesso a caches criados no branch-padrão (`principal`), `feature-a` e `feature-b`.
|
||||
|
||||
As restrições de acesso fornecem o isolamento da cache e a segurança ao criar um limite lógico entre os diferentes branches. Por exemplo, um cache criado para o branch `feature-a` (com a base no `principal`) não seria acessível para um pull request para o branch `feature-b` (com a base no `principal`).
|
||||
As restrições de acesso fornecem o isolamento da cache e a segurança ao criar um limite lógico entre os diferentes branches. For example, a cache created for the branch `feature-a` (with the base `main`) would not be accessible to a pull request for the branch `feature-c` (with the base `main`).
|
||||
|
||||
Vários fluxos de trabalho dentro de um repositório compartilham entradas de cache. Uma cache criada para um branch de um fluxo de trabalho pode ser acessada e restaurada a partir de outro fluxo de trabalho para o mesmo repositório e branch.
|
||||
|
||||
## Usar a ação `cache`
|
||||
|
||||
A ação `cache` tentará restaurar uma cache com base na `chave` que você fornecer. Quando a ação encontrar uma cache, ela irá restaurar os arquivos memorizados no `caminho` que você configurar.
|
||||
The [`cache` action](https://github.com/actions/cache) will attempt to restore a cache based on the `key` you provide. Quando a ação encontrar uma cache, ela irá restaurar os arquivos memorizados no `caminho` que você configurar.
|
||||
|
||||
Se não houver uma correspondência perfeita, a ação criará uma nova entrada da cache se o trabalho for concluído com sucesso. A nova cache usará a `chave` que você forneceu e conterá os arquivos no diretório do `caminho`.
|
||||
If there is no exact match, the action automatically creates a new cache if the job completes successfully. The new cache will use the `key` you provided and contains the files you specify in `path`.
|
||||
|
||||
Como alternativa, você pode fornecer uma lista de `chaves de restauração` a serem usadas quando a `chave` não corresponder à cache existente. Uma lista de `chaves de restauração` é importante quando você está tentando restaurar uma cache de outro branch, pois `as chaves de restauração`<code podem corresponder parcialmente às chaves da cache. Para obter mais informações sobre a correspondência das `chaves de restauração`, consulte "[Correspondendo uma chave da cache](#matching-a-cache-key)".
|
||||
|
||||
Para obter mais informações, consulte [`ações/cache`](https://github.com/actions/cache).
|
||||
|
||||
### Parâmetros de entrada para a ação da `cache`
|
||||
|
||||
- `key`: **Obrigatório** A chave criada ao salvar uma cache e a chave usada para pesquisar uma cache. Pode ser qualquer combinação de variáveis, valores de contexto, strings estáticas e funções. As chaves têm um tamanho máximo de 512 caracteres e as chaves maiores que o tamanho máximo gerarão uma falha na ação.
|
||||
- `caminho`: **Obrigatório** O caminho do arquivo no executor para armazenar em cache ou restaurar. O caminho pode ser absoluto ou relativo com relação ao diretório de trabalho.
|
||||
- Os caminhos podem ser diretórios ou arquivos únicos. Os padrões de glob são compatíveis.
|
||||
- Com o `v2` da ação `cache`, é possível especificar um único caminho ou é possível adicionar vários caminhos em linhas separadas. Por exemplo:
|
||||
- `key`: **Obrigatório** A chave criada ao salvar uma cache e a chave usada para pesquisar uma cache. It can be any combination of variables, context values, static strings, and functions. As chaves têm um tamanho máximo de 512 caracteres e as chaves maiores que o tamanho máximo gerarão uma falha na ação.
|
||||
- `path`: **Required** The path(s) on the runner to cache or restore.
|
||||
- You can specify a single path, or you can add multiple paths on separate lines. Por exemplo:
|
||||
|
||||
```
|
||||
- name: Cache Gradle packages
|
||||
@@ -101,14 +96,15 @@ Para obter mais informações, consulte [`ações/cache`](https://github.com/act
|
||||
~/.gradle/caches
|
||||
~/.gradle/wrapper
|
||||
```
|
||||
- Com `v1` da ação da `cache`, somente um caminho único é compatível e deve ser um diretório. Você não pode armazenar em cache um único arquivo.
|
||||
- `restore-keys`: **Opcional** Uma string que contêm chaves de restauração alternativas, com cada uma colocada em uma nova linha. Se nenhuma correspondência de cache foi encontrada para a `chave`, estas chaves de restauração serão usadas sequencialmente na ordem fornecida para encontrar e restaurar um cache. Por exemplo:
|
||||
- You can specify either directories or single files, and glob patterns are supported.
|
||||
- You can specify absolute paths, or paths relative to the workspace directory.
|
||||
- `restore-keys`: **Opcional** Uma string que contêm chaves de restauração alternativas, com cada uma colocada em uma nova linha. If no cache hit occurs for `key`, these restore keys are used sequentially in the order provided to find and restore a cache. Por exemplo:
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
restore-keys: |
|
||||
npm-foobar-${{ hashFiles('package-lock.json') }}
|
||||
npm-foobar-
|
||||
npm-feature-${{ hashFiles('package-lock.json') }}
|
||||
npm-feature-
|
||||
npm-
|
||||
```
|
||||
{% endraw %}
|
||||
@@ -123,17 +119,15 @@ Este exemplo cria uma nova cache quando são alterados os pacotes no arquivo `pa
|
||||
|
||||
```yaml{:copy}
|
||||
name: Caching with npm
|
||||
|
||||
on: push
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: {% data reusables.actions.action-checkout %}
|
||||
|
||||
- name: Cache node modules
|
||||
id: cache-npm
|
||||
uses: {% data reusables.actions.action-cache %}
|
||||
env:
|
||||
cache-name: cache-node-modules
|
||||
@@ -146,7 +140,12 @@ jobs:
|
||||
{% raw %}${{ runner.os }}-build-{% endraw %}
|
||||
{% raw %}${{ runner.os }}-{% endraw %}
|
||||
|
||||
- name: Install Dependencies
|
||||
- if: {% raw %}${{ steps.cache-npm.outputs.cache-hit == false }}{% endraw %}
|
||||
name: List the state of node modules
|
||||
continue-on-error: true
|
||||
run: npm list
|
||||
|
||||
- name: Install dependencies
|
||||
run: npm install
|
||||
|
||||
- name: Build
|
||||
@@ -156,23 +155,27 @@ jobs:
|
||||
run: npm test
|
||||
```
|
||||
|
||||
O processo de a `chave` corresponder a uma cache existente é denominado correspondência e a ação restaura o arquivo memorizado no diretório do `caminho`.
|
||||
When `key` matches an existing cache, it's called a _cache hit_, and the action restores the cached files to the `path` directory.
|
||||
|
||||
O processo de a `chave` não corresponder a uma cache existente é denominado falha e cria-se uma nova cache se o trabalho for concluído com sucesso. Ao ocorrer uma falha da cache, a ação pesquisa chaves alternativas chamadas `chaves de restauração`.
|
||||
When `key` doesn't match an existing cache, it's called a _cache miss_, and a new cache is automatically created if the job completes successfully.
|
||||
|
||||
When a cache miss occurs, the action also searches your specified `restore-keys` for any matches:
|
||||
|
||||
1. Se você fornecer `chaves de restauração`, a ação da `cache` pesquisará, em seguida, todas as caches que correspondem à lista de `chaves de restauração`.
|
||||
- Se houver uma correspondência exata, a ação irá restaurar os arquivos na cache para o diretório do `caminho`.
|
||||
- Se não houver correspondências exatas, a ação pesquisará correspondências parciais das chaves de restauração. Quando uma ação encontra uma correspondência parcial, a última cache é restaurada para o diretório do `caminho`.
|
||||
1. A ação da `cache` é concluída e a próxima etapa do fluxo de trabalho é executada no trabalho.
|
||||
1. Se o trabalho for concluído com sucesso, a ação cria uma nova cache com o conteúdo do diretório do `caminho`.
|
||||
1. The `cache` action completes and the next step in the job runs.
|
||||
1. If the job completes successfully, the action automatically creates a new cache with the contents of the `path` directory.
|
||||
|
||||
Para memorizar os arquivos em mais de um diretório, você precisará de uma etapa que usa a ação da [`cache`](https://github.com/actions/cache) para cada diretório. Após criar uma cache, você não poderá alterar o conteúdo de uma cache existente, mas você poderá criar uma nova cache com uma nova chave.
|
||||
For a more detailed explanation of the cache matching process, see "[Matching a cache key](#matching-a-cache-key)." Após criar uma cache, você não poderá alterar o conteúdo de uma cache existente, mas você poderá criar uma nova cache com uma nova chave.
|
||||
|
||||
### Usar contextos para criar chaves da cache
|
||||
|
||||
Uma chave da cache pode incluir quaisquer contextos, funções, literais e operadores suportados por {% data variables.product.prodname_actions %}. Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions)".
|
||||
Uma chave da cache pode incluir quaisquer contextos, funções, literais e operadores suportados por {% data variables.product.prodname_actions %}. For more information, see "[Contexts](/actions/learn-github-actions/contexts)" and "[Expressions](/actions/learn-github-actions/expressions)."
|
||||
|
||||
Usar expressões para criar uma `chave` permite que você crie automaticamente uma nova cache quando as dependências forem alteradas. Por exemplo, você pode criar uma `chave` usando uma expressão que calcula o hash de um arquivo `package-lock.json` de npm.
|
||||
Using expressions to create a `key` allows you to automatically create a new cache when dependencies change.
|
||||
|
||||
Por exemplo, você pode criar uma `chave` usando uma expressão que calcula o hash de um arquivo `package-lock.json` de npm. So, when the dependencies that make up the `package-lock.json` file change, the cache key changes and a new cache is automatically created.
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
@@ -186,19 +189,32 @@ npm-${{ hashFiles('package-lock.json') }}
|
||||
npm-d5ea0750
|
||||
```
|
||||
|
||||
### Using the output of the `cache` action
|
||||
|
||||
You can use the output of the `cache` action to do something based on whether a cache hit or miss occurred. If there is a cache miss (an exact match for a cache was not found for the specified `key`), the `cache-hit` output is set to `false`.
|
||||
|
||||
In the example workflow above, there is a step that lists the state of the Node modules if a cache miss occurred:
|
||||
|
||||
```yaml
|
||||
- if: {% raw %}${{ steps.cache-npm.outputs.cache-hit == false }}{% endraw %}
|
||||
name: List the state of node modules
|
||||
continue-on-error: true
|
||||
run: npm list
|
||||
```
|
||||
|
||||
## Corresponder uma chave da cache
|
||||
|
||||
A ação da `cache` primeiro pesquisa correspondências da cache para a `chave` e para as `chaves de restauração` no branch que contém a execução do fluxo de trabalho. Se não houver correspondências no branch atual, a ação da `cache` pesquisa a `chave` e as `chaves de restauração` no branch-pai e nos branches upstream.
|
||||
|
||||
Você pode fornecer uma lista de chaves de restauração a serem usadas quando houver uma falha de cache na `chave`. Você pode criar múltiplas chaves de restauração ordenadas da mais específica para a menos específica. A ação da `cache` pesquisa as `chaves de restauração` em ordem sequencial. Quando uma chave não corresponde diretamente, a ação pesquisa as chaves prefixadas com a chave de restauração. Se houver múltiplas correspondências parciais para uma chave de restauração, a ação retornará a cache criada por último.
|
||||
`restore-keys` allows you to specify a list of alternate restore keys to use when there is a cache miss on `key`. Você pode criar múltiplas chaves de restauração ordenadas da mais específica para a menos específica. The `cache` action searches the `restore-keys` in sequential order. Quando uma chave não corresponde diretamente, a ação pesquisa as chaves prefixadas com a chave de restauração. Se houver múltiplas correspondências parciais para uma chave de restauração, a ação retornará a cache criada por último.
|
||||
|
||||
### Exemplo do uso de múltiplas chaves de restauração
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
restore-keys: |
|
||||
npm-foobar-${{ hashFiles('package-lock.json') }}
|
||||
npm-foobar-
|
||||
npm-feature-${{ hashFiles('package-lock.json') }}
|
||||
npm-feature-
|
||||
npm-
|
||||
```
|
||||
{% endraw %}
|
||||
@@ -208,16 +224,16 @@ O executor avalia as expressões, que resolvem essas `chaves de restauração`:
|
||||
{% raw %}
|
||||
```yaml
|
||||
restore-keys: |
|
||||
npm-foobar-d5ea0750
|
||||
npm-foobar-
|
||||
npm-feature-d5ea0750
|
||||
npm-feature-
|
||||
npm-
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
A chave de restauração `npm-foobar-` corresponde a qualquer chave que começa com a string `npm-foobar-`. Por exemplo, ambas as chaves `npm-foobar-fd3052de` e `npm-foobar-a9b253ff` correspondem à chave de restauração. Será usada a cache com a data de criação mais recente. As chaves neste exemplo são pesquisadas na ordem a seguir:
|
||||
The restore key `npm-feature-` matches any key that starts with the string `npm-feature-`. For example, both of the keys `npm-feature-fd3052de` and `npm-feature-a9b253ff` match the restore key. Será usada a cache com a data de criação mais recente. As chaves neste exemplo são pesquisadas na ordem a seguir:
|
||||
|
||||
1. **`npm-foobar-d5ea0750`** corresponde a um hash específico.
|
||||
1. **`npm-foobar-`** corresponde a chaves da cache prefixadas com `npm-foobar-`.
|
||||
1. **`npm-feature-d5ea0750`** matches a specific hash.
|
||||
1. **`npm-feature-`** matches cache keys prefixed with `npm-feature-`.
|
||||
1. **`npm-`** corresponde a chaves prefixadas com `npm-`.
|
||||
|
||||
#### Exemplo de prioridade de pesquisa
|
||||
@@ -230,18 +246,24 @@ restore-keys: |
|
||||
npm-
|
||||
```
|
||||
|
||||
Por exemplo, se um pull request contiver um branch de`recurso` (escopo atual) e atingir o branch-padrão (`principal`), a ação pesquisará a `chave` e as `chaves de restauração` na ordem a seguir:
|
||||
For example, if a pull request contains a `feature` branch and targets the default branch (`main`), the action searches for `key` and `restore-keys` in the following order:
|
||||
|
||||
1. Chave `npm-feature-d5ea0750` no escopo do branch `de recurso`
|
||||
1. Chave `npm-feature-` no escopo do ramo `de recurso`
|
||||
2. Chave `npm-` no escopo do branch `de recurso`
|
||||
1. Chave `npm-feature-d5ea0750` no escopo do branc `principal`
|
||||
3. Chave `npm-feature-` no escopo do branch `principal`
|
||||
4. Chave `npm` no escopo do branch `principal`
|
||||
1. Key `npm-feature-d5ea0750` in the `feature` branch
|
||||
1. Key `npm-feature-` in the `feature` branch
|
||||
1. Key `npm-` in the `feature` branch
|
||||
1. Key `npm-feature-d5ea0750` in the `main` branch
|
||||
1. Key `npm-feature-` in the `main` branch
|
||||
1. Key `npm-` in the `main` branch
|
||||
|
||||
## Limites de uso e política de eliminação
|
||||
|
||||
{% data variables.product.prodname_dotcom %} removerá todas as entradas da cache não acessadas há mais de 7 dias. Não há limite no número de caches que você pode armazenar, mas o tamanho total de todos os caches em um repositório é limitado a 10 GB. Se você exceder esse limite, {% data variables.product.prodname_dotcom %} salvará seu cache mas começará a despejar caches até que o tamanho total seja inferior a 10 GB.
|
||||
{% data variables.product.prodname_dotcom %} removerá todas as entradas da cache não acessadas há mais de 7 dias. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited{% if actions-cache-policy-apis %}. By default, the limit is 10 GB per repository, but this limit might be different depending on policies set by your enterprise owners or repository administrators.{% else %} to 10 GB.{% endif %}
|
||||
|
||||
{% data reusables.actions.cache-eviction-process %}
|
||||
|
||||
{% if actions-cache-policy-apis %}
|
||||
For information on changing the policies for the repository cache size limit, see "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-cache-storage-in-your-enterprise)" and "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-cache-storage-for-a-repository)."
|
||||
{% endif %}
|
||||
|
||||
{% if actions-cache-management %}
|
||||
|
||||
|
||||
@@ -27,11 +27,11 @@ children:
|
||||
- /workflow-syntax-for-github-actions
|
||||
- /workflow-commands-for-github-actions
|
||||
- /reusing-workflows
|
||||
- /caching-dependencies-to-speed-up-workflows
|
||||
- /storing-workflow-data-as-artifacts
|
||||
- /creating-starter-workflows-for-your-organization
|
||||
- /using-starter-workflows
|
||||
- /sharing-workflows-secrets-and-runners-with-your-organization
|
||||
- /caching-dependencies-to-speed-up-workflows
|
||||
- /storing-workflow-data-as-artifacts
|
||||
- /using-github-cli-in-workflows
|
||||
---
|
||||
|
||||
|
||||
@@ -56,13 +56,21 @@ Para compartilhar dados entre trabalhos:
|
||||
|
||||
As etapas de um trabalho compartilham o mesmo ambiente na máquina executora, mas são executados em seus próprios processos individuais. Para transmitir dados entre etapas de um trabalho, você pode usar entradas e saídas. Para obter mais informações sobre entradas e saídas, consulte "[Sintaxe de metadados para o {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)".
|
||||
|
||||
{% if actions-caching %}
|
||||
|
||||
{% data reusables.actions.comparing-artifacts-caching %}
|
||||
|
||||
For more information on dependency caching, see "[Caching dependencies to speed up workflows](/actions/using-workflows/caching-dependencies-to-speed-up-workflows#comparing-artifacts-and-dependency-caching)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Fazer upload da compilação e testar artefatos
|
||||
|
||||
Você pode criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu código. Para obter mais informações sobre o uso do {% data variables.product.prodname_actions %} para executar CI, consulte "[Sobre integração contínua](/articles/about-continuous-integration)."
|
||||
|
||||
A saída da compilação e teste de seu código muitas vezes produz arquivos que podem ser usados para depurar falhas em testes e códigos de produção que você pode implantar. É possível configurar um fluxo de trabalho para compilar e testar o código com push no repositório e relatar um status de sucesso ou falha. Você pode fazer upload da saída de compilação e teste para usar em implantações, para depurar falhas e testes com falhas e visualizar a cobertura do conjunto de teste.
|
||||
|
||||
Você pode usar a ação `upload-artifact` para fazer o upload dos artefatos. Ao fazer o upload de um artefato, você pode especificar um arquivo ou diretório único, ou vários arquivos ou diretórios. Você também pode excluir certos arquivos ou diretórios e usar padrões coringa. Recomendamos que você forneça um nome para um artefato, mas se nenhum nome for fornecido, `artefato` será usado como nome-padrão. Para mais informações sobre sintaxe, consulte a ação {% ifversion fpt or ghec %}[actions/upload-artifact](https://github.com/actions/upload-artifact) {% else %} `actions/upload-artifact` em {% data variables.product.product_location %}{% endif %}.
|
||||
Você pode usar a ação `upload-artifact` para fazer o upload dos artefatos. Ao fazer o upload de um artefato, você pode especificar um arquivo ou diretório único, ou vários arquivos ou diretórios. Você também pode excluir certos arquivos ou diretórios e usar padrões coringa. Recomendamos que você forneça um nome para um artefato, mas se nenhum nome for fornecido, `artefato` será usado como nome-padrão. For more information on syntax, see the {% ifversion fpt or ghec %}[actions/upload-artifact](https://github.com/actions/upload-artifact) action{% else %} `actions/upload-artifact` action on {% data variables.product.product_location %}{% endif %}.
|
||||
|
||||
### Exemplo
|
||||
|
||||
@@ -80,7 +88,7 @@ Por exemplo, o seu repositório ou um aplicativo web pode conter arquivos SASS e
|
||||
|
|
||||
```
|
||||
|
||||
Esse exemplo mostra como criar um fluxo de trabalho para um projeto Node.js que builds (compila) o código no diretório `src` e executa os testes no diretório `tests`. Você pode partir do princípio que executar `npm test` produz um relatório de cobertura de código denominado `code-coverage.html`, armazenado no diretório `output/test/`.
|
||||
This example shows you how to create a workflow for a Node.js project that builds the code in the `src` directory and runs the tests in the `tests` directory. Você pode partir do princípio que executar `npm test` produz um relatório de cobertura de código denominado `code-coverage.html`, armazenado no diretório `output/test/`.
|
||||
|
||||
O fluxo de trabalho faz o upload dos artefatos de produção no diretório `dist`, mas exclui todos os arquivos de markdown. Ele também faz o upload do relatório de `code-coverage.html` como outro artefato.
|
||||
|
||||
|
||||
@@ -111,13 +111,10 @@ A tabela a seguir mostra quais funções do conjunto de ferramentas estão dispo
|
||||
| `core.getInput` | Acessível por meio do uso da variável de ambiente `INPUT_{NAME}` |
|
||||
| `core.getState` | Acessível por meio do uso da variável de ambiente `STATE_{NAME}` |
|
||||
| `core.isDebug` | Acessível por meio do uso da variável de ambiente `RUNNER_DEBUG` |
|
||||
| `core.saveState` | `save-state` |
|
||||
| `core.setCommandEcho` | `echo` |
|
||||
| `core.setFailed` | Usado como um atalho para `::error` e `exit 1` |
|
||||
| `core.setOutput` | `set-output` |
|
||||
| `core.setSecret` | `add-mask` |
|
||||
| `core.startGroup` | `grupo` |
|
||||
| `core.warning` | `aviso` |
|
||||
{%- if actions-job-summaries %}
|
||||
| `core.summary` | Accessible using environment variable `GITHUB_STEP_SUMMARY` |
|
||||
{%- endif %}
|
||||
| `core.saveState` | `save-state` | | `core.setCommandEcho` | `echo` | | `core.setFailed` | Used as a shortcut for `::error` and `exit 1` | | `core.setOutput` | `set-output` | | `core.setSecret` | `add-mask` | | `core.startGroup` | `group` | | `core.warning` | `warning` |
|
||||
|
||||
## Definir um parâmetro de saída
|
||||
|
||||
@@ -563,14 +560,16 @@ echo "{environment_variable_name}={value}" >> $GITHUB_ENV
|
||||
{% powershell %}
|
||||
|
||||
- Usando a versão 6 ou superior do PowerShell:
|
||||
```pwsh{:copy}
|
||||
"{environment_variable_name}={value}" >> $env:GITHUB_ENV
|
||||
```
|
||||
|
||||
```pwsh{:copy}
|
||||
"{environment_variable_name}={value}" >> $env:GITHUB_ENV
|
||||
```
|
||||
|
||||
- Usando a versão 5.1 ou inferior do PowerShell:
|
||||
```powershell{:copy}
|
||||
"{environment_variable_name}={value}" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
|
||||
```
|
||||
|
||||
```powershell{:copy}
|
||||
"{environment_variable_name}={value}" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
|
||||
```
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
@@ -657,6 +656,150 @@ steps:
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
{% if actions-job-summaries %}
|
||||
|
||||
## Adding a job summary
|
||||
|
||||
{% bash %}
|
||||
|
||||
```bash{:copy}
|
||||
echo "{markdown content}" >> $GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endbash %}
|
||||
|
||||
{% powershell %}
|
||||
|
||||
```pwsh{:copy}
|
||||
"{markdown content}" >> $env:GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
You can set some custom Markdown for each job so that it will be displayed on the summary page of a workflow run. You can use job summaries to display and group unique content, such as test result summaries, so that someone viewing the result of a workflow run doesn't need to go into the logs to see important information related to the run, such as failures.
|
||||
|
||||
Job summaries support [{% data variables.product.prodname_dotcom %} flavored Markdown](https://github.github.com/gfm/), and you can add your Markdown content for a step to the `GITHUB_STEP_SUMMARY` environment file. `GITHUB_STEP_SUMMARY` is unique for each step in a job. For more information about the per-step file that `GITHUB_STEP_SUMMARY` references, see "[Environment files](#environment-files)."
|
||||
|
||||
When a job finishes, the summaries for all steps in a job are grouped together into a single job summary and are shown on the workflow run summary page. If multiple jobs generate summaries, the job summaries are ordered by job completion time.
|
||||
|
||||
### Exemplo
|
||||
|
||||
{% bash %}
|
||||
|
||||
```bash{:copy}
|
||||
echo "### Hello world! :rocket:" >> $GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endbash %}
|
||||
|
||||
{% powershell %}
|
||||
|
||||
```pwsh{:copy}
|
||||
"### Hello world! :rocket:" >> $env:GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
|
||||
|
||||
### Multiline Markdown content
|
||||
|
||||
For multiline Markdown content, you can use `>>` to continuously append content for the current step. With every append operation, a newline character is automatically added.
|
||||
|
||||
#### Exemplo
|
||||
|
||||
{% bash %}
|
||||
|
||||
```yaml
|
||||
- name: Generate list using Markdown
|
||||
run: |
|
||||
echo "This is the lead in sentence for the list" >> $GITHUB_STEP_SUMMARY
|
||||
echo "" >> $GITHUB_STEP_SUMMARY # this is a blank line
|
||||
echo "- Lets add a bullet point" >> $GITHUB_STEP_SUMMARY
|
||||
echo "- Lets add a second bullet point" >> $GITHUB_STEP_SUMMARY
|
||||
echo "- How about a third one?" >> $GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endbash %}
|
||||
|
||||
{% powershell %}
|
||||
|
||||
```yaml
|
||||
- name: Generate list using Markdown
|
||||
run: |
|
||||
"This is the lead in sentence for the list" >> $env:GITHUB_STEP_SUMMARY
|
||||
"" >> $env:GITHUB_STEP_SUMMARY # this is a blank line
|
||||
"- Lets add a bullet point" >> $env:GITHUB_STEP_SUMMARY
|
||||
"- Lets add a second bullet point" >> $env:GITHUB_STEP_SUMMARY
|
||||
"- How about a third one?" >> $env:GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
### Overwriting job summaries
|
||||
|
||||
To clear all content for the current step, you can use `>` to overwrite any previously added content.
|
||||
|
||||
#### Exemplo
|
||||
|
||||
{% bash %}
|
||||
|
||||
```yaml
|
||||
- name: Overwrite Markdown
|
||||
run: |
|
||||
echo "Adding some Markdown content" >> $GITHUB_STEP_SUMMARY
|
||||
echo "There was an error, we need to clear the previous Markdown with some new content." > $GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endbash %}
|
||||
|
||||
{% powershell %}
|
||||
|
||||
```yaml
|
||||
- name: Overwrite Markdown
|
||||
run: |
|
||||
"Adding some Markdown content" >> $env:GITHUB_STEP_SUMMARY
|
||||
"There was an error, we need to clear the previous Markdown with some new content." > $env:GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
### Removing job summaries
|
||||
|
||||
To completely remove a summary for the current step, the file that `GITHUB_STEP_SUMMARY` references can be deleted.
|
||||
|
||||
#### Exemplo
|
||||
|
||||
{% bash %}
|
||||
|
||||
```yaml
|
||||
- name: Delete all summary content
|
||||
run: |
|
||||
echo "Adding Markdown content that we want to remove before the step ends" >> $GITHUB_STEP_SUMMARY
|
||||
rm $GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endbash %}
|
||||
|
||||
{% powershell %}
|
||||
|
||||
```yaml
|
||||
- name: Delete all summary content
|
||||
run: |
|
||||
"Adding Markdown content that we want to remove before the step ends" >> $env:GITHUB_STEP_SUMMARY
|
||||
rm $env:GITHUB_STEP_SUMMARY
|
||||
```
|
||||
|
||||
{% endpowershell %}
|
||||
|
||||
After a step has completed, job summaries are uploaded and subsequent steps cannot modify previously uploaded Markdown content. Summaries automatically mask any secrets that might have been added accidentally. If a job summary contains sensitive information that must be deleted, you can delete the entire workflow run to remove all its job summaries. For more information see "[Deleting a workflow run](/actions/managing-workflow-runs/deleting-a-workflow-run)."
|
||||
|
||||
### Step isolation and limits
|
||||
|
||||
Job summaries are isolated between steps and each step is restricted to a maximum size of 1MiB. Isolation is enforced between steps so that potentially malformed Markdown from a single step cannot break Markdown rendering for subsequent steps. If more than 1MiB of content is added for a step, then the upload for the step will fail and an error annotation will be created. Upload failures for job summaries do not affect the overall status of a step or a job. A maximum of 20 job summaries from steps are displayed per job.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Adicionar um caminho do sistema
|
||||
|
||||
Prepara um diretório para a variável `PATH` do sistema e disponibiliza automaticamente para todas as ações subsequentes no trabalho atual; a ação atualmente em execução não pode acessar a variável de caminho atualizada. Para ver os caminhos atualmente definidos para o seu trabalho, você pode usar o `echo "$PATH"` em uma etapa ou ação.
|
||||
@@ -678,21 +821,20 @@ echo "{path}" >> $GITHUB_PATH
|
||||
|
||||
### Exemplo
|
||||
|
||||
Este exemplo demonstra como adicionar o diretório `$HOME/.local/bin` ao `PATH`:
|
||||
|
||||
{% bash %}
|
||||
|
||||
Este exemplo demonstra como adicionar o diretório `$HOME/.local/bin` ao `PATH`:
|
||||
|
||||
```bash{:copy}
|
||||
echo "$HOME/.local/bin" >> $GITHUB_PATH
|
||||
```
|
||||
|
||||
{% endbash %}
|
||||
|
||||
{% powershell %}
|
||||
|
||||
Este exemplo demonstra como adicionar o diretório do usuário `$env:HOMEPATH/.local/bin` a `PATH`:
|
||||
|
||||
{% powershell %}
|
||||
|
||||
```pwsh{:copy}
|
||||
"$env:HOMEPATH/.local/bin" >> $env:GITHUB_PATH
|
||||
```
|
||||
|
||||
@@ -367,7 +367,7 @@ steps:
|
||||
|
||||
#### Exemplo: Usando funções de verificação de status
|
||||
|
||||
A função `my backup step` (minha etapa de backup) somente é executada quando houver falha em uma etapa anterior do trabalho. Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions#job-status-check-functions)".
|
||||
A função `my backup step` (minha etapa de backup) somente é executada quando houver falha em uma etapa anterior do trabalho. Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions#status-check-functions)".
|
||||
|
||||
```yaml
|
||||
steps:
|
||||
|
||||
@@ -26,13 +26,14 @@ Após habilitar a licença {% data variables.product.prodname_github_connect %},
|
||||
|
||||
Após configurar a conexão entre {% data variables.product.product_location %} e {% data variables.product.prodname_ghe_cloud %}, você pode habilitar funcionalidades individuais de {% data variables.product.prodname_github_connect %} para a sua empresa.
|
||||
|
||||
| Funcionalidade | Descrição | Mais informações |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |{% ifversion ghes %}
|
||||
| Funcionalidade | Descrição | Mais informações |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |{% ifversion ghes %}
|
||||
| Sincronização automática da licença do usuário | Gerencie o uso da licença entre as suas implantações de {% data variables.product.prodname_enterprise %} sincronizando automaticamente as licenças de usuários de {% data variables.product.product_location %} para {% data variables.product.prodname_ghe_cloud %}. | "[Habilitando a sincronização automática de licença de usuário para sua empresa](/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise)"{% endif %}{% ifversion ghes or ghae-issue-4864 %}
|
||||
| {% data variables.product.prodname_dependabot %} | Permite aos usuários encontrar e corrigir vulnerabilidades nas dependências do código. | "[Habilitando {% data variables.product.prodname_dependabot %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)"{% endif %}
|
||||
| Ações de {% data variables.product.prodname_dotcom_the_website %} | Permitir que os usuários usem ações de {% data variables.product.prodname_dotcom_the_website %} em arquivos de fluxo de trabalho. | "[Habilitando o acesso automático a ações de {% data variables.product.prodname_dotcom_the_website %} usando {% data variables.product.prodname_github_connect %}](/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect)" |
|
||||
| Pesquisa unificada | Permitir que os usuários incluam repositórios em {% data variables.product.prodname_dotcom_the_website %} nos seus resultados de pesquisa ao pesquisar em {% data variables.product.product_location %}. | "[Habilitando {% data variables.product.prodname_unified_search %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" |
|
||||
| Contribuições unificadas | Permitir que os usuários incluam o número de contribuições anonimizadas pelo trabalho deles em {% data variables.product.product_location %} nos seus gráficos de contribuição em {% data variables.product.prodname_dotcom_the_website %}. | "[Habilitando {% data variables.product.prodname_unified_contributions %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-unified-contributions-for-your-enterprise)" |
|
||||
| Ações de {% data variables.product.prodname_dotcom_the_website %} | Permitir que os usuários usem ações de {% data variables.product.prodname_dotcom_the_website %} em arquivos de fluxo de trabalho. | "[Enabling automatic access to {% data variables.product.prodname_dotcom_the_website %} actions using {% data variables.product.prodname_github_connect %}](/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect)"{% if server-statistics %}
|
||||
| {% data variables.product.prodname_server_statistics %} | Analyze your own aggregate data from GitHub Enterprise Server, and help us improve GitHub products. | "[Enabling {% data variables.product.prodname_server_statistics %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)"{% endif %}
|
||||
| Pesquisa unificada | Permitir que os usuários incluam repositórios em {% data variables.product.prodname_dotcom_the_website %} nos seus resultados de pesquisa ao pesquisar em {% data variables.product.product_location %}. | "[Habilitando {% data variables.product.prodname_unified_search %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" |
|
||||
| Contribuições unificadas | Permitir que os usuários incluam o número de contribuições anonimizadas pelo trabalho deles em {% data variables.product.product_location %} nos seus gráficos de contribuição em {% data variables.product.prodname_dotcom_the_website %}. | "[Habilitando {% data variables.product.prodname_unified_contributions %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-unified-contributions-for-your-enterprise)" |
|
||||
|
||||
## Transmissão de dados para {% data variables.product.prodname_github_connect %}
|
||||
|
||||
@@ -61,14 +62,15 @@ Ao habilitar {% data variables.product.prodname_github_connect %} ou funcionalid
|
||||
|
||||
Os dados adicionais são transmitidos se você habilitar as funcionalidades individuais de {% data variables.product.prodname_github_connect %}.
|
||||
|
||||
| Funcionalidade | Dados | Para onde os dados são transmitidos? | Onde os dados são usados? |
|
||||
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |{% ifversion ghes %}
|
||||
| Sincronização automática da licença do usuário | O ID de usuário de cada {% data variables.product.product_name %} e endereço de e-mail | De {% data variables.product.product_name %} para {% data variables.product.prodname_ghe_cloud %} | {% data variables.product.prodname_ghe_cloud %} |{% endif %}{% ifversion ghes or ghae-issue-4864 %}
|
||||
| {% data variables.product.prodname_dependabot_alerts %} | Alertas de vulnerabilidade | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %} | {% data variables.product.product_name %} |{% endif %}{% if dependabot-updates-github-connect %}
|
||||
| {% data variables.product.prodname_dependabot_updates %} | As dependências e metadados para o repositório de cada dependência<br><br>Se uma dependência for armazenada em um repositório privado em {% data variables.product.prodname_dotcom_the_website %}, os dados só serão transmitidos se {% data variables.product.prodname_dependabot %} estiver configurado e autorizado para acessar esse repositório. | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %} | {% data variables.product.product_name %} {% endif %}
|
||||
| Ações de {% data variables.product.prodname_dotcom_the_website %} | Nome da ação, ação (arquivo YAML de {% data variables.product.prodname_marketplace %}) | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %}<br><br>De {% data variables.product.product_name %} para {% data variables.product.prodname_dotcom_the_website %} | {% data variables.product.product_name %}
|
||||
| Pesquisa unificada | Termos de pesquisa, resultados de pesquisa | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %}<br><br>De {% data variables.product.product_name %} para {% data variables.product.prodname_dotcom_the_website %} | {% data variables.product.product_name %}
|
||||
| Contribuições unificadas | Contagens de contribuição | De {% data variables.product.product_name %} paraa {% data variables.product.prodname_dotcom_the_website %} | {% data variables.product.prodname_dotcom_the_website %}
|
||||
| Funcionalidade | Dados | Para onde os dados são transmitidos? | Onde os dados são usados? |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |{% ifversion ghes %}
|
||||
| Sincronização automática da licença do usuário | O ID de usuário de cada {% data variables.product.product_name %} e endereço de e-mail | De {% data variables.product.product_name %} para {% data variables.product.prodname_ghe_cloud %} | {% data variables.product.prodname_ghe_cloud %} |{% endif %}{% ifversion ghes or ghae-issue-4864 %}
|
||||
| {% data variables.product.prodname_dependabot_alerts %} | Alertas de vulnerabilidade | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %} | {% data variables.product.product_name %} |{% endif %}{% if dependabot-updates-github-connect %}
|
||||
| {% data variables.product.prodname_dependabot_updates %} | As dependências e metadados para o repositório de cada dependência<br><br>Se uma dependência for armazenada em um repositório privado em {% data variables.product.prodname_dotcom_the_website %}, os dados só serão transmitidos se {% data variables.product.prodname_dependabot %} estiver configurado e autorizado para acessar esse repositório. | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %} | {% data variables.product.product_name %} {% endif %}
|
||||
| Ações de {% data variables.product.prodname_dotcom_the_website %} | Nome da ação, ação (arquivo YAML de {% data variables.product.prodname_marketplace %}) | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %}<br><br>De {% data variables.product.product_name %} para {% data variables.product.prodname_dotcom_the_website %} | {% data variables.product.product_name %}{% if server-statistics %}
|
||||
| {% data variables.product.prodname_server_statistics %} | Aggregate {% data variables.product.prodname_ghe_server %} usage metrics<br>For the list of aggregate metrics collected, see "[{% data variables.product.prodname_server_statistics %} data collected](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics#server-statistics-data-collected)." | De {% data variables.product.product_name %} para {% data variables.product.prodname_ghe_cloud %} | {% data variables.product.prodname_ghe_cloud %}{% endif %}
|
||||
| Pesquisa unificada | Termos de pesquisa, resultados de pesquisa | De {% data variables.product.prodname_dotcom_the_website %} para {% data variables.product.product_name %}<br><br>De {% data variables.product.product_name %} para {% data variables.product.prodname_dotcom_the_website %} | {% data variables.product.product_name %}
|
||||
| Contribuições unificadas | Contagens de contribuição | De {% data variables.product.product_name %} paraa {% data variables.product.prodname_dotcom_the_website %} | {% data variables.product.prodname_dotcom_the_website %}
|
||||
|
||||
## Leia mais
|
||||
|
||||
|
||||
@@ -22,7 +22,7 @@ shortTitle: Sincronização automática da licença do usuário
|
||||
|
||||
{% data reusables.enterprise-licensing.about-license-sync %} Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_github_connect %}de](/admin/configuration/configuring-github-connect/about-github-connect#data-transmission-for-github-connect)."
|
||||
|
||||
Se você habilitar a sincronização automática de licença de usuário para a sua empresa, {% data variables.product.prodname_github_connect %} irá automaticamente sincronizar o uso da licença entre {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_ghe_cloud %} semanalmente.
|
||||
If you enable automatic user license sync for your enterprise, {% data variables.product.prodname_github_connect %} will automatically synchronize license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly.{% ifversion ghes > 3.4 %} You can also synchronize your license data at any time outside of the automatic weekly sync, by manually triggering a license sync job. For more information, see "[Triggering a license sync job](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud#triggering-a-license-sync-job)."{% endif %}
|
||||
|
||||
Se você usar várias instâncias de {% data variables.product.prodname_ghe_server %}, você pode habilitar a sincronização automática de licença entre cada uma de suas instâncias e a mesma organização ou conta corporativa em {% data variables.product.prodname_ghe_cloud %}.
|
||||
|
||||
|
||||
@@ -43,7 +43,7 @@ Também é possível sincronizar os dados de vulnerabilidade manualmente a qualq
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** Ao habilitar {% data variables.product.prodname_dependabot_alerts %}, nenhum código ou informação sobre o código de {% data variables.product.product_location %} será enviado para {% data variables.product.prodname_dotcom_the_website %}.
|
||||
**Note:** When you enable {% data variables.product.prodname_dependabot_alerts %}, no code or information about code from {% data variables.product.product_location %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: Enabling Server Statistics for your enterprise
|
||||
intro: 'You can analyze your own aggregate data from {% data variables.product.prodname_ghe_server %} and help us improve {% data variables.product.company_short %} products by enabling {% data variables.product.prodname_server_statistics %}.'
|
||||
versions:
|
||||
feature: server-statistics
|
||||
redirect_from:
|
||||
- /early-access/github/analyze-how-your-team-works-with-server-statistics/about-server-statistics/enabling-server-statistics
|
||||
topics:
|
||||
- Enterprise
|
||||
shortTitle: Server Statistics
|
||||
---
|
||||
|
||||
{% data reusables.server-statistics.release-phase %}
|
||||
|
||||
## Sobre {% data variables.product.prodname_server_statistics %}
|
||||
|
||||
{% data variables.product.prodname_server_statistics %} collects aggregate usage data from {% data variables.product.product_location %}, which you can use to better anticipate the needs of your organization, understand how your team works, and show the value you get from {% data variables.product.prodname_ghe_server %}.
|
||||
|
||||
{% data variables.product.prodname_server_statistics %} only collects certain aggregate metrics on repositories, issues, pull requests, and other features.{% data variables.product.prodname_dotcom %} content, such as code, issues, comments, or pull request content, is not collected. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_server_statistics %}](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics)."
|
||||
|
||||
By enabling {% data variables.product.prodname_server_statistics %}, you are also helping to improve {% data variables.product.company_short %}. The aggregated data you will provide helps us understand how our customers are using {% data variables.product.prodname_dotcom %}, and make better and more informed product decisions, ultimately benefiting you.
|
||||
|
||||
## Habilitar o {% data variables.product.prodname_server_statistics %}
|
||||
|
||||
Before you can enable {% data variables.product.prodname_server_statistics %}, you must first connect your {% data variables.product.prodname_ghe_server %} instance to {% data variables.product.prodname_dotcom_the_website %} through {% data variables.product.prodname_github_connect %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise-server@3.1/admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/connecting-github-enterprise-server-to-github-enterprise-cloud)".
|
||||
|
||||
You can disable {% data variables.product.prodname_server_statistics %} from {% data variables.product.prodname_ghe_server %} at any time.
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.github-connect-tab %}
|
||||
4. Under "Share server statistics with GitHub.com", select the dropdown menu and click **Enabled** or **Disabled**. 
|
||||
@@ -21,6 +21,7 @@ children:
|
||||
- /managing-github-connect
|
||||
- /enabling-automatic-user-license-sync-for-your-enterprise
|
||||
- /enabling-dependabot-for-your-enterprise
|
||||
- /enabling-server-statistics-for-your-enterprise
|
||||
- /enabling-unified-search-for-your-enterprise
|
||||
- /enabling-unified-contributions-for-your-enterprise
|
||||
shortTitle: GitHub Connect
|
||||
|
||||
@@ -24,23 +24,25 @@ O isolamento de subdomínios reduz os problemas de script entre sites e outras v
|
||||
|
||||
Quando o isolamento do subdomínio está ativado, o {% data variables.product.prodname_ghe_server %} substitui vários caminhos pelos subdomínios. Depois de habilitar o isolamento de subdomínio, as tentativas de acessar os caminhos anteriores para alguns conteúdos fornecidos pelo usuário como `http(s)://HOSTNAME/raw/` podem retornar erros de `404`.
|
||||
|
||||
| Caminho sem isolamento de subdomínio | Caminho com isolamento de subdomínio |
|
||||
| -------------------------------------- | ----------------------------------------------------------- |
|
||||
| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% ifversion ghes %}
|
||||
| Caminho sem isolamento de subdomínio | Caminho com isolamento de subdomínio |
|
||||
| -------------------------------------- | -------------------------------------------------------------- |
|
||||
| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` |
|
||||
| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` |{% ifversion ghes %}
|
||||
| `https://HOSTNAME/_registry/docker/` | `http(s)://docker.HOSTNAME/`{% endif %}{% ifversion ghes %}
|
||||
| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` |
|
||||
| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` |
|
||||
| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` |
|
||||
| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %}
|
||||
| `https://HOSTNAME/_registry/npm/` | `https://npm.HOSTNAME/` |
|
||||
| `https://HOSTNAME/_registry/rubygems/` | `https://rubygems.HOSTNAME/` |
|
||||
| `https://HOSTNAME/_registry/maven/` | `https://maven.HOSTNAME/` |
|
||||
| `https://HOSTNAME/_registry/nuget/` | `https://nuget.HOSTNAME/`{% endif %}{% ifversion ghes > 3.4 %}
|
||||
| Not supported | `https://containers.HOSTNAME/`
|
||||
{% endif %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
|
||||
@@ -210,7 +210,7 @@ ghe-logs-tail
|
||||
|
||||
### ghe-maintenance
|
||||
|
||||
Este utilitário permite controlar o estado do modo de manutenção da instalação. Ele foi desenvolvido para uso principalmente nos bastidores do {% data variables.enterprise.management_console %}, mas também pode ser usado diretamente.
|
||||
Este utilitário permite controlar o estado do modo de manutenção da instalação. Ele foi desenvolvido para uso principalmente nos bastidores do {% data variables.enterprise.management_console %}, mas também pode ser usado diretamente. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/admin/guides/installation/enabling-and-scheduling-maintenance-mode)".
|
||||
|
||||
```shell
|
||||
ghe-maintenance -h
|
||||
|
||||
@@ -130,6 +130,10 @@ $ ghe-restore -c 169.154.1.1
|
||||
> Acesse https://169.154.1.1/setup/settings para revisar a configuração do appliance.
|
||||
```
|
||||
|
||||
{% if ip-exception-list %}
|
||||
Optionally, to validate the restore, configure an IP exception list to allow access to a specified list of IP addresses. For more information, see "[Validating changes in maintenance mode using the IP exception list](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)."
|
||||
{% endif %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** as configurações de rede são excluídas do instantâneo de backup. Você deve configurar manualmente a rede no appliance de destino do {% data variables.product.prodname_ghe_server %} conforme o seu ambiente.
|
||||
|
||||
@@ -26,10 +26,7 @@ Os proprietários das empresas podem configurar e-mails para notificações.
|
||||
## Configurar SMTP para sua empresa
|
||||
|
||||
{% ifversion ghes %}
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
2. Na parte superior da página, clique em **Settings** (Configurações). 
|
||||
3. Na barra lateral esquerda, clique em **Email**. 
|
||||
{% data reusables.enterprise_site_admin_settings.email-settings %}
|
||||
4. Selecione **Enable email** (Habilitar e-mail). Fazer isso vai habilitar os e-mails enviados (saída) e recebidos (entrada). No entanto, para que o recebimento de e-mails funcione, você terá que definir suas configurações de DNS conforme descrito em "[Configurar o DNS e o firewall para o recebimento de e-mails](#configuring-dns-and-firewall-settings-to-allow-incoming-emails)". 
|
||||
5. Digite as configurações para o seu servidor SMTP.
|
||||
- No campo **Server address** (Endereço do servidor), digite o endereço do seu servidor SMTP.
|
||||
@@ -38,9 +35,9 @@ Os proprietários das empresas podem configurar e-mails para notificações.
|
||||
- Selecione o menu suspenso **Autenticação** e escolha o tipo de criptografia usado pelo seu servidor SMTP.
|
||||
- No campo **No-reply email address** (Endereço de e-mail no-reply), digite o endereço de e-mail para usar nos campos De e Para em todos os e-mails de notificação.
|
||||
6. Se você quiser descartar todos os e-mails recebidos destinados ao endereço no-reply, selecione **Discard email addressed to the no-reply email address** (Descartar e-mails recebidos no endereço no-reply). 
|
||||
7. Em **Support** (Suporte), escolha um tipo de link para dar suporte adicional aos usuários.
|
||||
- **Email:** endereço de e-mail interno.
|
||||
- **URL:** link para um site interno de suporte. Você deve incluir `http://` ou `https://`. 
|
||||
7. Under **Support**, choose a type of link to offer additional support to your users.
|
||||
- **Email:** An internal email address.
|
||||
- **URL:** A link to an internal support site. Você deve incluir `http://` ou `https://`. 
|
||||
8. [Teste a entrega de e-mails](#testing-email-delivery).
|
||||
{% elsif ghae %}
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
@@ -89,7 +86,7 @@ Se quiser permitir o recebimento de respostas para os e-mails de notificação,
|
||||
|
||||
### Criar um pacote de suporte
|
||||
|
||||
Se não conseguir determinar o que houve de errado na mensagem de erro exibida, você pode baixar um [pacote de suporte](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support) com toda a conversa SMTP entre o seu servidor de e-mail e o {% data variables.product.prodname_ghe_server %}. Depois de fazer o download e extrair o pacote, verifique as entradas em *enterprise-manage-logs/unicorn.log* e veja o log completo de conversas SMTP com os erros relacionados.
|
||||
If you cannot determine what is wrong from the displayed error message, you can download a [support bundle](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support) containing the entire SMTP conversation between your mail server and {% data variables.product.prodname_ghe_server %}. Once you've downloaded and extracted the bundle, check the entries in *enterprise-manage-logs/unicorn.log* for the entire SMTP conversation log and any related errors.
|
||||
|
||||
O log unicorn mostrará uma transação semelhante a esta:
|
||||
|
||||
@@ -134,7 +131,7 @@ Esse log mostra que o appliance:
|
||||
|
||||
Se você tiver de verificar o funcionamento do dos e-mails de entrada, examine dois arquivos de log na sua instância: */var/log/mail.log* e */var/log/mail-replies/metroplex.log*.
|
||||
|
||||
*/var/log/mail.log* verifica se as mensagens estão chegando ao seu servidor. Veja um exemplo de resposta de e-mail com êxito:
|
||||
*/var/log/mail.log* verifies that messages are reaching your server. Veja um exemplo de resposta de e-mail com êxito:
|
||||
|
||||
```
|
||||
Oct 30 00:47:18 54-171-144-1 postfix/smtpd[13210]: conectado de st11p06mm-asmtp002.mac.com[17.172.124.250]
|
||||
@@ -148,7 +145,7 @@ Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: desconectado de st11p06mm-asm
|
||||
|
||||
Observe que o cliente se conecta e depois a fila fica ativa. Em seguida, a mensagem é entregue, o cliente é removido da fila e a sessão é desconectada.
|
||||
|
||||
*/var/log/mail-replies/metroplex.log* mostra se os e-mails de entrada estão sendo processados para adicionar problemas e pull requests como respostas. Veja um exemplo de mensagem com êxito:
|
||||
*/var/log/mail-replies/metroplex.log* shows whether inbound emails are being processed to add to issues and pull requests as replies. Veja um exemplo de mensagem com êxito:
|
||||
|
||||
```
|
||||
[2014-10-30T00:47:23.306 INFO (5284) #] metroplex: processing <b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
|
||||
@@ -164,7 +161,7 @@ Para processar corretamente os e-mails de entrada, você deve configurar um regi
|
||||
|
||||
### Verificar as configurações de firewall ou grupo de segurança do AWS
|
||||
|
||||
Se a {% data variables.product.product_location %} estiver atrás de um firewall ou estiver funcionando com um grupo de segurança do AWS, verifique se a porta 25 está aberta para todos os servidores de e-mail que enviam mensagens para `reply@reply.[hostname]`.
|
||||
If {% data variables.product.product_location %} is behind a firewall or is being served through an AWS Security Group, make sure port 25 is open to all mail servers that send emails to `reply@reply.[hostname]`.
|
||||
|
||||
### Entrar em contato com o suporte
|
||||
{% ifversion ghes %}
|
||||
|
||||
@@ -0,0 +1,76 @@
|
||||
---
|
||||
title: Configuring web commit signing
|
||||
shortTitle: Configure web commit signing
|
||||
intro: 'You can enable auto-signing of commits made in the web interface of {% data variables.product.product_name %}.'
|
||||
versions:
|
||||
ghes: '>=3.5'
|
||||
type: how_to
|
||||
topics:
|
||||
- Access management
|
||||
- Enterprise
|
||||
- Fundamentals
|
||||
- Identity
|
||||
- Security
|
||||
permissions: 'Site administrators can configure web commit signing for {% data variables.product.product_location %}.'
|
||||
---
|
||||
|
||||
## About web commit signing
|
||||
|
||||
If you enable web commit signing, {% data variables.product.product_name %} will automatically use GPG to sign commits users make on the web interface of {% data variables.product.product_location %}. Commits signed by {% data variables.product.product_name %} will have a verified status. Para obter mais informações, consulte "[Sobre verificação de assinatura commit](/authentication/managing-commit-signature-verification/about-commit-signature-verification)".
|
||||
|
||||
You can enable web commit signing, rotate the private key used for web commit signing, and disable web commit signing.
|
||||
|
||||
## Enabling web commit signing
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.create-pgp-key-web-commit-signing %}
|
||||
- If you have a no-reply email address defined in the {% data variables.enterprise.management_console %}, use that email address. If not, use any email address, such as `web-flow@my-company.com`. The email address does not need to be valid.
|
||||
{% data reusables.enterprise_site_admin_settings.pgp-key-no-passphrase %}
|
||||
{% data reusables.enterprise_site_admin_settings.pgp-key-env-variable %}
|
||||
{% data reusables.enterprise_site_admin_settings.update-commit-signing-service %}
|
||||
1. Enable web commit signing.
|
||||
|
||||
```bash{:copy}
|
||||
ghe-config app.github.web-commit-signing-enabled true
|
||||
```
|
||||
1. Apply the configuration, then wait for the configuration run to complete.
|
||||
|
||||
```bash{:copy}
|
||||
ghe-config-apply
|
||||
```
|
||||
1. Create a new user on {% data variables.product.product_location %} via built-in authentication or external authentication. Para obter mais informações, consulte "[Sobre a autenticação para sua empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)".
|
||||
- The user's username must be `web-flow`.
|
||||
- The user's email address must be the same address you used for the PGP key.
|
||||
{% data reusables.enterprise_site_admin_settings.add-key-to-web-flow-user %}
|
||||
{% data reusables.enterprise_site_admin_settings.email-settings %}
|
||||
1. Under "No-reply email address", type the same email address you used for the PGP key.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** The "No-reply email address" field will only be displayed if you've enabled email for {% data variables.product.product_location %}. Para obter mais informações, consulte "[Configurar e-mail para notificações](/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications#configuring-smtp-for-your-enterprise).
|
||||
|
||||
{% endnote %}
|
||||
{% data reusables.enterprise_management_console.save-settings %}
|
||||
|
||||
## Rotating the private key used for web commit signing
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.create-pgp-key-web-commit-signing %}
|
||||
- Use the no-reply email address defined in the {% data variables.enterprise.management_console %}, which should be the same as the email address of the `web-flow` user.
|
||||
{% data reusables.enterprise_site_admin_settings.pgp-key-no-passphrase %}
|
||||
{% data reusables.enterprise_site_admin_settings.pgp-key-env-variable %}
|
||||
{% data reusables.enterprise_site_admin_settings.update-commit-signing-service %}
|
||||
{% data reusables.enterprise_site_admin_settings.add-key-to-web-flow-user %}
|
||||
|
||||
## Disabling web commit signing
|
||||
|
||||
You can disable web commit signing for {% data variables.product.product_location %}.
|
||||
|
||||
1. In the administrative shell, run the following command.
|
||||
|
||||
```bash{:copy}
|
||||
ghe-config app.github.web-commit-signing-enabled false
|
||||
```
|
||||
1. Aplique a configuração.
|
||||
|
||||
```bash{:copy}
|
||||
ghe-config-apply
|
||||
```
|
||||
@@ -33,12 +33,20 @@ Alguns tipos de operações requerem que a {% data variables.product.product_loc
|
||||
|
||||
É recomendável programar um período de manutenção de no mínimo 30 minutos para que os usuários tenham tempo de se preparar. Quando houver um período de manutenção programado, todos os usuários verão um banner ao acessar o site.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Quando a instância estiver em modo de manutenção, todos os acessos regulares por HTTP e Git serão recusados. Operações de fetch, clonagem e push também são rejeitadas, e uma mensagem de erro indicará que o site está temporariamente indisponível. Em configurações de alta disponibilidade, a replicação do Git será pausada. Os trabalhos com GitHub Actions não serão executados. O acesso ao site por navegador levará a uma página de manutenção.
|
||||
|
||||
|
||||
|
||||
{% if ip-exception-list %}
|
||||
|
||||
You can perform initial validation of your maintenance operation by configuring an IP exception list to allow access to {% data variables.product.product_location %} from only the IP addresses and ranges provided. Attempts to access {% data variables.product.product_location %} from IP addresses not specified on the IP exception list will receive a response consistent with those sent when the instance is in maintenance mode.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Habilitar o modo de manutenção imediatamente ou programar um período de manutenção mais tarde
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
@@ -50,6 +58,23 @@ Quando a instância estiver em modo de manutenção, todos os acessos regulares
|
||||
4. Selecione **Enable maintenance mode** (Habilitar modo de manutenção). 
|
||||
{% data reusables.enterprise_management_console.save-settings %}
|
||||
|
||||
{% if ip-exception-list %}
|
||||
|
||||
## Validating changes in maintenance mode using the IP exception list
|
||||
|
||||
The IP exception list provides controlled and restricted access to {% data variables.product.product_location %}, which is ideal for initial validation of server health following a maintenance operation. Once enabled, {% data variables.product.product_location %} will be taken out of maintenance mode and available only to the configured IP addresses. The maintenance mode checkbox will be updated to reflect the change in state.
|
||||
|
||||
If you re-enable maintenance mode, the IP exception list will be disabled and {% data variables.product.product_location %} will return to maintenance mode. If you just disable the IP exception list, {% data variables.product.product_location %} will return to normal operation.
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
1. At the top of the {% data variables.enterprise.management_console %}, click **Maintenance**, and confirm maintenance mode is already enabled. 
|
||||
1. Select **Enable IP exception list**. 
|
||||
1. In the text box, type a valid list of space-separated IP addresses or CIDR blocks that should be allowed to access {% data variables.product.product_location %}. 
|
||||
1. Clique em **Salvar**. 
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Programar o modo de manutenção com a {% data variables.product.prodname_enterprise_api %}
|
||||
|
||||
Você pode programar o modo de manutenção para horas ou datas diferentes na {% data variables.product.prodname_enterprise_api %}. Para obter mais informações, consulte "[Console de gerenciamento](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#enable-or-disable-maintenance-mode)".
|
||||
|
||||
@@ -36,6 +36,7 @@ children:
|
||||
- /configuring-github-pages-for-your-enterprise
|
||||
- /configuring-the-referrer-policy-for-your-enterprise
|
||||
- /configuring-custom-footers
|
||||
- /configuring-web-commit-signing
|
||||
shortTitle: Configure sua empresa
|
||||
---
|
||||
|
||||
|
||||
@@ -193,7 +193,7 @@ You can see the number of active committers that are currently using seats for {
|
||||
|
||||
Under "Current active committer count", you can see the number of active committers for repositories with {% data variables.product.prodname_GH_advanced_security %} enabled. This is the number of licensed seats that are currently being used.
|
||||
|
||||
Under "Maximum committers across across entire instance", you can see the number of active committers across all the repositories in your enterprise. This is the number of seats that would be used if you enabled {% data variables.product.prodname_GH_advanced_security %} for every repository in your enterprise.
|
||||
Under "Maximum committers across entire instance", you can see the number of active committers across all the repositories in your enterprise. This is the number of seats that would be used if you enabled {% data variables.product.prodname_GH_advanced_security %} for every repository in your enterprise.
|
||||
|
||||
Under "Calculate Additional Advanced Committers", you can calculate how many more additional seats will be used if you enable {% data variables.product.prodname_GH_advanced_security %} for specific organizations and repositories. Under "Organizations and Repositories", enter or paste a list of organizations and repositories, with one organization or repository per line.
|
||||
|
||||
|
||||
@@ -16,6 +16,12 @@ shortTitle: Increase CPU or memory
|
||||
---
|
||||
{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Before increasing CPU or memory resources, put your instance in maintenance mode.{% if ip-exception-list %} You can validate changes by configuring an IP exception list to allow access from specified IP addresses. {% endif %} For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Adding CPU or memory resources for AWS
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -24,7 +24,7 @@ shortTitle: Aumentar capacidade de armazenamento
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** antes de redimensionar qualquer volume de armazenamento, coloque a sua instância em modo de manutenção. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)".
|
||||
**Note:** Before resizing any storage volume, put your instance in maintenance mode.{% if ip-exception-list %} You can validate changes by configuring an IP exception list to allow access from specified IP addresses. {% endif %} For more information, see "[Enabling and scheduling maintenance mode](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
||||
@@ -174,6 +174,9 @@ Mesmo que seja possível usar um hotpatch para fazer a atualização do patch em
|
||||
Target root partition: /dev/xvda2
|
||||
Proceed with installation? [y/N]
|
||||
```
|
||||
{% if ip-exception-list %}
|
||||
1. Optionally, to validate the upgrade, configure an IP exception list to allow access to a specified list of IP addresses. For more information, see "[Validating changes in maintenance mode using the IP exception list](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)."
|
||||
{% endif %}
|
||||
7. Em atualizações de appliance único, desabilite o modo de manutenção para os usuários poderem trabalhar com a {% data variables.product.product_location %}.
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Habilitar o GitHub Actions com armazenamento do Amazon S3
|
||||
intro: 'Você pode habilitar {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} e usar o armazenamento Amazon S3 para armazenar artefatos gerados por execuções de fluxo de trabalho.'
|
||||
intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Amazon S3 storage to store data generated by workflow runs.'
|
||||
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
@@ -21,7 +21,7 @@ shortTitle: Armazenamento do Amazon S3
|
||||
|
||||
Antes de habilitar {% data variables.product.prodname_actions %}, certifique-se de que você realizou os seguintes passos:
|
||||
|
||||
* Crie seu bucket do Amazon S3 para armazenar artefatos gerados pelas execuções do fluxo de trabalho. {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %}
|
||||
* Create your Amazon S3 bucket for storing data generated by workflow runs. {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %}
|
||||
|
||||
{% data reusables.actions.enterprise-common-prereqs %}
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Habilitar o o GitHub Actions com armazenamento do Azure Blob
|
||||
intro: 'Você pode habilitar {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} e usar o Azure Blob Storage para armazenar artefatos gerados por execuções do fluxo de trabalho.'
|
||||
intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Azure Blob storage to store data generated by workflow runs.'
|
||||
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
@@ -19,7 +19,7 @@ shortTitle: Armazenamento do Azure Blob
|
||||
|
||||
Antes de habilitar {% data variables.product.prodname_actions %}, certifique-se de que você realizou os seguintes passos:
|
||||
|
||||
* Crie sua conta de armazenamento do Azure para armazenar artefatos de fluxo de trabalho. {% data variables.product.prodname_actions %} armazena seus dados como blobs de bloco, e dois tipos de conta de armazenamento são compatíveis:
|
||||
* Create your Azure storage account for storing workflow data. {% data variables.product.prodname_actions %} armazena seus dados como blobs de bloco, e dois tipos de conta de armazenamento são compatíveis:
|
||||
* Uma conta de armazenamento para **propósitos gerais** (também conhecida como `propósito geral v1` ou `propósito geral v2`) que usa o nível de desempenho **padrão**.
|
||||
|
||||
{% warning %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Habilitar o GitHub Actions com MinIO Gateway para armazenamento NAS
|
||||
intro: 'Você pode habilitar {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %} e usar MinIO Gateway para armazenamento NAS para armazenar artefatos gerados por execuções de fluxo de trabalho.'
|
||||
intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO Gateway for NAS storage to store data generated by workflow runs.'
|
||||
permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
@@ -15,18 +15,14 @@ redirect_from:
|
||||
shortTitle: MinIO Gateway para armazenamento NAS
|
||||
---
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: MinIO has announced removal of MinIO Gateways. Starting June 1st, 2022, support and bug fixes for the current MinIO NAS Gateway implementation will only be available for paid customers via their LTS support contract. If you want to continue using MinIO Gateways with {% data variables.product.prodname_actions %}, we recommend moving to MinIO LTS support. For more information, see [Scheduled removal of MinIO Gateway for GCS, Azure, HDFS](https://github.com/minio/minio/issues/14331) in the minio/minio repository.
|
||||
|
||||
{% endwarning %}
|
||||
{% data reusables.actions.minio-gateways-removal %}
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
Antes de habilitar {% data variables.product.prodname_actions %}, certifique-se de que você realizou os seguintes passos:
|
||||
|
||||
* Para evitar contenção de recursos no dispositivo, recomendamos que o MinIO seja hospedado separadamente de {% data variables.product.product_location %}.
|
||||
* Crie seu bucket para armazenar artefatos de fluxo de trabalho. Para configurar seu bucket e chave de acesso, consulte a [Documentação do MinIO](https://docs.min.io/docs/minio-gateway-for-nas.html). {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %}
|
||||
* Create your bucket for storing workflow data. Para configurar seu bucket e chave de acesso, consulte a [Documentação do MinIO](https://docs.min.io/docs/minio-gateway-for-nas.html). {% indented_data_reference reusables.actions.enterprise-s3-permission spaces=2 %}
|
||||
|
||||
{% data reusables.actions.enterprise-common-prereqs %}
|
||||
|
||||
|
||||
@@ -39,7 +39,7 @@ Você pode criar suas próprias automações exclusivas ou você pode usar e ada
|
||||
|
||||
{% 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 %} 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. OIDC fornece benefícios de segurança, como eliminar a necessidade de armazenar credenciais como segredos de longa duração. 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 %} fornece maior controle sobre implantações. For example, you can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow, or limit access to secrets.{% ifversion ghec or ghae-issue-4856 or ghes > 3.4 %} If your workflows need to access resources from a cloud provider that supports OpenID Connect (OIDC), you can configure your workflows to authenticate directly to the cloud provider. OIDC fornece benefícios de segurança, como eliminar a necessidade de armazenar credenciais como segredos de longa duração. 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)".
|
||||
|
||||
|
||||
@@ -26,7 +26,7 @@ Este artigo explica como os administradores do site podem configurar {% data var
|
||||
|
||||
{% data reusables.enterprise.upgrade-ghes-for-actions %}
|
||||
|
||||
{% data reusables.actions.ghes-actions-not-enabled-by-default %} Você deberá determinar se a sua instância possui recursos adequados de CPU e memória para lidar com 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 %} Você deberá determinar se a sua instância possui recursos adequados de CPU e memória para lidar com a carga do {% data variables.product.prodname_actions %} sem causar perda de desempenho e possivelmente aumentar esses recursos. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts{% if actions-caching %} and caches{% endif %} generated by workflow runs. 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 %}
|
||||
|
||||
@@ -105,7 +105,7 @@ Opcionalmente, você pode limitar o consumo de recursos em {% data variables.pro
|
||||
|
||||
Para habilitar o {% data variables.product.prodname_actions %} em {% data variables.product.prodname_ghe_server %}, você deve ter acesso ao armazenamento externo do blob.
|
||||
|
||||
O {% data variables.product.prodname_actions %} usa armazenamento do blob para armazenar artefatos gerados pelas execuções do fluxo de trabalho, como registros de fluxo de trabalho e artefatos de criação enviados pelo usuário. A quantidade de armazenamento necessária depende do seu uso de {% data variables.product.prodname_actions %}. Somente uma única configuração de armazenamento externo é compatível, e você não pode usar vários provedores de armazenamento ao mesmo tempo.
|
||||
{% data variables.product.prodname_actions %} uses blob storage to store data generated by workflow runs, such as workflow logs{% if actions-caching %}, caches,{% endif %} and user-uploaded build artifacts. A quantidade de armazenamento necessária depende do seu uso de {% data variables.product.prodname_actions %}. Somente uma única configuração de armazenamento externo é compatível, e você não pode usar vários provedores de armazenamento ao mesmo tempo.
|
||||
|
||||
{% data variables.product.prodname_actions %} é compatível com estes provedores de armazenamento:
|
||||
|
||||
@@ -119,6 +119,8 @@ O {% data variables.product.prodname_actions %} usa armazenamento do blob para a
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.actions.minio-gateways-removal %}
|
||||
|
||||
Antes de habilitar o {% data variables.product.prodname_actions %}, você pode testar a sua configuração de armazenamento a partir do shell administrativo com o utilitário `ghe-actions-precheck`. Para obter mais informações, consulte "[Utilitários de linha de comando](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-actions-check)" e "[Acessando o shell administrativo (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)".
|
||||
|
||||
## Considerações de rede
|
||||
|
||||
@@ -111,20 +111,18 @@ Finalmente, você deve considerar o fortalecimento da segurança para os executo
|
||||
|
||||
{% data reusables.actions.about-artifacts %} Para obter mais informações, consulte "[Armazenar dados do fluxo de trabalho como artefatos](/actions/advanced-guides/storing-workflow-data-as-artifacts)".
|
||||
|
||||
|
||||
{% if actions-caching %}{% data variables.product.prodname_actions %} also has a caching system that you can use to cache dependencies to speed up workflow runs. For more information, see "[Caching dependencies to speed up workflows](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)."{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
Você deve configurar o armazenamento externo de blob para estes artefatos. Escolha qual provedor de armazenamento compatível a sua empresa irá usar. Para obter mais informações, consulte "[Primeiros passos com {% data variables.product.prodname_actions %} para {% data variables.product.product_name %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#external-storage-requirements)".
|
||||
You must configure external blob storage for workflow artifacts{% if actions-caching %}, caches,{% endif %} and other workflow logs. Escolha qual provedor de armazenamento compatível a sua empresa irá usar. Para obter mais informações, consulte "[Primeiros passos com {% data variables.product.prodname_actions %} para {% data variables.product.product_name %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#external-storage-requirements)".
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghec or ghes %}
|
||||
|
||||
{% data reusables.actions.artifact-log-retention-statement %}
|
||||
You can use policy settings for {% data variables.product.prodname_actions %} to customize the storage of workflow artifacts{% if actions-caching %}, caches,{% endif %} and log retention. 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)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
Se você quiser manter registros e artefatos maiores que o limite superior que você pode configurar em {% data variables.product.product_name %}, você terá que planejar como exportar e armazenar os dados.
|
||||
|
||||
{% ifversion ghec %}
|
||||
Um certo nível armazenamento está incluído na sua assinatura, mas o armazenamento adicional afetará o seu pagamento. Você deveria preparar-se para este custo. 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)."
|
||||
{% endif %}
|
||||
|
||||
@@ -16,6 +16,14 @@ topics:
|
||||
- SSO
|
||||
---
|
||||
|
||||
{% ifversion ghec %}
|
||||
{% note %}
|
||||
|
||||
**Note:** This article only applies to {% data variables.product.prodname_emus %}. If you use {% data variables.product.prodname_ghe_cloud %} without {% data variables.product.prodname_emus %}, usernames are created by users, not {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
## Sobre nomes de usuário com autenticação externa
|
||||
|
||||
{% ifversion ghes %}
|
||||
@@ -26,9 +34,9 @@ Ao usar a autenticação externa, {% data variables.product.product_location %}
|
||||
|
||||
{% elsif ghec %}
|
||||
|
||||
Se você usar uma empresa com {% data variables.product.prodname_emus %}, os integrantes da sua empresa irão efetuar a autenticação para acessar {% data variables.product.prodname_dotcom %} por meio do seu provedor de identidade (IdP) do SAML. Para obter mais informações, consulte "[Sobre a autenticação para sua empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#authentication-methods-for-github-enterprise-server)".
|
||||
Se você usar uma empresa com {% data variables.product.prodname_emus %}, os integrantes da sua empresa irão efetuar a autenticação para acessar {% data variables.product.prodname_dotcom %} por meio do seu provedor de identidade (IdP) do SAML. For more information, see "[About {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users)" and "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#authentication-methods-for-github-enterprise-server)."
|
||||
|
||||
{% data variables.product.product_name %} cria automaticamente um nome de usuário para cada pessoa quando esta efetua o login pelo seu IdP pela primeira vez.
|
||||
{% data variables.product.product_name %} automatically creates a username for each person when their user account is provisioned via SCIM, by normalizing an identifier provided by your IdP. If multiple identifiers are normalized into the same username, a username conflict occurs, and only the first user account is created. You can resolve username conflicts by making a change in your IdP so that the normalized usernames will be unique.
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
@@ -36,32 +44,63 @@ Se você usar uma empresa com {% data variables.product.prodname_emus %}, os int
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## About usernames for {% data variables.product.prodname_managed_users %}
|
||||
|
||||
When your {% data variables.product.prodname_emu_enterprise %} is created, you will choose a short code that will be used as the suffix for your enterprise members' usernames. {% data reusables.enterprise-accounts.emu-shortcode %} O usuário configurado que configurar o SAML SSO terá um nome de usuário no formato de **@<em>SHORT-CODE</em>_admin**.
|
||||
|
||||
Ao fornecer um novo usuário a partir do provedor de identidade, o novo {% data variables.product.prodname_managed_user %} terá um nome de usuário de {% data variables.product.prodname_dotcom %} no formato de **@<em>IDP-USERNAME</em>_<em>SHORT-CODE</em>**. The <em>IDP-USERNAME</em> component is formed by normalizing the SCIM `userName` attribute value sent from the IdP.
|
||||
|
||||
| Provedor de identidade | Nome de usuário de {% data variables.product.prodname_dotcom %}
|
||||
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Azure Active Directory (Azure AD) | _IDP-USERNAME_ is formed by normalizing the characters preceding the `@` character in the UPN (User Principal Name), which does not include the `#EXT#` for guest accounts. |
|
||||
| Okta | _IDP-USERNAME_ is the normalized username attribute provided by the IdP. |
|
||||
|
||||
These rules may result in your IdP providing the same _IDP-USERNAME_ for multiple users. For example, for Azure AD, the following UPNs will result in the same username:
|
||||
|
||||
- `bob@contoso.com`
|
||||
- `bob@fabrikam.com`
|
||||
- `bob#EXT#fabrikamcom@contoso.com`
|
||||
|
||||
This will cause a username conflict, and only the first user will be provisioned. For more information, see "[Resolving username conflicts](#resolving-username-conflicts)."
|
||||
{% endif %}
|
||||
|
||||
Usernames{% ifversion ghec %}, including underscore and short code,{% endif %} must not exceed 39 characters.
|
||||
|
||||
## Sobre a normalização de usuário
|
||||
|
||||
Os nomes de usuário para contas de usuário em {% ifversion ghes or ghae %}{% data variables.product.product_name %}{% elsif ghec %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} podem conter apenas caracteres alfanuméricos e traços (`-`).
|
||||
|
||||
{% ifversion ghec or ghes %}Ao configurar {% ifversion ghes %}autenticação de CAS, LDAP ou {% endif %}SAML, {% endif %}{% data variables.product.product_name %} usa um identificador da conta de usuário em seu provedor de autenticação externa {% ifversion ghes %}{% elsif ghec or ghae %}IdP{% endif %} para determinar o nome de usuário da conta de usuário correspondente em {% ifversion ghes or ghae %}{% data variables.product.product_name %}{% elsif ghec %}{% data variables.product.prodname_dotcom_the_website %}{% endif %}. Se o identificador da conta no seu provedor incluir caracteres não compatíveis, {% data variables.product.product_name %} normalizará o nome de usuário por cada regra a seguir.
|
||||
{% ifversion ghec %}
|
||||
When you configure SAML authentication, {% data variables.product.product_name %} uses the SCIM `userName` attribute value sent from the IdP to determine the username for the corresponding user account on {% data variables.product.prodname_dotcom_the_website %}. If this value includes unsupported characters, {% data variables.product.product_name %} will normalize the username per the following rules.
|
||||
{% elsif ghes %}
|
||||
When you configure CAS, LDAP, or SAML authentication, {% data variables.product.product_name %} uses an identifier from the user account on your external authentication provider to determine the username for the corresponding user account on {% data variables.product.product_name %}. If the identifier includes unsupported characters, {% data variables.product.product_name %} will normalize the username per the following rules.
|
||||
{% elsif ghae %}
|
||||
When you configure SAML authentication, {% data variables.product.product_name %} uses an identifier from the user account on your IdP to determine the username for the corresponding user account on {% data variables.product.product_name %}. If the identifier includes unsupported characters, {% data variables.product.product_name %} will normalize the username per the following rules.
|
||||
{% endif %}
|
||||
|
||||
1. {% data variables.product.product_name %} normalizará qualquer caractere não alfanumérico do nome de usuário da sua conta em um traço. Por exemplo, um nome de usuário de `mona.the.octocat` será normalizado para `mona-the-octocat`. Observe que nomes de usuários normalizados também não podem iniciar ou terminar com um traço. Eles também não podem conter dois traços consecutivos.
|
||||
|
||||
1. Nomes de usuário criados a partir de endereços de e-mail são criados a partir dos caracteres normalizados que precedem o caractere `@`.
|
||||
|
||||
1. Se várias contas forem normalizadas para o mesmo nome de usuário {% data variables.product.product_name %}, será criada apenas a primeira conta de usuário. Usuários subsequentes com o mesmo nome de usuário não serão capazes de fazer o login.
|
||||
1. Se várias contas forem normalizadas para o mesmo nome de usuário {% data variables.product.product_name %}, será criada apenas a primeira conta de usuário. Usuários subsequentes com o mesmo nome de usuário não serão capazes de fazer o login. {% ifversion ghec %}For more information, see "[Resolving username conflicts](#resolving-username-conflicts)."{% endif %}
|
||||
|
||||
### Exemplos de normalização de nome de usuário
|
||||
|
||||
| Identificador no provedor | Nome de usuário normalizado para {% data variables.product.product_location %} | Resultado |
|
||||
|:------------------------- |:------------------------------------------------------------------------------ |:--------------------------------------------------------------------------------------------------- |
|
||||
| The.Octocat | `the-octocat` | Nome de usuário criado com sucesso. |
|
||||
| !The.Octocat | `-the-octocat` | Este nome de usuário não é criado, porque começa com um traço. |
|
||||
| The.Octocat! | `the-octocat-` | Este nome de usuário não é criado, porque termina com um traço. |
|
||||
| The!!Octocat | `the--octocat` | Este nome de usuário não é criado, porque contém dois traços consecutivos. |
|
||||
| The!Octocat | `the-octocat` | Este nome de usuário não é criado. Embora o nome de usuário normalizado seja válido, ele já existe. |
|
||||
| The.Octocat@example.com | `the-octocat` | Este nome de usuário não é criado. Embora o nome de usuário normalizado seja válido, ele já existe. |
|
||||
| Identificador no provedor | Normalized username on {% data variables.product.prodname_dotcom %} | Resultado |
|
||||
|:------------------------------------------------------------- |:------------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------- |
|
||||
| The.Octocat | `the-octocat{% ifversion ghec %}_SHORT-CODE{% endif %}` | Nome de usuário criado com sucesso. |
|
||||
| !The.Octocat | `-the-octocat{% ifversion ghec %}_SHORT-CODE{% endif %}` | Este nome de usuário não é criado, porque começa com um traço. |
|
||||
| The.Octocat! | `the-octocat-{% ifversion ghec %}_SHORT-CODE{% endif %}` | Este nome de usuário não é criado, porque termina com um traço. |
|
||||
| The!!Octocat | `the--octocat{% ifversion ghec %}_SHORT-CODE{% endif %}` | Este nome de usuário não é criado, porque contém dois traços consecutivos. |
|
||||
| The!Octocat | `the-octocat{% ifversion ghec %}_SHORT-CODE{% endif %}` | Este nome de usuário não é criado. Embora o nome de usuário normalizado seja válido, ele já existe. |
|
||||
| `The.Octocat@example.com` | `the-octocat{% ifversion ghec %}_SHORT-CODE{% endif %}` | Este nome de usuário não é criado. Embora o nome de usuário normalizado seja válido, ele já existe. |
|
||||
| `mona.lisa.the.octocat.from.github.united.states@example.com` | `mona-lisa-the-octocat-from-github-united-states{% ifversion ghec %}_SHORT-CODE{% endif %}` | This username is not created, because it exceeds the 39-character limit. |
|
||||
|
||||
{% ifversion not ghec %}
|
||||
### Sobre a normalização de usuário com SAML
|
||||
|
||||
{% ifversion ghec or ghes %}Se você {% ifversion ghec %}usar uma empresa com {% data variables.product.prodname_emus %}, você deverá usar a autenticação do SAML. {% else %}A configuração da autenticação do SAML para {% data variables.product.product_location %}, {% endif %}{% endif %}{% data variables.product.product_name %} determina o nome de usuário de cada pessoa por uma das seguintes afirmações na resposta SAML, ordenada por prioridade.
|
||||
{% ifversion ghes %}If you configure SAML authentication for {% data variables.product.product_location %}, {% endif %}{% data variables.product.product_name %} determines each person's username by one of the following assertions in the SAML response, ordered by descending priority.
|
||||
|
||||
1. O atributo `de nome de usuário` personalizado, se definido e presente
|
||||
1. Declaração `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`, se houver;
|
||||
@@ -70,12 +109,49 @@ Os nomes de usuário para contas de usuário em {% ifversion ghes or ghae %}{% d
|
||||
|
||||
{% data variables.product.product_name %} exige o elemento `NameID` mesmo que outros atributos estejam presentes. Para obter mais informações, consulte "[Referência de configuração do SAML](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference#saml-attributes)".
|
||||
|
||||
{% data variables.product.product_name %} cria um mapeamento entre `NameID` do IdP e o nome de usuário {% ifversion ghec or ghae %}em{% elsif ghes %}em{% endif %} {% data variables.product.product_location %}. Portanto, o `NameID` deve ser persistente, único e não sujeito a alterações para o ciclo de vida do usuário.
|
||||
{% data variables.product.product_name %} cria um mapeamento entre `NameID` do IdP e o nome de usuário {% ifversion ghae %}em{% else %}em{% endif %} {% data variables.product.product_location %}. Portanto, o `NameID` deve ser persistente, único e não sujeito a alterações para o ciclo de vida do usuário.
|
||||
|
||||
{% ifversion ghes %}
|
||||
{% note %}
|
||||
|
||||
**Observação**: Se `NameID` para um usuário for alterado no IdP, a pessoa verá uma mensagem de erro ao {% ifversion ghec %}efetuar a autenticação através do seu IdP para acessar seus recursos ao{% else %}efetuar o login em{% endif} {% data variables.product.product_location %}. Para restaurar o acesso da pessoa, você deverá atualizar o mapeamento de `NameID` da conta do usuário. Para obter mais informações, consulte "[Atualizando `NameID`](/admin/identity-and-access-management/using-saml-for-enterprise-iam/updating-a-users-saml-nameid) do SAML de um usuário."
|
||||
**Note**: If the `NameID` for a user does change on the IdP, the person will see an error message when signing into {% data variables.product.product_location %}. Para restaurar o acesso da pessoa, você deverá atualizar o mapeamento de `NameID` da conta do usuário. Para obter mais informações, consulte "[Atualizando `NameID`](/admin/identity-and-access-management/using-saml-for-enterprise-iam/updating-a-users-saml-nameid) do SAML de um usuário."
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Resolving username conflicts
|
||||
|
||||
When a new user is being provisioned, if the user's normalized username conflicts with an existing user in the enterprise, the provisioning attempt will fail with a `409` error.
|
||||
|
||||
To resolve this problem, you must make a change in your IdP so that the normalized usernames will be unique. If you cannot change the identifier that's being normalized, you can change the attribute mapping for the `userName` attribute. If you change the attribute mapping, usernames of existing {% data variables.product.prodname_managed_users %} will be updated, but nothing else about the accounts will change, including activity history.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** {% data variables.contact.github_support %} cannot provide assistance with customizing attribute mappings or configuring custom expressions. You can contact your IdP with any questions.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Resolving username conflicts with Azure AD
|
||||
|
||||
To resolve username conflicts in Azure AD, either modify the User Principal Name value for the conflicting user or modify the attribute mapping for the `userName` attribute. If you modify the attribute mapping, you can choose an existing attribute or use an expression to ensure that all provisioned users have a unique normalized alias.
|
||||
|
||||
1. In Azure AD, open the {% data variables.product.prodname_emu_idp_application %} application.
|
||||
1. In the left sidebar, click **Provisioning**.
|
||||
1. Click **Edit Provisioning**.
|
||||
1. Expand **Mappings**, then click **Provision Azure Active Directory Users**.
|
||||
1. Click the {% data variables.product.prodname_dotcom %} `userName` attribute mapping.
|
||||
1. Change the attribute mapping.
|
||||
- To map an existing attribute in Azure AD to the `userName` attribute in {% data variables.product.prodname_dotcom %}, click your desired attribute field. Then, save and wait for a provisioning cycle to occur within about 40 minutes.
|
||||
- To use an expression instead of an existing attribute, change the Mapping type to "Expression", then add a custom expression that will make this value unique for all users. For example, you could use `[FIRST NAME]-[LAST NAME]-[EMPLOYEE ID]`. For more information, see [Reference for writing expressions for attribute mappings in Azure Active Directory](https://docs.microsoft.com/en-us/azure/active-directory/app-provisioning/functions-for-customizing-application-data) in Microsoft Docs.
|
||||
|
||||
### Resolving username conflicts with Okta
|
||||
|
||||
To resolve username conflicts in Okta, update the attribute mapping settings for the {% data variables.product.prodname_emu_idp_application %} application.
|
||||
|
||||
1. In Okta, open the {% data variables.product.prodname_emu_idp_application %} application.
|
||||
1. Clique em **Iniciar sessão em**.
|
||||
1. In the "Settings" section, click **Edit**.
|
||||
1. Update the "Application username format."
|
||||
{% endif %}
|
||||
|
||||
@@ -56,6 +56,7 @@ O {% data variables.product.prodname_managed_users_caps %} só pode contribuir p
|
||||
* Outros usuários de {% data variables.product.prodname_dotcom %} não podem ver, mencionar ou convidar um {% data variables.product.prodname_managed_user %} para colaborar.
|
||||
* {% data variables.product.prodname_managed_users_caps %} só pode criar repositórios privados e {% data variables.product.prodname_managed_users %} só pode convidar outros integrantes da empresa para colaborar nos seus próprios repositórios.
|
||||
* Apenas repositórios privados e internos podem ser criados em organizações pertencentes a um {% data variables.product.prodname_emu_enterprise %}, dependendo das configurações de visibilidade da organização e do repositório corporativo.
|
||||
* {% data variables.product.prodname_managed_users_caps %} are limited in their use of {% data variables.product.prodname_pages %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_pages %}](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)".
|
||||
|
||||
## Sobre empresas com usuários gerenciados
|
||||
|
||||
@@ -87,17 +88,8 @@ O nome do usuário de configuração é o código curto da sua empresa com o suf
|
||||
|
||||
## Nome de usuário e informações de perfil
|
||||
|
||||
Quando o seu {% data variables.product.prodname_emu_enterprise %} for criado, você escolherá um código curto que será usado como sufixo para os nomes de usuários da sua empresa. {% data reusables.enterprise-accounts.emu-shortcode %} O usuário configurado que configurar o SAML SSO terá um nome de usuário no formato de **@<em>SHORT-CODE</em>_admin**.
|
||||
{% data variables.product.product_name %} automatically creates a username for each person by normalizing an identifier provided by your IdP. Para obter mais informações, consulte "[Considerações de nome de usuário para autenticação externa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)".
|
||||
|
||||
Ao fornecer um novo usuário a partir do provedor de identidade, o novo {% data variables.product.prodname_managed_user %} terá um nome de usuário de {% data variables.product.prodname_dotcom %} no formato de **@<em>IDP-USERNAME</em>_<em>SHORT-CODE</em>**.
|
||||
|
||||
| Provedor de identidade | Nome de usuário de {% data variables.product.prodname_dotcom %}
|
||||
| --------------------------------- | --------------------------------------------------------------- |
|
||||
| Azure Active Directory (Azure AD) | <ul><li>_IDP-USERNAME_ é formado por normalizar os caracteres anteriores ao caractere `@` no UPN (Nome Principal do Usuário).</li><li>Contas convidadas terão `#EXT` removidos do UPN.</li></ul> |
|
||||
| Okta | <ul><li>_IDP-USERNAME_ é o atributo de nome de usuário normalizado fornecido pelo IdP.</li></ul> |
|
||||
|
||||
É possível que ocorra um conflito quando os usuários são provisionados se as partes exclusivas do nome de usuário fornecido pelo IdP forem removidas quando for normalizado. Se você não puder provisionar um usuário devido a um conflito de nome de usuário, você deverá modificar o nome de usuário fornecido pelo seu IdP.
|
||||
|
||||
O nome de usuário da nova conta provisionada em {% data variables.product.prodname_dotcom %}, incluindo sublinhado e código curto, não deverá exceder 39 caracteres.
|
||||
A conflict may occur when provisioning users if the unique parts of the identifier provided by your IdP are removed during normalization. If you're unable to provision a user due to a username conflict, you should modify the username provided by your IdP. For more information, see "[Resolving username conflicts](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication#resolving-username-conflicts)."
|
||||
|
||||
O nome do perfil e endereço de email de um {% data variables.product.prodname_managed_user %} também é fornecido pelo IdP. {% data variables.product.prodname_managed_users_caps %} não pode alterar seu nome de perfil ou endereço de e-mail em {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: About Server Statistics
|
||||
intro: 'You can use {% data variables.product.prodname_server_statistics %} to analyze your own aggregate data from {% data variables.product.prodname_ghe_server %}, and help us improve {% data variables.product.company_short %} products.'
|
||||
versions:
|
||||
feature: server-statistics
|
||||
permissions: 'Enterprise owners can enable {% data variables.product.prodname_server_statistics %}.'
|
||||
redirect_from:
|
||||
- /early-access/github/analyze-how-your-team-works-with-server-statistics/about-server-statistics
|
||||
topics:
|
||||
- Enterprise
|
||||
---
|
||||
|
||||
{% data reusables.server-statistics.release-phase %}
|
||||
|
||||
## About the benefits of {% data variables.product.prodname_server_statistics %}
|
||||
|
||||
{% data variables.product.prodname_server_statistics %} can help you anticipate the needs of your organization, understand how your team works, and show the value you get from {% data variables.product.prodname_ghe_server %}.
|
||||
|
||||
Once enabled, {% data variables.product.prodname_server_statistics %} collects aggregate data on how much certain features are used on your instance over time. Unlike other [Admin Stats API](/rest/reference/enterprise-admin#admin-stats) endpoints, which only return data for the last day, {% data variables.product.prodname_server_statistics %} provides historical data of all {% data variables.product.prodname_server_statistics %} metrics collected since the day you enabled the feature. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_server_statistics %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)."
|
||||
|
||||
When you enable {% data variables.product.prodname_server_statistics %}, you're helping to build a better {% data variables.product.prodname_dotcom %}. The aggregated data you'll provide gives us insights into how {% data variables.product.prodname_dotcom %} adds value to our customers. This information allows {% data variables.product.company_short %} to make better and more informed product decisions, ultimately benefiting you.
|
||||
|
||||
## About data security
|
||||
|
||||
We respect your data. We will never transmit data from {% data variables.product.product_location %} unless you have first given us permission to do so.
|
||||
|
||||
We collect no personal data. We also don't collect any {% data variables.product.company_short %} content, such as code, issues, comments, or pull request content.
|
||||
|
||||
Only owners of the connected enterprise account or organization on {% data variables.product.prodname_ghe_cloud %} can access the data.
|
||||
|
||||
Only certain aggregate metrics are collected on repositories, issues, pull requests, and other features. To see the list of aggregate metrics collected, see "[{% data variables.product.prodname_server_statistics %} data collected](#server-statistics-data-collected)."
|
||||
|
||||
Any updates to the collected metrics will happen in future feature releases of {% data variables.product.prodname_ghe_server %} and will be described in the [{% data variables.product.prodname_ghe_server %} release notes](/admin/release-notes). In addition, we will update this article with all metric updates.
|
||||
|
||||
For a better understanding of how we store and secure {% data variables.product.prodname_server_statistics %} data, see "[GitHub Security](https://github.com/security)."
|
||||
|
||||
### About data retention and deletion
|
||||
|
||||
{% data variables.product.company_short %} collects {% data variables.product.prodname_server_statistics %} data for as long as your {% data variables.product.prodname_ghe_server %} license is active and the {% data variables.product.prodname_server_statistics %} feature is enabled.
|
||||
|
||||
If you would like to delete your data, you may do so by contacting GitHub Support, your {% data variables.product.prodname_dotcom %} account representative, or your Customer Success Manager. Generally, we delete data in the timeframe specified in our privacy statement. For more information, see [{% data variables.product.company_short %}'s privacy statement](/free-pro-team@latest/site-policy/privacy-policies/github-privacy-statement#data-retention-and-deletion-of-data) in the {% data variables.product.prodname_dotcom_the_website %} documentation.
|
||||
|
||||
### About data portability
|
||||
|
||||
As an organization owner or enterprise owner on {% data variables.product.prodname_ghe_cloud %}, you can access {% data variables.product.prodname_server_statistics %} data by exporting the data in a CSV or JSON file or through the {% data variables.product.prodname_server_statistics %} REST API. For more information, see "[Requesting {% data variables.product.prodname_server_statistics %} using the REST API](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api)" or "[Exporting {% data variables.product.prodname_server_statistics %}](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/exporting-server-statistics)."
|
||||
|
||||
## About disabling data collection
|
||||
|
||||
You can disable the {% data variables.product.prodname_server_statistics %} feature at any time. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_server_statistics %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)."
|
||||
|
||||
## {% data variables.product.prodname_server_statistics %} data collected
|
||||
|
||||
After you enable {% data variables.product.prodname_server_statistics %}, metrics are collected through a daily job that runs on {% data variables.product.product_location %}. The aggregate metrics are stored on your organization or enterprise account on {% data variables.product.prodname_ghe_cloud %} and are not stored on {% data variables.product.product_location %}.
|
||||
|
||||
The following aggregate metrics will be collected and transmitted on a daily basis and represent the total counts for the day:
|
||||
- `active_hooks`
|
||||
- `admin_users`
|
||||
- `closed_issues`
|
||||
- `closed_milestones`
|
||||
- `collection_date`
|
||||
- `disabled_orgs`
|
||||
- `dormancy_threshold`
|
||||
- `fork_repos`
|
||||
- `ghes_version`
|
||||
- `github_connect_features_enabled`
|
||||
- `inactive_hooks`
|
||||
- `mergeable_pulls`
|
||||
- `merged_pulls`
|
||||
- `open_issues`
|
||||
- `open_milestones`
|
||||
- `org_repos`
|
||||
- `private_gists`
|
||||
- `public_gists`
|
||||
- `root_repos`
|
||||
- `schema_version`
|
||||
- `server_id`
|
||||
- `suspended_users`
|
||||
- `total_commit_comments`
|
||||
- `total_dormant_users`
|
||||
- `total_gist_comments`
|
||||
- `total_gists`
|
||||
- `total_hooks`
|
||||
- `total_issues`
|
||||
- `total_issue_comments`
|
||||
- `total_milestones`
|
||||
- `total_repos`
|
||||
- `total_orgs`
|
||||
- `total_pages`
|
||||
- `total_pull_request_comments`
|
||||
- `total_pulls`
|
||||
- `total_pushes`
|
||||
- `total_team_members`
|
||||
- `total_teams`
|
||||
- `total_users`
|
||||
- `total_wikis`
|
||||
- `unmergeable_pulls`
|
||||
|
||||
## {% data variables.product.prodname_server_statistics %} payload example
|
||||
|
||||
To see an example of the response payload for the {% data variables.product.prodname_server_statistics %} API, see "[Requesting {% data variables.product.prodname_server_statistics %} using the REST API](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api)."
|
||||
|
||||
To see a list of the data collected, see "[{% data variables.product.prodname_server_statistics %} data collected](#server-statistics-data-collected)."
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: Exporting Server Statistics
|
||||
shortTitle: Export Server Statistics
|
||||
intro: 'You can use your own tools to analyze your {% data variables.product.prodname_ghe_server %} usage over time by downloading your {% data variables.product.prodname_server_statistics %} metrics in a CSV or JSON file.'
|
||||
versions:
|
||||
feature: server-statistics
|
||||
redirect_from:
|
||||
- /early-access/github/analyze-how-your-team-works-with-server-statistics/exploring-server-statistics
|
||||
---
|
||||
|
||||
{% data reusables.server-statistics.release-phase %}
|
||||
|
||||
You can download up to the last 365 days of {% data variables.product.prodname_server_statistics %} data in a CSV or JSON file. This data, which includes aggregate metrics on repositories, issues, and pull requests, can help you anticipate the needs of your organization, understand how your team works, and show the value you get from {% data variables.product.prodname_ghe_server %}.
|
||||
|
||||
Before you can download this data, you must enable {% data variables.product.prodname_server_statistics %}. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_server_statistics %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)."
|
||||
|
||||
To preview the metrics available to download, see "[About {% data variables.product.prodname_server_statistics %}](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics)."
|
||||
|
||||
To download these metrics, you must be an enterprise owner or organization owner on {% data variables.product.prodname_ghe_cloud %}.
|
||||
- If {% data variables.product.product_location %} is connected to an enterprise account on {% data variables.product.prodname_ghe_cloud %}, see "[Downloading metrics from your enterprise account](#downloading-metrics-from-your-enterprise-account)."
|
||||
- If {% data variables.product.product_location %} is connected to an organization on {% data variables.product.prodname_ghe_cloud %}, see "[Downloading metrics from your organization](#downloading-metrics-from-your-organization)."
|
||||
|
||||
Para saber mais sobre {% data variables.product.prodname_github_connect %}, consulte "[Sobre {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/about-github-connect)."
|
||||
|
||||
## Downloading metrics from your enterprise account
|
||||
|
||||
1. No canto superior direito de {% data variables.product.prodname_ghe_cloud %}, clique na sua foto de perfil e, em seguida, clique em **Suas empresas**. 
|
||||
|
||||
2. Next to your desired enterprise account, click **Settings**. 
|
||||
|
||||
3. On the left, click **GitHub Connect**. 
|
||||
|
||||
{% data reusables.server-statistics.csv-download %}
|
||||
|
||||
## Downloading metrics from your organization
|
||||
|
||||
1. In the top-right corner of {% data variables.product.prodname_ghe_cloud %}, click your profile photo, then click **Your organizations**. 
|
||||
|
||||
2. In the list of organizations, next to the organization that's connected to {% data variables.product.product_location %}, click **Settings**. 
|
||||
|
||||
3. On the left, click **GitHub Connect**. 
|
||||
|
||||
{% data reusables.server-statistics.csv-download %}
|
||||
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: Analyzing how your team works with Server Statistics
|
||||
shortTitle: Server Statistics
|
||||
intro: 'To analyze how your team works, understand the value you get from {% data variables.product.prodname_ghe_server %}, and help us improve our products, you can use {% data variables.product.prodname_server_statistics %} to review your usage data for {% data variables.product.prodname_ghe_server %} and share this aggregate data with {% data variables.product.company_short %}.'
|
||||
versions:
|
||||
feature: server-statistics
|
||||
children:
|
||||
- /about-server-statistics
|
||||
- /exporting-server-statistics
|
||||
- /requesting-server-statistics-using-the-rest-api
|
||||
---
|
||||
|
||||
@@ -0,0 +1,17 @@
|
||||
---
|
||||
title: Requesting Server Statistics using the REST API
|
||||
shortTitle: Server Statistics and REST API
|
||||
intro: 'You can use your own tools to analyze your {% data variables.product.prodname_ghe_server %} usage over time by requesting the {% data variables.product.prodname_server_statistics %} metrics collected using the REST API.'
|
||||
versions:
|
||||
feature: server-statistics
|
||||
redirect_from:
|
||||
- /early-access/github/analyze-how-your-team-works-with-server-statistics/requesting-server-statistics-using-the-rest-api
|
||||
---
|
||||
|
||||
{% data reusables.server-statistics.release-phase %}
|
||||
|
||||
You can request up to 365 days of metrics in a single {% data variables.product.prodname_server_statistics %} REST API request. This data, which includes aggregate metrics on repositories, issues, and pull requests, can help you anticipate the needs of your organization, understand how your team works, and show the value you get from {% data variables.product.prodname_ghe_server %}. For a list of the metrics collected, see "[{% data variables.product.prodname_server_statistics %} data collected](/admin/monitoring-activity-in-your-enterprise/analyzing-how-your-team-works-with-server-statistics/about-server-statistics#server-statistics-data-collected)."
|
||||
|
||||
Before you can use the {% data variables.product.prodname_server_statistics %} REST API, you must enable {% data variables.product.prodname_server_statistics %}. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_server_statistics %} para a sua empresa](/admin/configuration/configuring-github-connect/enabling-server-statistics-for-your-enterprise)."
|
||||
|
||||
For more information about using the REST API to request server statistics, see "[Get {% data variables.product.prodname_ghe_server %} statistics](/enterprise-cloud@latest/rest/enterprise-admin/admin-stats#get-github-enterprise-server-statistics)" in the {% data variables.product.prodname_ghe_cloud %} REST API documentation.
|
||||
@@ -12,6 +12,7 @@ topics:
|
||||
children:
|
||||
- /reviewing-audit-logs-for-your-enterprise
|
||||
- /exploring-user-activity
|
||||
- /analyzing-how-your-team-works-with-server-statistics
|
||||
shortTitle: Monitorar atividade
|
||||
---
|
||||
|
||||
|
||||
@@ -1050,7 +1050,7 @@ topics:
|
||||
| `restrict_notification_delivery.disable` | Email notification restrictions for an organization or enterprise were disabled. For more information, see "[Restricting email notifications for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization)" and "[Restricting email notifications for your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise)." |
|
||||
{%- endif %}
|
||||
|
||||
{%- ifversion ghec or ghes > 3.4 or ghae-issue-6271 %}
|
||||
{%- if custom-repository-roles %}
|
||||
### ações da categoria `função`
|
||||
|
||||
| Ação | Descrição |
|
||||
|
||||
@@ -22,6 +22,11 @@ Uma conta corporativa está incluída em {% data variables.product.prodname_ghe_
|
||||
|
||||
Ao criar uma conta corporativa, a organização existente será automaticamente propriedade da conta corporativa. Todos os proprietários atuais da sua organização irão tornar-se proprietários da conta corporativa. Todos os gerentes de cobrança atuais da organização irão tornar-se gerentes de cobrança da nova conta corporativa. Os detalhes de cobrança atuais da organização, incluindo o endereço de e-mail de cobrança da organização, irão tornar-se detalhes de cobrança da conta corporativa.
|
||||
|
||||
If the organization is connected to {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %} via {% data variables.product.prodname_github_connect %}, upgrading the organization to an enterprise account **will not** update the connection. If you want to connect to the new enterprise account, you must disable and re-enable {% data variables.product.prodname_github_connect %}.
|
||||
|
||||
- "[Managing {% data variables.product.prodname_github_connect %}](/enterprise-server@latest/admin/configuration/configuring-github-connect/managing-github-connect)" in the {% data variables.product.prodname_ghe_server %} documentation
|
||||
- "[Managing {% data variables.product.prodname_github_connect %}](/github-ae@latest/admin/configuration/configuring-github-connect/managing-github-connect)" in the {% data variables.product.prodname_ghe_managed %} documentation
|
||||
|
||||
## Criando uma conta corporativa em {% data variables.product.prodname_dotcom %}
|
||||
|
||||
Para criar uma conta corporativa em {% data variables.product.prodname_dotcom %}, a sua organização deve usar {% data variables.product.prodname_ghe_cloud %} e pagar por fatura.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Configurar o suporte ao ecossistema de pacote para sua empresa
|
||||
intro: 'Você pode configurar {% data variables.product.prodname_registry %} para a sua empresa habilitando ou desabilitando globalmente os ecossistemas de pacotes individuais na sua empresa, incluindo Docker, RubyGems, npm, Apache Maven, Gradle ou NuGet. Conheça outros requisitos de configuração para dar suporte aos ecossistemas de pacote específicos.'
|
||||
intro: 'You can configure {% data variables.product.prodname_registry %} for your enterprise by globally enabling or disabling individual package ecosystems on your enterprise, including {% ifversion ghes > 3.4 %}{% data variables.product.prodname_container_registry %}, {% endif %}Docker, and npm. Conheça outros requisitos de configuração para dar suporte aos ecossistemas de pacote específicos.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/packages/configuring-packages-support-for-your-enterprise
|
||||
- /admin/packages/configuring-packages-support-for-your-enterprise
|
||||
@@ -23,7 +23,10 @@ Para evitar que novos pacotes sejam carregados, você pode definir um ecossistem
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_site_admin_settings.packages-tab %}
|
||||
1. Em "Alternância de ecossistema", para cada tipo de pacote, selecione **habilitado**, **somente leitura** ou **Desabilitado**.
|
||||
{% ifversion ghes > 3.1 %}
|
||||
{%- ifversion ghes > 3.4 %}{% note -%}
|
||||
**Note**: Subdomain isolation must be enabled to toggle the
|
||||
{% data variables.product.prodname_container_registry %} options.
|
||||
{%- endnote %}{%- endif %}{%- ifversion ghes > 3.1 %}
|
||||
{% else %}
|
||||
{% endif %}
|
||||
{% data reusables.enterprise_management_console.save-settings %}
|
||||
|
||||
@@ -37,10 +37,10 @@ Para habilitar {% data variables.product.prodname_registry %} e configurar o arm
|
||||
|
||||
## Etapa 3: Especifique os ecossistemas de pacote que serão compatíveis com a sua instância
|
||||
|
||||
Escolha quais ecossistemas de pacote você gostaria de habilitar, desabilitar ou definir como somente leitura no seu {% data variables.product.product_location %}. As opções disponíveis são Docker, RubyGems, npm, Apache Maven, Gradle ou NuGet. Para obter mais informações, consulte "[Configurar a compatibilidade com o ecossistema de pacote para a sua empresa](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)".
|
||||
Escolha quais ecossistemas de pacote você gostaria de habilitar, desabilitar ou definir como somente leitura no seu {% data variables.product.product_location %}. Available options are {% ifversion ghes > 3.4 %}{% data variables.product.prodname_container_registry %}, {% endif %}Docker, RubyGems, npm, Apache Maven, Gradle, or NuGet. Para obter mais informações, consulte "[Configurar a compatibilidade com o ecossistema de pacote para a sua empresa](/enterprise/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)".
|
||||
|
||||
## Etapa 4: Certifique-se de ter um certificado TLS para a URL do seu pacote de hospedagem, se necessário
|
||||
|
||||
Se o isolamento de subdomínio estiver habilitado para {% data variables.product.product_location %}, você deverá criar e fazer upload de um certificado TLS que permite a URL de host do pacote para cada ecossistema que você deseja usar, como `npm.HOSTNAME`. Certifique-se de que o host de cada pacote contém `https://`.
|
||||
If subdomain isolation is enabled for {% data variables.product.product_location %}, you will need to create and upload a TLS certificate that allows the package host URL for each ecosystem you want to use, such as `{% data reusables.package_registry.container-registry-hostname %}`. Certifique-se de que o host de cada pacote contém `https://`.
|
||||
|
||||
Você pode criar o certificado manualmente ou pode usar _Let's Encrypt_. Se você já usa _Let's Encrypt_, você deverá solicitar um novo certificado TLS depois de habilitar {% data variables.product.prodname_registry %}. Para obter mais informações sobre as URLs de host do pacote, consulte "[Habilitar o isolamento de subdomínio](/enterprise/admin/configuration/enabling-subdomain-isolation)". Para obter mais informações sobre o upload de certificados TLS para {% data variables.product.product_name %}, consulte "[Configurar TLS](/enterprise/admin/configuration/configuring-tls)".
|
||||
|
||||
@@ -29,6 +29,14 @@ Este início rápido mostra como configurar o MinIO usando o Docker para uso com
|
||||
|
||||
Para obter mais informações sobre suas opções, consulte [Documentação oficial do MinIO](https://docs.min.io/).
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: MinIO has announced removal of MinIO Gateways. Starting June 1st, 2022, support and bug fixes for the current MinIO NAS Gateway implementation will only be available for paid customers via their LTS support contract. If you want to continue using MinIO Gateways with {% data variables.product.prodname_registry %}, we recommend moving to MinIO LTS support. For more information, see [Scheduled removal of MinIO Gateway for GCS, Azure, HDFS](https://github.com/minio/minio/issues/14331) in the minio/minio repository.
|
||||
|
||||
Other modes of MinIO remain available with standard support.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
## 2. Instalar, executar e efetuar o login no MinIO
|
||||
|
||||
1. Configure suas variáveis de ambiente preferidas para o MinIO.
|
||||
|
||||
@@ -134,3 +134,24 @@ Você pode definir as permissões padrão para o `GITHUB_TOKEN` nas configuraç
|
||||
</ol>
|
||||
|
||||
<p spaces-before="0">{% endif %}</p>
|
||||
|
||||
<p spaces-before="0">{% if actions-cache-policy-apis %}</p>
|
||||
|
||||
<h2 spaces-before="0">Enforcing a policy for cache storage in your enterprise</h2>
|
||||
|
||||
<p spaces-before="0">{% data reusables.actions.cache-default-size %} {% data reusables.actions.cache-eviction-process %}</p>
|
||||
|
||||
<p spaces-before="0">However, you can set an enterprise policy to customize both the default total cache size for each repository, as well as the maximum total cache size allowed for a repository. For example, you might want the default total cache size for each repository to be 5 GB, but also allow repository administrators to configure a total cache size up to 15 GB if necessary.</p>
|
||||
|
||||
<p spaces-before="0">People with admin access to a repository can set a total cache size for their repository up to the maximum cache size allowed by the enterprise policy setting.</p>
|
||||
|
||||
<p spaces-before="0">The policy settings for {% data variables.product.prodname_actions %} cache storage can currently only be modified using the REST API:</p>
|
||||
|
||||
<ul>
|
||||
<li>To view the current enterprise policy settings, see "<a href="/rest/actions/cache#get-github-actions-cache-usage-policy-for-an-enterprise">Get GitHub Actions cache usage policy for an enterprise</a>."</li>
|
||||
<li>To change the enterprise policy settings, see "<a href="/rest/actions/cache#get-github-actions-cache-usage-policy-for-an-enterprise">Set GitHub Actions cache usage policy for an enterprise</a>."</li>
|
||||
</ul>
|
||||
|
||||
<p spaces-before="0">{% data reusables.actions.cache-no-org-policy %}</p>
|
||||
|
||||
<p spaces-before="0">{% endif %}</p>
|
||||
|
||||
@@ -22,23 +22,33 @@ shortTitle: Gerenciar as funções da sua organização
|
||||
|
||||
Você pode optar por participar de uma organização pertencente à sua empresa como integrante ou como proprietário da organização, mudar a sua função dentro da organização ou sair da organização.
|
||||
|
||||
{% ifversion ghec %}
|
||||
{% warning %}
|
||||
|
||||
**Aviso**: Se uma organização usar o SCIM para fornecer usuários, entrar na organização desta forma poderia ter consequências não desejadas. Para obter mais informações, consulte "[Sobre SCIM para as organizações](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)".
|
||||
|
||||
{% endwarning %}
|
||||
{% endif %}
|
||||
|
||||
For information about managing other people's roles in an organization, see "[Managing membership in your organization](/organizations/managing-membership-in-your-organization)" and "[Managing people's access to your organization with roles](/organizations/managing-peoples-access-to-your-organization-with-roles)."
|
||||
|
||||
## Gerenciando seu papel com as configurações corporativas
|
||||
|
||||
Você pode participar de uma organização pertencente à sua empresa e gerenciar sua função na organização, diretamente nas configurações da conta corporativa.
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
Se uma organização aplivar o logon único do SAML (SSO), você não poderá usar as configurações corporativas para participar da organização. Em vez disso, você deve participar da organização usando o provedor de identidade (IdP) dessa organização. Em seguida, você pode gerenciar a sua função nas configurações da sua empresa. Para obter mais informações, consulte[Entrando para uma organização que apliva o SAML SSO](#joining-an-organization-that-enforces-saml-sso)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
1. Na guia **Organizações**, à direita da organização em que você deseja gerenciar sua função, selecione o menu suspenso {% octicon "gear" aria-label="The gear icon" %} e clique na ação que você deseja assumir.
|
||||
|
||||
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
## Entrando para uma organização que apliva o SAML SSO
|
||||
|
||||
Se uma organização aplicar o SSO SAML, você não poderá usar as configurações da empresa para participar da organização. Em vez disso, você deve participar da organização usando o provedor de identidade (IdP) dessa organização.
|
||||
@@ -52,3 +62,5 @@ Se uma organização aplicar o SSO SAML, você não poderá usar as configuraç
|
||||
`https://github.com/orgs/ORGANIZATION/sso`
|
||||
|
||||
Depois de entrar na organização, você poderá usar as configurações corporativas para gerenciar a sua função na organização como, por exemplo, se tornar proprietário da organização. Para obter mais informações, consulte "[Gerenciando sua função com as configurações corporativas](#managing-your-role-with-the-enterprise-settings)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -20,8 +20,9 @@ shortTitle: Autenticação no GitHub
|
||||
Para manter sua conta protegida, você deve efetuar a autenticação antes de poder acessar{% ifversion not ghae %} certos{% endif %} recursos em {% data variables.product.product_name %}. Ao efetuar a autenticação em {% data variables.product.product_name %}, você fornece ou confirma credenciais que são exclusivas que provam quem você declara ser.
|
||||
|
||||
Você pode acessar seus recursos em {% data variables.product.product_name %} de várias formas: no navegador, por meio do {% data variables.product.prodname_desktop %} ou outro aplicativo da área de trabalho, com a API ou por meio da linha de comando. Cada forma de acessar o {% data variables.product.product_name %} é compatível com diferentes modos de autenticação.
|
||||
|
||||
- {% ifversion ghae %}Seu provedor de identidade (IdP){% else %}Nome de usuário e senha com autenticação de dois fatores{% endif %}
|
||||
{%- ifversion not fpt %}
|
||||
- Your identity provider (IdP){% endif %}{% ifversion not ghae %}
|
||||
- Username and password with two-factor authentication{% endif %}
|
||||
- Token de acesso de pessoal
|
||||
- Chave SSH
|
||||
|
||||
@@ -30,14 +31,21 @@ Você pode acessar seus recursos em {% data variables.product.product_name %} de
|
||||
Você pode efetuar a autenticação no {% data variables.product.product_name %} no navegador {% ifversion ghae %}usando o seu IdP. Para obter mais informações, consulte "[Sobre a autenticação com o logon único SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)."{% else %}de formas diferentes.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
- Se você for um integrante de um {% data variables.product.prodname_emu_enterprise %}, você irá efetuar a autenticação em {% data variables.product.product_name %} no seu navegador usando seu IdP. Para obter mais informações, consulte "[Efetuando a autenticação como um usuário gerenciado](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users#authenticating-as-a-managed-user)){% ifversion fpt %}" na documentação {% data variables.product.prodname_ghe_cloud %}.{% else %}."{% endif %} Se você não é um integrante de {% data variables.product.prodname_emu_enterprise %}, você irá efetuar a autenticação usando seu navegador em {% data variables.product.prodname_dotcom_the_website %}.
|
||||
- Se você for um integrante de um {% data variables.product.prodname_emu_enterprise %}, você irá efetuar a autenticação em {% data variables.product.product_name %} no seu navegador usando seu IdP. For more information, see "[Authenticating as a managed user](/enterprise-cloud@latest/admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users#authenticating-as-a-managed-user){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}
|
||||
|
||||
If you're not a member of an {% data variables.product.prodname_emu_enterprise %}, you will authenticate using your {% data variables.product.prodname_dotcom_the_website %} username and password. You may also be required to enable two-factor authentication.
|
||||
{% endif %}
|
||||
|
||||
- **Apenas nome de usuário e senha**
|
||||
- Você irá definir uma senha ao criar sua conta pessoal em {% data variables.product.product_name %}. Recomendamos que você use um gerenciador de senhas para gerar uma senha aleatória e única. Para obter mais informações, consulte "[Criar uma senha forte](/github/authenticating-to-github/creating-a-strong-password)".
|
||||
- You'll create a password when you create your account on {% data variables.product.product_name %}. Recomendamos que você use um gerenciador de senhas para gerar uma senha aleatória e única. For more information, see "[Creating a strong password](/github/authenticating-to-github/creating-a-strong-password)."{% ifversion fpt or ghec %}
|
||||
- If you have not enabled 2FA, {% data variables.product.product_name %} will ask for additional verification when you first sign in from an unrecognized device, such as a new browser profile, a browser where the cookies have been deleted, or a new computer.
|
||||
|
||||
After providing your username and password, you will be asked to provide a verification code that we will send to you via email. If you have the GitHub Mobile application installed, you'll receive a notification there instead.{% endif %}
|
||||
- **Autenticação de dois fatores (2FA)** (recomendado)
|
||||
- Se você habilitar a 2FA, também iremos solicitar que você forneça um código gerado por um aplicativo no seu dispositivo móvel ou enviado como uma mensagem de texto (SMS) depois que você digitar seu nome de usuário e senha com sucesso. Para obter mais informações, consulte "[Acessar o {% data variables.product.prodname_dotcom %} usando a autenticação de dois fatores](/github/authenticating-to-github/accessing-github-using-two-factor-authentication#providing-a-2fa-code-when-signing-in-to-the-website)".
|
||||
- Além de autenticação com um aplicativo para celular ou uma mensagem de texto. você pode, opcionalmente, adicionar um método secundário de autenticação com uma chave de segurança usando o WebAuthn. Para obter mais informações, consulte "[Configurar a autenticação de dois fatores usando uma chave de segurança](/github/authenticating-to-github/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key)".
|
||||
- If you enable 2FA, after you successfully enter your username and password, we'll also prompt you to provide a code that's generated by a time-based one time password (TOTP) application on your mobile device{% ifversion fpt or ghec %} or sent as a text message (SMS){% endif %}. Para obter mais informações, consulte "[Acessar o {% data variables.product.prodname_dotcom %} usando a autenticação de dois fatores](/github/authenticating-to-github/accessing-github-using-two-factor-authentication#providing-a-2fa-code-when-signing-in-to-the-website)".
|
||||
- In addition to authentication with a TOTP application{% ifversion fpt or ghec %} or a text message{% endif %}, you can optionally add an alternative method of authentication with {% ifversion fpt or ghec %}{% data variables.product.prodname_mobile %} or{% endif %} a security key using WebAuthn. For more information, see {% ifversion fpt or ghec %}"[Configuring two-factor authentication with {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile)" and {% endif %}"[Configuring two-factor authentication using a security key](/github/authenticating-to-github/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key)."{% endif %}{% ifversion ghes %}
|
||||
- **Identity provider (IdP) authentication**
|
||||
- Your site administrator may configure {% data variables.product.product_location %} to use authentication with an IdP instead of a username and password. For more information, see "[External authentication methods](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#external-authentication)."
|
||||
{% endif %}
|
||||
|
||||
## Efetuar a autenticação com {% data variables.product.prodname_desktop %}
|
||||
@@ -85,11 +93,12 @@ Se você efetuar a autenticação com {% data variables.product.prodname_cli %},
|
||||
|
||||
Se você efetuar a autenticação sem {% data variables.product.prodname_cli %}, você deverá gerar um conjunto de chaves pública/privada no seu computador local e adicionar a chave pública à sua conta em {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}. Para obter mais informações, consulte "[Gerar uma nova chave SSH e adicioná-la ao ssh-agent](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)". Sempre que usar o Git para efetuar a autenticação com {% data variables.product.product_name %}, será solicitado que você digite a senha da sua chave SSH, a menos que você [tenha armazenado a chave](/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#adding-your-ssh-key-to-the-ssh-agent).
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
|
||||
### Autorizando para logon único SAML
|
||||
|
||||
{% ifversion fpt or ghec %}Para usar um token de acesso pessoal ou chave SSH para acessar os recursos que pertencem a uma organização que usa o logon único SAML, você também deve autorizar o token pessoal ou chave SSH. Para mais informações, consulte "[Autorizando um token de acesso pessoal para usar com logon único SAML ](/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" ou "[Autorizando uma chave SSH para usar com o logon único SAML](/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on){% ifversion fpt %}" na documentação de {% data variables.product.prodname_ghe_cloud %}.{% else %}."{% endif %}{% endif %}
|
||||
To use a personal access token or SSH key to access resources owned by an organization that uses SAML single sign-on, you must also authorize the personal token or SSH key. Para mais informações, consulte "[Autorizando um token de acesso pessoal para usar com logon único SAML ](/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" ou "[Autorizando uma chave SSH para usar com o logon único SAML](/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on){% ifversion fpt %}" na documentação de {% data variables.product.prodname_ghe_cloud %}.{% else %}."{% endif %}{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
|
||||
|
||||
@@ -54,6 +54,8 @@ Depois que uma autorização for revogada, todos os tokens associados à autoriz
|
||||
|
||||
O proprietário de um {% data variables.product.prodname_oauth_app %} pode revogar a autorização de uma conta do seu aplicativo. Isso também irá revogar todos os tokens associados à autorização. Para obter mais informações sobre a revogação de autorizações do seu aplicativo OAuth, consulte[Excluir uma autorização de aplicativo](/rest/reference/apps#delete-an-app-authorization). "
|
||||
|
||||
{% data variables.product.prodname_oauth_app %} owners can also revoke individual tokens associated with an authorization. For more information about revoking individual tokens for your OAuth app, see "[Delete an app token](/rest/apps/oauth-applications#delete-an-app-token)".
|
||||
|
||||
## Token revogado devido ao excesso de tokens para um {% data variables.product.prodname_oauth_app %} com o mesmo escopo
|
||||
|
||||
{% data reusables.apps.oauth-token-limit %}
|
||||
|
||||
@@ -49,8 +49,11 @@ Os administradores do repositório podem impor a assinatura de commit obrigatór
|
||||
|
||||
{% data reusables.identity-and-permissions.verification-status-check %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
{% data variables.product.product_name %} usará automaticamente o GPG para assinar os commits que você criar usando a interface web de {% data variables.product.product_name %}. Commits assinados por {% data variables.product.product_name %} terão um status de verificado em {% data variables.product.product_name %}. É possível verificar a assinatura localmente usando a chave pública disponível em https://github.com/web-flow.gpg. A impressão digital completa da chave é `5DE3 E050 9C47 EA3C F04A 42D3 4AEE 18F8 3AFD EB23`. Opcionalmente, você pode escolher que {% data variables.product.product_name %} assine os commits que você fizer em {% data variables.product.prodname_codespaces %}. Para obter mais informações sobre como habilitar a verificação de GPG para os seus códigos, consulte "[Gerenciar a verificação de GPG para {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces)".
|
||||
{% ifversion fpt or ghec or ghes > 3.4 %}
|
||||
{% ifversion ghes %}If a site administrator has enabled web commit signing, {% data variables.product.product_name %} will automatically use GPG to sign commits you make using the web interface. Commits signed by {% data variables.product.product_name %} will have a verified status. You can verify the signature locally using the public key available at `https://HOSTNAME/web-flow.gpg`. For more information, see "[Configuring web commit signing](/admin/configuration/configuring-your-enterprise/configuring-web-commit-signing)."
|
||||
{% else %}{% data variables.product.prodname_dotcom %} will automatically use GPG to sign commits you make using the web interface. Commits signed by {% data variables.product.prodname_dotcom %} will have a verified status. É possível verificar a assinatura localmente usando a chave pública disponível em https://github.com/web-flow.gpg. A impressão digital completa da chave é `5DE3 E050 9C47 EA3C F04A 42D3 4AEE 18F8 3AFD EB23`.
|
||||
|
||||
Opcionalmente, você pode escolher que {% data variables.product.prodname_dotcom %} assine os commits que você fizer em {% data variables.product.prodname_codespaces %}. For more information about enabling GPG verification for your codespaces, see "[Managing GPG verification for {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces)."{% endif %}
|
||||
{% endif %}
|
||||
|
||||
## Verificação da assinatura de commit GPG
|
||||
|
||||
@@ -19,7 +19,7 @@ No {% data variables.product.product_name %}, a segunda forma de autenticação
|
||||
{% data reusables.two_fa.after-2fa-add-security-key %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
Além das chaves de segurança, você também pode usar {% data variables.product.prodname_mobile %} para 2FA após configurar um aplicativo TOTP para dispositivo móvel ou mensagens de texto. {% data variables.product.prodname_mobile %} usa criptografia de chave pública para proteger sua conta, permitindo que você use qualquer dispositivo móvel que usou para entrar no {% data variables.product.prodname_mobile %} como segundo fator.
|
||||
Além das chaves de segurança, você também pode usar {% data variables.product.prodname_mobile %} para 2FA após configurar um aplicativo TOTP para dispositivo móvel ou mensagens de texto. {% data variables.product.prodname_mobile %} uses public-key cryptography to secure your account, allowing you to use any mobile device that you've used to sign in to {% data variables.product.prodname_mobile %} as your second factor.
|
||||
{% endif %}
|
||||
|
||||
Você também pode configurar métodos de recuperação adicionais, caso você o acesso às suas credenciais de autenticação de dois fatores. Para obter mais informações sobre como configurar a 2FA, consulte "[Configurar a autenticação de dois fatores](/articles/configuring-two-factor-authentication)" e "[Configurar métodos de recuperação de autenticação de dois fatores](/articles/configuring-two-factor-authentication-recovery-methods)".
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Conectar uma assinatura do Azure à sua empresa
|
||||
intro: 'Você pode usar o Contrato da Microsoft Enterprise para habilitar e pagar por {% data variables.product.prodname_actions %} e pelo uso de {% data variables.product.prodname_registry %}, além dos valores incluídos para a sua empresa.'
|
||||
intro: 'You can use your Microsoft Enterprise Agreement to enable and pay for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, and {% data variables.product.prodname_codespaces %} usage.'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/connecting-an-azure-subscription-to-your-enterprise
|
||||
- /github/setting-up-and-managing-billing-and-payments-on-github/connecting-an-azure-subscription-to-your-enterprise
|
||||
@@ -14,7 +14,17 @@ shortTitle: Conectar uma assinatura do Azure
|
||||
|
||||
{% data reusables.enterprise-accounts.billing-microsoft-ea-overview %} Para obter mais informações, consulte "[Sobre a cobrança para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions) e "[Sobre cobrança para {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/about-billing-for-github-packages)."
|
||||
|
||||
Após conectar a uma assinatura do Azure, você também poderá gerenciar seu limite de gastos. Para informações sobre como gerenciar e alterar o limite de gastos da sua conta, consulte "[Gerenciar o seu limite de gastos para {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/managing-your-spending-limit-for-github-packages)" e "[Gerenciar o seu limite de gastos para {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)".
|
||||
{% note %}
|
||||
|
||||
**Note:** If your enterprise account is on a Microsoft Enterprise Agreement, connecting an Azure subscription is the only way to use {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %} beyond the included amounts, or to use {% data variables.product.prodname_codespaces %} at all.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
After you connect an Azure subscription, you can also manage your spending limits.
|
||||
|
||||
- "[Managing your spending limit for {% data variables.product.prodname_registry %}](/billing/managing-billing-for-github-packages/managing-your-spending-limit-for-github-packages)"
|
||||
- "[Managing your spending limit for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)"
|
||||
- "[Managing your spending limit for {% data variables.product.prodname_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-codespaces)"
|
||||
|
||||
## Conectar a sua assinatura do Azure à sua conta corporativa
|
||||
|
||||
|
||||
@@ -26,9 +26,22 @@ Se você não deseja habilitar {% data variables.product.prodname_github_connect
|
||||
|
||||
## Sincronizar automaticamente o uso da licença
|
||||
|
||||
É possível usar o {% data variables.product.prodname_github_connect %} para sincronizar automaticamente o uso e a contagem da licença de usuários entre o {% data variables.product.prodname_ghe_server %} e o {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Habilitando a sincronização da licença de usuário para a sua empresa ]({% ifversion ghec %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise){% ifversion ghec %}" na documentação de {% data variables.product.prodname_ghe_server %}.{% elsif ghes %}."{% endif %}
|
||||
You can use {% data variables.product.prodname_github_connect %} to automatically synchronize user license count and usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly. Para obter mais informações, consulte "[Habilitando a sincronização da licença de usuário para a sua empresa ]({% ifversion ghec %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise){% ifversion ghec %}" na documentação de {% data variables.product.prodname_ghe_server %}.{% elsif ghes %}."{% endif %}
|
||||
|
||||
## Uso da licença sincronizado manualmente
|
||||
{% ifversion ghec or ghes > 3.4 %}
|
||||
After you enable {% data variables.product.prodname_github_connect %}, license data will be automatically synchronized weekly. You can also manually synchronize your license data at any time, by triggering a license sync job.
|
||||
|
||||
### Triggering a license sync job
|
||||
|
||||
1. Sign in to your {% data variables.product.prodname_ghe_server %} instance.
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.license-tab %}
|
||||
1. Under "License sync", click {% octicon "sync" aria-label="The Sync icon" %} **Sync now**. 
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Manually uploading GitHub Enterprise Server license usage
|
||||
|
||||
Para sincronizar manualmente o uso das licenças de usuário entre as duas implantações, você pode baixar um arquivo JSON do {% data variables.product.prodname_ghe_server %} e fazer upload desse arquivo no {% data variables.product.prodname_ghe_cloud %}.
|
||||
|
||||
@@ -38,7 +51,6 @@ Para sincronizar manualmente o uso das licenças de usuário entre as duas impla
|
||||
5. Em "Quick links" (Links rápidos), para baixar um arquivo com o uso da sua licença atual no {% data variables.product.prodname_ghe_server %}, clique em **Export license usage** (Exportar uso de licença). 
|
||||
{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
8. Na barra lateral esquerda, clique em **Enterprise licensing** (Licenciamento Empresarial). 
|
||||
{% data reusables.enterprise-accounts.license-tab %}
|
||||
10. Em "Instâncias Enterprise Server", clique em **Add server usage** (Adicionar uso de servidor). 
|
||||
11. Faça upload do arquivo JSON que você baixou do {% data variables.product.prodname_ghe_server %}.
|
||||
|
||||
@@ -85,12 +85,19 @@ Any valid SARIF 2.1.0 output file can be uploaded, however, {% data variables.pr
|
||||
|
||||
| Name | Description |
|
||||
|----|----|
|
||||
| `tool.driver.name` | **Required.** The name of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the name on {% data variables.product.prodname_dotcom %} to allow you to filter results by tool. |
|
||||
| `tool.driver.version` | **Optional.** The version of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. |
|
||||
| `tool.driver.semanticVersion` | **Optional.** The version of the analysis tool, specified by the Semantic Versioning 2.0 format. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. For more information, see "[Semantic Versioning 2.0.0](https://semver.org/)" in the Semantic Versioning documentation. |
|
||||
| `tool.driver.rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). |
|
||||
| `tool.driver` | **Required.** A `toolComponent` object that describes the analysis tool. For more information, see the [`toolComponent` object](#toolcomponent-object). |
|
||||
| `tool.extensions[]` | **Optional.** An array of `toolComponent` objects that represent any plugins or extensions used by the tool during analysis. For more information, see the [`toolComponent` object](#toolcomponent-object). |
|
||||
| `results[]` | **Required.** The results of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the results on {% data variables.product.prodname_dotcom %}. For more information, see the [`result` object](#result-object).
|
||||
|
||||
### `toolComponent` object
|
||||
|
||||
| Name | Description |
|
||||
|----|----|
|
||||
| `name` | **Required.** The name of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} displays the name on {% data variables.product.prodname_dotcom %} to allow you to filter results by tool. |
|
||||
| `version` | **Optional.** The version of the analysis tool. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. |
|
||||
| `semanticVersion` | **Optional.** The version of the analysis tool, specified by the Semantic Versioning 2.0 format. {% data variables.product.prodname_code_scanning_capc %} uses the version number to track when results may have changed due to a tool version change rather than a change in the code being analyzed. If the SARIF file includes the `semanticVersion` field, `version` is not used by {% data variables.product.prodname_code_scanning %}. For more information, see "[Semantic Versioning 2.0.0](https://semver.org/)" in the Semantic Versioning documentation. |
|
||||
| `rules[]` | **Required.** An array of `reportingDescriptor` objects that represent rules. The analysis tool uses rules to find problems in the code being analyzed. For more information, see the [`reportingDescriptor` object](#reportingdescriptor-object). |
|
||||
|
||||
### `reportingDescriptor` object
|
||||
|
||||
| Name | Description |
|
||||
@@ -176,7 +183,7 @@ Use the category to distinguish between multiple analyses for the same tool or c
|
||||
- The run with an `id` of "my-analysis/tool1/" belongs to the category "my-analysis/tool1" but is not distinguished from other runs in that category.
|
||||
- The run whose `id` is "my-analysis for tool1 " has a unique identifier but cannot be inferred to belong to any category.
|
||||
|
||||
For more information about the `runAutomationDetails` object and the `id` field, see [runAutomationDetails object](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012479) in the OASIS documentation.
|
||||
For more information about the `runAutomationDetails` object and the `id` field, see [runAutomationDetails object](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html#_Toc16012479) in the OASIS documentation.
|
||||
|
||||
Note that the rest of the supported fields are ignored.
|
||||
|
||||
@@ -302,7 +309,7 @@ This SARIF output file has example values to show all supported SARIF properties
|
||||
]
|
||||
}
|
||||
},
|
||||
"automationDetails": {
|
||||
"automationDetails": {
|
||||
"id": "my-category/"
|
||||
},
|
||||
"results": [
|
||||
|
||||
@@ -66,11 +66,11 @@ Você pode mostrar a ajuda de linha de comando para qualquer comando usando <nob
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
```shell
|
||||
# Single supported language - create one CodeQL databsae
|
||||
codeql database create <database> --command<build> --language=<language-identifier>
|
||||
codeql database create <database> --command<build> --language=<language-identifier>
|
||||
|
||||
# Multiple supported languages - create one CodeQL database per language
|
||||
codeql database create <database> --command<build> \
|
||||
--db-cluster --language=<language-identifier>,<language-identifier>
|
||||
--db-cluster --language=<language-identifier>,<language-identifier>
|
||||
```
|
||||
{% else %}
|
||||
```shell
|
||||
@@ -230,7 +230,7 @@ $ codeql database create /codeql-dbs/example-repo --language=javascript \
|
||||
in /checkouts/example-repo.
|
||||
> [build-stdout] Single-threaded extraction.
|
||||
> [build-stdout] Extracting
|
||||
...
|
||||
...
|
||||
> Finalizing database at /codeql-dbs/example-repo.
|
||||
> Successfully created database at /codeql-dbs/example-repo.
|
||||
```
|
||||
@@ -270,16 +270,11 @@ $
|
||||
|
||||
## Analisando um banco de dados de {% data variables.product.prodname_codeql %}
|
||||
|
||||
1. Criar um banco de dados de {% data variables.product.prodname_codeql %} (ver acima).{% if codeql-packs %}
|
||||
2. Opcional, execute `codeql pack download` para fazer o download de quaisquer pacotes (beta) de {% data variables.product.prodname_codeql %} que você deseja executar durante a análise. Para obter mais informações, consulte "[Fazer o download e usando pacotes de consulta de {% data variables.product.prodname_codeql %} pacotes de consulta](#downloading-and-using-codeql-query-packs)" abaixo.
|
||||
```shell
|
||||
codeql pack download <packs>
|
||||
```
|
||||
{% endif %}
|
||||
3. Executar `codeql database analyze` no banco de dados e especifique quais {% if codeql-packs %}pacotes e/ou {% endif %}consultas devem ser usados.
|
||||
1. Criar um banco de dados de {% data variables.product.prodname_codeql %} (ver acima).
|
||||
2. Executar `codeql database analyze` no banco de dados e especifique quais {% if codeql-packs %}pacotes e/ou {% endif %}consultas devem ser usados.
|
||||
```shell
|
||||
codeql database analyze <database> --format=<format> \
|
||||
--output=<output> {% if codeql-packs %}<packs,queries>{% else %} <queries>{% endif %}
|
||||
--output=<output> {% if codeql-packs %}--download <packs,queries>{% else %}<queries>{% endif %}
|
||||
```
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
@@ -401,7 +396,20 @@ codeql database analyze <database> --format=<format> \
|
||||
</td>
|
||||
|
||||
<td>
|
||||
Opcional. Use se você fez o download dos pacotes de consulta CodeQL e desejar executar as consultas padrão ou os conjuntos de consulta especificados nos pacotes. Para obter mais informações, consulte "<a href="#downloading-and-using-codeql-query-packs">Fazer o download e usar pacotes de {% data variables.product.prodname_codeql %}</a>."{% endif %}
|
||||
Opcional. Use if you want to include CodeQL query packs in your analysis. For more information, see "<a href="#downloading-and-using-codeql-query-packs">Downloading and using {% data variables.product.prodname_codeql %} packs</a>."
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td>
|
||||
<nobr>`--download`</nobr>
|
||||
</td>
|
||||
|
||||
<td align="center">
|
||||
</td>
|
||||
|
||||
<td>
|
||||
Opcional. Use if some of your CodeQL query packs are not yet on disk and need to be downloaded before running queries.{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
@@ -441,13 +449,12 @@ Este exemplo analisa um banco de dados {% data variables.product.prodname_codeql
|
||||
|
||||
```
|
||||
$ codeql database analyze /codeql-dbs/example-repo \
|
||||
javascript-code-scanning.qls {% ifversion fpt or ghes > 3.1 or ghae or ghec %}--sarif-category=javascript{% endif %}
|
||||
javascript-code-scanning.qls {% ifversion fpt or ghes > 3.1 or ghae or ghec %}--sarif-category=javascript \{% endif %}
|
||||
--format={% ifversion fpt or ghae or ghec %}sarif-latest{% else %}sarifv2.1.0{% endif %} --output=/temp/example-repo-js.sarif
|
||||
|
||||
> Running queries.
|
||||
> Compiling query plan for /codeql-home/codeql/qlpacks/
|
||||
codeql-javascript/AngularJS/DisablingSce.ql.
|
||||
...
|
||||
> Compiling query plan for /codeql-home/codeql/qlpacks/codeql-javascript/AngularJS/DisablingSce.ql.
|
||||
...
|
||||
> Shutting down query evaluator.
|
||||
> Interpreting results.
|
||||
```
|
||||
@@ -590,11 +597,7 @@ Não há saída deste comando a menos que o upload não tenha sido bem-sucedido.
|
||||
|
||||
O pacote de {% data variables.product.prodname_codeql_cli %} inclui consultas mantidas por especialistas de {% data variables.product.company_short %}, pesquisadores de segurança e contribuidores da comunidade. Se você quiser executar consultas desenvolvidas por outras organizações, os pacotes de consulta de {% data variables.product.prodname_codeql %} fornecem uma forma eficiente e confiável de fazer o download e executar consultas. Para obter mais informações, consulte "[Sobre digitalização de código com o CodeQL](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql#about-codeql-queries)".
|
||||
|
||||
Antes de usar um pacote de {% data variables.product.prodname_codeql %} para analisar um banco de dados, você deve fazer o download de todos os pacotes que precisar a partir de {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %} executando `codeql download` e especificando os pacotes que você deseja baixar. Se um pacote não estiver disponível publicamente, você precisará usar um {% data variables.product.prodname_github_app %} ou um token de acesso pessoal para efetuar a autenticação. Para obter mais informações e um exemplo, consulte "[o Fazer upload dos resultados para {% data variables.product.product_name %}](#uploading-results-to-github)" acima.
|
||||
|
||||
```shell
|
||||
codeql pack download <scope/name@version>,...
|
||||
```
|
||||
Before you can use a {% data variables.product.prodname_codeql %} pack to analyze a database, you must download any packages you require from the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}. This can be done either by using the `--download` flag as part of the `codeql database analyze` command. Se um pacote não estiver disponível publicamente, você precisará usar um {% data variables.product.prodname_github_app %} ou um token de acesso pessoal para efetuar a autenticação. Para obter mais informações e um exemplo, consulte "[o Fazer upload dos resultados para {% data variables.product.product_name %}](#uploading-results-to-github)" acima.
|
||||
|
||||
<table spaces-before="0">
|
||||
<tr>
|
||||
@@ -621,7 +624,7 @@ codeql pack download <scope/name@version>,...
|
||||
</td>
|
||||
|
||||
<td>
|
||||
Especifique o escopo e o nome de um ou mais pacotes de consulta CodeQL para fazer o download usando uma lista separada por vírgulas. Opcionalmente, inclua a versão para fazer o download e descompactar. Por padrão, a versão mais recente deste pacote foi baixada.
|
||||
Especifique o escopo e o nome de um ou mais pacotes de consulta CodeQL para fazer o download usando uma lista separada por vírgulas. Opcionalmente, inclua a versão para fazer o download e descompactar. Por padrão, a versão mais recente deste pacote foi baixada. Optionally, include a path to a query, directory, or query suite to run. If no path is included, then run the default queries of this pack.
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
@@ -641,25 +644,41 @@ codeql pack download <scope/name@version>,...
|
||||
|
||||
### Exemplo básico
|
||||
|
||||
Este exemplo executa dois comandos para baixar a última versão do pacote `octo-org/security-queries` e, em seguida, analisar o banco de dados `/codeql-dbs/exemplo-repo`.
|
||||
This example runs the `codeql database analyze` command with the `--download` option to:
|
||||
|
||||
1. Download the latest version of the `octo-org/security-queries` pack.
|
||||
2. Download a version of the `octo-org/optional-security-queries` pack that is *compatible* with version 1.0.1 (in this case, it is version 1.0.2). For more information on semver compatibility, see [npm's semantic version range documentation](https://github.com/npm/node-semver#ranges).
|
||||
3. Run all the default queries in `octo-org/security-queries`.
|
||||
4. Run only the query `queries/csrf.ql` from `octo-org/optional-security-queries`
|
||||
|
||||
```
|
||||
$ echo $OCTO-ORG_ACCESS_TOKEN | codeql pack download octo-org/security-queries
|
||||
$ echo $OCTO-ORG_ACCESS_TOKEN | codeql database analyze --download /codeql-dbs/example-repo \
|
||||
octo-org/security-queries \
|
||||
octo-org/optional-security-queries@~1.0.1:queries/csrf.ql \
|
||||
--format=sarif-latest --output=/temp/example-repo-js.sarif
|
||||
|
||||
> Download location: /Users/mona/.codeql/packages
|
||||
> Installed fresh octo-org/security-queries@1.0.0
|
||||
|
||||
$ codeql database analyze /codeql-dbs/example-repo octo-org/security-queries \
|
||||
--format=sarif-latest --output=/temp/example-repo-js.sarif
|
||||
|
||||
> Installed fresh octo-org/optional-security-queries@1.0.2
|
||||
> Running queries.
|
||||
> Compiling query plan for /Users/mona/.codeql/packages/octo-org/security-queries/1.0.0/potential-sql-injection.ql.
|
||||
> [1/1] Found in cache: /Users/mona/.codeql/packages/octo-org/security-queries/1.0.0/potential-sql-injection.ql.
|
||||
> [1/2] Found in cache: /Users/mona/.codeql/packages/octo-org/security-queries/1.0.0/potential-sql-injection.ql.
|
||||
> Starting evaluation of octo-org/security-queries/query1.ql.
|
||||
> [1/1 eval 394ms] Evaluation done; writing results to docto-org/security-queries/query1.bqrs.
|
||||
> Compiling query plan for /Users/mona/.codeql/packages/octo-org/optional-security-queries/1.0.2/queries/csrf.ql.
|
||||
> [2/2] Found in cache: /Users/mona/.codeql/packages/octo-org/optional-security-queries/1.0.2/queries/csrf.ql.
|
||||
> Starting evaluation of octo-org/optional-security-queries/queries/csrf.ql.
|
||||
> [2/2 eval 694ms] Evaluation done; writing results to octo-org/security-queries/query1.bqrs.
|
||||
> Shutting down query evaluator.
|
||||
> Interpreting results.
|
||||
```
|
||||
|
||||
### Direct download of {% data variables.product.prodname_codeql %} packs
|
||||
|
||||
If you want to download a {% data variables.product.prodname_codeql %} pack without running it immediately, then you can use the `codeql pack download` command. This is useful if you want to avoid accessing the internet when running {% data variables.product.prodname_codeql %} queries. When you run the {% data variables.product.prodname_codeql %} analysis, you can specify packs, versions, and paths in the same way as in the previous example:
|
||||
|
||||
```shell
|
||||
echo $OCTO-ORG_ACCESS_TOKEN | codeql pack download <scope/name@version:path> <scope/name@version:path> ...
|
||||
```
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.1 or ghae or ghec %}
|
||||
|
||||
@@ -42,6 +42,8 @@ O {% data variables.product.product_name %} atualmente verifica repositórios p
|
||||
|
||||
Quando {% data variables.product.prodname_secret_scanning_GHAS %} está habilitado, {% data variables.product.prodname_dotcom %} digitalia os segredos emitidos pelos seguintes prestadores de serviços. {% ifversion ghec %}Para obter mais informações sobre {% data variables.product.prodname_secret_scanning_GHAS %}, consulte "[Sobre {% data variables.product.prodname_secret_scanning_GHAS %}](/code-security/secret-scanning/about-secret-scanning#about-secret-scanning-for-advanced-security)."{% endif %}
|
||||
|
||||
If you use the REST API for secret scanning, you can use the `Secret type` to report on secrets from specific issuers. Para obter mais informações, consulte "[Verificação de segredo](/enterprise-cloud@latest/rest/secret-scanning)".
|
||||
|
||||
{% ifversion ghes > 3.1 or ghae or ghec %}
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -150,7 +150,7 @@ Você pode etiquetar uma porta para tornar a porta mais facilmente identificáve
|
||||
|
||||
## Adicionar uma porta à configuração do código
|
||||
|
||||
É possível adicionar uma porta encaminhada para a configuração {% data variables.product.prodname_codespaces %} do repositório para que a porta seja automaticamente encaminhada para todos os códigos criados a partir do repositório. Depois de atualizar a configuração, todos os codespaces criados anteriormente deverão ser reconstruídos para que a alteração seja aplicada. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_codespaces %} para seu projeto](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project#applying-changes-to-your-configuration)".
|
||||
É possível adicionar uma porta encaminhada para a configuração {% data variables.product.prodname_codespaces %} do repositório para que a porta seja automaticamente encaminhada para todos os códigos criados a partir do repositório. Depois de atualizar a configuração, todos os codespaces criados anteriormente deverão ser reconstruídos para que a alteração seja aplicada. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_codespaces %} para seu projeto](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project#applying-configuration-changes-to-a-codespace)".
|
||||
|
||||
Você pode configurar manualmente as portas encaminhadas em um arquivo `.devcontainer.json` usando a propriedade `forwardPorts` ou você pode usar o painel "Portas" no seu codespace.
|
||||
|
||||
|
||||
@@ -47,7 +47,7 @@ Você pode fazer pull das alterações do repositório remoto para seu codespace
|
||||
1. Na parte superior da barra lateral, clique na elipse (**...**). 
|
||||
1. No menu suspenso, clique em **Pull**.
|
||||
|
||||
Se a configuração do contêiner dev foi alterada desde que você criou o codespace, você pode aplicar as alterações reconstruindo o contêiner para o codespace. Para obter mais informações, consulte "[Introdução a contêineres de desenvolvimento](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project#applying-changes-to-your-configuration)".
|
||||
Se a configuração do contêiner dev foi alterada desde que você criou o codespace, você pode aplicar as alterações reconstruindo o contêiner para o codespace. Para obter mais informações, consulte "[Introdução a contêineres de desenvolvimento](/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project#applying-configuration-changes-to-a-codespace)".
|
||||
|
||||
## Configurar o seu codespace para buscar novas alterações automaticamente
|
||||
|
||||
|
||||
@@ -32,6 +32,13 @@ Por padrão, um codespace só pode acessar o repositório no qual ele foi criado
|
||||
|
||||
## Habilitar {% data variables.product.prodname_codespaces %} para os usuários na sua organização
|
||||
|
||||
{% ifversion fpt %}
|
||||
{% note %}
|
||||
|
||||
**Note:** If you are a verified educator or a teacher, you must enable {% data variables.product.prodname_codespaces %} from a {% data variables.product.prodname_classroom %} to use your {% data variables.product.prodname_codespaces %} Education benefit. For more information, see "[Using GitHub Codespaces with GitHub Classroom](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom#about-the-codespaces-education-benefit-for-verified-teachers)."
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% data reusables.profile.access_org %}
|
||||
{% data reusables.profile.org_settings %}
|
||||
{% data reusables.organizations.click-codespaces %}
|
||||
|
||||
@@ -87,7 +87,7 @@ Para criar codespaces com permissões personalizadas definidas, você deve usar
|
||||
}
|
||||
```
|
||||
|
||||
Para definir todas as permissões para um determinado repositório, use `read-all` ou `write-all` no objeto `permissões`
|
||||
To set all permissions for a given repository, use `"permissions": "read-all"` or `"permissions": "write-all"` in the repository object.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -95,9 +95,7 @@ Para criar codespaces com permissões personalizadas definidas, você deve usar
|
||||
"codespaces": {
|
||||
"repositories": {
|
||||
"my_org/my_repo": {
|
||||
"permissions": {
|
||||
"write-all"
|
||||
}
|
||||
"permissions": "write-all"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -58,7 +58,20 @@ Exibe o histórico de execução de fluxo de trabalho para pré-compilações pa
|
||||
|
||||
1. Faça as alterações necessárias na configuração de pré-compilação e, em seguida, clique em **Atualizar**.
|
||||
|
||||
### Excluir uma configuração de pré-compilação
|
||||
### Disabling a prebuild configuration
|
||||
|
||||
To pause the update of prebuild templates for a configuration, you can disable workflow runs for the configuration. Disabling the workflow runs for a prebuild configuration does not delete any previously created prebuild templates for that configuration and, as a result, codespaces will continue to be generated from an existing prebuild template.
|
||||
|
||||
Disabling the workflow runs for a prebuild configuration is useful if you need to investigate template creation failures.
|
||||
|
||||
1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to disable.
|
||||
1. In the dropdown menu, click **Disable runs**.
|
||||
|
||||
|
||||
|
||||
1. To confirm that you want to disable this configuration, click **OK**.
|
||||
|
||||
### Deleting a prebuild configuration
|
||||
|
||||
A exclusão de uma configuração de pré-compilação também exclui todos os modelos de pré-compilação criados anteriormente para essa configuração. Como resultado, logo após você excluir uma configuração, as pré-compilações geradas por essa configuração não estarão disponíveis ao criar um novo codespace.
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ Para obter mais informações, consulte "[Introdução a contêineres de desenvo
|
||||
1. Crie um código a partir do branch pré-compilado cujo contêiner de desenvolvimento você deseja alterar. Para obter mais informações, consulte "[Criando um codespace ](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)".
|
||||
1. No codespaec, confira um branch de teste. Para obter mais informações, consulte "[Usando controle de origem no seu codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace#creating-or-switching-branches)."
|
||||
1. Faça as alterações necessárias na configuração do contêiner de desenvolvimento.
|
||||
1. Aplique as alterações recompilando o container. Para obter mais informações, consulte "[Introdução a contêineres de desenvolvimento](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-changes-to-your-configuration)".
|
||||
1. Aplique as alterações recompilando o container. Para obter mais informações, consulte "[Introdução a contêineres de desenvolvimento](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)."
|
||||
1. Depois de tudo parecer bom, recomendamos também criar um novo codespace a partir de seu branch de teste para garantir que tudo está funcionando. Você pode então fazer commit das alterações no branch padrão do seu repositório ou em um branch de recurso ativo, acionando uma atualização do modelo de pré-criação para esse branch.
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -138,7 +138,7 @@ Usar uma configuração predefinida é uma ótima ideia se você precisa de uma
|
||||
|
||||
|
||||
|
||||
1. Se você estiver trabalhando em um codespace, aplique suas alterações clicando em **Reconstruir agora** na mensagem na parte inferior direita da janela. Para obter mais informações sobre a reconstrução do seu contêiner, consulte "[Aplicar alterações na sua configuração](#applying-changes-to-your-configuration)".
|
||||
1. Se você estiver trabalhando em um codespace, aplique suas alterações clicando em **Reconstruir agora** na mensagem na parte inferior direita da janela. For more information about rebuilding your container, see "[Applying changes to your configuration](#applying-configuration-changes-to-a-codespace)."
|
||||
|
||||
|
||||
|
||||
@@ -163,7 +163,7 @@ Você pode adicionar algumas das características mais comuns selecionando-as na
|
||||
|
||||
|
||||
|
||||
1. Para aplicar as alterações, no canto inferior direito da tela, clique em **Reconstruir agora**. Para obter mais informações sobre a reconstrução do seu contêiner, consulte "[Aplicar alterações na sua configuração](#applying-changes-to-your-configuration)".
|
||||
1. Para aplicar as alterações, no canto inferior direito da tela, clique em **Reconstruir agora**. For more information about rebuilding your container, see "[Applying changes to your configuration](#applying-configuration-changes-to-a-codespace)."
|
||||
|
||||
|
||||
|
||||
@@ -211,7 +211,7 @@ Você pode definir as configurações de editor-padrão para {% data variables.p
|
||||
* Editor settings defined in the `.vscode/settings.json` file in your repository are applied as _Workspace_-scoped settings in the codespace.
|
||||
* Editor settings defined in the `settings` key in the `devcontainer.json` file are applied as _Remote [Codespaces]_-scoped settings in the codespace.
|
||||
|
||||
## Aplicando alterações à sua configuração
|
||||
## Applying configuration changes to a codespace
|
||||
|
||||
{% data reusables.codespaces.apply-devcontainer-changes %}
|
||||
|
||||
|
||||
@@ -57,6 +57,10 @@ Essas são as coisas a serem verificadas se a etiqueta " Pré-compilação de {%
|
||||
* Verifique se uma alteração para a configuração do contêiner de desenvolvimento foi enviada por push para o branch habilitado pela pré-compilação recentemente. Se for dessa forma, normalmente você terá que esperar até que o fluxo de trabalho de pré-criação, aguarde até que a execução do fluxo de trabalho de pré-compilação seja concluída antes que as pré-criações estejam disponíveis novamente.
|
||||
* Se nenhuma alteração de configuração foi realizada recentemente, acesse a aba **Ações** do seu repositório, clique em **{% octicon "codespaces" aria-label="The Codespaces icon" %} Pré-compilações de {% data variables.product.prodname_codespaces %}** na lista de fluxos de trabalho e verifique se as execuções do fluxo de trabalho de pré-compilação são sendo bem-sucedidas. Se as últimas execuções de um fluxo de trabalho falharem e uma ou mais dessas execuções falharam continham alterações na configuração do contêiner de desenvolvimento, não haverá pré-compilações disponíveis para o branch associado.
|
||||
|
||||
## Troubleshooting failed workflow runs for prebuilds
|
||||
|
||||
If the workflow runs for a prebuild configuration are failing, you can temporarily disable the prebuild configuration while you investigate. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)."
|
||||
|
||||
## Leia mais
|
||||
|
||||
- "[Configurando pré-compilações](/codespaces/prebuilding-your-codespaces/configuring-prebuilds)"
|
||||
|
||||
@@ -47,12 +47,14 @@ Qualquer pessoa com acesso de gravação em um repositório pode editar comentá
|
||||
|
||||
Considera-se apropriado editar um comentário e remover o conteúdo que não contribui para a conversa e viole o código de conduta da sua comunidade{% ifversion fpt or ghec %} ou as diretrizes [da Comunidade do GitHub](/free-pro-team@latest/github/site-policy/github-community-guidelines){% endif %}.
|
||||
|
||||
Quando editar um comentário, anote a localização de onde o comentário foi removido e, opcionalmente, os motivos para a remoção.
|
||||
Sometimes it may make sense to clearly indicate edits and their justification.
|
||||
|
||||
Qualquer pessoa com acesso de leitura em um repositório pode visualizar o histórico de edição do comentário. O menu suspenso **edited** (editado) na parte superior do comentário tem um histório de edições mostrando o usuário e o horário de cada edição.
|
||||
That said, anyone with read access to a repository can view a comment's edit history. O menu suspenso **edited** (editado) na parte superior do comentário tem um histório de edições mostrando o usuário e o horário de cada edição.
|
||||
|
||||
|
||||
|
||||
## Redacting sensitive information
|
||||
|
||||
Autores do comentário e pessoas com acesso de gravação a um repositório podem excluir informações confidenciais do histórico de edição de um comentário. Para obter mais informações, consulte "[Controlar as alterações em um comentário](/communities/moderating-comments-and-conversations/tracking-changes-in-a-comment)".
|
||||
|
||||
1. Navegue até o comentário que deseja editar.
|
||||
@@ -65,20 +67,22 @@ Autores do comentário e pessoas com acesso de gravação a um repositório pode
|
||||
|
||||
Qualquer pessoa com acesso de gravação em um repositório pode excluir comentários sobre problemas, pull requests e commits. Proprietários de organização, mantenedores de equipes e o autor do comentário também podem excluir um comentário na página da equipe.
|
||||
|
||||
Se o comentário contém algum conteúdo construtivo que contribui para a conversa sobre o problema ou pull request, você pode editar o comentário.
|
||||
|
||||
Excluir um comentário é o seu último recurso como moderador. É apropriado excluir um comentário se todo o comentário não adicionar conteúdo construtivo a uma conversa e violar o código de conduta da sua comunidade{% ifversion fpt or ghec %} ou [Diretrizes da Comunidade](/free-pro-team@latest/github/site-policy/github-community-guidelines){% endif %}.
|
||||
|
||||
Excluir um comentário cria um evento na linha do tempo visível a qualquer um com acesso de leitura no repositório. No entanto, o nome de usuário da pessoa que excluiu o comentário somente pode ser visualizado pelas pessoas com acesso de gravação ao repositório. Para qualquer pessoa sem acesso de gravação, o evento na linha do tempo é anônimo.
|
||||
|
||||
|
||||
|
||||
Se o comentário contém algum conteúdo construtivo que contribui para a conversa sobre o problema ou pull request, você pode editar o comentário.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** o comentário inicial (ou texto) de um problema ou pull request não pode ser excluído. Entretanto, você pode editar textos de problemas e pull requests para remover conteúdo indesejável.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Steps to delete a comment
|
||||
|
||||
1. Navegue até o comentário que deseja excluir.
|
||||
2. No canto superior direito do comentário, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e em **Delete** (Excluir). 
|
||||
3. Opcionalmente, escreva um comentário informando que você deletou o comentário e por quê.
|
||||
|
||||
@@ -11,11 +11,11 @@ versions:
|
||||
shortTitle: Para alunos
|
||||
---
|
||||
|
||||
Usar o {% data variables.product.prodname_dotcom %} nos projetos da sua escola é uma maneira prática de colaborar com outras pessoas e de criar um portfólio que demonstra experiência no mundo real.
|
||||
|
||||
{% data reusables.education.about-github-education-link %}
|
||||
|
||||
Cada pessoa com uma conta do {% data variables.product.prodname_dotcom %} pode colaborar em repositórios públicos e privados ilimitados com o {% data variables.product.prodname_free_user %}. Como estudante, você também pode candidatar-se aos benefícios dos Alunos do GitHub, que inclui acesso ao Campo Global do GitHub, um campus digital para a nossa comunidade de alunos do GitHub para beneficiar-se de alguns dos melhores programas que o GitHub Education tem para oferecer. O Campus Global do GitHub inclui o {% data variables.product.prodname_student_pack %}, que oferece livre acesso a ferramentas e serviços usados pelos desenvolvedores profissionais, além de acessar o conteúdo de [Campus TV](https://www.twitch.tv/githubeducation), eventos de alunos, atividades de sala de aula GitHub e muito mais para ajudar os alunos a atingir seus objetivos técnicos de carreira. Para obter mais informações, consulte "[Aplicar um pacote de desenvolvedor para estudante](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/apply-for-a-student-developer-pack)" e [{% data variables.product.prodname_education %}](https://education.github.com/).
|
||||
Usar o {% data variables.product.prodname_dotcom %} nos projetos da sua escola é uma maneira prática de colaborar com outras pessoas e de criar um portfólio que demonstra experiência no mundo real.
|
||||
|
||||
Cada pessoa com uma conta do {% data variables.product.prodname_dotcom %} pode colaborar em repositórios públicos e privados ilimitados com o {% data variables.product.prodname_free_user %}. As a student, you can also apply for GitHub Student benefits. Para obter mais informações, consulte "[Aplicar um pacote de desenvolvedor para estudante](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/apply-for-a-student-developer-pack)" e [{% data variables.product.prodname_education %}](https://education.github.com/).
|
||||
|
||||
Se você for integrante de um clube de robótica FIRST, seu mentor poderá solicitar um desconto para educador para que sua equipe possa colaborar usando o {% data variables.product.prodname_team %}, que permite repositórios privados e de usuários ilimitados, gratuitamente. Para obter mais informações, consulte "[Aplicar um desconto para educador ou pesquisador](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/apply-for-an-educator-or-researcher-discount)".
|
||||
|
||||
|
||||
@@ -6,6 +6,7 @@ versions:
|
||||
fpt: '*'
|
||||
children:
|
||||
- /integrate-github-classroom-with-an-ide
|
||||
- /using-github-codespaces-with-github-classroom
|
||||
- /about-using-visual-studio-code-with-github-classroom
|
||||
- /about-using-makecode-arcade-with-github-classroom
|
||||
- /replit-with-github-classroom
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user