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
Os fluxos de trabalho iniciais permitem que todos em sua organização que têm permissão para criar fluxos de trabalho o façam de forma mais rápida e facilmente. Quando você cria um novo fluxo de trabalho, você pode escolher um fluxo de trabalho inicial e parte ou todo o trabalho de escrita do fluxo de trabalho será feito para você. Você pode usar os fluxos de trabalho iniciais como um local inicial para criar o seu fluxo de trabalho personalizado ou usá-los como se apresentam. Isso não só poupa tempo, como promove consistência e práticas recomendadas na sua organização.
GitHub fornece fluxos de trabalho iniciais prontos para uso para as seguintes categorias de alto nível:
-
Implantação (CD). Para obter mais informações, consulteSobre a implantação contínua".
-
Integração Contínua (CI). Para obter mais informações, consulte "Sobre integração contínua".
-
Automação. Os fluxos de trabalho iniciais de automação oferecem soluções para automatizar os fluxos de trabalho como, por exemplo, pull requests de triagem e aplicação de uma etiqueta baseada nos caminhos modificados no pull request, ou saudar usuários que contribuem pela primeira vez para o repositório.
Criando um fluxo de trabalho inicial
Os fluxos de trabalho iniciantes podem ser criados pelos usuários com acesso de gravação ao repositório .github
da organização. Eles poderão ser usados pelos integrantes da organização com permissão para criar fluxos de trabalho.
Este procedimento demonstra como criar um arquivo de metadados e fluxo de trabalho inicial. O arquivo de metadados descreve como os fluxos de trabalho iniciais serão apresentados aos usuários quando estiverem 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, 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 starter workflow.", "iconName": "example-icon", "categories": [ "Go" ], "filePatterns": [ "package.json$", "^Dockerfile", ".*\\.md$" ] }
name
- Obrigatório. O nome do fluxo de trabalho. É exibido na lista de fluxos de trabalho disponíveis.description
- Obrigatório. A descrição do fluxo de trabalho. É exibido na lista de fluxos de trabalho disponíveis.iconName
- Opcional. Especifica um íncone para o fluxo de trabalho exibido na lista de fluxos de trabalho. OiconName
deve ser o nome de um arquivo SVG, sem a extensão de nome do arquivo, 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 fluxos de trabalho iniciais disponíveis para um repositório, os fluxos de trabalho que correspondem � linguagem identificada para o projeto são apresentados de forma mais proeminente. 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 fluxo de trabalho 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 fluxo de trabalho inicial, adicione seus arquivos ao mesmo diretório workflow-templates
. Por exemplo:
Próximas etapas
Para continuar aprendendo sobre GitHub Actions, consulte "Usando fluxos de trabalho iniciais."