Skip to main content

Início rápido para GitHub Actions

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

Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.

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 repositório GitHub se este diretório não existir.

  2. No diretório .github/workflows, crie um arquivo denominado github-actions-demo.yml. Para obter mais informações, consulte "Criar arquivos".

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

    YAML
    name: GitHub Actions Demo
    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@v3
          - 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 novo branch para este commit e iniciar um pull request. Em seguida, para criar um pull request, clique em Propor novo arquivo. Arquivo do fluxo de trabalho do commit

Fazer commit do arquivo de fluxo de trabalho para um branch em seu repositório aciona o evento push e executa seu fluxo de trabalho.

Visualizar os resultados do seu fluxo de trabalho

  1. No your GitHub Enterprise Server instance, navegue até a página principal do repositório.

  2. Under your repository name, click Actions. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.

    Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar.

    Nome da execução do fluxo de trabalho

  5. Em Trabalhos, clique no trabalho Explore-GitHub-Actions.

    Localizar trabalho

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

    Exemplos de resultados do fluxo de trabalho

    Por exemplo, você pode ver a lista de arquivos no seu repositório: Exemplo do detalhe da ação

Mais fluxos de trabalho iniciais

GitHub fornece o fluxo de trabalho inicial pré-configurado que você pode personalizar para criar o seu próprio fluxo de trabalho de integração contínua. O GitHub Enterprise Server analisa o seu código e mostra o fluxo de trabalho inicial da CI que pode ser útil para o 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 o fluxo de trabalho inicial como um ponto inicial para construir o fluxo de trabalho personalizado ou usá-lo como se apresenta.

Você pode pesquisar a lista completa do fluxo de trabalho inicial no repositório actions/starter-workflows em your GitHub Enterprise Server instance.

Exemplos mais complexos

Para obter exemplos que demonstram características mais complexas do GitHub Actions, consulte "Exemplos". Você pode ver exemplos detalhados que explicam como testar seu código em um executor, acessar a CLI de GitHub e usar funcionalidades avançadas como matrizes de concorrência e teste.

Próximas etapas

O exemplo do fluxo de trabalho que você acabou de adicionar é executado cada vez que o código for enviado para o branch e mostra como GitHub Actions pode funcionar com o conteúdo do seu repositório. Mas este é apenas o início do que você pode fazer com GitHub Actions:

  • O seu repositório pode conter vários fluxos de trabalho que ativam diferentes tarefas com base em diferentes eventos.
  • Você pode usar um fluxo de trabalho para instalar aplicativos de teste de software e fazer com que testem automaticamente seu código nos executores de GitHub.

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: