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.
Observação: Os selos de fluxo de trabalho em um repositório privado não podem ser acessados externamente,. Portanto, você não poderá incorporá-los ou vinculá-los a partir de um site externo.
Um selo de status mostra se um fluxo de trabalho está falhando ou passando. Um lugar comum para adicionar um selo de status é o arquivo README.md
do seu repositório, mas você pode adicioná-lo a qualquer página da web que desejar. Por padrão, os selos exibem o status do seu branch-padrão. Também é possível exibir o status de uma execução de fluxo de trabalho para um branch ou evento específico usando os parâmetros de consulta do branch
e evento
na URL.
Para adicionar um selo de status de fluxo de trabalho ao seu arquivo README.md
, primeiro encontre a URL para o selo de status que você gostaria de exibir. Em seguida, você pode usar o Markdown para exibir o selo como uma imagem em seu arquivo README.md
. Para obter mais informações sobre markup de imagens em Markdown, consulte "Gravação básica e sintaxe de formatação".
Usar o nome do arquivo do fluxo de trabalho
Você pode criar a URL para um selo de status de fluxo de trabalho usando o nome do arquivo do fluxo de trabalho:
<HOSTNAME>/<OWNER>/<REPOSITORY>/actions/workflows/<WORKFLOW_FILE>/badge.svg
Para exibir o selo de status do fluxo de trabalho no arquivo README.md
, use o markup do Markdown para incorporar imagens. Para obter mais informações sobre markup de imagens em Markdown, consulte "Gravação básica e sintaxe de formatação".
Por exemplo, adicione o seguinte Markdown ao seu arquivo README.md
para adicionar um selo de status a um fluxo de trabalho com o caminho do arquivo .github/workflows/main.yml
. O PROPRIETÁRIO
do repositório é a organização do github
e o nome do REPOSITÓRIO
é docs
.

Usando o parâmetro branch
Para exibir o status de uma execução do fluxo de trabalho em um ramo específico, adicione ?branch=<BRANCH_NAME>
ao final da URL do selo de status.
Por exemplo, adicione o seguinte Markdown ao seu arquivo README.md
para exibir um selo de status para um branch com o nome feature-1
.

Usar o parâmetro evento
Para exibir o status das execuções de execução do workflow acionadas pelo evento push
, adicione ?event=push
ao final da URL do selo de status.
Por exemplo, adicione o seguinte Markdown ao seu arquivo README.md
para exibir um selo com o status de execução de fluxo de trabalho acionado pelo evento push
, que mostrará o status da compilação para o estado atual desse branch.
