{"meta":{"title":"Fluxos de trabalho","intro":"Obtenha uma visão geral de alto nível dos fluxos de GitHub Actions trabalho, incluindo gatilhos, sintaxe e recursos avançados.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/concepts","title":"Conceitos"},{"href":"/pt/actions/concepts/workflows-and-actions","title":"Fluxos de trabalho e ações"},{"href":"/pt/actions/concepts/workflows-and-actions/workflows","title":"Fluxos de trabalho"}],"documentType":"article"},"body":"# Fluxos de trabalho\n\nObtenha uma visão geral de alto nível dos fluxos de GitHub Actions trabalho, incluindo gatilhos, sintaxe e recursos avançados.\n\n## Sobre fluxos de trabalho\n\nUm **fluxo de trabalho** é um processo automatizado configurável que executará um ou mais trabalhos. Os fluxos de trabalho são definidos por um arquivo YAML verificado no seu repositório e será executado quando acionado por um evento no repositório, ou eles podem ser acionados manualmente ou de acordo com um cronograma definido.\n\nOs fluxos de trabalho são definidos no diretório `.github/workflows` de um repositório. Um repositório pode ter vários fluxos de trabalho, cada um dos quais pode executar um conjunto diferente de tarefas, como:\n\n* Como criar e testar pull requests\n* Como implantar seu aplicativo sempre que uma versão for criada\n* Como adicionar um rótulo sempre que um novo problema for aberto\n\n## Noções básicas do fluxo de trabalho\n\nUm fluxo de trabalho precisa conter os seguintes componentes básicos:\n\n1. Um ou mais *eventos* que acionarão o fluxo de trabalho.\n2. Um ou mais *tarefas*, cada uma sendo executada em uma máquina *runner* e realizando uma série de uma ou mais *etapas*.\n3. Cada etapa pode executar um script que você define ou executa uma ação, que é uma extensão reutilizável que pode simplificar seu fluxo de trabalho.\n\nPara obter mais informações sobre esses componentes básicos, confira [Noções básicas sobre GitHub Actions](/pt/actions/get-started/understand-github-actions#the-components-of-github-actions).\n\n![Diagrama de um evento que dispara o Executor 1 para executar o Trabalho 1, que dispara o Executor 2 para executar o Trabalho 2. Cada um dos trabalhos é dividido em várias etapas.](/assets/images/help/actions/overview-actions-simple.png)\n\n## Gatilhos do fluxo de trabalho\n\nOs acionadores de fluxo de trabalho são eventos que fazem com que um fluxo de trabalho seja executado. Esses eventos podem ser:\n\n* Eventos que ocorrem no repositório do fluxo de trabalho\n* Eventos que ocorrem fora de GitHub e acionam um evento `repository_dispatch` em GitHub\n* Horários agendados\n* Manual\n\nPor exemplo, você pode configurar o fluxo de trabalho para executar quando um push é feito no branch padrão do seu repositório, quando uma versão é criada, ou quando um problema é aberto.\n\nOs gatilhos de fluxo de trabalho são definidos com a chave `on`. Para saber mais, confira [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax#on).\n\nAs etapas a seguir ocorrem para acionar a execução de um fluxo de trabalho:\n\n1. Um evento ocorre no seu repositório. O evento tem um SHA de commit associado e um ref de Git.\n2. GitHub procura no diretório `.github/workflows` na raiz do seu repositório por arquivos de fluxo de trabalho que estão presentes no commit SHA associado ou na Git ref do evento.\n3. A execução de um fluxo de trabalho é disparada para todos os fluxos de trabalho que têm valores `on:` correspondentes ao evento de gatilho. Alguns eventos também exigem que o arquivo do fluxo de trabalho esteja presente no branch padrão do repositório para ser executado.\n\nCada execução de fluxo de trabalho usará a versão do fluxo de trabalho presente no commit SHA ou na referência do Git associados ao evento. Quando um fluxo de trabalho é executado, GitHub define as `GITHUB_SHA` variáveis de ambiente (commit SHA) e `GITHUB_REF` (Git ref) no ambiente do executor. Para saber mais, confira [Armazenar informações em variáveis](/pt/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables).\n\nPara saber mais, confira [Acionando um fluxo de trabalho](/pt/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow).\n\n## Próximas etapas\n\nPara criar seu primeiro fluxo de trabalho, confira [Criando um exemplo de fluxo de trabalho](/pt/actions/tutorials/create-an-example-workflow)."}