{"meta":{"title":"Sobre ações personalizadas","intro":"As ações são tarefas individuais que podem ser combinadas para criar trabalhos e personalizar seu fluxo de trabalho. Você pode criar suas próprias ações ou usar e personalizar ações compartilhadas pela GitHub comunidade.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/enterprise-server@3.22/actions","title":"GitHub Actions"},{"href":"/pt/enterprise-server@3.22/actions/concepts","title":"Conceitos"},{"href":"/pt/enterprise-server@3.22/actions/concepts/workflows-and-actions","title":"Fluxos de trabalho e ações"},{"href":"/pt/enterprise-server@3.22/actions/concepts/workflows-and-actions/custom-actions","title":"Ações personalizadas"}],"documentType":"article"},"body":"# Sobre ações personalizadas\n\nAs ações são tarefas individuais que podem ser combinadas para criar trabalhos e personalizar seu fluxo de trabalho. Você pode criar suas próprias ações ou usar e personalizar ações compartilhadas pela GitHub comunidade.\n\n> \\[!NOTE]\n> No momento, não há suporte para executores hospedados no GitHub Enterprise Server no GitHub.\n\n## Sobre ações personalizadas\n\nVocê pode criar ações escrevendo código personalizado que interage com seu repositório da maneira que desejar, incluindo a integração com GitHubAPIs e qualquer API de terceiros publicamente disponível. Por exemplo, uma ação pode publicar módulos npm, enviar alertas de SMS quando problemas urgentes surgirem ou implantar o código pronto para produção.\n\nAs ações podem ser executadas diretamente em uma máquina ou em um contêiner Docker. É possível definir as entradas, saídas e variáveis do ambiente de uma ação.\n\n## Tipos de ações\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
\n\n| Tipo | Linux | macOS | Windows |\n| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| contêiner do Docker | | | |\n| JavaScript | | | |\n| Ações compostas | | | |\n\n
\n\n### Ações de contêiner do Docker\n\nOs contêineres do Docker empacotam o ambiente com o GitHub Actions código. Esse procedimento cria uma unidade de trabalho mais consistente e confiável, pois o consumidor da ação não precisa se preocupar com ferramentas ou dependências.\n\nUm contêiner Docker permite usar versões específicas de um sistema operacional, bem como as dependências, as ferramentas e o código. Para ações a serem executadas em uma configuração específica de ambiente, o Docker é a opção ideal porque permite personalizar o sistema operacional e as ferramentas. Por causa da latência para compilar e recuperar o contêiner, as ações de contêiner Docker são mais lentas que as ações JavaScripts.\n\nAs ações do contêiner Docker podem apenas ser executadas em executores com o sistema operacional Linux. Executores auto-hospedados devem usar um sistema operacional Linux e ter o Docker instalado para executar as ações do contêiner Docker. Para obter mais informações sobre os requisitos dos executores autohospedados, consulte [Referência de executores auto-hospedados](/pt/enterprise-server@3.22/actions/reference/runners/self-hosted-runners#requirements-for-self-hosted-runner-machines).\n\n### Ações de JavaScript\n\nAs ações do JavaScript podem ser executadas diretamente em uma máquina executora e separar o código de ação do ambiente usado para executar o código. Usar ações JavaScript simplifica o código da ação e é um processo mais rápido se comparado à opção do contêiner Docker.\n\nPara garantir que suas ações de JavaScript sejam compatíveis com todos os executores hospedados no GitHub (Ubuntu, Windows e macOS), o código JavaScript empacotado que você escreve deve ser JavaScript puro e não depender de outros binários. As ações JavaScript são executadas diretamente no executor e usam binários que já existem na imagem do executor.\n\nSe você estiver desenvolvendo um projeto Node.js, o GitHub Actions Kit de Ferramentas fornecerá pacotes que você pode usar em seu projeto para acelerar o desenvolvimento. Para obter mais informações, confira o repositório [actions/toolkit](https://github.com/actions/toolkit).\n\n### Ações compostas\n\nUma ação *composta* permite combinar várias etapas de fluxo de trabalho em uma ação. Por exemplo, você pode usar esse recurso para juntar vários comandos executando em uma ação e, em seguida, ter um fluxo de trabalho que executa os comandos empacotados como uma única etapa usando essa ação. Para ver um exemplo, confira [Criar uma ação composta](/pt/enterprise-server@3.22/actions/tutorials/create-actions/create-a-composite-action).\n\n## Próximas etapas\n\nPara saber mais sobre como gerenciar suas ações personalizadas, consulte [Como gerenciar ações personalizadas](/pt/enterprise-server@3.22/actions/how-tos/create-and-publish-actions/manage-custom-actions)."}