{"meta":{"title":"Referência de sintaxe de metadados","intro":"É possível criar ações para realizar tarefas no repositório. Se você estiver fazendo uma ação personalizada, ela exigirá um arquivo de metadados que use a sintaxe YAML.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/actions","title":"GitHub Actions"},{"href":"/pt/enterprise-cloud@latest/actions/reference","title":"Referência"},{"href":"/pt/enterprise-cloud@latest/actions/reference/workflows-and-actions","title":"Fluxos de trabalho e ações"},{"href":"/pt/enterprise-cloud@latest/actions/reference/workflows-and-actions/metadata-syntax","title":"Sintaxe dos metadados"}],"documentType":"article"},"body":"# Referência de sintaxe de metadados\n\nÉ possível criar ações para realizar tarefas no repositório. Se você estiver fazendo uma ação personalizada, ela exigirá um arquivo de metadados que use a sintaxe YAML.\n\n> \\[!NOTE]\n> Você pode criar um contêiner do Docker, JavaScript e ações compostas. As ações exigem um arquivo de metadados para definir a configuração de entradas, saídas e execuções para sua ação. Os arquivos de metadados de ação usam a sintaxe YAML e o nome do arquivo de metadados deve ser `action.yml` ou `action.yaml`. O formato preferencial é `action.yml`.\n\n## `name`\n\n```\n          **Obrigatório** O nome da sua ação. O GitHub exibe o `name` na guia **Actions** para facilitar a identificação visual das ações em cada trabalho.\n```\n\n## `author`\n\n```\n          **Opcional** O nome do autor da ação.\n```\n\n## `description`\n\n```\n          **Obrigatório** Uma breve descrição da ação.\n```\n\n## `inputs`\n\n```\n          **Opcional** Os parâmetros de entrada permitem que você especifique os dados que a ação espera usar durante o runtime. O GitHub armazena parâmetros como variáveis de ambiente. Recomenda-se usar identificações de entrada com letras minúsculas.\n```\n\n### Exemplo: Especificando entradas\n\nEste exemplo configura duas entradas: `num-octocats` e `octocat-eye-color`. A entrada `num-octocats` não é obrigatória e usará o valor `1` como padrão.\n`octocat-eye-color` é obrigatório e não tem valor padrão.\n\n> \\[!NOTE]\n> As ações que usam `required: true` não retornarão automaticamente um erro se a entrada não for especificada.\n\nOs arquivos de fluxo de trabalho que usam essa ação podem usar a palavra-chave `with` a fim de definir um valor de entrada para `octocat-eye-color`. Para obter mais informações sobre a sintaxe `with`, confira [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/enterprise-cloud@latest/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepswith).\n\n```yaml\ninputs:\n  num-octocats:\n    description: 'Number of Octocats'\n    required: false\n    default: '1'\n  octocat-eye-color:\n    description: 'Eye color of the Octocats'\n    required: true\n```\n\nQuando você especifica uma entrada, o GitHub cria uma variável de ambiente para a entrada com o nome `INPUT_<VARIABLE_NAME>`. A variável de ambiente criada converte os nomes de entrada em letras maiúsculas e substitui os espaços por caracteres `_`.\n\nSe a ação for escrita usando um [composite](/pt/enterprise-cloud@latest/actions/creating-actions/creating-a-composite-action), ela não obterá `INPUT_<VARIABLE_NAME>` automaticamente. Com ações compostas, você pode usar `inputs`[Referência de contextos](/pt/enterprise-cloud@latest/actions/learn-github-actions/contexts) para acessar entradas de ação.\n\nPara acessar a variável de ambiente em uma ação de contêiner do Docker, você precisará transmitir 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 das ações de contêiner do Docker, confira [Criando uma ação de contêiner do Docker](/pt/enterprise-cloud@latest/actions/creating-actions/creating-a-docker-container-action#creating-an-action-metadata-file).\n\nPor exemplo, se um fluxo de trabalho definir as entradas `num-octocats` e `octocat-eye-color`, o código da ação poderá ler os valores das entradas usando as variáveis de ambiente `INPUT_NUM-OCTOCATS` e `INPUT_OCTOCAT-EYE-COLOR`.\n\n### `inputs.<input_id>`\n\n```\n          **Obrigatório** Um identificador `string` a ser associado à entrada. O valor de `<input_id>` é um mapa dos metadados da entrada. A `<input_id>` precisa ser um identificador exclusivo dentro do objeto `inputs`. A `<input_id>` precisa começar com uma letra ou `_` e conter apenas caracteres alfanuméricos, `-` ou `_`.\n```\n\n### `inputs.<input_id>.description`\n\n```\n          **Obrigatório** Uma descrição `string` dos parâmetros de entrada.\n```\n\n### `inputs.<input_id>.required`\n\n```\n          **Opcional** Um `boolean` para indicar se a ação exige o parâmetro de entrada. Defina-o como `true` quando o parâmetro for obrigatório.\n```\n\n### `inputs.<input_id>.default`\n\n```\n          **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.\n```\n\n### `inputs.<input_id>.deprecationMessage`\n\n```\n          **Opcional** se o parâmetro de entrada for usado, essa `string` será registrada em log como uma mensagem de aviso. Você pode usar esse aviso para notificar os usuários de que a entrada é encerrando e mencionar quaisquer alternativas.\n```\n\n##\n\n```\n          `outputs` para ações de contêiner do Docker e de JavaScript\n\n          **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.\n```\n\nAs saídas podem ter no máximo 1 MB por trabalho. O total de todas as saídas em uma execução de fluxo de trabalho pode ter no máximo 50 MB. O tamanho é aproximado com base na codificação UTF-16.\n\nSe 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 como definir saídas em uma ação, consulte [Comandos de fluxo de trabalho para o GitHub Actions](/pt/enterprise-cloud@latest/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter).\n\n### Exemplo: Declarando saídas para contêiner Docker e ações JavaScript\n\n```yaml\noutputs:\n  sum: # id of the output\n    description: 'The sum of the inputs'\n```\n\n### `outputs.<output_id>`\n\n```\n          **Obrigatório** Um identificador `string` a ser associado à saída. O valor de `<output_id>` é um mapa dos metadados da saída. A `<output_id>` precisa ser um identificador exclusivo dentro do objeto `outputs`. A `<output_id>` precisa começar com uma letra ou `_` e conter apenas caracteres alfanuméricos, `-` ou `_`.\n```\n\n### `outputs.<output_id>.description`\n\n```\n          **Obrigatório** Uma descrição `string` do parâmetro de saída.\n```\n\n##\n\n```\n          `outputs` para ações compostas\n\n          **Opcional**`outputs` usa os mesmos parâmetros que `outputs.<output_id>` e `outputs.<output_id>.description` (confira [`outputs` para ações de contêiner do Docker e de JavaScript](#outputs-for-docker-container-and-javascript-actions)), mas também inclui o token `value`.\n```\n\nAs saídas podem ter no máximo 1 MB por trabalho. O total de todas as saídas em uma execução de fluxo de trabalho pode ter no máximo 50 MB. O tamanho é aproximado com base na codificação UTF-16.\n\n### Exemplo: Declarando saídas para ações compostas\n\n```yaml\noutputs:\n  random-number:\n    description: \"Random number\"\n    value: ${{ steps.random-number-generator.outputs.random-id }}\nruns:\n  using: \"composite\"\n  steps:\n    - id: random-number-generator\n      run: echo \"random-id=$(echo $RANDOM)\" >> $GITHUB_OUTPUT\n      shell: bash\n```\n\n### `outputs.<output_id>.value`\n\n```\n          **Obrigatório** O valor para o qual o parâmetro de saída será mapeado. Defina isso como uma `string` ou uma expressão com um contexto. Por exemplo, você pode usar o contexto `steps` para definir o `value` de uma saída como o valor de saída de uma etapa.\n```\n\nPara obter mais informações sobre como usar a sintaxe de contexto, consulte [Referência de contextos](/pt/enterprise-cloud@latest/actions/learn-github-actions/contexts).\n\n## `runs`\n\n```\n          **Obrigatório** Especifica se esta é uma ação de JavaScript, uma ação composta ou uma ação de contêiner do Docker e como a ação é executada.\n```\n\n##\n\n```\n          `runs` para ações de JavaScript\n\n          **Obrigatório** Configura o caminho para o código da ação e o runtime usado para executar o código.\n```\n\n### Exemplo: usar o Node.js v24\n\n```yaml\nruns:\n  using: 'node24'\n  main: 'main.js'\n```\n\n###\n\n```\n          `runs.using` para ações de JavaScript\n\n          **Obrigatório** O runtime usado para executar o código especificado em [`main`](#runsmain).\n```\n\n* Use `node20` para Node.js v20.\n* Usar `node24` para Node.js v24.\n\n### `runs.main`\n\n```\n          **Obrigatório** O arquivo que contém o código de ação. O runtime especificado em [`using`](#runsusing-for-javascript-actions) executa este arquivo.\n```\n\n### `runs.pre`\n\n```\n          **Opcional** Permite que você execute um script no início de um trabalho, antes do início da ação `main:`. Por exemplo, você pode usar `pre:` para executar um script de configuração de pré-requisito. O runtime especificado com a sintaxe [`using`](#runsusing-for-javascript-actions) executará esse arquivo. A ação `pre:` sempre é executada por padrão, mas você pode substituir isso usando [`runs.pre-if`](#runspre-if).\n```\n\n> \\[!NOTE]\n\n```\n          `runs.pre` não tem suporte para ações locais.\n```\n\nNeste exemplo, a ação `pre:` executa um script chamado `setup.js`:\n\n```yaml\nruns:\n  using: 'node24'\n  pre: 'setup.js'\n  main: 'index.js'\n  post: 'cleanup.js'\n```\n\n### `runs.pre-if`\n\n```\n          **Opcional** Permite definir condições para a execução da ação `pre:`. A ação `pre:` só será executada se as condições em `pre-if` forem atendidas. Se isso não estiver definido, `pre-if` usará `always()` como padrão. Em `pre-if`, as funções de verificação de status são avaliadas em relação ao status do trabalho, não ao status próprio da ação.\n```\n\nObserve que o contexto `step` não está disponível, pois nenhuma etapa foi executada ainda.\n\nNeste exemplo, `cleanup.js` só é executado em executores baseados em Linux:\n\n```yaml\n  pre: 'cleanup.js'\n  pre-if: runner.os == 'linux'\n```\n\n### `runs.post`\n\n```\n          **Opcional** Permite que você execute um script no final de um trabalho, depois que a ação `main:` for concluída. Por exemplo, você pode usar `post:` para encerrar alguns processos ou remover arquivos desnecessários. O runtime especificado com a sintaxe [`using`](#runsusing-for-javascript-actions) executará esse arquivo.\n```\n\nNeste exemplo, a ação `post:` executa um script chamado `cleanup.js`:\n\n```yaml\nruns:\n  using: 'node24'\n  main: 'index.js'\n  post: 'cleanup.js'\n```\n\nA ação `post:` sempre é executada por padrão, mas você pode substituir isso usando `post-if`.\n\n### `runs.post-if`\n\n```\n          **Opcional** Permite definir 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 isso não estiver definido, `post-if` usará `always()` como padrão. Em `post-if`, as funções de verificação de status são avaliadas em relação ao status do trabalho, não ao status próprio da ação.\n```\n\nPor exemplo, este `cleanup.js` só será executado em executores baseados em Linux:\n\n```yaml\n  post: 'cleanup.js'\n  post-if: runner.os == 'linux'\n```\n\n##\n\n```\n          `runs` para ações compostas\n\n          **Obrigatório** Configura o caminho para a ação composta.\n```\n\n###\n\n```\n          `runs.using` para ações compostas\n\n          **Obrigatório** Você precisa definir esse valor como `'composite'`.\n```\n\n### `runs.steps`\n\n```\n          **Obrigatório** As etapas que você pretende executar nesta ação. Elas podem ser etapas `run` ou etapas `uses`.\n```\n\n#### `runs.steps[*].run`\n\n```\n          **Opcional** O comando que você deseja executar. Essa opção pode ser embutida ou um script no repositório de ação:\n```\n\n```yaml\nruns:\n  using: \"composite\"\n  steps:\n    - run: ${{ github.action_path }}/test/script.sh\n      shell: bash\n```\n\nComo alternativa, você pode usar `$GITHUB_ACTION_PATH`:\n\n```yaml\nruns:\n  using: \"composite\"\n  steps:\n    - run: $GITHUB_ACTION_PATH/script.sh\n      shell: bash\n```\n\nPara saber mais, confira [Referência de contextos](/pt/enterprise-cloud@latest/actions/learn-github-actions/contexts#github-context).\n\n#### `runs.steps[*].shell`\n\n```\n          **Opcional** O shell no qual você deseja executar o comando. Você pode usar qualquer um dos shells listados em [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsshell). Obrigatório se `run` for definido.\n```\n\n#### `runs.steps[*].if`\n\n```\n          **Opcional** Use o condicional `if` para impedir que uma etapa seja executada, a não ser que uma condição seja atendida. Você pode usar qualquer contexto e expressão compatível para criar uma condicional.\n```\n\nAo usar expressões em um condicional `if`, opcionalmente, você poderá omitir a sintaxe de expressão `${{ }}`, pois o GitHub Actions avalia automaticamente o condicional `if` como uma expressão. No entanto, essa exceção não se aplica a todos os lugares.\n\nVocê sempre deverá usar a sintaxe de expressão `${{ }}` ou escapar com `''`, `\"\"` ou `()` quando a expressão começar com `!`, já que `!` é a notação reservada no formato YAML. Por exemplo:\n\n```yaml\nif: ${{ ! startsWith(github.ref, 'refs/tags/') }}\n```\n\nPara obter mais informações, confira [Avaliar expressões em fluxos de trabalho e ações](/pt/enterprise-cloud@latest/actions/learn-github-actions/expressions).\n\n```\n          **Exemplo: Usando contextos**\n```\n\nEssa etapa só é executada quando o tipo de evento é uma `pull_request` e a ação do evento é `unassigned`.\n\n```yaml\nsteps:\n  - run: echo This event is a pull request that had an assignee removed.\n    if: ${{ github.event_name == 'pull_request' && github.event.action == 'unassigned' }}\n```\n\n```\n          **Exemplo: Usando funções de verificação de status**\n```\n\nO `my backup step` só é executado quando o passo anterior de uma ação composta falha. Para saber mais, confira [Avaliar expressões em fluxos de trabalho e ações](/pt/enterprise-cloud@latest/actions/learn-github-actions/expressions#status-check-functions).\n\n```yaml\nsteps:\n  - name: My first step\n    uses: octo-org/action-name@main\n  - name: My backup step\n    if: ${{ failure() }}\n    uses: actions/heroku@1.0.0\n```\n\n#### `runs.steps[*].name`\n\n```\n          **Opcional** O nome da etapa composta.\n```\n\n#### `runs.steps[*].id`\n\n```\n          **Opcional** Um identificador exclusivo da etapa. Use a `id` para referenciar a etapa em contextos. Para saber mais, confira [AUTOTITLE](/actions/learn-github-actions/contexts).\n```\n\n#### `runs.steps[*].env`\n\n```\n          **Opcional** Define um conjunto de variáveis de ambiente somente para essa etapa. Caso deseje modificar a variável de ambiente armazenada no fluxo de trabalho, use `echo \"{name}={value}\" >> $GITHUB_ENV` em uma etapa composta.\n```\n\n#### `runs.steps[*].working-directory`\n\n```\n          **Opcional** Especifica o diretório de trabalho em que o comando é executado.\n```\n\n#### `runs.steps[*].uses`\n\n```\n          **Opcional** Seleciona uma ação para executá-la como parte de uma etapa no trabalho. A ação é uma unidade reutilizável de código. Você pode usar uma ação definida no mesmo repositório do fluxo de trabalho, um repositório público ou em uma [imagem publicada de um contêiner do Docker](https://hub.docker.com/).\n```\n\nÉ altamente recomendável incluir a versão da ação que você está usando ao especificar um ref do Git, SHA ou número de tag do Docker. 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.\n\n* Usar o commit SHA de uma versão de ação lançada é a maneira mais garantida de obter estabilidade e segurança.\n* 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.\n* 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.\n\nAlgumas ações exigem entradas que precisam ser definidas com a palavra-chave [`with`](/pt/enterprise-cloud@latest/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepswith). Revise o arquivo README da ação para determinar as entradas obrigatórias.\n\n```yaml\nruns:\n  using: \"composite\"\n  steps:\n    # Reference a specific commit\n    - uses: actions/checkout@8f4b7f84864484a7bf31766abe9204da3cbe65b3\n    # Reference the major version of a release\n    - uses: actions/checkout@v6\n    # Reference a specific version\n    - uses: actions/checkout@v6.2.0\n    # Reference a branch\n    - uses: actions/checkout@main\n    # References a subdirectory in a public GitHub repository at a specific branch, ref, or SHA\n    - uses: actions/aws/ec2@main\n    # References a local action\n    - uses: ./.github/actions/my-action\n    # References a docker public registry action\n    - uses: docker://gcr.io/cloud-builders/gradle\n    # Reference a docker image published on docker hub\n    - uses: docker://alpine:3.8\n```\n\n#### `runs.steps[*].with`\n\n```\n          **Opcional** Um `map` dos parâmetros de entrada definidos pela ação. Cada parâmetro de entrada é um par chave/valor. Para obter mais informações, confira [Exemplo: como especificar entradas](#example-specifying-inputs).\n```\n\n```yaml\nruns:\n  using: \"composite\"\n  steps:\n    - name: My first step\n      uses: actions/hello_world@main\n      with:\n        first_name: Mona\n        middle_name: The\n        last_name: Octocat\n```\n\n#### `runs.steps[*].continue-on-error`\n\n```\n          **Opcional** Impede que a ação falhe quando uma etapa falha. Defina como `true` para permitir que a ação continue se esta etapa falhar.\n```\n\n##\n\n```\n          `runs` para ações de contêiner do Docker\n\n          **Obrigatório** Configura a imagem usada para a ação de contêiner do Docker.\n```\n\n### Exemplo: Usando um arquivo do Dockerfile no seu repositório\n\n```yaml\nruns:\n  using: 'docker'\n  image: 'Dockerfile'\n```\n\n### Exemplo: Usando o contêiner de registro público do Docker\n\n```yaml\nruns:\n  using: 'docker'\n  image: 'docker://debian:stretch-slim'\n```\n\n###\n\n```\n          `runs.using` para ações de contêiner do Docker\n\n          **Obrigatório** Você precisa definir esse valor como `'docker'`.\n```\n\n### `runs.pre-entrypoint`\n\n```\n          **Opcional** Permite que você execute um script antes do início da ação `entrypoint`. Por exemplo, você pode usar `pre-entrypoint:` para executar um script de configuração de pré-requisito. O GitHub Actions usa `docker run` para iniciar esta ação e executa o script dentro de um novo contêiner que usa a mesma imagem base. Isso significa que o estado de runtime é diferente do contêiner `entrypoint` principal, e todos os status que você exigir precisarão ser acessados no workspace, `HOME`, ou como uma variável `STATE_`. A ação `pre-entrypoint:` sempre é executada por padrão, mas você pode substituir isso usando [`runs.pre-if`](#runspre-if).\n```\n\nO runtime especificado com a sintaxe [`using`](#runsusing-for-docker-container-actions) executará esse arquivo.\n\nNeste exemplo, a ação `pre-entrypoint:` executa um script chamado `setup.sh`:\n\n```yaml\nruns:\n  using: 'docker'\n  image: 'Dockerfile'\n  args:\n    - 'bzz'\n  pre-entrypoint: 'setup.sh'\n  entrypoint: 'main.sh'\n```\n\n### `runs.image`\n\n```\n          **Obrigatório** A imagem Docker a ser usada como contêiner para executar a ação. O valor pode ser o nome da imagem base do Docker, um `Dockerfile` local no seu repositório ou uma imagem pública do Docker Hub ou de outro registro. Para referenciar um `Dockerfile` local no seu repositório, o arquivo precisa ser nomeado `Dockerfile` e você precisa usar um caminho relativo ao arquivo de metadados da ação. O aplicativo `docker` executará esse arquivo.\n```\n\n### `runs.env`\n\n```\n          **Opcional** Especifica um mapa de chave/valor das variáveis do ambiente a serem definidas no ambiente do contêiner.\n```\n\n### `runs.entrypoint`\n\n```\n          **Opcional** Substitui o `ENTRYPOINT` do Docker no `Dockerfile` ou define-o caso ainda não tenha sido especificado. Use `entrypoint` quando `Dockerfile` não especificar um `ENTRYPOINT` ou você desejar substituir a instrução `ENTRYPOINT`. Se você omitir `entrypoint`, os comandos especificados na instrução `ENTRYPOINT` do Docker serão executados. A instrução `ENTRYPOINT` do Docker tem um formulário de _shell_ e um formulário de _execução_. A documentação de `ENTRYPOINT` do Docker recomenda o uso da forma _exec_ da instrução `ENTRYPOINT`.\n```\n\nPara obter mais informações sobre como `entrypoint` é executado, confira [Suporte do Dockerfile para GitHub Actions](/pt/enterprise-cloud@latest/actions/creating-actions/dockerfile-support-for-github-actions#entrypoint).\n\n### `runs.post-entrypoint`\n\n```\n          **Opcional** Permite executar um script de limpeza depois que a ação `runs.entrypoint` for concluída. O GitHub Actions usa `docker run` para iniciar esta ação. Como o GitHub Actions executa o script dentro de um novo contêiner usando a mesma imagem base, o estado do runtime é diferente do contêiner `entrypoint` principal. Você pode acessar qualquer estado necessário tanto no workspace, `HOME`, quanto como uma variável `STATE_`. A ação `post-entrypoint:` sempre é executada por padrão, mas você pode substituir isso usando [`runs.post-if`](#runspost-if).\n```\n\n```yaml\nruns:\n  using: 'docker'\n  image: 'Dockerfile'\n  args:\n    - 'bzz'\n  entrypoint: 'main.sh'\n  post-entrypoint: 'cleanup.sh'\n```\n\n### `runs.args`\n\n```\n          **Opcional** Uma matriz de cadeias de caracteres que define as entradas de um contêiner do Docker. As entradas podem incluir strings com codificação rígida. O GitHub transmite os `args` para o `ENTRYPOINT` do contêiner quando o contêiner é iniciado.\n```\n\nOs `args` são usados no lugar da instrução `CMD` em um `Dockerfile`. Se você usar `CMD` no `Dockerfile`, use as diretrizes ordenadas por preferência:\n\n1. Documente os argumentos necessários no README da ação e omita-os da instrução `CMD`.\n2. Use padrões que permitam o uso da ação sem a especificação de `args`.\n3. Se a ação expuser um sinalizador `--help` ou algo semelhante, use-o para tornar a ação autodocumentada.\n\nSe 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 o atributo `entrypoint` estiver definido como `\"sh -c\"`, `args` será executado em um shell de comando. Como alternativa, se o `Dockerfile` usar um `ENTRYPOINT` para executar o mesmo comando (`\"sh -c\"`), `args` será executado em um shell de comando.\n\nPara obter mais informações sobre como usar a instrução `CMD` com GitHub Actions, confira [Suporte do Dockerfile para GitHub Actions](/pt/enterprise-cloud@latest/actions/creating-actions/dockerfile-support-for-github-actions#cmd).\n\n#### Exemplo: Definir argumentos para o contêiner do Docker\n\n```yaml\nruns:\n  using: 'docker'\n  image: 'Dockerfile'\n  args:\n    - ${{ inputs.greeting }}\n    - 'foo'\n    - 'bar'\n```\n\n## `branding`\n\n```\n          **Opcional** Você pode usar uma cor e um ícone [Feather](https://feathericons.com/) para criar um distintivo para personalizar e distinguir sua ação. Emblemas são exibidos ao lado do seu nome da ação no [GitHub Marketplace](https://github.com/marketplace?type=actions).\n```\n\n### Exemplo: Configurar a marca para uma ação\n\n```yaml\nbranding:\n  icon: 'award'\n  color: 'green'\n```\n\n### `branding.color`\n\nCor de fundo do selo. Pode ser: `white`, `black`, `yellow`, `blue`, `green`, `orange`, `red`, `purple` ou `gray-dark`.\n\n### `branding.icon`\n\nO nome do ícone de [Pena](https://feathericons.com/) v4.28.0 a ser usado.\n\n#### Ícones omitidos\n\nOs ícones de marca, e todos os ícones a seguir, são omitidos.\n\n<ul style=\"-webkit-column-count: 4; -moz-column-count: 4; column-count: 4;\">\n<li>café</li>\n<li>colunas</li>\n<li>divide-circle</li>\n<li>divide-square</li>\n<li>dividir</li>\n<li>frown</li>\n<li>hexágono</li>\n<li>chave</li>\n<li>meh</li>\n<li>ponteiro do mouse</li>\n<li>sorriso</li>\n<li>ferramenta</li>\n<li>x-octagon</li>\n</ul>\n\n#### Lista completa de todos os ícones com suporte no momento\n\n<!--\n  This list should match the icon list in `app/models/repository_actions/icons.rb` in the internal github repo.\n  To support a new icon, update `app/models/repository_actions/icons.rb` and add the svg to `/static/images/icons/feather` in the internal github repo.\n-->\n\n<ul style=\"-webkit-column-count: 4; -moz-column-count: 4; column-count: 4;\">\n<li>atividade</li>\n<li>frequência de execução</li>\n<li>alerta-círculo</li>\n<li>alerta-octagon</li>\n<li>triângulo de alerta</li>\n<li>alinhar-centro</li>\n<li>alinhar-justificar</li>\n<li>alinhar-esquerda</li>\n<li>alinhar-direita</li>\n<li>âncora</li>\n<li>abertura</li>\n<li>arquivar</li>\n<li>círculo com flecha para baixo</li>\n<li>flecha-abaixo-esquerda</li>\n<li>flecha-abaixo-direita</li>\n<li>flecha-abaixo</li>\n<li>flecha-esquerda-círculo</li>\n<li>flecha-esquerda</li>\n<li>flecha-direita-círculo</li>\n<li>flecha-direita</li>\n<li>flecha-acima-círculo</li>\n<li>flecha-acima-esquerda</li>\n<li>flecha-acima-direita</li>\n<li>arrow-up</li>\n<li>arroba</li>\n<li>prêmio</li>\n<li>barra-quadro-2</li>\n<li>gráfico de barras</li>\n<li>carregamento da bateria</li>\n<li>bateria</li>\n<li>sino-desativado</li>\n<li>campainha</li>\n<li>bluetooth</li>\n<li>negrito</li>\n<li>livro-aberto</li>\n<li>livro</li>\n<li>indicador</li>\n<li>box</li>\n<li>pasta</li>\n<li>calendário</li>\n<li>câmera-desligada</li>\n<li>câmera</li>\n<li>conversão</li>\n<li>círculo de verificação</li>\n<li>marcar-quadrado</li>\n<li>verificação</li>\n<li>chevron-abaixo</li>\n<li>Chevron à esquerda</li>\n<li>chevron-direita</li>\n<li>chevron-acima</li>\n<li>chevrons-abaixo</li>\n<li>chevrons-esquerda</li>\n<li>chevrons-direita</li>\n<li>chevrons-acima</li>\n<li>círculo</li>\n<li>área de transferência</li>\n<li>relógio</li>\n<li>nuvem-chuvisco</li>\n<li>nuvem-relâmpago</li>\n<li>nuvem-desativada</li>\n<li>nuvem-chuva</li>\n<li>nuvem-neve</li>\n<li>nuvem</li>\n<li>codificar</li>\n<li>comando</li>\n<li>compass</li>\n<li>copiar</li>\n<li>canto-abaixo-esquerda</li>\n<li>canto-abaixo-direita</li>\n<li>canto-esquerda-abaixo</li>\n<li>canto-esquerda-acima</li>\n<li>canto-direita-abaixo</li>\n<li>canto-direita-acima</li>\n<li>canto-acima-esquerda</li>\n<li>canto-acima-direita</li>\n<li>cpu</li>\n<li>cartão-de-crédito</li>\n<li>cortar</li>\n<li>mira</li>\n<li>banco de dados</li>\n<li>excluir</li>\n<li>disco</li>\n<li>sinal de dólar</li>\n<li>download-nuvem</li>\n<li>baixar</li>\n<li>droplet</li>\n<li>editar-2</li>\n<li>editar-3</li>\n<li>edição</li>\n<li>link-externo</li>\n<li>olho-fechado</li>\n<li>olho</li>\n<li>avançar rapidamente</li>\n<li>pena</li>\n<li>arquivo-menos</li>\n<li>arquivo-plus</li>\n<li>arquivo-texto</li>\n<li>arquivo</li>\n<li>filme</li>\n<li>filtro</li>\n<li>sinalizador</li>\n<li>pasta-menos</li>\n<li>pasta-mais</li>\n<li>pasta</li>\n<li>presente</li>\n<li>git-branch</li>\n<li>git-commit</li>\n<li>git-merge</li>\n<li>git-pull-request (solicitação de pull do Git)</li>\n<li>globo</li>\n<li>grade</li>\n<li>disco-rígido</li>\n<li>hash</li>\n<li>fones-de-ouvido</li>\n<li>coração</li>\n<li>círculo de ajuda</li>\n<li>página inicial</li>\n<li>imagem</li>\n<li>caixa de entrada</li>\n<li>informações</li>\n<li>itálico</li>\n<li>camadas</li>\n<li>layout</li>\n<li>boia salva-vidas</li>\n<li>link-2</li>\n<li>link</li>\n<li>lista</li>\n<li>carregador</li>\n<li>bloquear</li>\n<li>log-in</li>\n<li>log-out</li>\n<li>email</li>\n<li>fixar-mapa</li>\n<li>mapa</li>\n<li>maximizar-2</li>\n<li>maximizar</li>\n<li>menu</li>\n<li>círculo de mensagens</li>\n<li>mensagem-quadrado</li>\n<li>microfone-desligado</li>\n<li>Microfone</li>\n<li>minimizar-2</li>\n<li>minimizar</li>\n<li>menos-círculo</li>\n<li>menos-quadrado</li>\n<li>negativo</li>\n<li>monitor</li>\n<li>lua</li>\n<li>mais horizontal</li>\n<li>mais-vertical</li>\n<li>move</li>\n<li>música</li>\n<li>navegação-2</li>\n<li>navegação</li>\n<li>octágono</li>\n<li>pacote</li>\n<li>clipe de papel</li>\n<li>ícone de pausa</li>\n<li>pausar</li>\n<li>por cento</li>\n<li>chamada-telefônica</li>\n<li>telefone-transferência</li>\n<li>telefone-entrada</li>\n<li>telefone-perdido</li>\n<li>telefone-desligado</li>\n<li>telefone-fora</li>\n<li>telefone</li>\n<li>gráfico-pizza</li>\n<li>reproduzir-círculo</li>\n<li>executar</li>\n<li>mais-círculo</li>\n<li>mais-quadrado</li>\n<li>mais</li>\n<li>bolso</li>\n<li>potência</li>\n<li>impressora</li>\n<li>rádio</li>\n<li>atualizar-ccw</li>\n<li>atualizar cw</li>\n<li>repetir</li>\n<li>retroceder</li>\n<li>girar-ccw</li>\n<li>girar-cw</li>\n<li>rss</li>\n<li>Salvar</li>\n<li>tesoura</li>\n<li>busca</li>\n<li>enviar</li>\n<li>servidor</li>\n<li>configurações</li>\n<li>compartilhar-2</li>\n<li>compartilhamento</li>\n<li>escudo-desabilitado</li>\n<li>escudo</li>\n<li>sacola-de-compras</li>\n<li>carrinho-de-compras</li>\n<li>shuffle</li>\n<li>barra lateral</li>\n<li>pular-atrás</li>\n<li>pular-frente</li>\n<li>slash</li>\n<li>controles deslizantes</li>\n<li>smartphone</li>\n<li>alto-falante</li>\n<li>square</li>\n<li>estrela</li>\n<li>círculo de parada</li>\n<li>sol</li>\n<li>nascer-do-sol</li>\n<li>pôr do sol</li>\n<li>tabela</li>\n<li>tablet</li>\n<li>marca</li>\n<li>destino</li>\n<li>terminal</li>\n<li>termômetro</li>\n<li>polegar-para-baixo</li>\n<li>polegar-para-cima</li>\n<li>alternar-esquerda</li>\n<li>alternar-direita</li>\n<li>lixeira-2</li>\n<li>jogar no lixo</li>\n<li>tendência de queda</li>\n<li>tendência de alta</li>\n<li>triângulo</li>\n<li>caminhão</li>\n<li>tv</li>\n<li>tipo</li>\n<li>guarda-chuva</li>\n<li>sublinhado</li>\n<li>desbloquear</li>\n<li>enviar para a nuvem</li>\n<li>carregamento</li>\n<li>usuário-marcar</li>\n<li>usuário-menos</li>\n<li>usuário premium</li>\n<li>usuário-x</li>\n<li>usuário</li>\n<li>usuários</li>\n<li>vídeo-desligado</li>\n<li>vídeo</li>\n<li>correio de voz</li>\n<li>volume-1</li>\n<li>volume-2</li>\n<li>volume-x</li>\n<li>volume</li>\n<li>inspeção</li>\n<li>wifi-desligado</li>\n<li>wifi</li>\n<li>vento</li>\n<li>x-círculo</li>\n<li>x-quadrado</li>\n<li>x</li>\n<li>zapear-desligado</li>\n<li>zap</li>\n<li>ampliar</li>\n<li>afastar</li>\n</ul>\n\n## Alterando o nome do arquivo de metadados\n\nEmbora o arquivo de metadados de ações dê suporte a ambos os formatos YAML, alterar o nome dele (de `action.yml` para `action.yaml` ou vice-versa) entre as versões afetará as versão anteriores que foram publicadas no GitHub Marketplace. Ao alterar o nome do arquivo, todas as versões de lançamento associadas ao nome do arquivo anterior serão ocultadas do GitHub Marketplace. As versões anteriores ainda estarão acessíveis para os usuários por meio do repositório de origem.\n\nAo lançar novas versões das ações, somente as versões lançadas após a alteração do nome do arquivo de metadados terão a marca GitHub Marketplace e aparecerão no GitHub Marketplace"}