Início rápido para GitHub Actions

Introdução

Imprimir "Olá, mundo!" é uma ótima maneira de explorar a configuração e a sintaxe básicas de uma nova linguagem de programação. Neste guia, você usará o GitHub Actions para imprimir "Hello, World!" dentro dos registros do fluxo de trabalho do seu repositório de GitHub. Tudo o que você precisa para começar é um repositório de GitHub em que você se sente confortável para criar e executar um fluxo de trabalho de amostra de GitHub Actions. Sinta-se à vontade para criar um novo repositório para este Início rápido testar esse e fluxos de trabalhos de GitHub Actions futuros.

Criar o seu primeiro fluxo de trabalho

1. Do seu repositório em GitHub, crie um novo arquivo no diretório .github/workflows denominado hello-world.yml. Para obter mais informações, consulte "Criar novos arquivos."

2. Copie o seguinte conteúdo YAML para o arquivo hello-world.yml.

   YAML

   name: Say hello!
   
   # GitHub Actions Workflows are automatically triggered by GitHub events
   on:
     # For this workflow, we're using the workflow_dispatch event which is triggered when the user clicks Run workflow in the GitHub Actions UI
     workflow_dispatch:
       # The workflow_dispatch event accepts optional inputs so you can customize the behavior of the workflow
       inputs:
         name:
           description: 'Person to greet'
           required: true
           default: 'World'
   # When the event is triggered, GitHub Actions will run the jobs indicated
   jobs:
     say_hello:
       # Uses a ubuntu-latest runner to complete the requested steps
       runs-on: ubuntu-latest
       steps:
       - run: |
           echo "Hello ${{ github.event.inputs.name }}!"

3. Vá até o final da página e selecione Criar um novo branch para este commit e inicie um pull request. Em seguida, para criar um pull request, clique em Propor novo arquivo.

   

4. Assim que o merge do pull request for realizado, você estará pronto para "Acionar o seu fluxo de trabalho".

Acionar o seu fluxo de trabalho

1. No GitHub, navegue até a página principal do repositório.
2. No nome do seu repositório, clique em Ações.
   
3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja executar.
   
4. À direita, clique no menu suspenso Executar fluxo de trabalho e clique em Executar fluxo de trabalho. Opcionalmente, você pode inserir uma mensagem personalizada na entrada "Pessoa a saudar" antes de executar o fluxo de trabalho.
   
5. A execução do fluxo de trabalho irá aparecer na parte superior da lista de execuções de fluxos de trabalho "Say hello!". Clique em "Say hello!" para ver o resultado da execução do fluxo de trabalho.
   
6. Na barra lateral esquerda, clique no trabalho "say_hello".
   
7. Nos registros do fluxo de trabalho, expanda a seção 'Run echo "Hello World!"'.
   

More workflow templates

GitHub fornece modelos de fluxo de trabalho pré-configurados que você pode personalizar para criar o seu próprio fluxo de trabalho de integração contínua. GitHub analisa seu código e mostra modelos de CI que podem ser úteis para o 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 os modelos do fluxo de trabalho como um ponto de partida para criar o fluxo de trabalho personalizado ou usá-los como se apresentam.

Você pode pesquisar a lista completa de modelos de fluxo de trabalho no repositório de actions/starter-workflows repository.

Next steps

The hello-world workflow you just added is a minimal example of a manually triggered workflow. Esse é 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. 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:

• "Aprenda GitHub Actions" para um tutorial detalhado
• "Guides" para casos específicos de usos e exemplos