Skip to content

Commit f999ec3

Browse files
author
Martin Lopes
authored
Merge branch 'main' into avinal-improve-docs
2 parents a0e3146 + acc669a commit f999ec3

202 files changed

Lines changed: 819 additions & 1673 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
{% data variables.product.prodname_actions %} usage is free for public repositories and self-hosted runners. For private repositories, each {% data variables.product.prodname_dotcom %} account receives a certain amount of free minutes and storage, depending on the product used with the account. Any usage beyond the included amounts is controlled by spending limits.
1+
{% data variables.product.prodname_actions %} usage is free for both public repositories and self-hosted runners. For private repositories, each {% data variables.product.prodname_dotcom %} account receives a certain amount of free minutes and storage, depending on the product used with the account. Any usage beyond the included amounts is controlled by spending limits.

translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ redirect_from:
88
versions:
99
free-pro-team: '*'
1010
enterprise-server: '>=2.22'
11-
type: 'tutorial'
1211
---
1312

1413
{% data reusables.actions.enterprise-beta %}
@@ -37,11 +36,7 @@ Para iniciar rapidamente, adicione o modelo ao diretório `.github/workflows` do
3736
```yaml{:copy}
3837
name: Node.js CI
3938
40-
on:
41-
push:
42-
branches: [ $default-branch ]
43-
pull_request:
44-
branches: [ $default-branch ]
39+
on: [push]
4540
4641
jobs:
4742
build:
@@ -50,17 +45,19 @@ jobs:
5045
5146
strategy:
5247
matrix:
53-
node-version: [10.x, 12.x, 14.x, 15.x]
48+
node-version: [8.x, 10.x, 12.x]
5449
5550
steps:
5651
- uses: actions/checkout@v2
5752
- name: Use Node.js ${{ matrix.node-version }}
5853
uses: actions/setup-node@v1
5954
with:
6055
node-version: ${{ matrix.node-version }}
61-
- run: npm ci
56+
- run: npm install
6257
- run: npm run build --if-present
6358
- run: npm test
59+
env:
60+
CI: true
6461
```
6562
{% endraw %}
6663

@@ -72,15 +69,15 @@ A maneira mais fácil de especificar uma versão do Node.js é usar a ação `se
7269

7370
A ação `setup-node` considera uma versão do Node.js como uma entrada e configura essa versão no executor. A ação `setup-node` localiza uma versão específica do Node.js da cache das ferramentas em casa executor e adiciona os binários necessários ao `PATH`, que persiste no resto do trabalho. Usar a ação `setup-node` é a forma recomendada de usar o Node.js com {% data variables.product.prodname_actions %}, pois garante um comportamento consistente nos diferentes executores e nas diferentes versões do Node.js. Se você estiver usando um executor auto-hospedado, você deverá instalar o Node.js e adicioná-lo ao `PATH`.
7471

75-
O modelo inclui uma estratégia matriz que cria e testa seu código com quatro versões de Node.js: 10.x, 12.x, 14.x e 15.x. O "x" é um caractere curinga que corresponde à última versão menor e à versão do patch disponível para uma versão. Cada versão do Node.js especificada na matriz `node-version` cria uma tarefa que executa as mesmas etapas.
72+
O modelo inclui uma estratégia de matriz que cria e testa o seu código com três versões do Node.js: 8.x, 10.x, e 12.x. O "x" é um caractere curinga que corresponde à última versão menor e à versão do patch disponível para uma versão. Cada versão do Node.js especificada na matriz `node-version` cria uma tarefa que executa as mesmas etapas.
7673

7774
Cada trabalho pode acessar o valor definido na matriz `node-version` usando o contexto `matriz`. A ação `setup-node` usa o contexto como entrada de `node-version`. A ação `setup-node` configura cada tarefa com uma versão diferente de Node.js antes de criar e testar o código. Para obter mais informações sobre os contextos e estratégias da matriz, consulte ""[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" e "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)".
7875

7976
{% raw %}
8077
```yaml
8178
strategy:
8279
matrix:
83-
node-version: [10.x, 12.x, 14.x, 15.x]
80+
node-version: [8.x, 10.x, 12.x]
8481

8582
steps:
8683
- uses: actions/checkout@v2
@@ -118,9 +115,11 @@ jobs:
118115
uses: actions/setup-node@v1
119116
with:
120117
node-version: '12.x'
121-
- run: npm ci
118+
- run: npm install
122119
- run: npm run build --if-present
123120
- run: npm test
121+
env:
122+
CI: true
124123
```
125124
{% endraw %}
126125

translations/pt-BR/content/actions/guides/publishing-docker-images.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ redirect_from:
77
versions:
88
free-pro-team: '*'
99
enterprise-server: '>=2.22'
10-
type: 'tutorial'
1110
---
1211

1312
{% data reusables.actions.enterprise-beta %}
@@ -47,7 +46,7 @@ Neste guia, usaremos a ação `build-push-action` do Docker para criar a imagem
4746

4847
No exemplo do fluxo de trabalho abaixo, usamos a ação `build-push-action` do Docker para criar a imagem e, se a construção for bem-sucedida, faça o push da imagem criada para o Docker Hub.
4948

50-
Para fazer push para o Docker Hub, você deverá ter uma conta Docker Hub e ter criado um repositório Docker Hub. Para obter mais informações, consulte "[Fazer push de uma imagem de contêiner do Docker para o Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" na documentação do Docker.
49+
Para fazer push para o Docker Hub, você deverá ter uma conta Docker Hub e ter criado um repositório Docker Hub. For more information, see "[Pushing a Docker container image to Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" in the Docker documentation.
5150

5251
As opções `build-push-action` necessárias para o Docker Hub são:
5352

translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md

Lines changed: 2 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ redirect_from:
88
versions:
99
free-pro-team: '*'
1010
enterprise-server: '>=2.22'
11-
type: 'tutorial'
1211
---
1312

1413
{% data reusables.actions.enterprise-beta %}
@@ -88,28 +87,9 @@ always-auth=true
8887
8988
Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado sempre que ocorre o evento `versão` com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado.
9089
91-
#### Configurar o repositório de destino
90+
Por padrão, o {% data variables.product.prodname_registry %} publica um pacote no repositório {% data variables.product.prodname_dotcom %} que você especificar no campo `nome` do arquivo *package.json*. Por exemplo, você publicaria um pacote denominado `@my-org/test` no repositório `my-org/test` do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) na documentação do npm.
9291
93-
If you don't provide the `repository` key in your *package.json* file, then {% data variables.product.prodname_registry %} publishes a package in the {% data variables.product.prodname_dotcom %} repository you specify in the `name` field of the *package.json* file. Por exemplo, um pacote denominado `@my-org/test` é publicado no `my-org/test` repositório de {% data variables.product.prodname_dotcom %}.
94-
95-
No entanto, se você fornecer a chave `repositório`, o repositório nessa chave será usado como o registro de npm de destino para {% data variables.product.prodname_registry %}. For example, publishing the below *package.json* results in a package named `my-amazing-package` published to the `octocat/my-other-repo` {% data variables.product.prodname_dotcom %} repository.
96-
97-
```json
98-
{
99-
"name": "@octocat/my-amazing-package",
100-
"repository": {
101-
"type": "git",
102-
"url": "https://github.com/octocat/my-other-repo.git"
103-
},
104-
```
105-
106-
#### Efetuar a autenticação no repositório de destino
107-
108-
Para efetuar a autenticação no registro de {% data variables.product.prodname_registry %} no seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN` do seu repositório. Ele é criado automaticamente e tem permissão de _leitura_ e _gravação_ para pacotes no repositório, em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Autenticação em um fluxo de trabalho](/actions/reference/authentication-in-a-workflow)".
109-
110-
Se você quiser publicar seu pacote em um repositório diferente, você deverá usar um token de acesso pessoal (PAT) que tenha permissão para escrever pacotes no repositório de destino. Para obter mais informações, consulte "[Criar um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)" e "[Segredos criptografados](/actions/reference/encrypted-secrets)".
111-
112-
#### Exemplo de fluxo de trabalho
92+
Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)".
11393
11494
Este exemplo armazena o segredo `GITHUB_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`.
11595

translations/pt-BR/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md

Lines changed: 0 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,11 @@ redirect_from:
77
versions:
88
free-pro-team: '*'
99
enterprise-server: '>=2.22'
10-
type: 'tutorial'
1110
---
1211

1312
{% data reusables.actions.enterprise-beta %}
1413
{% data reusables.actions.enterprise-github-hosted-runners %}
1514

16-
Você pode adicionar um executor auto-hospedado a {{ site.data.variables.product.prodname_actions }}.
17-
18-
Se você é um administrador de empresa ou organização, talvez você queira adicionar seus executores auto-hospedados a nível da organização ou empresa. Esta abordagem torna o executor disponível para vários repositórios na sua organização ou empresa, e também permite gerenciar seus executores em um só lugar.
19-
2015
Para obter informações sobre sistemas operacionais compatíveis com executores auto-hospedados ou sobre como usar executores auto-hospedados com um servidor proxy, consulte "[Sobre executores auto-hospedados](/github/automating-your-workflow-with-github-actions/about-self-hosted-runners)."
2116

2217
{% warning %}
@@ -49,8 +44,6 @@ Você pode adicionar executores auto-hospedados no nível da organização, onde
4944
{% data reusables.github-actions.self-hosted-runner-configure %}
5045
{% data reusables.github-actions.self-hosted-runner-check-installation-success %}
5146

52-
{% data reusables.github-actions.self-hosted-runner-public-repo-access %}
53-
5447
### Adicionar um executor auto-hospedado a uma empresa
5548

5649
Você pode adicionar executores auto-hospedados a uma empresa, onde podem ser atribuídos a várias organizações. Os administradores da organização poderão então controlar quais repositórios podem usá-los.
@@ -69,13 +62,3 @@ Para adicionar um executor auto-hospedado no nível de empresa de
6962
1. Clique em **Adicionar novo** e depois clique em **Novo executor**. Novos runners são atribuídos ao grupo padrão. Você pode modificar o grupo do executor depois de registrar o runner (executor). Para obter mais informações, consulte "[Gerenciando acesso a runners auto-hospedados](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)".
7063
{% data reusables.github-actions.self-hosted-runner-configure %}
7164
{% data reusables.github-actions.self-hosted-runner-check-installation-success %}
72-
73-
{% data reusables.github-actions.self-hosted-runner-public-repo-access %}
74-
75-
#### Disponibilizar executores corporativos para repositórios
76-
77-
Por padrão, os executores do grupo de executores "Padrão" de uma empresa estão disponíveis para todas as organizações da empresa, mas não estão disponíveis para todos os repositórios em cada organização.
78-
79-
Para tornar um grupo de executores auto-hospedado de nível empresarial disponível para um repositório da organização, você pode precisar alterar as configurações herdadas da organização para o grupo de executores a fim de tornar o executor disponível para repositórios na organização.
80-
81-
Para mais informações sobre como alterar as configurações de acesso de grupo de executor, consulte "[Gerenciar acesso a executores auto-hospedados usando grupos](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)."

translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
---
22
title: Gerenciar fluxos de trabalhos complexos
33
shortTitle: Gerenciar fluxos de trabalhos complexos
4-
intro: 'Este guia mostra como usar os recursos avançados de {% data variables.product.prodname_actions %}, com gestão de segredo, trabalhos dependentes, cache, matrizes de compilação{{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} ambientes,{% endif %} e etiquetas.'
4+
intro: 'Este guia mostra como usar os recursos avançados de {% data variables.product.prodname_actions %}, com gestão de segredo, trabalhos dependentes, cache, matrizes de compilação{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} ambientes,{% endif %} e etiquetas.'
55
versions:
66
free-pro-team: '*'
77
enterprise-server: '>=2.22'
8-
type: 'how_to'
98
---
109

1110
{% data reusables.actions.enterprise-beta %}
@@ -155,15 +154,6 @@ Para obter mais informações, consulte ["Usar etiquetas com executores auto-ho
155154
Você pode configurar ambientes com regras de proteção e segredos. Cada trabalho em um fluxo de trabalho pode fazer referência a um único ambiente. Todas as regras de proteção configuradas para o ambiente têm de ser aprovadas antes que um trabalho de referência ao ambiente seja enviado a um executor. Para obter mais informações, consulte "[Ambientes](/actions/reference/environments)".
156155
{% endif %}
157156

158-
### Usar um modelo do fluxo de trabalho
159-
160-
{% data reusables.actions.workflow-template-overview %}
161-
162-
{% data reusables.repositories.navigate-to-repo %}
163-
{% data reusables.repositories.actions-tab %}
164-
1. Caso o seu repositório tenha fluxos de trabalho existentes: No canto superior esquerdo, clique em **Novo fluxo de trabalho**. ![Criar um novo fluxo de trabalho](/assets/images/help/repository/actions-new-workflow.png)
165-
1. Sob, nome do template que você gostaria de usar, clique em **Configurar este fluxo de trabalho**. ![Configurar este fluxo de trabalho](/assets/images/help/settings/actions-create-starter-workflow.png)
166-
167157
### Próximas etapas
168158

169159
Para continuar aprendendo sobre {% data variables.product.prodname_actions %}, consulte "[Compartilhar fluxos de trabalho com a sua organização](/actions/learn-github-actions/sharing-workflows-with-your-organization)".

translations/pt-BR/content/actions/learn-github-actions/sharing-workflows-with-your-organization.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ redirect_from:
77
versions:
88
free-pro-team: '*'
99
enterprise-server: '>=2.22'
10-
type: 'how_to'
1110
---
1211

1312
{% data reusables.actions.enterprise-beta %}
@@ -45,10 +44,10 @@ Este procedimento demonstra como criar um modelo de fluxo de trabalho e um arqui
4544
runs-on: ubuntu-latest
4645

4746
steps:
48-
- uses: actions/checkout@v2
47+
- uses: actions/checkout@v2
4948

50-
- name: Run a one-line script
51-
run: echo Hello from Octo Organization
49+
- name: Run a one-line script
50+
run: echo Hello from Octo Organization
5251
```
5352
1. Crie um arquivo de metadados dentro do diretório `workflow-templates`. O arquivo de metadados deve ter o mesmo nome do arquivo de fluxo de trabalho, mas em vez da extensão `.yml`, deve-se adicionar `.properties.json`. Por exemplo, este arquivo denominado `octo-organization-ci.properties.json` contém os metadados para um arquivo de fluxo de trabalho denominado `octo-organization-ci.yml`:
5453
```yaml
@@ -76,7 +75,7 @@ Para adicionar outro modelo de fluxo de trabalho, adicione seus arquivos ao mesm
7675

7776
![Arquivos do modelo do fluxo de trabalho](/assets/images/help/images/workflow-template-files.png)
7877

79-
### Usar um modelo de fluxo de trabalho da sua organização
78+
### Usar um modelo do fluxo de trabalho
8079

8180
Este procedimento demonstra como um membro da sua organização pode localizar e usar um modelo de fluxo de trabalho para criar um novo fluxo de trabalho. Os modelos de fluxo de trabalho de uma organização podem ser usados por qualquer pessoa que seja integrante da organização.
8281

0 commit comments

Comments
 (0)