Skip to main content

Esta versão do GitHub Enterprise Server foi descontinuada em 2024-07-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Início rápido para GitHub Actions

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

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Introdução

GitHub Actions é uma plataforma de integração contínua e entrega contínua (CI/CD) que permite automatizar a sua compilação, testar e pipeline de implantação. É possível criar fluxos de trabalho que criam e testam cada pull request no seu repositório, ou implantar pull requests mesclados em produção.

Este guia de início rápido mostra como usar a interface do usuário de sua instância do GitHub Enterprise Server para adicionar um fluxo de trabalho que demonstra alguns dos recursos essenciais de GitHub Actions.

Para obter uma visão geral sobre fluxos de trabalho de GitHub Actions, confira "Sobre fluxos de trabalho." Se você quiser saber mais sobre os vários componentes que compõem GitHub Actions, consulte "Entendendo o GitHub Actions".

Pré-requisitos

Este guia supõe que:

Criar o seu primeiro fluxo de trabalho

  1. Em seu repositório em sua instância do GitHub Enterprise Server, crie um arquivo de fluxo de trabalho chamado github-actions-demo.yml no diretório .github/workflows. Para fazer isso:

    • Se o diretório .github/workflows já existir, navegue até esse diretório em GitHub, clique em Adicionar arquivo e, em seguida, clique em Criar novo arquivo e nomeie o arquivo como github-actions-demo.yml.

    • Se o repositório não tiver um diretório .github/workflows, vá para a página principal do repositório em GitHub, clique em Adicionar arquivo e, em seguida, clique em Criar novo arquivo e nomeie o arquivo como .github/workflows/github-actions-demo.yml. Isso criará os diretórios .github e workflows e o arquivo github-actions-demo.yml em uma única etapa.

    Note

    Para que GitHub descubra quaisquer fluxos de trabalho GitHub Actions do repositório, você deverá salvar os arquivos do fluxo de trabalho em um diretório chamado .github/workflows.

    É possível dar ao arquivo de fluxo de trabalho qualquer nome que desejar, mas você deverá usar .yml ou .yaml como a extensão de nome de arquivo. YAML é uma linguagem de marcação comumente usada para arquivos de configuração.

  2. 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 }}."
    

    Neste estágio, você não precisa entender os detalhes desse fluxo de trabalho. Por enquanto, só é possível copiar e colar o conteúdo no arquivo. Depois de concluir este guia de início rápido, você poderá aprender sobre a sintaxe dos arquivos de fluxo de trabalho em "AUTOTITLE" e, para obter uma explicação dos contextos de GitHub Actions, como ${{ github.actor }} e ${{ github.event_name }}, consulte "Contextos".

  3. Clique em Confirmar alterações.

  4. Na caixa de diálogo "Propor alterações", selecione a opção para confirmar o branch padrão ou a opção para criar um novo branch e iniciar uma solicitação de pull. Em seguida, clique em Fazer commit de alterações ou em Propor alterações.

    Captura de tela da caixa de diálogo "Propor alterações" com as áreas mencionadas destacadas com um contorno laranja.

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

Se você optar por iniciar uma solicitação de pull, poderá continuar e criar a solicitação de pull, mas isso não será necessário para os fins deste início rápido, pois a confirmação ainda foi feita em um branch e acionará o novo fluxo de trabalho.

Visualizar os resultados do seu fluxo de trabalho

  1. No sua instância do GitHub Enterprise Server, 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, é possível ver a lista de arquivos no repositório:

    Captura de tela da etapa "Listar arquivos no repositório" expandida para mostrar a saída do log. A saída da etapa é realçada com um contorno laranja.

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 Server 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 do sua instância do GitHub Enterprise Server.

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.