Introdução
Você só precisa de um repositório de GitHub existente para criar e executar um fluxo de trabalho de GitHub Actions. Neste guia, você adicionará um fluxo de trabalho que cria várias linguagens de codificação usando a Ação de Super-Linter de GitHub. O fluxo de trabalho usa o Super-Linter para validar o seu código-fonte toda vez que um novo commit é subido para o seu repositório.
Criar o seu primeiro fluxo de trabalho
-
Do seu repositório no GitHub, crie um novo arquivo no diretório
.github/workflows
denominadosuperlinter.yml
. Para obter mais informações, consulte "Criar arquivos". -
Copie o conteúdo de YAML a seguir para o arquivo
superlinter.yml
. Observação: Se seu branch-padrão não forprincipal
, atualize o valor deDEFAULT_BRANCH
para corresponder ao nome do branch-padrão do seu repositório.YAML name: Super-Linter # Run this workflow every time a new commit pushed to your repository on: push jobs: # Set the job key. The key is displayed as the job name # when a job name is not provided super-lint: # Name the Job name: Lint code base # Set the type of machine to run on runs-on: ubuntu-latest steps: # Checks out a copy of your repository on the ubuntu-latest machine - name: Checkout code uses: actions/checkout@v2 # Runs the Super-Linter action - name: Run Super-Linter uses: github/super-linter@v3 env: DEFAULT_BRANCH: main GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
Para executar seu fluxo de trabalho, desça a barra de rolagem 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.
Fazer commit do arquivo de fluxo de trabalho no repositório aciona o evento push
e executa seu fluxo de trabalho.
Visualizar seus resultados do fluxo de trabalho
-
No GitHub, navegue até a página principal do repositório.
-
No nome do seu repositório, clique em Ações.
-
Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.
-
Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar.
-
Em Trabalhos ou no gráfico de visualização, clique no trabalho de base de código Lint.
-
Todas as etapas com falha são automaticamente expandidas para exibir os resultados.
Mais fluxos de trabalho iniciais
O GitHub fornece modelos de fluxo de trabalho pré-configurados com os quais você pode começar para automatizar ou criar fluxos de trabalho de integração contínua. Você pode pesquisar a lista completa de modelos de fluxo de trabalho no repositório de actions/starter-workflows repository.
Próximas etapas
O fluxo de trabalho do super-linter que você acabou de adicionar é executado sempre que o código é enviado para o seu repositório para ajudá-lo a detectar erros e inconsistências no seu código. 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. 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
- github/super-linter para obter mais informações sobre a configuração da ação de Super-Linter
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. Você pode usá-lo para testar este e futuros fluxos de trabalho de GitHub Actions.
Criar o seu primeiro fluxo de trabalho
-
Do seu repositório em GitHub, crie um novo arquivo no diretório
.github/workflows
denominadohello-world.yml
. Para obter mais informações, consulte "Criar novos arquivos." -
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 }}!"
-
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.
-
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
- No GitHub, navegue até a página principal do repositório.
- No nome do seu repositório, clique em Ações.
- Na barra lateral esquerda, clique no fluxo de trabalho que você deseja executar.
- À 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.
- 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.
- Na barra lateral esquerda, clique no trabalho "say_hello".
- Nos registros do fluxo de trabalho, expanda a seção 'Run echo "Hello World!"'. ![Detalhe do fluxo de trabalho(/assets/images/help/repository/workflow-log-listing.png)
Mais fluxos de trabalho iniciais
GitHub fornece modelos de fluxo de trabalho pré-configurados dos quais você pode partir para automatizar ou criar fluxos de trabalho de integração contínua. Você pode pesquisar a lista completa de modelos de fluxo de trabalho no repositório actions/starter-workflows.
Próximas etapas
O fluxo de trabalho hello-world que você acabou de adicionar é um exemplo simples de um fluxo de trabalho acionado manualmente. 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