Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.
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 Enterprise Server, 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.
-
Na barra lateral esquerda, clique no trabalho Lint de código-bsee.
-
Todas as etapas com falha são automaticamente expandidas para exibir os resultados.
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 Enterprise Server 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
e no repositório your GitHub Enterprise Server instance.
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 Enterprise Server, 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 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!"'.
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 Enterprise Server 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
e no repositório your GitHub Enterprise Server instance.
Next steps
The hello-world workflow you just added is a simple 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