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
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
-
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. -
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". -
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 }}."
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 }}."
-
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.
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
-
No sua instância do GitHub Enterprise Server, navegue até a página principal do repositório.
-
No nome do repositório, clique em Ações.
-
Na barra lateral esquerda, clique no fluxo de trabalho que deseja exibir, neste exemplo "Demonstração do GitHub Actions".
-
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".
-
Na barra lateral esquerda da página de execução do fluxo de trabalho, em Trabalhos, clique no trabalho Explore-GitHub-Actions.
-
O registro mostra como cada uma das etapas foi processada. Expanda qualquer um dos passos para ver seus detalhes.
Por exemplo, você pode ver a lista de arquivos do repositório:
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.