O Que É um Contexto no GitHub Actions?

Um contexto é um conjunto estruturado de dados da execução, como github, env, matrix e secrets, que você lê dentro de expressões.

Os workflows precisam saber sobre si mesmos: qual branch, qual evento, quais inputs. Os contextos expõem essas informações como objetos que você referencia dentro de expressões ${{ }}.

O que é

Um contexto é um objeto nomeado que guarda dados sobre a execução ou o ambiente. Exemplos incluem github (dados do evento e do repo), env (variáveis), secrets, matrix, needs e inputs.

steps:
  - run: |
      echo "Repo: ${{ github.repository }}"
      echo "Actor: ${{ github.actor }}"
      echo "Event: ${{ github.event_name }}"

Como funciona

Você acessa os campos de um contexto com notação de ponto dentro de uma expressão. O GitHub preenche cada contexto antes da avaliação, então os valores refletem a execução atual.

Onde os contextos estão disponíveis

Nem todo contexto está disponível em todo lugar. Por exemplo, secrets não pode ser usado em algumas chaves, e matrix só existe em jobs de matrix. A documentação lista a disponibilidade de cada contexto.

Por que importa

Os contextos são como os workflows se adaptam aos dados de runtime, ramificando com base no evento, lendo inputs ou conectando job outputs entre si. Sem eles, o YAML não conseguiria reagir ao que de fato aconteceu.

Conceitos relacionados

Os contextos são consumidos dentro de expressões e alimentam condições, matrizes (matrix) e o fluxo de dados do needs entre jobs.

Principais conclusões

• Um contexto é um objeto estruturado com dados da execução.
• Os mais comuns são github, env, secrets, matrix, needs.
• Leia campos com notação de ponto dentro das expressões.

Guias relacionados