Skip to main content

Início rápido para GitHub Actions

Experimente as funcionalidades de GitHub Actions em 5 minutos ou menos.

Introdução

Você precisa apenas de um repositório de GitHub para criar e executar um fluxo de trabalho de GitHub Actions. Neste guia, você adicionará um fluxo de trabalho que demonstra algumas das funcionalidades essenciais de GitHub Actions.

O exemplo a seguir mostra como os trabalhos de GitHub Actions podem ser acionados automaticamente, onde são executados e como podem interagir com o código no seu repositório.

Criar o seu primeiro fluxo de trabalho

  1. Crie um diretório .github/workflows no seu repositório do GitHub caso ele ainda não exista. O diretório deve ter esse nome exato para que o GitHub descubra quaisquer fluxos de trabalho do GitHub Actions que ele contém.

  2. No diretório .github/workflows, crie um arquivo com a extensão .yml ou .yaml. Este tutorial usará github-actions-demo.yml como o nome do arquivo. Para obter mais informações, confira "Criar arquivos".

  3. Copie o seguinte conteúdo YAML para o arquivo github-actions-demo.yml:

    YAML
    name: GitHub Actions Demo
    run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
    on: [push]
    jobs:
      Explore-GitHub-Actions:
        runs-on: ubuntu-latest
        steps:
          - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
          - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
          - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
          - name: Check out repository code
            uses: actions/checkout@v4
          - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
          - run: echo "🖥️ The workflow is now ready to test your code on the runner."
          - name: List files in the repository
            run: |
              ls ${{ github.workspace }}
          - run: echo "🍏 This job's status is ${{ job.status }}."
    
  4. Vá até o final da página e selecione Criar um branch para este commit e iniciar uma solicitação de pull. Em seguida, para criar uma solicitação de pull, clique em Propor novo arquivo.

    Captura de tela da área "Fazer commit de novo arquivo" na página.

O commit do arquivo de fluxo de trabalho em um branch no repositório dispara o evento push e executa o fluxo de trabalho.

Visualizar os resultados do seu fluxo de trabalho

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No nome do repositório, clique em Ações.

    Captura de tela das guias do repositório "github/docs". A guia "Ações" está realçada com um contorno laranja.

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja exibir, neste exemplo "Demonstração do GitHub Actions".

    Captura de tela da página "Ações". O nome do fluxo de trabalho de exemplo, "Demonstração do GitHub Actions", é realçado por um contorno laranja escuro.

  4. Na lista de execuções de fluxo de trabalho, clique no nome da execução que deseja ver. Neste exemplo "USERNAME está testando o GitHub Actions".

  5. Na barra lateral esquerda da página de execução do fluxo de trabalho, em Trabalhos, clique no trabalho Explore-GitHub-Actions.

    Captura de tela da página "Execução do fluxo de trabalho". Na barra lateral esquerda, o trabalho "Explore-GitHub-Actions" é realçado com um contorno laranja escuro.

  6. O registro mostra como cada uma das etapas foi processada. Expanda qualquer um dos passos para ver seus detalhes.

    Captura de tela das etapas executadas pelo fluxo de trabalho.

    Por exemplo, você pode ver a lista de arquivos do repositório: captura de tela da etapa "Listar arquivos do repositório" expandida para mostrar a saída do log. A saída da etapa é realçada com um contorno laranja escuro.

O fluxo de trabalho de exemplo que você acabou de adicionar é disparado cada vez que o código é enviado para o branch e mostra como GitHub Actions pode funcionar com o conteúdo do seu repositório. Para obter um tutorial detalhado, confira "Entendendo o GitHub Actions".

Mais fluxos de trabalho iniciais

O GitHub fornece fluxos de trabalho iniciais pré-configurados que você pode personalizar para criar seu fluxo de trabalho de integração contínua. O GitHub Enterprise Cloud analisa seu código e mostra os fluxos de trabalho iniciais de CI que podem ser úteis para seu repositório. Por exemplo, se o seu repositório contiver o código Node.js, você verá sugestões para projetos Node.js. Você pode usar fluxos de trabalho iniciais como ponto de partida para criar seu fluxo de trabalho personalizado ou usá-los no estado em que se encontram.

Navegue pela lista completa de fluxos de trabalho iniciais no repositório actions/starter-workflows.

Próximas etapas

O GitHub Actions pode ajudá-lo a automatizar quase todos os aspectos dos processos de desenvolvimento do seu aplicativo. Pronto para começar? Aqui estão alguns recursos úteis para dar seus próximos passos com GitHub Actions:

  • Para conhecer uma maneira rápida de criar um fluxo de trabalho do GitHub Actions, consulte "Usando fluxos de trabalho iniciais".
  • Para fluxos de trabalho de CI (integração contínua) para criar e testar seu código, confira "Automatizando criações e testes".
  • Para compilar e publicar pacotes, confira "Publicando pacotes".
  • Para implantar projetos, confira "Implantação".
  • Para automatizar tarefas e processos em GitHub, confira "Gerenciar problemas e pull requests".
  • Para obter exemplos que demonstram recursos mais complexos do GitHub Actions, incluindo muitos dos casos de uso acima, confira " Exemplos". Você pode ver exemplos detalhados que explicam como testar o seu código em um executor, acessar a CLI do GitHub e usar recursos avançados, como simultaneidade e matrizes de teste.
  • Se quiser certificar sua proficiência em automatização de fluxos de trabalho e aceleração de desenvolvimento com GitHub Actions, você pode obter um certificado de GitHub Actions com GitHub Certifications. Para obter mais informações, confira "Sobre GitHub Certifications".