Início rápido para GitHub Actions

Introdução

You only need a GitHub repository to create and run a GitHub Actions workflow. In this guide, you'll add a workflow that demonstrates some of the essential features of GitHub Actions.

The following example shows you how GitHub Actions jobs can be automatically triggered, where they run, and how they can interact with the code in your repository.

Criar o seu primeiro fluxo de trabalho

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

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

3. 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.

   

Committing the workflow file to a branch in your repository triggers the push event and runs your workflow.

Visualizar seus resultados do 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 ver.

   

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

   

5. Under Jobs , click the Explore-GitHub-Actions job.

   

6. The log shows you how each of the steps was processed. Expand any of the steps to view its details.

   

   For example, you can see the list of files in your repository:

   

Mais modelos de fluxo de trabalho

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.

Próximas etapas

The example workflow you just added runs each time code is pushed to the branch, and shows you how GitHub Actions can work with the contents of your repository. 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.
• You can use a workflow to install software testing apps and have them automatically test your code on GitHub's runners.

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 obter um tutorial aprofundado.
• "Guias" para casos e exemplos específicos de uso.