Como usar: Gerador de fluxos de trabalho do GitHub Actions
- Escolha sua pilha e os branches nos quais o fluxo de trabalho deve ser executado.
- Escolha os gatilhos — push, pull requests, execuções manuais, tags de versão ou uma programação.
- Escolha as etapas e as versões que você quer testar e, se quiser, um destino de implantação.
- Salve o arquivo YAML como
.github/workflows/ci.yml, adicione os segredos listados em Configurações → Segredos e variáveis → Ações e faça o push.
Anatomia de um fluxo de trabalho
| Chave | Objetivo |
|---|---|
on | Eventos que dão início ao fluxo de trabalho: push, pull_request, schedule, workflow_dispatch |
permissions | O que o sistema automático GITHUB_TOKEN pode fazer — mantenha isso no mínimo |
concurrency | Cancela execuções desatualizadas no mesmo branch |
jobs.<id>.runs-on | O executor, por exemplo ubuntu-latest |
strategy.matrix | Executa a tarefa uma vez por versão |
steps | uses: uma ação ou run: um comando de shell |
Ações usadas
O gerador vincula as ações oficiais às suas versões principais atuais — actions/checkout@v4, actions/setup-node@v4, actions/setup-python@v5, actions/setup-go@v5, actions/cache@v4, actions/upload-pages-artifact@v3, actions/deploy-pages@v4 e as do Docker docker/build-push-action@v6. Para garantir o máximo de segurança na cadeia de suprimentos, vincule as ações de terceiros a um SHA de commit completo.
Segredos e variáveis de ambiente
Nunca faça commit de tokens. Armazene-os como segredos do repositório e leia-os com ${{ secrets.NAME }}. Mantenha uma lista das variáveis necessárias no .env.example e valide os arquivos locais com o Validador de Arquivos .env. Os fluxos de trabalho agendados usam sintaxe cron em UTC — crie expressões com o Gerador de Expressões Cron.
Certifique-se de que seu `package.json` tenha lint, test e build scripts; os aplicativos em contêineres, um arquivo Docker Compose; e valida o YAML com o conversor de YAML para JSON se o GitHub relatar um erro de sintaxe.
Também pesquisado como: gerador de ações do github, fluxo de trabalho do github actions, node do github actions, github actions yaml, pipeline de ci/cd, ação de implantação do github pages, ação de compilação e envio no docker, github actions cron.
Ferramentas que combinam com: Gerador de fluxos de trabalho do GitHub Actions
- GitLab CI Generator — Pick your stack and get a working .gitlab-ci.yml: install with caching, lint and test jobs, a build with artifacts, a Docker image pushed to the GitLab registry, or a GitLab Pages deploy — with rules that run pipelines for merge requests and your default branch without duplicates.
- Gerador de .gitignore — Marque as tecnologias que você usa — Node, Python, React, Next.js, Docker, macOS, VS Code e mais 40 — e receba uma lista organizada e sem repetições .gitignore com seções comentadas, pronto para baixar.
- YAML Validator — Paste a Docker Compose file, Kubernetes manifest, GitHub Actions workflow or any YAML to pinpoint errors, catch common pitfalls and get a cleanly formatted version.
- Kubernetes YAML Generator — Fill in your app’s name, image and port and get production-ready Kubernetes YAML: a Deployment with probes, resource limits and a hardened security context, plus the Service, Ingress with TLS, ConfigMap, Secret and HorizontalPodAutoscaler you tick — in one file ready for kubectl apply.
Perguntas frequentes
Onde eu salvo o arquivo do fluxo de trabalho?
.github/workflows/ no seu repositório, por exemplo, .github/workflows/ci.yml. O GitHub vai pegar isso no próximo push.Como faço para publicar no GitHub Pages?
Por que meu fluxo de trabalho agendado não é executado na hora certa?
O que o `npm ci` faz de diferente do `npm install`?
npm ci instala exatamente o que está no `package-lock.json`, dá erro se não corresponder ao `package.json` e é mais rápido — ideal para CI.