Observação: GitHub Actions estava disponível para GitHub Enterprise Server 2.22 como um beta limitado. O beta terminou. GitHub Actions está agora geralmente disponível em GitHub Enterprise Server 3.0 ou posterior. Para obter mais informações, consulte as observações sobre a versão GitHub Enterprise Server 3.0.
- Para obter mais informações sobre a atualização para GitHub Enterprise Server 3.0 ou posterior, consulte "Atualizar GitHub Enterprise Server".
- Para obter mais informações sobre a configuração de GitHub Actions após atualizar, consulte a documentação para GitHub Enterprise Server 3.0.
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.
Visão Geral
Workflow templates allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When you create a new workflow, you can choose a template and some or all of the work of writing the workflow will be done for you. 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. This not only saves time, it promotes consistency and best practice across your organization.
Criar um modelo do fluxo de trabalho
Os modelos do fluxo de trabalh podem ser criados por usuários com acesso de gravação ao repositório .github
da organização. Em seguida, os modelos podem ser usados por integrantes da organização com permissão para criar fluxos de trabalho. Você pode compartilhar modelos de fluxo de trabalho se o repositório da sua organização for público ou se o repositório for privado e estiver em um plano corporativo.
Este procedimento demonstra como criar um modelo de fluxo de trabalho e um arquivo de metadados. O arquivo de metadados descreve como o modelo é apresentado aos usuários quando estão criando um novo fluxo de trabalho.
-
Se já não existir, crie um novo repositório público denominado
.github
na sua organização. -
Crie um diretório denominado
workflow-templates
. -
Crie seu novo arquivo de fluxo de trabalho dentro do diretório
workflow-templates
.Se você precisar referir-se ao branch-padrão de um repositório, você poderá usar o espaço reservado
branch$default
. Quando um fluxo de trabalho é criado usando seu modelo, o espaço reservado será automaticamente substituído pelo nome do branch-padrão do repositório.Por exemplo, este arquivo denominado
octo-organization-ci.yml
demonstra um fluxo de trabalho básico.name: Octo Organization CI on: push: branches: [ $default-branch ] pull_request: branches: [ $default-branch ] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Run a one-line script run: echo Hello from Octo Organization
-
Crie um arquivo de metadados dentro do diretório
workflow-templates
. O arquivo de metadados deve ter o mesmo nome do arquivo de fluxo de trabalho, mas em vez da extensão.yml
, deve-se adicionar.properties.json
. Por exemplo, este arquivo denominadoocto-organization-ci.properties.json
contém os metadados para um arquivo de fluxo de trabalho denominadoocto-organization-ci.yml
:{ "name": "Octo Organization Workflow", "description": "Octo Organization CI workflow template.", "iconName": "example-icon", "categories": [ "Go" ], "filePatterns": [ "package.json$", "^Dockerfile", ".*\\.md$" ] }
nome
- Obrigatório. O nome do modelo de fluxo de trabalho. Isto é exibido na lista de modelos disponíveis.descrição
- Obrigatória. A descrição do modelo de fluxo de trabalho. Isto é exibido na lista de modelos disponíveis.iconName
- Obrigatório. Define um ícone para a entrada do fluxo de trabalho na lista de modelos. OiconName
deve ser um ícone SVG com o mesmo nome e deve ser armazenado no diretórioworkflow-templates
. Por exemplo, um arquivo SVG denominadoexemplo-icon.svg
é referenciado comoexample-icon
.categorias
- Opcional. Define a categoria de idioma do fluxo de trabalho. Quando um usuário visualiza os modelos disponíveis, esses modelos que correspondem àao mesmo idioma terão mais destaque. Para obter informações sobre as categorias de idioma disponíveis, consulte https://github.com/github/linguist/blob/master/lib/linguist/languages.yml.filePatterns
- Opcional. Permite que o modelo seja usado se o repositório do usuário tiver um arquivo no diretório-raiz que corresponde a uma expressão regular definida.
Para adicionar outro modelo de fluxo de trabalho, adicione seus arquivos ao mesmo diretório workflow-templates
. Por exemplo:
Próximas etapas
Para continuar aprendendo sobre GitHub Actions, consulte "Usando modelos de fluxo de trabalho".