diff --git a/translations/log/pt-resets.csv b/translations/log/pt-resets.csv index 1ff8babf21..1fbd6e708e 100644 --- a/translations/log/pt-resets.csv +++ b/translations/log/pt-resets.csv @@ -10,6 +10,7 @@ translations/pt-BR/content/actions/advanced-guides/storing-workflow-data-as-arti translations/pt-BR/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md,rendering error translations/pt-BR/content/actions/automating-builds-and-tests/building-and-testing-python.md,rendering error translations/pt-BR/content/actions/creating-actions/creating-a-javascript-action.md,rendering error +translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md,rendering error translations/pt-BR/content/actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services.md,rendering error translations/pt-BR/content/actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-azure.md,rendering error translations/pt-BR/content/actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform.md,rendering error @@ -23,6 +24,8 @@ translations/pt-BR/content/actions/hosting-your-own-runners/removing-self-hosted translations/pt-BR/content/actions/hosting-your-own-runners/using-a-proxy-server-with-self-hosted-runners.md,rendering error translations/pt-BR/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md,Listed in localization-support#489 translations/pt-BR/content/actions/hosting-your-own-runners/using-self-hosted-runners-in-a-workflow.md,rendering error +translations/pt-BR/content/actions/learn-github-actions/contexts.md,rendering error +translations/pt-BR/content/actions/learn-github-actions/environment-variables.md,rendering error translations/pt-BR/content/actions/learn-github-actions/expressions.md,rendering error translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md,Listed in localization-support#489 translations/pt-BR/content/actions/learn-github-actions/managing-complex-workflows.md,rendering error @@ -67,6 +70,7 @@ translations/pt-BR/content/admin/github-actions/managing-access-to-actions-from- translations/pt-BR/content/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md,rendering error translations/pt-BR/content/admin/github-actions/using-github-actions-in-github-ae/index.md,rendering error translations/pt-BR/content/admin/guides.md,rendering error +translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md,rendering error translations/pt-BR/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md,rendering error translations/pt-BR/content/admin/user-management/managing-organizations-in-your-enterprise/creating-teams.md,rendering error translations/pt-BR/content/admin/user-management/managing-repositories-in-your-enterprise/configuring-git-large-file-storage-for-your-enterprise.md,rendering error @@ -106,9 +110,11 @@ translations/pt-BR/content/code-security/supply-chain-security/understanding-you translations/pt-BR/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md,rendering error translations/pt-BR/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md,rendering error translations/pt-BR/content/codespaces/customizing-your-codespace/index.md,rendering error +translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md,rendering error translations/pt-BR/content/codespaces/customizing-your-codespace/prebuilding-codespaces-for-your-project.md,rendering error translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces.md,rendering error translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-default-region-for-codespaces.md,rendering error +translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces.md,rendering error translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md,rendering error translations/pt-BR/content/codespaces/developing-in-codespaces/creating-a-codespace.md,rendering error translations/pt-BR/content/codespaces/developing-in-codespaces/deleting-a-codespace.md,rendering error @@ -196,7 +202,6 @@ translations/pt-BR/content/issues/trying-out-the-new-projects-experience/customi translations/pt-BR/content/issues/trying-out-the-new-projects-experience/managing-access-to-projects.md,rendering error translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md,Listed in localization-support#489 translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md,parsing error -translations/pt-BR/content/organizations/keeping-your-organization-secure/reviewing-the-audit-log-for-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md,rendering error @@ -241,7 +246,6 @@ translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-f translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md,rendering error translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics.md,rendering error translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md,parsing error -translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md,rendering error translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository.md,rendering error translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository.md,rendering error translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md,rendering error diff --git a/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md b/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md index feb40a9f96..82ae1473e6 100644 --- a/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md +++ b/translations/pt-BR/content/actions/creating-actions/metadata-syntax-for-github-actions.md @@ -1,7 +1,7 @@ --- -title: Sintaxe de metadados para o GitHub Actions -shortTitle: Sintaxe dos metadados -intro: Você pode criar ações para executar tarefas no repositório. As ações requerem um arquivo de metadados que usa sintaxe YAML. +title: Metadata syntax for GitHub Actions +shortTitle: Metadata syntax +intro: You can create actions to perform tasks in your repository. Actions require a metadata file that uses YAML syntax. redirect_from: - /articles/metadata-syntax-for-github-actions - /github/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions @@ -19,31 +19,31 @@ type: reference {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -## Sobre sintaxe YAML para o {% data variables.product.prodname_actions %} +## About YAML syntax for {% data variables.product.prodname_actions %} -Ações Docker e JavaScript requerem um arquivo de metadados. O nome do arquivo dos metadados deve ser `action.yml` ou `action.yaml`. Os dados no arquivo de metadados definem as entradas, as saídas e o ponto de entrada principal para sua ação. +Docker and JavaScript actions require a metadata file. The metadata filename must be either `action.yml` or `action.yaml`. The data in the metadata file defines the inputs, outputs and main entrypoint for your action. -Arquivos de metadados de ação usam a sintaxe YAML. Se você não souber o que é YAML, consulte "[Aprender a usar YAML em cinco minutos](https://www.codeproject.com/Articles/1214409/Learn-YAML-in-five-minutes)". +Action metadata files use YAML syntax. If you're new to YAML, you can read "[Learn YAML in five minutes](https://www.codeproject.com/Articles/1214409/Learn-YAML-in-five-minutes)." ## `name` -**Necessário**: O nome de sua ação. O {% data variables.product.prodname_dotcom %} exibe o `nome` na aba **Ações** para facilitar a identificação visual das ações em cada trabalho. +**Required** The name of your action. {% data variables.product.prodname_dotcom %} displays the `name` in the **Actions** tab to help visually identify actions in each job. -## `autor` +## `author` -**Opcional**: O nome do autor da ação. +**Optional** The name of the action's author. -## `descrição` +## `description` -**Necessário**: uma descrição curta da ação. +**Required** A short description of the action. ## `inputs` -**Opcional**: parâmetros de entrada permitem que você especifique os dados que a ação espera usar no momento da execução. O {% data variables.product.prodname_dotcom %} armazena parâmetros como variáveis de ambiente. Identificações de entrada com letras maiúsculas são alteradas para letras minúsculas no momento da execução. Recomenda-se usar identificações de entrada com letras minúsculas. +**Optional** Input parameters allow you to specify data that the action expects to use during runtime. {% data variables.product.prodname_dotcom %} stores input parameters as environment variables. Input ids with uppercase letters are converted to lowercase during runtime. We recommended using lowercase input ids. -### Exemplo +### Example -Este exemplo configura duas entradas: numOctocats e octocatEyeColor. A entrada numOctocats não é necessária e assumirá o valor '1'. A entrada octocatEyeColor é necessária e não tem valor padrão. Arquivos de fluxo de trabalho que usam essa ação devem usar a palavra-chave `with` (com) para definir um valor de entrada para octocatEyeColor. Para obter mais informações sobre a sintaxe `with` (com), consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)". +This example configures two inputs: numOctocats and octocatEyeColor. The numOctocats input is not required and will default to a value of '1'. The octocatEyeColor input is required and has no default value. Workflow files that use this action must use the `with` keyword to set an input value for octocatEyeColor. For more information about the `with` syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepswith)." ```yaml inputs: @@ -56,61 +56,61 @@ inputs: required: true ``` -Quando você especifica uma entrada em um arquivo de fluxo de trabalho ou usar um valor de entrada padrão, o {% data variables.product.prodname_dotcom %} criará uma variável de ambiente para a entrada com o nome `INPUT_`. A variável de ambiente criada altera os nomes de entrada para letras maiúsculas e substitui espaços por caracteres `_`. +When you specify an input in a workflow file or use a default input value, {% data variables.product.prodname_dotcom %} creates an environment variable for the input with the name `INPUT_`. The environment variable created converts input names to uppercase letters and replaces spaces with `_` characters. -Se a ação for escrita usando um [composto](/actions/creating-actions/creating-a-composite-action), ela não receberá `INPUT_` automaticamente. Se não ocorrer a conversão, você poderá alterar estas entradas manualmente. +If the action is written using a [composite](/actions/creating-actions/creating-a-composite-action), then it will not automatically get `INPUT_`. If the conversion doesn't occur, you can change these inputs manually. -Para acessar a variável de ambiente em uma ação do contêiner do Docker, você deverá passar a entrada usando a palavra-chave `args` no arquivo de metadados da ação. Para obter mais informações sobre o arquivo de metadados de ação para ações de contêiner do Docker, consulte "[Criar uma ação de contêiner do Docker](/articles/creating-a-docker-container-action#creating-an-action-metadata-file)". +To access the environment variable in a Docker container action, you must pass the input using the `args` keyword in the action metadata file. For more information about the action metadata file for Docker container actions, see "[Creating a Docker container action](/articles/creating-a-docker-container-action#creating-an-action-metadata-file)." -Por exemplo, se um fluxo de trabalho definiu as entradas `numOctocats` e `octocatEyeColor`, o código de ação poderia ler os valores das entradas usando as variáveis de ambiente do `INPUT_NUMTOCATS` e `INPUT_OCTOCATEYECOLOR`. +For example, if a workflow defined the `numOctocats` and `octocatEyeColor` inputs, the action code could read the values of the inputs using the `INPUT_NUMOCTOCATS` and `INPUT_OCTOCATEYECOLOR` environment variables. ### `inputs.` -**Necessário**: um identificador `string` para associar à entrada. O valor de `` é um mapa dos metadados da entrada. `` deve ser um identificador único dentro do objeto `inputs` (entradas). `` deve iniciar com uma letra ou `_` e conter somente caracteres alfanuméricos, `-` ou `_`. +**Required** A `string` identifier to associate with the input. The value of `` is a map of the input's metadata. The `` must be a unique identifier within the `inputs` object. The `` must start with a letter or `_` and contain only alphanumeric characters, `-`, or `_`. ### `inputs..description` -**Necessário**: descrição de `string` do parâmetro de entrada. +**Required** A `string` description of the input parameter. ### `inputs..required` -**Necessário**: um `booleano` para indicar se a ação exige o parâmetro de entrada. Defina para `true` quando o parâmetro for necessário. +**Required** A `boolean` to indicate whether the action requires the input parameter. Set to `true` when the parameter is required. ### `inputs..default` -**Opcional**: uma `string` que representa o valor padrão. O valor padrão é usado quando um parâmetro de entrada não é especificado em um arquivo de fluxo de trabalho. +**Optional** A `string` representing the default value. The default value is used when an input parameter isn't specified in a workflow file. ### `inputs..deprecationMessage` -**Opcional** Se o parâmetro de entrada for usado, esta `string` será registrada como uma mensagem de aviso. Você pode usar este aviso para notificar os usuários de que o valor de entrada está obsoleto e mencionar outras alternativas. +**Optional** If the input parameter is used, this `string` is logged as a warning message. You can use this warning to notify users that the input is deprecated and mention any alternatives. -## `outputs (saídas)` +## `outputs` -**Opcional** Os parâmetros de saída permitem que você declare os dados definidos por uma ação. As ações executadas posteriormente em um fluxo de trabalho podem usar os dados de saída definidos em ações executadas anteriormente. Por exemplo, se uma ação executou a adição de duas entradas (x + y = z), a ação poderia usar o resultado da soma (z) como entrada em outras ações. +**Optional** Output parameters allow you to declare data that an action sets. Actions that run later in a workflow can use the output data set in previously run actions. For example, if you had an action that performed the addition of two inputs (x + y = z), the action could output the sum (z) for other actions to use as an input. -Se você não declarar uma saída no seu arquivo de metadados de ação, você ainda poderá definir as saídas e usá-las no seu fluxo de trabalho. Para obter mais informações sobre a definição de saídas em uma ação, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-output-parameter)." +If you don't declare an output in your action metadata file, you can still set outputs and use them in a workflow. For more information on setting outputs in an action, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-output-parameter)." -### Exemplo +### Example ```yaml -saídas: - soma: número do ID da saída - descrição: 'Soma das entradas' +outputs: + sum: # id of the output + description: 'The sum of the inputs' ``` ### `outputs.` -**Necessário**: um identificador `string` para associar à saída. O valor de `` é um mapa dos metadados de saída. `` deve ser um identificador único dentro do objeto `outputs` (saídas). `` deve iniciar com uma letra ou `_` e conter somente caracteres alfanuméricos, `-` ou `_`. +**Required** A `string` identifier to associate with the output. The value of `` is a map of the output's metadata. The `` must be a unique identifier within the `outputs` object. The `` must start with a letter or `_` and contain only alphanumeric characters, `-`, or `_`. ### `outputs..description` -**Necessário**: descrição de `string` do parâmetro de saída. +**Required** A `string` description of the output parameter. -## `outputs` para ações compostas +## `outputs` for composite actions -As **saídas** `opcionais` usam os mesmos parâmetros que `outputs.` e `outputs..description` (veja "[`saídas` para {% data variables.product.prodname_actions %}](/actions/creating-actions/metadata-syntax-for-github-actions#outputs)"), mas também inclui o token do `valor`. +**Optional** `outputs` use the same parameters as `outputs.` and `outputs..description` (see "[`outputs` for {% data variables.product.prodname_actions %}](/actions/creating-actions/metadata-syntax-for-github-actions#outputs)"), but also includes the `value` token. -### Exemplo +### Example {% raw %} ```yaml @@ -129,38 +129,45 @@ runs: ### `outputs..value` -**Obrigatório** O valor com o qual o parâmetro de saída será mapeado. Você pode defini-lo como uma `string` ou uma expressão com contexto. Por exemplo, você pode usar o contexto das `etapas` para definir o `valor` de uma saída como o valor de saída de uma etapa. +**Required** The value that the output parameter will be mapped to. You can set this to a `string` or an expression with context. For example, you can use the `steps` context to set the `value` of an output to the output value of a step. -Para obter mais informações sobre como usar a sintaxe de contexto, consulte "[Contextos](/actions/learn-github-actions/contexts)". +For more information on how to use context syntax, see "[Contexts](/actions/learn-github-actions/contexts)." -## `runs` para ações de JavaScript +## `runs` -**Obrigatório** Configura o caminho para o código da ação e o aplicativo usado para executar o código. +**Required** Specifies whether this is a JavaScript action, a composite action or a Docker action and how the action is executed. -### Exemplo usando Node.js +## `runs` for JavaScript actions + +**Required** Configures the path to the action's code and the runtime used to execute the code. + +### Example using Node.js v12 ```yaml -executa: +runs: using: 'node12' main: 'main.js' ``` ### `runs.using` -**Obrigatório** O aplicativo usado para executar o código especificado em [`principal`](#runsmain). +**Required** The runtime used to execute the code specified in [`main`](#runsmain). + +- Use `node12` for Node.js v12. +- Use `node16` for Node.js v16. ### `runs.main` -**Obrigatório** O arquivo que contém o código da ação. O aplicativo especificado em [`usando`](#runsusing) executa este arquivo. +**Required** The file that contains your action code. The runtime specified in [`using`](#runsusing) executes this file. ### `pre` -**Opcional** Permite que você execute um script no início de um trabalho antes de a ação `main:` começar. Por exemplo, você pode usar `pre:` para executar um pré-requisito da configuração do script. O aplicativo especificado com a sintaxe [`using`](#runsusing) executará esse arquivo. A ação `pre:` é sempre executada como padrão, mas você pode substituí-la usando [`pre-if`](#pre-if). +**Optional** Allows you to run a script at the start of a job, before the `main:` action begins. For example, you can use `pre:` to run a prerequisite setup script. The runtime specified with the [`using`](#runsusing) syntax will execute this file. The `pre:` action always runs by default but you can override this using [`pre-if`](#pre-if). -Neste exemplo, a ação `pre:` executa um script denominado `setup.js.`: +In this example, the `pre:` action runs a script called `setup.js`: ```yaml -executa: +runs: using: 'node12' pre: 'setup.js' main: 'index.js' @@ -169,9 +176,10 @@ executa: ### `pre-if` -**Opcional** Permite que você defina condições para a execução da ação `pre:`. A ação `pre:` será executada apenas se as condições em `pre-if` forem atendidas. Se não forem definidas, o padrão de `pre-if` será `sempre()`. Observe que o contexto da `etapa` está indisponível, uma vez que nenhuma etapa foi executada ainda. +**Optional** Allows you to define conditions for the `pre:` action execution. The `pre:` action will only run if the conditions in `pre-if` are met. If not set, then `pre-if` defaults to `always()`. +Note that the `step` context is unavailable, as no steps have run yet. -Neste exemplo, o `cleanup.js` é executado apenas nos executores baseados no Linux: +In this example, `cleanup.js` only runs on Linux-based runners: ```yaml pre: 'cleanup.js' @@ -180,52 +188,52 @@ Neste exemplo, o `cleanup.js` é executado apenas nos executores baseados no Lin ### `post` -**Opcional** Permite que você execute um script no final do trabalho, uma vez que a ação `main:` foi finalizada. Por exemplo, você pode usar `post:` para encerrar uns processos ou remover arquivos desnecessários. O aplicativo especificado com a sintaxe [`using`](#runsusing) executará esse arquivo. +**Optional** Allows you to run a script at the end of a job, once the `main:` action has completed. For example, you can use `post:` to terminate certain processes or remove unneeded files. The runtime specified with the [`using`](#runsusing) syntax will execute this file. -Neste exemplo, a ação `post:` executa um script chamado `cleanup.js`: +In this example, the `post:` action runs a script called `cleanup.js`: ```yaml -executa: +runs: using: 'node12' main: 'index.js' post: 'cleanup.js' ``` -A ação `post:` é executada sempre por padrão, mas você pode substituí-la usando `post-if`. +The `post:` action always runs by default but you can override this using `post-if`. ### `post-if` -**Opcional** Permite que você defina condições para a execução da ação `post:`. A ação `post:` só será executada se as condições em `post-if` forem atendidas. Se não forem definidas, o padrão de `post-if` será `sempre()`. +**Optional** Allows you to define conditions for the `post:` action execution. The `post:` action will only run if the conditions in `post-if` are met. If not set, then `post-if` defaults to `always()`. -Por exemplo, este `cleanup.js` só será executado em executores baseados no Linux: +For example, this `cleanup.js` will only run on Linux-based runners: ```yaml post: 'cleanup.js' post-if: runner.os == 'linux' ``` -## `runs` para ações compostas +## `runs` for composite actions -**Obrigatório** Configura o caminho para a ação composta, e o aplicativo usado para executar o código. +**Required** Configures the path to the composite action. ### `runs.using` -**Obrigatório** Para usar uma ação composta, defina-o como `"cmposto"`. +**Required** You must set this value to `'composite'`. ### `runs.steps` {% ifversion fpt or ghes > 3.2 or ghae-issue-4853 or ghec %} -**Obrigatório** As etapas de que você planeja executar nesta ação. Elas podem ser etapas de `run` ou etapas de `uses`. +**Required** The steps that you plan to run in this action. These can be either `run` steps or `uses` steps. {% else %} -**Obrigatório** As etapas de que você planeja executar nesta ação. +**Required** The steps that you plan to run in this action. {% endif %} #### `runs.steps[*].run` {% ifversion fpt or ghes > 3.2 or ghae-issue-4853 or ghec %} -**Optional** O comando que você deseja executar. Isso pode ser inline ou um script no seu repositório de ação: +**Optional** The command you want to run. This can be inline or a script in your action repository: {% else %} -**Obrigatório** O comando que você deseja executar. Isso pode ser inline ou um script no seu repositório de ação: +**Required** The command you want to run. This can be inline or a script in your action repository: {% endif %} {% raw %} @@ -238,7 +246,7 @@ runs: ``` {% endraw %} -Como alternativa, você pode usar `$GITHUB_ACTION_PATH`: +Alternatively, you can use `$GITHUB_ACTION_PATH`: ```yaml runs: @@ -248,43 +256,43 @@ runs: shell: bash ``` -Para obter mais informações, consulte "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". +For more information, see "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". #### `runs.steps[*].shell` {% ifversion fpt or ghes > 3.2 or ghae-issue-4853 or ghec %} -**Opcional** O shell onde você deseja executar o comando. Você pode usar qualquer um dos shells listados [aqui](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). Obrigatório se `run` estiver configurado. +**Optional** The shell where you want to run the command. You can use any of the shells listed [here](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). Required if `run` is set. {% else %} -**Obrigatório** O shell onde você quer executar o comando. Você pode usar qualquer um dos shells listados [aqui](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). Obrigatório se `run` estiver configurado. +**Required** The shell where you want to run the command. You can use any of the shells listed [here](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). Required if `run` is set. {% endif %} #### `runs.steps[*].name` -**Opcional** O nome da etapa composta. +**Optional** The name of the composite step. #### `runs.steps[*].id` -**Opcional** Um identificador único para a etapa. Você pode usar `id` para fazer referência à etapa em contextos. Para obter mais informações, consulte "[Contextos](/actions/learn-github-actions/contexts)". +**Optional** A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Contexts](/actions/learn-github-actions/contexts)." #### `runs.steps[*].env` -**Opcional** Define um `mapa` de variáveis de ambiente apenas para essa etapa. Se você deseja modificar a variável de ambiente armazenada no fluxo de trabalho, use `eco "{name}={value}" >> $GITHUB_ENV` em uma etapa composta. +**Optional** Sets a `map` of environment variables for only that step. If you want to modify the environment variable stored in the workflow, use `echo "{name}={value}" >> $GITHUB_ENV` in a composite step. #### `runs.steps[*].working-directory` -**Opcional** Especifica o diretório de trabalho onde o comando é executado. +**Optional** Specifies the working directory where the command is run. {% ifversion fpt or ghes > 3.2 or ghae-issue-4853 or ghec %} #### `runs.steps[*].uses` -**Opcional** Seleciona uma ação a ser executada como parte de uma etapa do seu trabalho. A ação é uma unidade reutilizável de código. Você pode usar uma ação definida no mesmo repositório que o fluxo de trabalho, um repositório público ou em uma [imagem publicada de contêiner Docker](https://hub.docker.com/). +**Optional** Selects an action to run as part of a step in your job. An action is a reusable unit of code. You can use an action defined in the same repository as the workflow, a public repository, or in a [published Docker container image](https://hub.docker.com/). -É altamente recomendável incluir a versão da ação que você está usando ao especificar um número de tag Docker, SHA ou ref do Git. Se você não especificar uma versão, ela poderá interromper seus fluxos de trabalho ou causar um comportamento inesperado quando o proprietário da ação publicar uma atualização. -- Usar o commit SHA de uma versão de ação lançada é a maneira mais garantida de obter estabilidade e segurança. -- Usar a versão principal da ação permite receber correções importantes e patches de segurança sem perder a compatibilidade. Fazer isso também garante o funcionamento contínuo do fluxo de trabalho. -- Usar o branch-padrão de uma ação pode ser conveniente, mas se alguém lançar uma nova versão principal com uma mudança significativa, seu fluxo de trabalho poderá ter problemas. +We strongly recommend that you include the version of the action you are using by specifying a Git ref, SHA, or Docker tag number. If you don't specify a version, it could break your workflows or cause unexpected behavior when the action owner publishes an update. +- Using the commit SHA of a released action version is the safest for stability and security. +- Using the specific major action version allows you to receive critical fixes and security patches while still maintaining compatibility. It also assures that your workflow should still work. +- Using the default branch of an action may be convenient, but if someone releases a new major version with a breaking change, your workflow could break. -Algumas ações requerem entradas que devem ser definidas com a palavra-chave [`com`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepswith). Revise o arquivo README da ação para determinar as entradas obrigatórias. +Some actions require inputs that you must set using the [`with`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepswith) keyword. Review the action's README file to determine the inputs required. ```yaml runs: @@ -310,7 +318,7 @@ runs: #### `runs.steps[*].with` -**Opcional** Um `mapa` dos parâmetros de entrada definidos pela ação. Cada parâmetro de entrada é um par chave/valor. Parâmetros de entrada são definidos como variáveis de ambiente. A variável é precedida por INPUT_ e convertida em letras maiúsculas. +**Optional** A `map` of the input parameters defined by the action. Each input parameter is a key/value pair. Input parameters are set as environment variables. The variable is prefixed with INPUT_ and converted to upper case. ```yaml runs: @@ -325,11 +333,11 @@ runs: ``` {% endif %} -## `runs` para ações do Docker +## `runs` for Docker actions -**Obrigatório** Configura a imagem usada para a ação Docker. +**Required** Configures the image used for the Docker action. -### Exemplos de uso do arquivo Docker no repositório +### Example using a Dockerfile in your repository ```yaml runs: @@ -337,7 +345,7 @@ runs: image: 'Dockerfile' ``` -### Exemplo usando um contêiner de registro Docker público +### Example using public Docker registry container ```yaml runs: @@ -347,15 +355,15 @@ runs: ### `runs.using` -**Obrigatório** Você deve definir este valor como `'docker'`. +**Required** You must set this value to `'docker'`. ### `pre-entrypoint` -**Opcional** Permite que você execute um script antes de a ação do `entrypoint` começar. Por exemplo, você pode usar o `pre-entrypoint:` para executar um pré-requisito do script da configuração. {% data variables.product.prodname_actions %} usa a `execução do docker` para lançar esta ação e executa o script dentro de um novo contêiner que usa a mesma imagem-base. Isso significa que o momento de execução é diferente do contêiner principal do `entrypoint` e qualquer status de que você precisar devem ser acessado na área de trabalho, em `HOME`, ou como uma variável `STATE_`. A ação `pre-entrypoint:` é sempre executada por padrão, mas você pode substituí-la usando [`pre-if`](#pre-if). +**Optional** Allows you to run a script before the `entrypoint` action begins. For example, you can use `pre-entrypoint:` to run a prerequisite setup script. {% data variables.product.prodname_actions %} uses `docker run` to launch this action, and runs the script inside a new container that uses the same base image. This means that the runtime state is different from the main `entrypoint` container, and any states you require must be accessed in either the workspace, `HOME`, or as a `STATE_` variable. The `pre-entrypoint:` action always runs by default but you can override this using [`pre-if`](#pre-if). -O aplicativo especificado com a sintaxe [`using`](#runsusing) executará esse arquivo. +The runtime specified with the [`using`](#runsusing) syntax will execute this file. -Neste exemplo, a ação `pre-entrypoint:` executa um script denominado `setup.sh`: +In this example, the `pre-entrypoint:` action runs a script called `setup.sh`: ```yaml runs: @@ -369,21 +377,21 @@ runs: ### `runs.image` -**Obrigatório ** A imagem do Docker a ser usada como contêiner para executar a ação. O valor pode ser o nome da imagem de base do Docker, um `arquivo Docker` local no seu repositório u uma imagem pública no Docker Hub ou outro registro. Para fazer referência a um `arquivo Docker` local no seu repositório, o arquivo precisa ser denominado `arquivo Docker` e você precisa usar um caminho relativo ao seu arquivo de metadados de ação. O aplicativo do `docker` executará este arquivo. +**Required** The Docker image to use as the container to run the action. The value can be the Docker base image name, a local `Dockerfile` in your repository, or a public image in Docker Hub or another registry. To reference a `Dockerfile` local to your repository, the file must be named `Dockerfile` and you must use a path relative to your action metadata file. The `docker` application will execute this file. ### `runs.env` -**Opcional** Especifica um mapa da chave/valor das variáveis do ambiente a serem definidas no ambiente do contêiner. +**Optional** Specifies a key/value map of environment variables to set in the container environment. ### `runs.entrypoint` -**Opcional** Substitui o `ENTRYPOINT` do Docker no `arquivo Docker` ou o define, caso nenhum já tenha sido especificado. Use o `entrypoint` quando o `arquivo Docker` não especificar um `ENTRYPOINT` ou você desejar substituir a instrução do`ENTRYPOINT`. Se você omitir o `entrypoint`, serão executados os comandos que você especificar na instrução do `ENTRYPOINT` do Docker. A instrução do `ENTRYPOINT` do Docker tem forma de _shell_ e forma de _exec_. A documentação do `ENTRYPOINT` do docker recomenda o uso da forma _exec_ da instrução do `ENTRYPOINT`. +**Optional** Overrides the Docker `ENTRYPOINT` in the `Dockerfile`, or sets it if one wasn't already specified. Use `entrypoint` when the `Dockerfile` does not specify an `ENTRYPOINT` or you want to override the `ENTRYPOINT` instruction. If you omit `entrypoint`, the commands you specify in the Docker `ENTRYPOINT` instruction will execute. The Docker `ENTRYPOINT` instruction has a _shell_ form and _exec_ form. The Docker `ENTRYPOINT` documentation recommends using the _exec_ form of the `ENTRYPOINT` instruction. -Para obter mais informações sobre como o `entrypoint` é executado, consulte "[Suporte do arquivo Docker para {% data variables.product.prodname_actions %}](/actions/creating-actions/dockerfile-support-for-github-actions/#entrypoint)". +For more information about how the `entrypoint` executes, see "[Dockerfile support for {% data variables.product.prodname_actions %}](/actions/creating-actions/dockerfile-support-for-github-actions/#entrypoint)." ### `post-entrypoint` -**Opcional**Permite que você execute um script de cleanup, uma vez finalizada a ação`runs.entrypoint`. {% data variables.product.prodname_actions %} usa a `execução do docker` para lançar esta ação. Porque {% data variables.product.prodname_actions %} executa o script dentro de um novo contêiner usando a mesma imagem-base, o estado do momento da execução é diferente do contêiner principal do `entrypoint`. Você pode acessar qualquer estado que precisar na área de trabalho, em `HOME` ou como variável `STATE_`. A ação `post-entrypoint:` é sempre executada por padrão, mas você pode substituí-la usando [`post-if`](#post-if). +**Optional** Allows you to run a cleanup script once the `runs.entrypoint` action has completed. {% data variables.product.prodname_actions %} uses `docker run` to launch this action. Because {% data variables.product.prodname_actions %} runs the script inside a new container using the same base image, the runtime state is different from the main `entrypoint` container. You can access any state you need in either the workspace, `HOME`, or as a `STATE_` variable. The `post-entrypoint:` action always runs by default but you can override this using [`post-if`](#post-if). ```yaml runs: @@ -397,17 +405,17 @@ runs: ### `runs.args` -**Opcional** Um array de strings que define as entradas para um contêiner Docker. As entradas podem incluir strings com codificação rígida. O {% data variables.product.prodname_dotcom %} entrega os `args` ao `ENTRYPOINT` do contêiner quando o contêiner inicia. +**Optional** An array of strings that define the inputs for a Docker container. Inputs can include hardcoded strings. {% data variables.product.prodname_dotcom %} passes the `args` to the container's `ENTRYPOINT` when the container starts up. -`args` são usados em substituição à instrução `CMD` em um `Dockerfile`. Se você usar `CMD` no `Dockerfile`, use as diretrizes ordenadas por preferência: +The `args` are used in place of the `CMD` instruction in a `Dockerfile`. If you use `CMD` in your `Dockerfile`, use the guidelines ordered by preference: {% data reusables.github-actions.dockerfile-guidelines %} -Se você precisar passar variáveis de ambiente para uma ação, certifique-se de que sua ação executa um shell de comando para realizar a substituição de variáveis. Por exemplo, se seu atributo `entrypoint` é definido como `"sh -c"`, os `args` serão executados em um terminal de comando. Como alternativa, se o seu `arquivo Docker` usar um `Entrypoint` para executar o mesmo comando (`"sh-c"`), os `Args` serão executado em um shell de comando. +If you need to pass environment variables into an action, make sure your action runs a command shell to perform variable substitution. For example, if your `entrypoint` attribute is set to `"sh -c"`, `args` will be run in a command shell. Alternatively, if your `Dockerfile` uses an `ENTRYPOINT` to run the same command (`"sh -c"`), `args` will execute in a command shell. -Para obter mais informações sobre o uso da instrução `CMD` com {% data variables.product.prodname_actions %}, consulte "[Suporte do arquivo Docker para {% data variables.product.prodname_actions %}](/actions/creating-actions/dockerfile-support-for-github-actions/#cmd)". +For more information about using the `CMD` instruction with {% data variables.product.prodname_actions %}, see "[Dockerfile support for {% data variables.product.prodname_actions %}](/actions/creating-actions/dockerfile-support-for-github-actions/#cmd)." -#### Exemplo +#### Example {% raw %} ```yaml @@ -421,11 +429,11 @@ runs: ``` {% endraw %} -## `branding (marca)` +## `branding` -Você pode usar uma cor e o ícone da [Pena](https://feathericons.com/) para criar um selo para personalizar e distinguir a sua ação. Os selos são exibidos ao lado do nome da sua ação em [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). +You can use a color and [Feather](https://feathericons.com/) icon to create a badge to personalize and distinguish your action. Badges are shown next to your action name in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions). -### Exemplo +### Example ```yaml branding: @@ -435,399 +443,399 @@ branding: ### `branding.color` -Cor de fundo do selo. Pode ser: `branco`, `amarelo`, `azul`, `verde`, `laranja`, `vermelho`, `roxo` ou `cinza-escuro`. +The background color of the badge. Can be one of: `white`, `yellow`, `blue`, `green`, `orange`, `red`, `purple`, or `gray-dark`. ### `branding.icon` -Nome do ícone [Feather](https://feathericons.com/) (pena) para usar. +The name of the [Feather](https://feathericons.com/) icon to use. - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - + + + - - - - + + + + - - - - + + + + - - + + - + - - - - + + + + - - - + + + - - - - + + + + - - - + + + - - - + + + - - - + + + - - + + - - - - + + + + - - - - + + + + - - + + - - + + - + - - + + - - + + - + - - + + - + - + - - + + - - + + - + - + - - + + - - - - + + + + - - - + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - + + + - - + + - + - - - - + + + + - - - - + + + + - - - + + + - - - - + + + + - - - + + + - + - - - - + + + + - - - - + + + + - - + + - + - - - - + + + + - - - - + + + + - - + + - + - - + + - - + + - - - + + + - - - + + + - + diff --git a/translations/pt-BR/content/actions/learn-github-actions/contexts.md b/translations/pt-BR/content/actions/learn-github-actions/contexts.md index e4522fa917..670876a830 100644 --- a/translations/pt-BR/content/actions/learn-github-actions/contexts.md +++ b/translations/pt-BR/content/actions/learn-github-actions/contexts.md @@ -1,7 +1,7 @@ --- -title: Contextos -shortTitle: Contextos -intro: Você pode acessar as informações de contexto nos fluxos de trabalho e nas ações. +title: Contexts +shortTitle: Contexts +intro: You can access context information in workflows and actions. redirect_from: - /articles/contexts-and-expression-syntax-for-github-actions - /github/automating-your-workflow-with-github-actions/contexts-and-expression-syntax-for-github-actions @@ -20,145 +20,157 @@ miniTocMaxHeadingLevel: 3 {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -## Sobre os contextos +## About contexts {% data reusables.github-actions.context-injection-warning %} -Os contextos são uma forma de acessar informações sobre execuções de fluxo de trabalho, ambientes dos executores, trabalhos e etapas. Contextos usam a sintaxe de expressão. Para obter mais informações, consulte "[Expressões](/actions/learn-github-actions/expressions)". +Contexts are a way to access information about workflow runs, runner environments, jobs, and steps. Contexts use the expression syntax. For more information, see "[Expressions](/actions/learn-github-actions/expressions)." {% raw %} `${{ }}` {% endraw %} -| Nome do contexto | Tipo | Descrição | -| ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `objeto` | Informações sobre a execução do fluxo de trabalho. Para obter mais informações, consulte [contexto `github`](#github-context). | -| `env` | `objeto` | Contém variáveis de ambiente definidas em um fluxo de trabalho, trabalho ou etapa. Para obter mais informações, consulte o contexto [`env`](#env-context). | -| `trabalho` | `objeto` | Tem informações sobre o trabalho em execução no momento. Para obter mais informações, consulte [contexto `trabalho`](#job-context). | -| `steps` | `objeto` | Informações sobre as etapas que foram executadas neste trabalho. Para obter mais informações, consulte [contexto `etapas`](#steps-context). | -| `runner` | `objeto` | Informações sobre o executor do trabalho atual. Para obter mais informações, consulte [`runner` context](#runner-context). | -| `secrets` | `objeto` | Habilita o acesso a segredos. Para obter mais informações sobre segredos, consulte "[Criar e usar segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". | -| `strategy` | `objeto` | Habilita acesso aos parâmetros de estratégia configurados e informações sobre o trabalho atual. Parâmetros de estratégia incluem `fail-fast`, `job-index`, `job-total` e `max-parallel`. | -| `matrix` | `objeto` | Habilita acesso aos parâmetros de matriz configurados para o trabalho atual. Por exemplo, se você configurar uma criação de matriz com as versões `os` e `node`, o objeto de contexto `matrix` inclui as versões `os` e `node` do trabalho atual. | -| `needs` | `objeto` | Permite o acesso às saídas de todos os trabalhos definidos como uma dependência do trabalho atual. Para obter mais informações, consulte o contexto [`needs`](#needs-context). | -{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4757 %}「 `entradas` stuff `objeto` | Habilita acesso às entradas do fluxo de trabalho reutilizável. Para obter mais informações, consulte o contexto [`entradas`](#inputs-context). |{% endif %} +| Context name | Type | Description | +|---------------|------|-------------| +| `github` | `object` | Information about the workflow run. For more information, see [`github` context](#github-context). | +| `env` | `object` | Contains environment variables set in a workflow, job, or step. For more information, see [`env` context](#env-context). | +| `job` | `object` | Information about the currently executing job. For more information, see [`job` context](#job-context). | +| `steps` | `object` | Information about the steps that have been run in this job. For more information, see [`steps` context](#steps-context). | +| `runner` | `object` | Information about the runner that is running the current job. For more information, see [`runner` context](#runner-context). | +| `secrets` | `object` | Enables access to secrets. For more information about secrets, see "[Creating and using encrypted secrets](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." | +| `strategy` | `object` | Enables access to the configured strategy parameters and information about the current job. Strategy parameters include `fail-fast`, `job-index`, `job-total`, and `max-parallel`. | +| `matrix` | `object` | Enables access to the matrix parameters you configured for the current job. For example, if you configure a matrix build with the `os` and `node` versions, the `matrix` context object includes the `os` and `node` versions of the current job. | +| `needs` | `object` | Enables access to the outputs of all jobs that are defined as a dependency of the current job. For more information, see [`needs` context](#needs-context). | +{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4757 %}| `inputs` | `object` | Enables access to the inputs of reusable workflow. For more information, see [`inputs` context](#inputs-context). |{% endif %} -Como parte de uma expressão, você pode acessar as informações de contexto usando uma das duas sintaxes: -- Sintaxe de índice: `github['sha']`; -- Sintaxe de propriedade de desreferência: `github.sha` +As part of an expression, you may access context information using one of two syntaxes. +- Index syntax: `github['sha']` +- Property dereference syntax: `github.sha` -Para usar a sintaxe de propriedade de desreferência, o nome da propriedade deve: -- começar com `a-Z` ou `_`; -- ser seguido por `a-Z` `0-9` `-` ou `_`. +In order to use property dereference syntax, the property name must: +- start with `a-Z` or `_`. +- be followed by `a-Z` `0-9` `-` or `_`. -### Determinar quando usar contextos +### Determining when to use contexts {% data reusables.github-actions.using-context-or-environment-variables %} -### Contexto `github` +### `github` context -O contexto `github` context contém informações sobre a execução do fluxo de trabalho e sobre o evento que a acionou. Você pode ler a maioria dos dados de contexto `github` em variáveis de ambiente. Para obter mais informações sobre as variáveis de ambiente, consulte "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)". +The `github` context contains information about the workflow run and the event that triggered the run. You can read most of the `github` context data in environment variables. For more information about environment variables, see "[Using environment variables](/actions/automating-your-workflow-with-github-actions/using-environment-variables)." {% data reusables.github-actions.github-context-warning %} {% data reusables.github-actions.context-injection-warning %} -| Nome da propriedade | Tipo | Descrição | -| -------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `github` | `objeto` | Contexto de nível mais alto disponível em qualquer trabalho ou etapa de um fluxo de trabalho. | -| `github.action` | `string` | O nome da ação atualmente em execução. {% data variables.product.prodname_dotcom %} remove caracteres especiais ou usa o nome `__run` quando a etapa atual executa um script. Se você usar a mesma ação mais de uma vez no mesmo trabalho, o nome incluirá um sufixo com o número da sequência com o sublinhado antes dele. Por exemplo, o primeiro script que você executar terá o nome `__run` e o segundo script será denominado `__run_2`. Da mesma forma, a segunda invocação de `actions/checkout` será `actionscheckout2`. | -| `github.action_path` | `string` | O caminho onde está localizada a sua ação. Você pode usar esse caminho para acessar facilmente os arquivos localizados no mesmo repositório que sua ação. Este atributo é compatível apenas em ações compostas. | -| `github.actor` | `string` | Login do usuário que iniciou a execução do fluxo de trabalho. | -| `github.base_ref` | `string` | `base_ref` ou branch alvo da pull request em uma execução de fluxo de trabalho. Esta propriedade só está disponível quando o evento que aciona a execução de um fluxo de trabalho for `pull_request` ou `pull_request_target`. | -| `github.event` | `objeto` | Carga de evento de webhook completa. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/articles/events-that-trigger-workflows/)". Você pode acessar as propriedades individuais do evento usando este contexto. | -| `github.event_name` | `string` | Nome do evento que acionou a execução do fluxo de trabalho. | -| `github.event_path` | `string` | O caminho para a carga completa do evento do webhook no executor. | -| `github.head_ref` | `string` | `head_ref` ou branch de origem da pull request em uma execução de fluxo de trabalho. Esta propriedade só está disponível quando o evento que aciona a execução de um fluxo de trabalho for `pull_request` ou `pull_request_target`. | -| `github.job` | `string` | O [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) do trabalho atual. | -| `github.ref` | `string` | Branch ou ref tag que acionou a execução do fluxo de trabalho. Para branches, este é o formato `refs/heads/` e, para tags, é `refs/tags/`. | +| Property name | Type | Description | +|---------------|------|-------------| +| `github` | `object` | The top-level context available during any job or step in a workflow. | +| `github.action` | `string` | The name of the action currently running. {% data variables.product.prodname_dotcom %} removes special characters or uses the name `__run` when the current step runs a script. If you use the same action more than once in the same job, the name will include a suffix with the sequence number with underscore before it. For example, the first script you run will have the name `__run`, and the second script will be named `__run_2`. Similarly, the second invocation of `actions/checkout` will be `actionscheckout2`. | +| `github.action_path` | `string` | The path where your action is located. You can use this path to easily access files located in the same repository as your action. This attribute is only supported in composite actions. | +| `github.actor` | `string` | The login of the user that initiated the workflow run. | +| `github.base_ref` | `string` | The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is either `pull_request` or `pull_request_target`. | +| `github.event` | `object` | The full event webhook payload. For more information, see "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." You can access individual properties of the event using this context. | +| `github.event_name` | `string` | The name of the event that triggered the workflow run. | +| `github.event_path` | `string` | The path to the full event webhook payload on the runner. | +| `github.head_ref` | `string` | The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is either `pull_request` or `pull_request_target`. | +| `github.job` | `string` | The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. | +| `github.ref` | `string` | The branch or tag ref that triggered the workflow run. For branches this is the format `refs/heads/`, and for tags it is `refs/tags/`. | {%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %} -| `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} | | `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} | | `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %} +| `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} | +| `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} | +| `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %} | {%- endif %} -| `github.repository` | `string` | O nome do proprietário e do repositório. Por exemplo, `Codertocat/Hello-World`. | | `github.repository_owner` | `string` | O nome do proprietário do repositório. Por exemplo, `Codertocat`. | | `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} | | `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} | | `github.run_attempt` | `string` | O úmero único para cada tentativa de uma execução de 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. | | `github.server_url` | `string` | Retorna a URL do servidor do GitHub. Por exemplo: `https://github.com`. | | `github.sha` | `string` | O SHA do commit que acionou a execução do fluxo de trabalho. | | `github.token` | `string` | Um token para efetuar a autenticação em nome do aplicativo instalado no seu repositório. Isso é funcionalmente equivalente ao segredo `GITHUB_TOKEN`. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". | | `github.workflow` | `string` | O nome do fluxo de trabalho. Se o fluxo de trabalho não determina um `name` (nome), o valor desta propriedade é o caminho completo do arquivo do fluxo de trabalho no repositório. | | `github.workspace` | `string` | O diretório de trabalho padrão para as etapas e localidade padrão do seu repositório ao usar a ação [`checkout`](https://github.com/actions/checkout). | +| `github.repository` | `string` | The owner and repository name. For example, `Codertocat/Hello-World`. | +| `github.repository_owner` | `string` | The repository owner's name. For example, `Codertocat`. | +| `github.run_id` | `string` | {% data reusables.github-actions.run_id_description %} | +| `github.run_number` | `string` | {% data reusables.github-actions.run_number_description %} | +| `github.run_attempt` | `string` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. | +| `github.server_url` | `string` | Returns the URL of the GitHub server. For example: `https://github.com`. | +| `github.sha` | `string` | The commit SHA that triggered the workflow run. | +| `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." | +| `github.workflow` | `string` | The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository. | +| `github.workspace` | `string` | The default working directory for steps and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. | -### Contexto `env` +### `env` context -O contexto `env` contém variáveis de ambiente que foram definidas em um fluxo de trabalho, trabalho ou etapa. Para obter mais informações sobre como configurar variáveis de ambiente em seu fluxo de trabalho, consulte "[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)". +The `env` context contains environment variables that have been set in a workflow, job, or step. For more information about setting environment variables in your workflow, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)." -A sintaxe de contexto `env` permite que você use o valor de uma variável de ambiente no seu arquivo de fluxo de trabalho. Você pode usar o contexto `env` no valor de qualquer chave em uma **etapa**, exceto para as chaves `id` e `uses`. Para obter mais informações sobre a sintaxe da etapa, consulte "[Sintaxe do fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)". +The `env` context syntax allows you to use the value of an environment variable in your workflow file. You can use the `env` context in the value of any key in a **step** except for the `id` and `uses` keys. For more information on the step syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)." -Se você desejar usar o valor de uma variável de ambiente dentro de um executor, use o método normal do sistema operacional do executor para ler as variáveis de ambiente. +If you want to use the value of an environment variable inside a runner, use the runner operating system's normal method for reading environment variables. -| Nome da propriedade | Tipo | Descrição | -| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- | -| `env` | `objeto` | Esse contexto altera cada etapa em um trabalho. Você pode acessar esse contexto em qualquer etapa de um trabalho. | -| `env.` | `string` | O valor de uma variável de ambiente específica. | +| Property name | Type | Description | +|---------------|------|-------------| +| `env` | `object` | This context changes for each step in a job. You can access this context from any step in a job. | +| `env.` | `string` | The value of a specific environment variable. | -### Contexto `trabalho` +### `job` context -O contexto `job` (trabalho) contém informações sobre o trabalho atualmente em execução. +The `job` context contains information about the currently running job. -| Nome da propriedade | Tipo | Descrição | -| ----------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `trabalho` | `objeto` | Esse contexto altera cada trabalho em uma execução de fluxo de trabalho. Você pode acessar esse contexto em qualquer etapa de um trabalho. | -| `job.container` | `objeto` | Informações sobre o contêiner do trabalho. Para obter mais informações sobre contêineres, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)". | -| `job.container.id` | `string` | Identificação do contêiner. | -| `job.container.network` | `string` | Identificação da rede do contêiner. O executor cria a rede usada por todos os contêineres em um trabalho. | -| `job.services` | `objeto` | Contêineres de serviços criados para um trabalho. Para obter mais informações sobre contêineres de serviço, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)". | -| `job.services..id` | `string` | Identificação do contêiner de serviço. | -| `job.services..network` | `string` | Identificação da rede do contêiner de serviço. O executor cria a rede usada por todos os contêineres em um trabalho. | -| `job.services..ports` | `objeto` | As portas expostas do contêiner de serviço. | -| `job.status` | `string` | Status atual do trabalho. Possíveis valores são `success`, `failure` ou `cancelled`. | +| Property name | Type | Description | +|---------------|------|-------------| +| `job` | `object` | This context changes for each job in a workflow run. You can access this context from any step in a job. | +| `job.container` | `object` | Information about the job's container. For more information about containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)." | +| `job.container.id` | `string` | The id of the container. | +| `job.container.network` | `string` | The id of the container network. The runner creates the network used by all containers in a job. | +| `job.services` | `object` | The service containers created for a job. For more information about service containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)." | +| `job.services..id` | `string` | The id of the service container. | +| `job.services..network` | `string` | The id of the service container network. The runner creates the network used by all containers in a job. | +| `job.services..ports` | `object` | The exposed ports of the service container. | +| `job.status` | `string` | The current status of the job. Possible values are `success`, `failure`, or `cancelled`. | -### Contexto `etapas` +### `steps` context -O contexto `steps` (etapas) contém informações sobre as etapas já executadas do trabalho atual. +The `steps` context contains information about the steps in the current job that have already run. -| Nome da propriedade | Tipo | Descrição | -| --------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `steps` | `objeto` | Esse contexto altera cada etapa em um trabalho. Você pode acessar esse contexto em qualquer etapa de um trabalho. | -| `steps..outputs` | `objeto` | Conjunto de saídas definidas para a etapa. Para obter mais informações, consulte "[Sintaxe de metadados para o {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)". | -| `steps..conclusion` | `string` | O resultado de uma etapa concluída após [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) ser aplicado. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. Quando ocorre uma falha na etapa de `continue-on-error`, o `resultado` será `falha`, mas a conclusão `final` será `sucesso`. | -| `steps..outcome` | `string` | O resultado de uma etapa concluída antes de [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) ser aplicado. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. Quando ocorre uma falha na etapa de `continue-on-error`, o `resultado` será `falha`, mas a conclusão `final` será `sucesso`. | -| `steps..outputs.` | `string` | Valor de uma saída específica. | +| Property name | Type | Description | +|---------------|------|-------------| +| `steps` | `object` | This context changes for each step in a job. You can access this context from any step in a job. | +| `steps..outputs` | `object` | The set of outputs defined for the step. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)." | +| `steps..conclusion` | `string` | The result of a completed step after [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outcome` | `string` | The result of a completed step before [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. | +| `steps..outputs.` | `string` | The value of a specific output. | -### Contexto do `executor` +### `runner` context -O contexto do `executor` contém informações sobre o executor que está executando o trabalho atual. +The `runner` context contains information about the runner that is executing the current job. -| Nome da propriedade | Tipo | Descrição | -| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `runner.name` | `string` | {% data reusables.actions.runner-name-description %} -| `runner.os` | `string` | {% data reusables.actions.runner-os-description %} -| `runner.temp` | `string` | {% data reusables.actions.runner-temp-directory-description %} -| `runner.tool_cache` | `string` | {% ifversion ghae %}Para instruções instruções sobre como ter certeza de que o seu {% data variables.actions.hosted_runner %} tem o software necessário instalado, consulte "[Criar imagens personalizadas](/actions/using-github-hosted-runners/creating-custom-images)". {% else %} {% data reusables.actions.runner-tool-cache-description %} {% endif %} +| Property name | Type | Description | +|---------------|------|-------------| +| `runner.name` | `string` | {% data reusables.actions.runner-name-description %} | +| `runner.os` | `string` | {% data reusables.actions.runner-os-description %} |{% if actions-runner-arch-envvars %} +| `runner.arch` | `string` | {% data reusables.actions.runner-arch-description %} |{% endif %} +| `runner.temp` | `string` | {% data reusables.actions.runner-temp-directory-description %} | +| `runner.tool_cache` | `string` | {% ifversion ghae %}For instructions on how to make sure your {% data variables.actions.hosted_runner %} has the required software installed, see "[Creating custom images](/actions/using-github-hosted-runners/creating-custom-images)." {% else %} {% data reusables.actions.runner-tool-cache-description %} {% endif %}| -### Contexto `needs` +### `needs` context -O contexto `needs` contém saídas de todos os trabalhos definidos como uma dependência do trabalho atual. Para obter mais informações sobre a definição de dependências de tarefas, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". +The `needs` context contains outputs from all jobs that are defined as a dependency of the current job. For more information on defining job dependencies, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)." -| Nome da propriedade | Tipo | Descrição | -| -------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `needs.` | `objeto` | Um único trabalho do qual o trabalho atual depende. | -| `needs..outputs` | `objeto` | O conjunto de saídas de um trabalho do qual o trabalho atual depende. | -| `needs..outputs.` | `string` | O valor de uma saída específica para um trabalho do qual o trabalho atual depende. | -| `needs..result` | `string` | O resultado de um trabalho do qual depende o trabalho atual. Os valores possíveis são: `sucesso`, `falha`, `cancelado`ou `ignorado`. | +| Property name | Type | Description | +|---------------|------|-------------| +| `needs.` | `object` | A single job that the current job depends on. | +| `needs..outputs` | `object` | The set of outputs of a job that the current job depends on. | +| `needs..outputs.` | `string` | The value of a specific output for a job that the current job depends on. | +| `needs..result` | `string` | The result of a job that the current job depends on. Possible values are `success`, `failure`, `cancelled`, or `skipped`. | {% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4757 %} -### Contexto `entradas` +### `inputs` context -O contexto `entradas` contém informações sobre as entradas do fluxo de trabalho reutilizável. As entradas são definidas na configuração do evento [`workflow_call`](/actions/learn-github-actions/events-that-trigger-workflows#workflow-reuse-events). Essas entradas são passadas de [`jobs..with`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idwith) em um fluxo de trabalho externo. +The `inputs` context contains information about the inputs of reusable workflow. The inputs are defined in [`workflow_call` event configuration](/actions/learn-github-actions/events-that-trigger-workflows#workflow-reuse-events). These inputs are passed from [`jobs..with`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idwith) in an external workflow. -Para obter mais informações, consulte "[Reutilizando fluxos de trabalho](/actions/learn-github-actions/reusing-workflows)". +For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)". -| Nome da propriedade | Tipo | Descrição | -| --------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -| `inputs` | `objeto` | Este contexto só está disponível quando é [um fluxo de trabalho reutilizável](/actions/learn-github-actions/reusing-workflows). | -| `inputs.` | `string` ou `número` ou `booleano` | Cada valor de entrada é passado de um fluxo de trabalho externo. | +| Property name | Type | Description | +|---------------|------|-------------| +| `inputs` | `object` | This context is only available when it is [a reusable workflow](/actions/learn-github-actions/reusing-workflows). | +| `inputs.` | `string` or `number` or `boolean` | Each input value passed from an external workflow. | {% endif %} -#### Exemplo de impressão de informações de contexto no arquivo de log +#### Example printing context information to the log file -Para inspecionar as informações acessíveis em cada contexto, você pode usar este exemplo de arquivo de fluxo de trabalho. +To inspect the information that is accessible in each context, you can use this workflow file example. {% data reusables.github-actions.github-context-warning %} @@ -198,68 +210,71 @@ jobs: ``` {% endraw %} -## Disponibilidade do contexto +## Context availability -Contextos diferentes estão disponíveis durante a execução de um fluxo de trabalho. Por exemplo, o contexto de `segredos` só pode ser usado em certos lugares dentro de um trabalho. +Different contexts are available throughout a workflow run. For example, the `secrets` context may only be used at certain places within a job. -Além disso, algumas funções só podem ser utilizadas em determinados lugares. Por exemplo, a função `hashFiles` não está disponível em qualquer lugar. +In addition, some functions may only be used in certain places. For example, the `hashFiles` function is not available everywhere. -A tabela a seguir indica onde cada contexto e função especial pode ser utilizado dentro de um fluxo de trabalho. A menos que esteja listado abaixo, uma função pode ser usada em qualquer lugar. |{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -| Caminho | Contexto | Funções especiais | -| -------------------------- | -------------------------- | -------------------------- | -| concorrência | github | | -| env | github, segredos, entradas | | -| jobs.<job_id>.concurrency | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.container | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.container.credentials | github, necessidades, estratégia, matrix, env, segredos, entradas | | -| jobs.<job_id>.container.env.<env_id> | github, necessidades, estratégia, matrix, trabalho, executor, env, segredos, entradas | | -| jobs.<job_id>.continue-on-error | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.defaults.run | github, necessidades, estratégia, matriz, env, entradas | | -| jobs.<job_id>.env | github, necessidades, estratégia, matriz, segredos, entradas | | -| jobs.<job_id>.environment | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.environment.url | github, necessidades, estratégia, matriz, trabalho, executor, env, etapas, entradas | | -| jobs.<job_id>.if | github, necessidades, entradas | always, cancelled, success, failure | -| jobs.<job_id>.name | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.outputs.<output_id> | github, necessidades, estratégia, matriz, trabalho, executor, env, segredos, etapas, entradas | | -| jobs.<job_id>.runs-on | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.secrets.<secrets_id> | github, necessidades, segredos | | -| jobs.<job_id>.services | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.services.<service_id>.credentials | github, necessidades, estratégia, matrix, env, segredos, entradas | | -| jobs.<job_id>.services.<service_id>.env.<env_id> | github, necessidades, estratégia, matrix, trabalho, executor, env, segredos, entradas | | +The following table indicates where each context and special function can be used within a workflow. Unless listed below, a function can be used anywhere. + +{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} + +| Path | Context | Special functions | +| ---- | ------- | ----------------- | +| concurrency | github | | +| env | github, secrets, inputs | | +| jobs.<job_id>.concurrency | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.container | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.container.credentials | github, needs, strategy, matrix, env, secrets, inputs | | +| jobs.<job_id>.container.env.<env_id> | github, needs, strategy, matrix, job, runner, env, secrets, inputs | | +| jobs.<job_id>.continue-on-error | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.defaults.run | github, needs, strategy, matrix, env, inputs | | +| jobs.<job_id>.env | github, needs, strategy, matrix, secrets, inputs | | +| jobs.<job_id>.environment | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.environment.url | github, needs, strategy, matrix, job, runner, env, steps, inputs | | +| jobs.<job_id>.if | github, needs, inputs | always, cancelled, success, failure | +| jobs.<job_id>.name | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.outputs.<output_id> | github, needs, strategy, matrix, job, runner, env, secrets, steps, inputs | | +| jobs.<job_id>.runs-on | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.secrets.<secrets_id> | github, needs, secrets | | +| jobs.<job_id>.services | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.services.<service_id>.credentials | github, needs, strategy, matrix, env, secrets, inputs | | +| jobs.<job_id>.services.<service_id>.env.<env_id> | github, needs, strategy, matrix, job, runner, env, secrets, inputs | | | jobs.<job_id>.steps.continue-on-error | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | -| jobs.<job_id>.steps.env | github, necessidades, estratégia, matriz, trabalho, executor, env, segredos, etapas, entradas | hashFiles | -| jobs.<job_id>.steps.if | github, necessidades, estratégia, matriz, trabalho, executor, env, etapas, entradas | always, cancelled, success, failure, hashFiles | -| jobs.<job_id>.steps.name | github, necessidades, estratégia, matriz, trabalho, executor, env, segredos, etapas, entradas | hashFiles | -| jobs.<job_id>.steps.run | github, necessidades, estratégia, matriz, trabalho, executor, env, segredos, etapas, entradas | hashFiles | +| jobs.<job_id>.steps.env | github, needs, strategy, matrix, job, runner, env, secrets, steps, inputs | hashFiles | +| jobs.<job_id>.steps.if | github, needs, strategy, matrix, job, runner, env, steps, inputs | always, cancelled, success, failure, hashFiles | +| jobs.<job_id>.steps.name | github, needs, strategy, matrix, job, runner, env, secrets, steps, inputs | hashFiles | +| jobs.<job_id>.steps.run | github, needs, strategy, matrix, job, runner, env, secrets, steps, inputs | hashFiles | | jobs.<job_id>.steps.timeout-minutes | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | -| jobs.<job_id>.steps.with | github, necessidades, estratégia, matriz, trabalho, executor, env, segredos, etapas, entradas | hashFiles | -| jobs.<job_id>.steps.working-directory | github, necessidades, estratégia, matriz, trabalho, executor, env, segredos, etapas, entradas | hashFiles | -| jobs.<job_id>.strategy | github, necessidades, entradas | | -| jobs.<job_id>.timeout-minutes | github, necessidades, estratégia, matriz, entradas | | -| jobs.<job_id>.with.<with_id> | github, needs | | -| on.workflow_call.inputs.<inputs_id>.default | github | | -| on.workflow_call.outputs.<output_id>.value | github, jobs, inputs | | +| jobs.<job_id>.steps.with | github, needs, strategy, matrix, job, runner, env, secrets, steps, inputs | hashFiles | +| jobs.<job_id>.steps.working-directory | github, needs, strategy, matrix, job, runner, env, secrets, steps, inputs | hashFiles | +| jobs.<job_id>.strategy | github, needs, inputs | | +| jobs.<job_id>.timeout-minutes | github, needs, strategy, matrix, inputs | | +| jobs.<job_id>.with.<with_id> | github, needs | | +| on.workflow_call.inputs.<inputs_id>.default | github | | +| on.workflow_call.outputs.<output_id>.value | github, jobs, inputs | | {% else %} -| Caminho | Contexto | Funções especiais | -| --------------------------- | --------------------------- | --------------------------- | -| concorrência | github | | -| env | github, secrets | | -| jobs.<job_id>.concurrency | github, needs, strategy, matrix | | -| jobs.<job_id>.container | github, needs, strategy, matrix | | -| jobs.<job_id>.container.credentials | github, needs, strategy, matrix, env, secrets | | -| jobs.<job_id>.container.env.<env_id> | github, needs, strategy, matrix, job, runner, env, secrets | | -| jobs.<job_id>.continue-on-error | github, needs, strategy, matrix | | -| jobs.<job_id>.defaults.run | github, needs, strategy, matrix, env | | -| jobs.<job_id>.env | github, needs, strategy, matrix, secrets | | -| jobs.<job_id>.environment | github, needs, strategy, matrix | | -| jobs.<job_id>.environment.url | github, needs, strategy, matrix, job, runner, env, steps | | -| jobs.<job_id>.if | github, needs | always, cancelled, success, failure | -| jobs.<job_id>.name | github, needs, strategy, matrix | | -| jobs.<job_id>.outputs.<output_id> | github, needs, strategy, matrix, job, runner, env, secrets, steps | | -| jobs.<job_id>.runs-on | github, needs, strategy, matrix | | -| jobs.<job_id>.services | github, needs, strategy, matrix | | -| jobs.<job_id>.services.<service_id>.credentials | github, needs, strategy, matrix, env, secrets | | -| jobs.<job_id>.services.<service_id>.env.<env_id> | github, needs, strategy, matrix, job, runner, env, secrets | | +| Path | Context | Special functions | +| ---- | ------- | ----------------- | +| concurrency | github | | +| env | github, secrets | | +| jobs.<job_id>.concurrency | github, needs, strategy, matrix | | +| jobs.<job_id>.container | github, needs, strategy, matrix | | +| jobs.<job_id>.container.credentials | github, needs, strategy, matrix, env, secrets | | +| jobs.<job_id>.container.env.<env_id> | github, needs, strategy, matrix, job, runner, env, secrets | | +| jobs.<job_id>.continue-on-error | github, needs, strategy, matrix | | +| jobs.<job_id>.defaults.run | github, needs, strategy, matrix, env | | +| jobs.<job_id>.env | github, needs, strategy, matrix, secrets | | +| jobs.<job_id>.environment | github, needs, strategy, matrix | | +| jobs.<job_id>.environment.url | github, needs, strategy, matrix, job, runner, env, steps | | +| jobs.<job_id>.if | github, needs | always, cancelled, success, failure | +| jobs.<job_id>.name | github, needs, strategy, matrix | | +| jobs.<job_id>.outputs.<output_id> | github, needs, strategy, matrix, job, runner, env, secrets, steps | | +| jobs.<job_id>.runs-on | github, needs, strategy, matrix | | +| jobs.<job_id>.services | github, needs, strategy, matrix | | +| jobs.<job_id>.services.<service_id>.credentials | github, needs, strategy, matrix, env, secrets | | +| jobs.<job_id>.services.<service_id>.env.<env_id> | github, needs, strategy, matrix, job, runner, env, secrets | | | jobs.<job_id>.steps.continue-on-error | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | | jobs.<job_id>.steps.env | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | | jobs.<job_id>.steps.if | github, needs, strategy, matrix, job, runner, env, steps | always, cancelled, success, failure, hashFiles | @@ -268,6 +283,6 @@ A tabela a seguir indica onde cada contexto e função especial pode ser utiliza | jobs.<job_id>.steps.timeout-minutes | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | | jobs.<job_id>.steps.with | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | | jobs.<job_id>.steps.working-directory | github, needs, strategy, matrix, job, runner, env, secrets, steps | hashFiles | -| jobs.<job_id>.strategy | github, needs | | -| jobs.<job_id>.timeout-minutes | github, needs, strategy, matrix | | -{% endif %} +| jobs.<job_id>.strategy | github, needs | | +| jobs.<job_id>.timeout-minutes | github, needs, strategy, matrix | | +{% endif %} \ No newline at end of file diff --git a/translations/pt-BR/content/actions/learn-github-actions/environment-variables.md b/translations/pt-BR/content/actions/learn-github-actions/environment-variables.md index 966f65bdc0..69cdc2e29d 100644 --- a/translations/pt-BR/content/actions/learn-github-actions/environment-variables.md +++ b/translations/pt-BR/content/actions/learn-github-actions/environment-variables.md @@ -1,6 +1,6 @@ --- -title: Variáveis de ambiente -intro: '{% data variables.product.prodname_dotcom %} define as variáveis do ambiente para cada execução do fluxo de trabalho {% data variables.product.prodname_actions %}. Você também pode definir variáveis de ambiente personalizadas no seu arquivo do fluxo de trabalho.' +title: Environment variables +intro: '{% data variables.product.prodname_dotcom %} sets default environment variables for each {% data variables.product.prodname_actions %} workflow run. You can also set custom environment variables in your workflow file.' redirect_from: - /github/automating-your-workflow-with-github-actions/using-environment-variables - /actions/automating-your-workflow-with-github-actions/using-environment-variables @@ -17,11 +17,11 @@ versions: {% data reusables.actions.enterprise-github-hosted-runners %} {% data reusables.actions.ae-beta %} -## Sobre as variáveis de ambiente +## About environment variables -{% data variables.product.prodname_dotcom %} define as variáveis-padrão do ambiente disponíveis para cada etapa da execução de um fluxo de trabalho. As variáveis de ambiente diferenciam entre maiúsculas e minúsculas. Os comandos executados em ações ou etapas podem criar, ler e modificar as variáveis do ambiente. +{% data variables.product.prodname_dotcom %} sets default environment variables that are available to every step in a workflow run. Environment variables are case-sensitive. Commands run in actions or steps can create, read, and modify environment variables. -Para definir as variáveis do ambiente personalizadas, você deverá especificar as variáveis no arquivo do fluxo de trabalho. Você pode definir as variáveis de ambiente para uma etapa, trabalho ou para todo um fluxo de trabalho, usando as palavras-chave [`jobs..steps[*].env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv), and [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env). Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)". +To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the [`jobs..steps[*].env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv), and [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) keywords. For more information, see "[Workflow syntax for {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)." {% raw %} ```yaml @@ -41,51 +41,61 @@ jobs: ``` {% endraw %} -Para usar o valor de uma variável de ambiente em um arquivo do fluxo de trabalho, você deve usar o [contexto` env`](/actions/reference/context-and-expression-syntax-for-github-actions#env-context). Se você deseja usar o valor de uma variável de ambiente dentro de um executor, você poderá usar o método normal do sistema operacional do executor para ler variáveis de ambiente. +To use the value of an environment variable in a workflow file, you should use the [`env` context](/actions/reference/context-and-expression-syntax-for-github-actions#env-context). If you want to use the value of an environment variable inside a runner, you can use the runner operating system's normal method for reading environment variables. -Se você usar a chave `executar` do arquivo de fluxo de trabalho para ler variáveis de ambiente de dentro do sistema operacional do executor (como mostrado no exemplo acima), a variável será substituída no sistema operacional do executor depois que a tarefa for enviada para o executor. Para outras partes de um arquivo de fluxo de trabalho, você deve usar o contexto `env` para ler variáveis de ambiente. Isso ocorre porque as chaves do fluxo de trabalho (como `se`) exigem que a variável seja substituída durante o processamento do fluxo de trabalho antes de ser enviada para o executor. +If you use the workflow file's `run` key to read environment variables from within the runner operating system (as shown in the example above), the variable is substituted in the runner operating system after the job is sent to the runner. For other parts of a workflow file, you must use the `env` context to read environment variables; this is because workflow keys (such as `if`) require the variable to be substituted during workflow processing before it is sent to the runner. -Você também pode usar o arquivo de ambiente `GITHUB_ENV` para definir uma variável de ambiente que as etapas a seguir podem usar em um trabalho. O arquivo de ambiente pode ser usado diretamente por uma ação ou como um comando shell em um arquivo de fluxo de trabalho usando a palavra-chave `executar`. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)". +You can also use the `GITHUB_ENV` environment file to set an environment variable that the following steps in a job can use. The environment file can be used directly by an action or as a shell command in a workflow file using the `run` keyword. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)." -## Variáveis padrão de ambiente +## Default environment variables -É altamente recomendável que as ações usem as variáveis do ambiente para acessar o sistema do arquivo em vez de usar os caminhos do arquivo com codificação rígida. {% data variables.product.prodname_dotcom %} define as variáveis de ambiente para ações a serem usadas em todos os ambientes executores. +We strongly recommend that actions use environment variables to access the filesystem rather than using hardcoded file paths. {% data variables.product.prodname_dotcom %} sets environment variables for actions to use in all runner environments. -| Variável de ambiente | Descrição | -| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `CI` | Definido sempre como `verdadeiro`. | -| `GITHUB_WORKFLOW` | Nome do fluxo de trabalho. | -| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} -| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} -| `GITHUB_JOB` | O [job_id](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) do trabalho atual. | -| `GITHUB_ACTION` | Identificador único (`id`) da ação. | -| `GITHUB_ACTION_PATH` | O caminho onde está localizada a sua ação. Você pode usar esse caminho para acessar os arquivos localizados no mesmo repositório que sua ação. Esta variável só é compatível em ações compostas. | -| `GITHUB_ACTIONS` | Definido sempre como `verdadeiro` quando {% data variables.product.prodname_actions %} estiver executando o fluxo de trabalho. Você pode usar esta variável para diferenciar quando os testes estão sendo executados localmente ou por {% data variables.product.prodname_actions %}. | -| `GITHUB_ACTOR` | Nome da pessoa ou aplicativo que iniciou o fluxo de trabalho. Por exemplo, `octocat`. | -| `GITHUB_REPOSITORY` | Nome do repositório e o proprietário. Por exemplo, `octocat/Hello-World`. | -| `GITHUB_EVENT_NAME` | Nome do evento de webhook que acionou o workflow. | -| `GITHUB_EVENT_PATH` | Caminho do arquivo com a carga completa do evento webhook. Por exemplo, `/github/workflow/event.json`. | -| `GITHUB_WORKSPACE` | O caminho do diretório do espaço de trabalho de {% data variables.product.prodname_dotcom %} está inicialmente vazio. Por exemplo, `/home/runner/work/my-repo-name/my-repo-name`. A ação [actions/checkout](https://github.com/actions/checkout) irá fazer o check-out dos arquivos, por padrão uma cópia do seu repositório, neste diretório. | -| `GITHUB_SHA` | Commit SHA que acionou o fluxo de trabalho. Por exemplo, `ffac537e6cbbf934b08745a378932722df287a53`. | -| `GITHUB_REF` | Branch ou ref tag que acionou o fluxo de trabalho. Por exemplo, `refs/heads/feature-branch-1`. Se não houver branch ou tag disponível para o tipo de evento, a variável não existirá. | +| Environment variable | Description | +| ---------------------|------------ | +| `CI` | Always set to `true`. | +| `GITHUB_WORKFLOW` | The name of the workflow. | +| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} | +| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} | +| `GITHUB_JOB` | The [job_id](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. | +| `GITHUB_ACTION` | The unique identifier (`id`) of the action. | +| `GITHUB_ACTION_PATH` | The path where your action is located. You can use this path to access files located in the same repository as your action. This variable is only supported in composite actions. | +| `GITHUB_ACTIONS` | Always set to `true` when {% data variables.product.prodname_actions %} is running the workflow. You can use this variable to differentiate when tests are being run locally or by {% data variables.product.prodname_actions %}. +| `GITHUB_ACTOR` | The name of the person or app that initiated the workflow. For example, `octocat`. | +| `GITHUB_REPOSITORY` | The owner and repository name. For example, `octocat/Hello-World`. | +| `GITHUB_EVENT_NAME` | The name of the webhook event that triggered the workflow. | +| `GITHUB_EVENT_PATH` | The path of the file with the complete webhook event payload. For example, `/github/workflow/event.json`. | +| `GITHUB_WORKSPACE` | The {% data variables.product.prodname_dotcom %} workspace directory path, initially empty. For example, `/home/runner/work/my-repo-name/my-repo-name`. The [actions/checkout](https://github.com/actions/checkout) action will check out files, by default a copy of your repository, within this directory. | +| `GITHUB_SHA` | The commit SHA that triggered the workflow. For example, `ffac537e6cbbf934b08745a378932722df287a53`. | +| `GITHUB_REF` | The branch or tag ref that triggered the workflow. For example, `refs/heads/feature-branch-1`. If neither a branch or tag is available for the event type, the variable will not exist. | {%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %} -| `GITHUB_REF_NAME` | {% data reusables.actions.ref_name-description %} | | `GITHUB_REF_PROTECTED` | {% data reusables.actions.ref_protected-description %} | | `GITHUB_REF_TYPE` | {% data reusables.actions.ref_type-description %} +| `GITHUB_REF_NAME` | {% data reusables.actions.ref_name-description %} | +| `GITHUB_REF_PROTECTED` | {% data reusables.actions.ref_protected-description %} | +| `GITHUB_REF_TYPE` | {% data reusables.actions.ref_type-description %} | {%- endif %} -| `GITHUB_HEAD_REF` | Definido apenas para eventos de pull request. O nome do branch principal. | `GITHUB_BASE_REF` | Definido apenas para eventos de pull request. O nome do branch de base. | `GITHUB_SERVER_URL`| Retorna a URL do servidor de {% data variables.product.product_name %}. Por exemplo: `https://{% data variables.product.product_url %}`. | `GITHUB_API_URL` | Retorna a URL da API. Por exemplo: `{% data variables.product.api_url_code %}`. | `GITHUB_GRAPHQL_URL` | Retorna a URL da API do GraphQL. Por exemplo: `{% data variables.product.graphql_url_code %}`. | `RUNNER_NAME` | {% data reusables.actions.runner-name-description %} | `RUNNER_OS` | {% data reusables.actions.runner-os-description %} | `RUNNER_TEMP` | {% data reusables.actions.runner-temp-directory-description %} +| `GITHUB_HEAD_REF` | Only set for pull request events. The name of the head branch. +| `GITHUB_BASE_REF` | Only set for pull request events. The name of the base branch. +| `GITHUB_SERVER_URL`| Returns the URL of the {% data variables.product.product_name %} server. For example: `https://{% data variables.product.product_url %}`. +| `GITHUB_API_URL` | Returns the API URL. For example: `{% data variables.product.api_url_code %}`. +| `GITHUB_GRAPHQL_URL` | Returns the GraphQL API URL. For example: `{% data variables.product.graphql_url_code %}`. +| `RUNNER_NAME` | {% data reusables.actions.runner-name-description %} +| `RUNNER_OS` | {% data reusables.actions.runner-os-description %}{% if actions-runner-arch-envvars %} +| `RUNNER_ARCH` | {% data reusables.actions.runner-arch-description %}{% endif %} +| `RUNNER_TEMP` | {% data reusables.actions.runner-temp-directory-description %} {% ifversion not ghae %}| `RUNNER_TOOL_CACHE` | {% data reusables.actions.runner-tool-cache-description %}{% endif %} {% tip %} -**Observação:** Se você precisar usar o URL de um fluxo de trabalho em um trabalho, você poderá combinar estas variáveis de ambiente: `$GITHUB_SERVER_URL/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_ID` +**Note:** If you need to use a workflow run's URL from within a job, you can combine these environment variables: `$GITHUB_SERVER_URL/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_ID` {% endtip %} -### Determinar quando usar variáveis de ambiente padrão ou contextos +### Determining when to use default environment variables or contexts {% data reusables.github-actions.using-context-or-environment-variables %} -## Convenções de nomenclatura para variáveis de ambiente +## Naming conventions for environment variables -Ao definir uma variável de ambiente personalizada, você não poderá usar qualquer um dos nomes de variáveis de ambiente padrão listados acima com o prefixo `GITHUB_`. Se você tentar substituir o valor de uma dessas variáveis de ambiente padrão, a atribuição será ignorada. +When you set a custom environment variable, you cannot use any of the default environment variable names listed above with the prefix `GITHUB_`. If you attempt to override the value of one of these default environment variables, the assignment is ignored. -Qualquer variável de ambiente nova que você definir e apontar para um local no sistema de arquivos deve ter um sufixo `_PATH`. As variáveis padrão `HOME` e `GITHUB_WORKSPACE` são exceções a essa convenção porque as palavras "inicial" e "espaço de trabalho" já indicam o local. +Any new environment variables you set that point to a location on the filesystem should have a `_PATH` suffix. The `HOME` and `GITHUB_WORKSPACE` default variables are exceptions to this convention because the words "home" and "workspace" already imply a location. diff --git a/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md b/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md index c6425f3a22..c687ca375c 100644 --- a/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md +++ b/translations/pt-BR/content/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md @@ -54,6 +54,36 @@ It's not possible to add CPU or memory resources to an existing AWS/EC2 instance 3. Start the instance. {% data reusables.enterprise_installation.configuration-recognized %} +## Adding CPU or memory resources on Microsoft Azure + +{% note %} + +**Note:** To add CPU or memory resources in Microsoft Azure, you must be familiar with using either the Azure Portal, Azure CLI or Azure Powershell to manage VM instances. For background and details on using the Azure tools of your choice to perform the resize, please refer to the Azure documentation on [changing the size of a virtual machine](https://docs.microsoft.com/en-us/azure/virtual-machines/resize-vm). + +{% endnote %} + +### Resizing considerations + +Before increasing CPU or memory resources for {% data variables.product.product_location %}, review the following recommendations. + +- **Scale your memory with CPUs**. {% data reusables.enterprise_installation.increasing-cpus-req %} +- **Assign a static IP address to the instance**. If you haven't assigned a static IP to your instance, you might have to adjust the DNS A records for your {% data variables.product.prodname_ghe_server %} host after the restart to account for the change in IP address. + +### Supported Microsoft Azure instance sizes + +You need to determine the instance size you would like to upgrade to based on CPU/memory specifications. + +{% data reusables.enterprise_installation.warning-on-scaling %} + +{% data reusables.enterprise_installation.azure-instance-recommendation %} + +### Resizing for Microsoft Azure + +You can scale the VM up by changing the VM size. Changing its size will cause it to be restarted. In some cases, you must deallocate the VM first. This can happen if the new size is not available on the hardware cluster that is currently hosting the VM. + +1. Refer to the Azure documentation on [changing the size of a virtual machine](https://docs.microsoft.com/en-us/azure/virtual-machines/resize-vm) for the required steps. +{% data reusables.enterprise_installation.configuration-recognized %} + ## Adding CPU or memory resources for OpenStack KVM It's not possible to add CPU or memory resources to an existing OpenStack KVM instance. Instead, you must: diff --git a/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md b/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md index 0a254d65ab..ee09f2f006 100644 --- a/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md +++ b/translations/pt-BR/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md @@ -1,6 +1,6 @@ --- -title: Instalar o GitHub Enterprise Server no Azure -intro: 'Para instalar o {% data variables.product.prodname_ghe_server %} no Azure, você deve fazer a implantação em uma instância da série DS e usar o armazenamento Premium-LRS.' +title: Installing GitHub Enterprise Server on Azure +intro: 'To install {% data variables.product.prodname_ghe_server %} on Azure, you must deploy onto a DS-series instance and use Premium-LRS storage.' redirect_from: - /enterprise/admin/guides/installation/installing-github-enterprise-on-azure/ - /enterprise/admin/installation/installing-github-enterprise-server-on-azure @@ -13,63 +13,58 @@ topics: - Enterprise - Infrastructure - Set up -shortTitle: Instalar no Azure +shortTitle: Install on Azure --- +You can deploy {% data variables.product.prodname_ghe_server %} on global Azure or Azure Government. -Você pode implantar o {% data variables.product.prodname_ghe_server %} no Azure global ou Azure Government. - -## Pré-requisitos +## Prerequisites - {% data reusables.enterprise_installation.software-license %} -- Você deve ter uma conta do Azure que permita provisionar novas máquinas. Para obter mais informações, consulte o [site do Microsoft Azure](https://azure.microsoft.com). -- A maioria das ações necessárias para iniciar sua máquina virtual (VM) também pode ser executada pelo Portal do Azure. No entanto, é recomendável instalar a interface da linha de comando (CLI) do Azure para a configuração inicial. Veja abaixo alguns exemplos de uso da CLI do Azure 2.0. Para obter mais informações, consulte o guia "[Instalar a CLI do Azure 2.0](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest)". +- You must have an Azure account capable of provisioning new machines. For more information, see the [Microsoft Azure website](https://azure.microsoft.com). +- Most actions needed to launch your virtual machine (VM) may also be performed using the Azure Portal. However, we recommend installing the Azure command line interface (CLI) for initial setup. Examples using the Azure CLI 2.0 are included below. For more information, see Azure's guide "[Install Azure CLI 2.0](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest)." -## Considerações de hardware +## Hardware considerations {% data reusables.enterprise_installation.hardware-considerations-all-platforms %} -## Determinar o tipo de máquina virtual +## Determining the virtual machine type -Antes de lançar {% data variables.product.product_location %} no Azure, você deverá determinar o tipo de máquina que melhor atende às necessidades da sua organização. Para revisar os requisitos mínimos para {% data variables.product.product_name %}, consulte "[Requisitos mínimos](#minimum-requirements)". +Before launching {% data variables.product.product_location %} on Azure, you'll need to determine the machine type that best fits the needs of your organization. To review the minimum requirements for {% data variables.product.product_name %}, see "[Minimum requirements](#minimum-requirements)." {% data reusables.enterprise_installation.warning-on-scaling %} -O appliance do {% data variables.product.prodname_ghe_server %} requer um disco de dados de armazenamento premium e é compatível com qualquer VM do Azure que tenha suporte ao armazenamento premium. Tipos de Azure VM com `s` sufixo são compatíveis com o armazenamento premium. Para obter mais informações, consulte "[Quais tipos de disco estão disponíveis no Azure?](https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types#premium-ssd)" e "[Armazenamento premium do Azure: design para alto desempenho](https://docs.microsoft.com/en-us/azure/virtual-machines/premium-storage-performance)" na documentação do Azure. +{% data reusables.enterprise_installation.azure-instance-recommendation %} -{% data variables.product.company_short %} recomenda uma VM com memória otimizada para {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Tamanhos de máquinas virtuais com memória otimizada ](https://docs.microsoft.com/en-us/azure/virtual-machines/sizes-memory)" na documentação do Azure. - -O {% data variables.product.prodname_ghe_server %} dá suporte a qualquer região compatível com o seu tipo de VM. Para obter mais informações sobre as regiões compatíveis com cada VM, consulte "[Produtos disponíveis por região](https://azure.microsoft.com/regions/services/)". - -## Criar a instância da máquina virtual do {% data variables.product.prodname_ghe_server %} +## Creating the {% data variables.product.prodname_ghe_server %} virtual machine {% data reusables.enterprise_installation.create-ghe-instance %} -1. Localize a imagem mais recente do appliance do {% data variables.product.prodname_ghe_server %}. Para obter mais informações sobre o comando `vm image list`, consulte "[Lista de imagens de vm no az](https://docs.microsoft.com/cli/azure/vm/image?view=azure-cli-latest#az_vm_image_list)" na documentação da Microsoft. +1. Find the most recent {% data variables.product.prodname_ghe_server %} appliance image. For more information about the `vm image list` command, see "[az vm image list](https://docs.microsoft.com/cli/azure/vm/image?view=azure-cli-latest#az_vm_image_list)" in the Microsoft documentation. ```shell $ az vm image list --all -f GitHub-Enterprise | grep '"urn":' | sort -V ``` -2. Crie uma VM usando a imagem do appliance. Para obter mais informações, consulte "[criar vm no az](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_create)" na documentação da Microsoft. +2. Create a new VM using the appliance image you found. For more information, see "[az vm create](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_create)" in the Microsoft documentation. - Veja as opções de nome da VM, grupo de recursos, tamanho da VM, nome da região preferida do Azure, nome da da imagem de VM do appliance que você listou na etapa anterior e o SKU de armazenamento para Premium. Para obter mais informações sobre grupos de recursos, consulte "[Grupos de recursos](https://docs.microsoft.com/azure/azure-resource-manager/resource-group-overview#resource-groups)" na documentação da Microsoft. + Pass in options for the name of your VM, the resource group, the size of your VM, the name of your preferred Azure region, the name of the appliance image VM you listed in the previous step, and the storage SKU for premium storage. For more information about resource groups, see "[Resource groups](https://docs.microsoft.com/azure/azure-resource-manager/resource-group-overview#resource-groups)" in the Microsoft documentation. ```shell $ az vm create -n VM_NAME -g RESOURCE_GROUP --size VM_SIZE -l REGION --image APPLIANCE_IMAGE_NAME --storage-sku Premium_LRS ``` -3. Defina as configurações de segurança na VM para abrir as portas necessárias. Para obter mais informações, consulte "[abrir portas para a vm no az](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_open_port)" na documentação da Microsoft. A tabela abaixo descreve cada porta para determinar quais portas você precisa abrir. +3. Configure the security settings on your VM to open up required ports. For more information, see "[az vm open-port](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_open_port)" in the Microsoft documentation. See the table below for a description of each port to determine what ports you need to open. ```shell $ az vm open-port -n VM_NAME -g RESOURCE_GROUP --port PORT_NUMBER ``` - Esta tabela identifica o uso de cada porta. + This table identifies what each port is used for. {% data reusables.enterprise_installation.necessary_ports %} -4. Crie e anexe um novo disco de dados não criptografado à VM e configure o tamanho com base na sua contagem de licenças do usuário. Para obter mais informações, consulte "[anexar disco a uma vm no az](https://docs.microsoft.com/cli/azure/vm/disk?view=azure-cli-latest#az_vm_disk_attach)" na documentação da Microsoft. +4. Create and attach a new unencrypted data disk to the VM, and configure the size based on your user license count. For more information, see "[az vm disk attach](https://docs.microsoft.com/cli/azure/vm/disk?view=azure-cli-latest#az_vm_disk_attach)" in the Microsoft documentation. - Veja as opções de nome da VM (por exemplo, `ghe-acme-corp`), o grupo de recursos, o SKU de armazenamento Premium, o tamanho do disco (por exemplo, `100`) e um nome para o VHD resultante. + Pass in options for the name of your VM (for example, `ghe-acme-corp`), the resource group, the premium storage SKU, the size of the disk (for example, `100`), and a name for the resulting VHD. ```shell $ az vm disk attach --vm-name VM_NAME -g RESOURCE_GROUP --sku Premium_LRS --new -z SIZE_IN_GB --name ghe-data.vhd --caching ReadWrite @@ -77,33 +72,33 @@ O {% data variables.product.prodname_ghe_server %} dá suporte a qualquer regiã {% note %} - **Observação:** para que as instâncias não relacionadas à produção tenham capacidade suficiente de E/S, o tamanho mínimo de disco recomendado é de 40 GB com cache de leitura e gravação habilitado (`--caching ReadWrite`). + **Note:** For non-production instances to have sufficient I/O throughput, the recommended minimum disk size is 40 GiB with read/write cache enabled (`--caching ReadWrite`). {% endnote %} -## Configurar a máquina virtual do {% data variables.product.prodname_ghe_server %} +## Configuring the {% data variables.product.prodname_ghe_server %} virtual machine -1. Antes de configurar a VM, você deve aguardar a entrada no status ReadyRole. Verifique o status da VM com o comando `vm list`. Para obter mais informações, consulte "[listar vms no az](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_list)" na documentação da Microsoft. +1. Before configuring the VM, you must wait for it to enter ReadyRole status. Check the status of the VM with the `vm list` command. For more information, see "[az vm list](https://docs.microsoft.com/cli/azure/vm?view=azure-cli-latest#az_vm_list)" in the Microsoft documentation. ```shell $ az vm list -d -g RESOURCE_GROUP -o table > Name ResourceGroup PowerState PublicIps Fqdns Location Zones > ------ --------------- ------------ ------------ ------- ---------- ------- > VM_NAME RESOURCE_GROUP VM running 40.76.79.202 eastus - + ``` {% note %} - - **Observação:** o Azure não cria uma entrada FQDNS automaticamente para a VM. Para obter mais informações, consulte o guia do Azure sobre como "[Criar um nome de domínio totalmente qualificado no portal do Azure para uma VM Linux](https://docs.microsoft.com/azure/virtual-machines/linux/portal-create-fqdn)". - + + **Note:** Azure does not automatically create a FQDNS entry for the VM. For more information, see Azure's guide on how to "[Create a fully qualified domain name in the Azure portal for a Linux VM](https://docs.microsoft.com/azure/virtual-machines/linux/portal-create-fqdn)." + {% endnote %} - + {% data reusables.enterprise_installation.copy-the-vm-public-dns-name %} {% data reusables.enterprise_installation.upload-a-license-file %} - {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} Para obter mais informações, consulte "[Configurar o appliance do {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/configuring-the-github-enterprise-server-appliance)". + {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} For more information, see "[Configuring the {% data variables.product.prodname_ghe_server %} appliance](/enterprise/admin/guides/installation/configuring-the-github-enterprise-server-appliance)." {% data reusables.enterprise_installation.instance-will-restart-automatically %} {% data reusables.enterprise_installation.visit-your-instance %} - -## Leia mais - -- "[Visão geral do sistema](/enterprise/admin/guides/installation/system-overview){% ifversion ghes %} -- "[Sobre atualizações para novas versões](/admin/overview/about-upgrades-to-new-releases)"{% endif %} + +## Further reading + +- "[System overview](/enterprise/admin/guides/installation/system-overview)"{% ifversion ghes %} +- "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)"{% endif %} diff --git a/translations/pt-BR/content/codespaces/customizing-your-codespace/index.md b/translations/pt-BR/content/codespaces/customizing-your-codespace/index.md index a1b0969f7c..b2649f276e 100644 --- a/translations/pt-BR/content/codespaces/customizing-your-codespace/index.md +++ b/translations/pt-BR/content/codespaces/customizing-your-codespace/index.md @@ -14,6 +14,7 @@ children: - /changing-the-machine-type-for-your-codespace - /setting-your-default-editor-for-codespaces - /setting-your-default-region-for-codespaces + - /setting-your-timeout-period-for-codespaces - /prebuilding-codespaces-for-your-project --- diff --git a/translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md b/translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md index e5f842d295..076985854c 100644 --- a/translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md +++ b/translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account.md @@ -1,6 +1,6 @@ --- -title: Personalizar os codespaces para a sua conta -intro: 'Você pode personalizar {% data variables.product.prodname_codespaces %} usando um repositório `dotfiles` em {% data variables.product.product_name %} ou usando Configurações de Sincronização.' +title: Personalizing Codespaces for your account +intro: 'You can personalize {% data variables.product.prodname_codespaces %} by using a `dotfiles` repository on {% data variables.product.product_name %} or by using Settings Sync.' redirect_from: - /github/developing-online-with-github-codespaces/personalizing-github-codespaces-for-your-account - /github/developing-online-with-codespaces/personalizing-codespaces-for-your-account @@ -14,40 +14,40 @@ topics: - Set up - Fundamentals product: '{% data reusables.gated-features.codespaces %}' -shortTitle: Personalize seus codespaces +shortTitle: Personalize your codespaces --- -## Sobre a personalização de {% data variables.product.prodname_codespaces %} +## About personalizing {% data variables.product.prodname_codespaces %} -Ao usar qualquer ambiente de desenvolvimento, a personalização das configurações e ferramentas para suas preferências e fluxos de trabalho é uma etapa importante. {% data variables.product.prodname_codespaces %} permite duas formas principais de personalizar seus codespaces. +When using any development environment, customizing the settings and tools to your preferences and workflows is an important step. {% data variables.product.prodname_codespaces %} allows for two main ways of personalizing your codespaces. -- [Configurações de sincronização](#settings-sync) - Você pode usar e compartilhar as configurações {% data variables.product.prodname_vscode %} entre {% data variables.product.prodname_codespaces %} e outras instâncias de {% data variables.product.prodname_vscode %}. -- [Dotfiles](#dotfiles) - Você pode usar um repositório `dotfiles` público para especificar scripts, preferências do shell e outras configurações. +- [Settings Sync](#settings-sync) - You can use and share {% data variables.product.prodname_vscode %} settings between {% data variables.product.prodname_codespaces %} and other instances of {% data variables.product.prodname_vscode %}. +- [Dotfiles](#dotfiles) – You can use a `dotfiles` repository to specify scripts, shell preferences, and other configurations. -A personalização de {% data variables.product.prodname_codespaces %} aplica-se a qualquer codespace que você criar. +{% data variables.product.prodname_codespaces %} personalization applies to any codespace you create. -Os mantenedores do projeto também podem definir uma configuração-padrão que se aplica a todos os codespaces de um repositório, criados por qualquer pessoa. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_codespaces %} para seu projeto](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project)". +Project maintainers can also define a default configuration that applies to every codespace for a repository, created by anyone. For more information, see "[Configuring {% data variables.product.prodname_codespaces %} for your project](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project)." -## Configurações de sincronização +## Settings Sync -A sincronização de configurações permite que você compartilhe configurações como configurações, atalhos de teclado, snippets, extensões e estado da interface de usuário entre as máquinas e instâncias de {% data variables.product.prodname_vscode %}. +Settings Sync allows you to share configurations such as settings, keyboard shortcuts, snippets, extensions, and UI state across machines and instances of {% data variables.product.prodname_vscode %}. -Para habilitar a sincronização de configurações, no canto inferior esquerdo da barra de atividades, selecione {% octicon "gear" aria-label="The gear icon" %} e clique **Habilitar as configurações de sincronização…**. Na caixa de diálogo, selecione quais configurações você gostaria de sincronizar. +To enable Settings Sync, in the bottom-left corner of the Activity Bar, select {% octicon "gear" aria-label="The gear icon" %} and click **Turn on Settings Sync…**. In the dialog box, select the settings you'd like to sync. -![Opção de configuração de sincronização no menu de gerenciamento](/assets/images/help/codespaces/codespaces-manage-settings-sync.png) +![Setting Sync option in manage menu](/assets/images/help/codespaces/codespaces-manage-settings-sync.png) -Para obter mais informações, consulte o [Guia de sincronização de configurações](https://code.visualstudio.com/docs/editor/settings-sync) na documentação de {% data variables.product.prodname_vscode %}. +For more information, see the [Settings Sync guide](https://code.visualstudio.com/docs/editor/settings-sync) in the {% data variables.product.prodname_vscode %} documentation. ## Dotfiles -Os Dotfiles são arquivos e pastas de sistemas de tipo Unix, que começam com `.` e controlam a configuração de aplicativos e shells no seu sistema. Você pode armazenar e gerenciar seus dotfiles em um repositório no {% data variables.product.prodname_dotcom %}. Para obter aconselhamento e tutoriais sobre o que incluir no repositório `dotfiles`, consulte [GitHub gerencia dotfiles](https://dotfiles.github.io/). +Dotfiles are files and folders on Unix-like systems starting with `.` that control the configuration of applications and shells on your system. You can store and manage your dotfiles in a repository on {% data variables.product.prodname_dotcom %}. For advice and tutorials about what to include in your dotfiles repository, see [GitHub does dotfiles](https://dotfiles.github.io/). -Se sua conta de usuário em {% data variables.product.prodname_dotcom %} possui um repositório público denominado `dotfiles`, {% data variables.product.prodname_dotcom %} poderá usar este repositório automaticamente para personalizar o ambiente do seu codespace, uma vez habilitado nas suas [configurações de codespaces pessoais](https://github.com/settings/codespaces). Atualmente, não são compatíveis os repositórios privados `dotfiles`. +Your dotfiles repository might include your shell aliases and preferences, any tools you want to install, or any other codespace personalization you want to make. -O seu repositório `dotfiles` pode incluir os alias e preferências do seu shell, quaisquer ferramentas que você deseja instalar ou qualquer outra personalização de codespace que desejar fazer. +You can configure {% data variables.product.prodname_codespaces %} to use dotfiles from any repository you own by selecting that repository in your [personal {% data variables.product.prodname_codespaces %} settings](https://github.com/settings/codespaces). -Ao criar um novo codespace, o {% data variables.product.prodname_dotcom %} clona seus repositórios de `dotfiles` para o ambiente do codespace e procura por um dos seguintes arquivos para configurar o ambiente. +When you create a new codespace, {% data variables.product.prodname_dotcom %} clones your selected repository to the codespace environment, and looks for one of the following files to set up the environment. * _install.sh_ * _install_ @@ -58,42 +58,45 @@ Ao criar um novo codespace, o {% data variables.product.prodname_dotcom %} clona * _setup_ * _script/setup_ -Se nenhum desses arquivos for encontrado, quaisquer arquivos ou pastas nos `dotfiles` que comecem com `.` será vinculado simbolicamente ao diretório `~` ou `$HOME` do codespace. +If none of these files are found, then any files or folders in your selected dotfiles repository starting with `.` are symlinked to the codespace's `~` or `$HOME` directory. -Quaisquer alterações no repositório de `dotfiles` serão aplicadas apenas a cada novo codespace e não afetarão nenhum codespace existente. +Any changes to your selected dotfiles repository will apply only to each new codespace, and do not affect any existing codespace. {% note %} -**Observação:** Atualmente, o {% data variables.product.prodname_codespaces %} não é compatível com a personalização das configurações do _Usuário_ para o editor de {% data variables.product.prodname_vscode %} com o repositório `dotfiles`. É possível definir as configurações-padrão do _espaço de trabalho_ e _Remote [Codespaces]_ para um projeto específico no repositório do projeto. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_codespaces %} para seu projeto](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-codespace-configuration)". +**Note:** Currently, {% data variables.product.prodname_codespaces %} does not support personalizing the _User_ settings for the {% data variables.product.prodname_vscode %} editor with your `dotfiles` repository. You can set default _Workspace_ and _Remote [Codespaces]_ settings for a specific project in the project's repository. For more information, see "[Configuring {% data variables.product.prodname_codespaces %} for your project](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-codespace-configuration)." {% endnote %} -### Habilitando o repositório de dotfiles para {% data variables.product.prodname_codespaces %} +### Enabling your dotfiles repository for {% data variables.product.prodname_codespaces %} -Você pode usar o seu repositório `dotfiles` público para personalizar o seu ambiente de {% data variables.product.prodname_codespaces %}. Depois de configurar esse repositório, é possível adicionar seus scripts, preferências e configurações a ele. Em seguida, você deverá habilitar os seus dotfiles na sua página pessoal de configurações de {% data variables.product.prodname_codespaces %}. +You can use your selected dotfiles repository to personalize your {% data variables.product.prodname_codespaces %} environment. Once you choose your dotfiles repository, you can add your scripts, preferences, and configurations to it. You then need to enable your dotfiles from your personal {% data variables.product.prodname_codespaces %} settings page. + +{% warning %} + +**Warning:** Dotfiles have the ability to run arbitrary scripts, which may contain unexpected or malicious code. Before installing a dotfiles repo, we recommend checking scripts to ensure they don't perform any unexpected actions. + +{% endwarning %} {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.codespaces-tab %} -1. Em "Dotfiles", selecione "Instalar dotfiles automaticamente" para que {% data variables.product.prodname_codespaces %} instale automaticamente seus dotfiles em cada novo codespace que você criar. ![Instalando dotfiles](/assets/images/help/codespaces/install-dotfiles.png) +1. Under "Dotfiles", select **Automatically install dotfiles** so that {% data variables.product.prodname_codespaces %} automatically installs your dotfiles into every new codespace you create. + ![Installing dotfiles](/assets/images/help/codespaces/install-custom-dotfiles.png) +2. Choose the repository you want to install dotfiles from. + ![Selecting a dotfiles repo](/assets/images/help/codespaces/select-dotfiles-repo.png) - {% note %} +You can add further script, preferences, configuration files to your dotfiles repository or edit existing files whenever you want. Changes to settings will only be picked up by new codespaces. - **Observação:** Esta opção só está disponível se você criou um repositório público de `dotfiles` para a sua conta de usuário. +## Other available settings - {% endnote %} +You can also personalize {% data variables.product.prodname_codespaces %} using additional [Codespaces settings](https://github.com/settings/codespaces): -Você pode adicionar mais script, preferências e arquivos de configuração ao repositório de dotfiles ou editar arquivos existentes sempre que quiser. As alterações nas configurações só serão selecionadas por novos codespaces. +- To set your default region, see "[Setting your default region for {% data variables.product.prodname_codespaces %}](/codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces)." +- To set your editor, see "[Setting your default editor for {% data variables.product.prodname_codespaces %}](/codespaces/managing-your-codespaces/setting-your-default-editor-for-codespaces)." +- To add encrypted secrets, see "[Managing encrypted secrets for {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces)." +- To enable GPG verification, see "[Managing GPG verification for {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces)." +- To allow your codespaces to access other repositories, see "[Managing access and security for {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-access-and-security-for-codespaces)." -## Outras configurações disponíveis +## Further reading -Você também pode personalizar {% data variables.product.prodname_codespaces %} usando outras [Configurações de codespace](https://github.com/settings/codespaces): - -- Para definir sua região padrão, consulte "[Definindo sua região padrão para {% data variables.product.prodname_codespaces %}](/codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces)." -- Para definir seu editor, consulte "[Definindo seu editor padrão para {% data variables.product.prodname_codespaces %}](/codespaces/managing-your-codespaces/setting-your-default-editor-for-codespaces)" -- Para adicionar segredos criptografados, consulte "[Gerenciar segredos criptografados para {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces)". -- Para habilitar a verificação do GPG, consulte "[Gerenciar a verificação de GPG para {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces)." -- Para permitir que seus codespaces acessem outros repositórios, consulte "[Gerenciar acesso e segurança para {% data variables.product.prodname_codespaces %}](/github/developing-online-with-codespaces/managing-access-and-security-for-codespaces)". - -## Leia mais - -* "[Criar um repositório](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)" +* "[Creating a new repository](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)" diff --git a/translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces.md b/translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces.md new file mode 100644 index 0000000000..4ddd9466a3 --- /dev/null +++ b/translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces.md @@ -0,0 +1,46 @@ +--- +title: Setting your timeout period for Codespaces +intro: 'You can set your default timeout for {% data variables.product.prodname_codespaces %} in your personal settings page.' +product: '{% data reusables.gated-features.codespaces %}' +versions: + fpt: '*' + ghec: '*' +topics: + - Codespaces +shortTitle: Set the timeout +--- + +A codespace will stop running after a period of inactivity. You can specify the length of this timeout period. The updated setting will apply to any newly created codespace. + +{% warning %} + +**Warning**: Codespaces are billed per minute. If you are not actively using a codespace but the codespace has not yet timed out, you are still billed for the time that the codespace is running. For more information, see "[About billing for Codespaces](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces#codespaces-pricing)." + +{% endwarning %} + +## Setting your default timeout + +{% include tool-switcher %} + +{% webui %} + +{% data reusables.user_settings.access_settings %} +{% data reusables.user_settings.codespaces-tab %} +1. Under "Default idle timeout", enter the time that you want, then click **Save**. The time must be between 5 minutes and 240 minutes (4 hours). + ![Selecting your timeout](/assets/images/help/codespaces/setting-default-timeout.png) + +{% endwebui %} + +{% cli %} + +{% data reusables.cli.cli-learn-more %} + +To set the timeout period, use the `idle-timeout` argument with the `codespace create` subcommand. Specify the time in minutes, followed by `m`. The time must be between 5 minutes and 240 minutes (5 hours). + +```shell +gh codespace create --idle-timeout 90m +``` + +If you do not specify a timeout period when creating a codespace, then your default timeout period will be used. You cannot currently specify a default timeout period for all future codespaces through {% data variables.product.prodname_cli %}. + +{% endcli %} diff --git a/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md b/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md index 59a3cb1418..fc9df54ea7 100644 --- a/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md +++ b/translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md @@ -33,7 +33,7 @@ If you have unsaved changes, your editor will prompt you to save them before exi ## Codespaces timeouts -If you leave your codespace running without interaction or if you exit your codespace without explicitly stopping it, the codespace will timeout after 30 minutes of inactivity and stop running. For more information, see "[Stopping a codespace](#stopping-a-codespace)." +If you leave your codespace running without interaction, or if you exit your codespace without explicitly stopping it, the codespace will timeout after a period of inactivity and stop running. By default, a codespace will timeout after 30 minutes of inactivity, but you can customize the duration of the timeout period for new codespaces that you create. For more information about setting the default timeout period for your codespaces, see "[Setting your timeout period for Codespaces](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces)." For more information about stopping a codespace, see "[Stopping a codespace](#stopping-a-codespace)." When a codespace times out, your data is preserved from the last time your changes were saved. For more information, see "[Saving changes in a codespace](#saving-changes-in-a-codespace)." diff --git a/translations/pt-BR/data/features/actions-runner-arch-envvars.yml b/translations/pt-BR/data/features/actions-runner-arch-envvars.yml new file mode 100644 index 0000000000..66ced1151a --- /dev/null +++ b/translations/pt-BR/data/features/actions-runner-arch-envvars.yml @@ -0,0 +1,8 @@ +--- +#Reference: #5727 +#Documentation for new runner 'arch' environment variables set by the `runner` app. +versions: + fpt: '*' + ghec: '*' + ghes: '>=3.4' + ghae: 'ghae-issue-5727' diff --git a/translations/pt-BR/data/release-notes/enterprise-server/3-3/0-rc1.yml b/translations/pt-BR/data/release-notes/enterprise-server/3-3/0-rc1.yml index 028d23c601..4a18f90bd7 100644 --- a/translations/pt-BR/data/release-notes/enterprise-server/3-3/0-rc1.yml +++ b/translations/pt-BR/data/release-notes/enterprise-server/3-3/0-rc1.yml @@ -122,6 +122,10 @@ sections: For more information, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/security-guides/security-hardening-for-github-actions#auditing-github-actions-events)." - Performance improvements have been made to {% data variables.product.prodname_actions %}, which may result in higher maximum job concurrency. + - + heading: 'GitHub Packages changes' + notes: + - When a repository is deleted, any associated package files are now immediately deleted from your {% data variables.product.prodname_registry %} external storage. - heading: 'Dependabot and Dependency graph changes' notes: diff --git a/translations/pt-BR/data/reusables/actions/runner-arch-description.md b/translations/pt-BR/data/reusables/actions/runner-arch-description.md new file mode 100644 index 0000000000..d3b8df34bc --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/runner-arch-description.md @@ -0,0 +1 @@ +The architecture of the runner executing the job. Possible values are `X86`, `X64`, `ARM`, and `ARM64`. diff --git a/translations/pt-BR/data/reusables/enterprise_installation/azure-instance-recommendation.md b/translations/pt-BR/data/reusables/enterprise_installation/azure-instance-recommendation.md new file mode 100644 index 0000000000..1d5056c83e --- /dev/null +++ b/translations/pt-BR/data/reusables/enterprise_installation/azure-instance-recommendation.md @@ -0,0 +1,5 @@ +O appliance do {% data variables.product.prodname_ghe_server %} requer um disco de dados de armazenamento premium e é compatível com qualquer VM do Azure que tenha suporte ao armazenamento premium. Tipos de Azure VM com `s` sufixo são compatíveis com o armazenamento premium. Para obter mais informações, consulte "[Quais tipos de disco estão disponíveis no Azure?](https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types#premium-ssd)" e "[Armazenamento premium do Azure: design para alto desempenho](https://docs.microsoft.com/en-us/azure/virtual-machines/premium-storage-performance)" na documentação do Azure. + +{% data variables.product.company_short %} recomenda uma VM com memória otimizada para {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Tamanhos de máquinas virtuais com memória otimizada ](https://docs.microsoft.com/en-us/azure/virtual-machines/sizes-memory)" na documentação do Azure. + +O {% data variables.product.prodname_ghe_server %} dá suporte a qualquer região compatível com o seu tipo de VM. Para obter mais informações sobre as regiões compatíveis com cada VM, consulte "[Produtos disponíveis por região](https://azure.microsoft.com/regions/services/)". \ No newline at end of file
atividadefrequência de execuçãoalerta-círculoalerta-octágonoactivityairplayalert-circlealert-octagon
alerta-triânguloalinhar-centroalinhar-justificaralinhar-esquerdaalert-trianglealign-centeralign-justifyalign-left
alinhar-direitaâncoraaberturaarquivaralign-rightanchoraperturearchive
flecha-abaixo-círculoflecha-abaixo-esquerdaflecha-abaixo-direitaflecha-abaixoarrow-down-circlearrow-down-leftarrow-down-rightarrow-down
flecha-esquerda-círculoflecha-esquerdaflecha-direita-círculoflecha-direitaarrow-left-circlearrow-leftarrow-right-circlearrow-right
flecha-acima-círculoflecha-acima-esquerdaflecha-acima-direitaflecha-acimaarrow-up-circlearrow-up-leftarrow-up-rightarrow-up
arrobaprêmiobarra-quadro-2barra-quadroat-signawardbar-chart-2bar-chart
bateria-carregandobateriasino-desativadosinobattery-chargingbatterybell-offbell
bluetoothnegritolivro-abertolivroboldbook-openbook
favoritocaixapastacalendáriobookmarkboxbriefcasecalendar
câmera-desligadacâmeramoldemarcar-círculocamera-offcameracastcheck-circle
marcar-quadradomarcarchevron-abaixochevron-esquerdacheck-squarecheckchevron-downchevron-left
chevron-direitachevron-acimachevrons-abaixochevrons-esquerdachevron-rightchevron-upchevrons-downchevrons-left
chevrons-direitachevrons-acimacírculochevrons-rightchevrons-upcircle clipboard
relógionuvem-chuvisconuvem-relâmpagonuvem-desativadaclockcloud-drizzlecloud-lightningcloud-off
nuvem-chuvanuvem-nevenuvemcódigocloud-raincloud-snowcloudcode
comandobússulacommandcompass copycanto-abaixo-esquerdacorner-down-left
canto-abaixo-direitacanto-esquerda-abaixocanto-esquerda-acimacanto-direita-abaixocorner-down-rightcorner-left-downcorner-left-upcorner-right-down
canto-direita-acimacanto-acima-esquerdacanto-acima-direitacorner-right-upcorner-up-leftcorner-up-right cpu
cartão-de-créditocortarmirabanco de dadoscredit-cardcropcrosshairdatabase
deletediscodólar-sinaldownload-nuvemdiscdollar-signdownload-cloud
downloadgotaeditar-2editar-3dropletedit-2edit-3
editlink-externoolho-fechadoolhoexternal-linkeye-offeye
facebook fast-forwardpenaarquivo-menosfeatherfile-minus
arquivo-maisarquivo-textoarquivofilmefile-plusfile-textfilefilm
filtrosinalizadorpasta-menospasta-maisfilterflagfolder-minusfolder-plus
pastapresentefoldergift git-branch git-commit
git-merge git-pull-requestglobogradeglobegrid
disco-rígidohard-drive hashfones-de-ouvidocoraçãoheadphonesheart
ajuda-círculocasahelp-circlehome imagecaixa de entradainbox
infoitálicocamadasitaliclayers layout
boia salva-vidaslife-buoy link-2 linklistalist
carregadorbloquearloaderlock log-in log-out
correiofixar-mapamailmap-pin mapmaximizar-2maximize-2
maximizarmaximize menumensagem-círculomensagem-quadradomessage-circlemessage-square
microfone-desligadomicrofoneminimizar-2minimizarmic-offmicminimize-2minimize
menos-círculomenos-quadradomenosminus-circleminus-squareminus monitor
luamais-horizontalmais-verticalmovermoonmore-horizontalmore-verticalmove
músicanavegação-2navegaçãooctágonomusicnavigation-2navigationoctagon
pacoteclips de papelpausa-círculopausapackagepaperclippause-circlepause
porcentagemchamada-telefônicatelefone-transferênciatelefone-entradapercentphone-callphone-forwardedphone-incoming
telefone-perdidotelefone-desligadotelefone-foratelefonephone-missedphone-offphone-outgoingphone
gráfico-pizzareproduzir-círculoreproduzirmais-círculopie-chartplay-circleplayplus-circle
mais-quadradomaisbolsoenergiaplus-squarepluspocketpower
impressorarádioatualizar-ccwatualizar-cwprinterradiorefresh-ccwrefresh-cw
repetirretrocedergirar-ccwgirar-cwrepeatrewindrotate-ccwrotate-cw
rsssalvartesourapesquisarsavescissorssearch
enviarservidorsendserver settingscompartilhar-2share-2
compartilharescudo-desabilitadoescudosacola-de-comprasshareshield-offshieldshopping-bag
carrinho-de-comprasaleatóriobarra lateralpular-atrásshopping-cartshufflesidebarskip-back
pular-frentebarracursorskip-forwardslashsliders smartphone
alto-falantequadradoestrelaparar-círculospeakersquarestarstop-circle
solnascer-do-solpôr-do-solsunsunrisesunset tablet
tag target terminaltermômetrothermometer
polegar-para-baixopolegar-para-cimaalternar-esquerdaalternar-direitathumbs-downthumbs-uptoggle-lefttoggle-right
lixeira-2lixeiratendência-baixatendência-altatrash-2trashtrending-downtrending-up
triângulocaminhãotriangletruck tvtipotype
guarda-chuvasublinhardesbloquearcarregar-nuvemumbrellaunderlineunlockupload-cloud
fazer uploadusuário-marcarusuário-menosusuário-maisuploaduser-checkuser-minususer-plus
usuário-xusuáriouser-xuser usersvídeo-desligadovideo-off
vídeocorreio de vozvideovoicemail volume-1 volume-2
volume-x volumeinspecionarwifi-desligadowatchwifi-off
wifiventox-círculox-quadradowindx-circlex-square
xzapear-desligadozapearaproximarzap-offzapzoom-in
afastarzoom-out