Workflow Context

GitHub Actions Context’leri, bir Workflow içinde pek çok farklı bilgilere (ör. hangi branch üzerinde çalışıldığı, hangi ortam değişkenleri set edildiği, hangi sıradaki job/step’in yürüdüğü vb.) erişebilmeni sağlar. Bu bilgilere “expression syntax” kullanarak, yani ${{ context.key }} şeklinde ulaşabilirsin.

1) github

• Ne içerir?

  • Repo bilgisi (ör. github.repository → “owner/repo”)

  • Event bilgisi (ör. github.event_name, github.event.pull_request.title, vb.)

  • Ref bilgisi (ör. github.ref → hangi branch/tag)

  • Actor bilgisi (github.actor → iş akışını tetikleyen kullanıcı)

if: ${{ github.ref == 'refs/heads/main' }}

Bu örnekte, branch ana dal (main) ise koşul sağlanır.

2) env

• Ne içerir?

  • Workflow, job veya step düzeyinde tanımladığın environment değişkenleri.

env:
  FOLDER: "scripts"
steps:
  - name: Print folder
    run: echo "Folder is ${{ env.FOLDER }}"

env.FOLDER → "scripts" bilgisini döndürür.

3) vars

• Ne içerir?

  • GitHub ayarlarında (repo, org veya environment düzeyinde) tanımlanmış değişkenler (Variables) bulunur.

• Farkı nedir?

  • env Workflow içinde tanımladığın değişkenler,

  • vars ise GitHub’ın “Settings → Variables” menüsünde eklediğin değişkenlerdir.

run: echo "Global variable: ${{ vars.GLOBAL_VAR }}"

vars.GLOBAL_VAR → GitHub’ın arayüzünde tanımladığın bir değer döner.

4) job

• Ne içerir?

  • O an çalışan job ile ilgili bilgiler: job adı, durumu, container ayarları vb.

• Kullanım Örneği

  • Çok sık kullanılmaz, ancak job düzeyinde metadata gerekirken faydalı olabilir. Örneğin job.status vb.

5) jobs (Reusable Workflows İçin)

• Ne içerir?

  • Reusable Workflow’larda, birden fazla job’un çıktısına (outputs) erişmene yarar.

  • Normal (tekil) Workflows’da genelde “needs” üzerinden job’ların çıktılarına bakarız; “jobs” genellikle Reusable Workflow senaryolarında kullanılır.

6) steps

• Ne içerir?

  • Şu anda içinde bulunduğun job’daki step’lerin durum ve çıktı (outputs) bilgileri.

steps:
  - name: Step A
    id: my_step
    run: echo "result=hello" >> $GITHUB_OUTPUT

  - name: Use step output
    run: echo "Output is ${{ steps.my_step.outputs.result }}"

7) runner

• Ne içerir?

  • İş akışını çalıştıran runner hakkında bilgi: işletim sistemi, mimari, vb.

  • Örnek: runner.os, runner.arch.

if: ${{ runner.os == 'Linux' }}

Bu koşul sadece Linux runner’da çalışsın istiyorsan kullanabilirsin.

8) secrets

• Ne içerir?

  • GitHub “Settings → Secrets” bölümünde tanımladığın gizli değerler (API anahtarları, parolalar vb.).

env:
  MY_SECRET: ${{ secrets.MY_SECRET_KEY }}
run: echo "$MY_SECRET"

secrets.MY_SECRET_KEY ile sakladığın gizli değere erişirsin. Loglarda bu değer maskelenir.

9) strategy

• Ne içerir?

  • Eğer bir matrix strategy (matris yapısı) kullanıyorsan, strategy context’i ile matris detaylarına ulaşabilirsin.

strategy:
  matrix:
    node: [14, 16, 18]
# ...
run: echo "Node version is ${{ matrix.node }}"

matrix.node → Her job varyantında ilgili Node sürümü.

10) matrix

• Ne içerir?

  • strategy.matrix ile tanımladığın parametre değerlerini taşıyan context.

  • Örneğin “matrix.os” veya “matrix.node” gibi parametreler.

11) needs

• Ne içerir?

  • Bu job’un bağımlı olduğu (önce çalışan) job’ların outputs değerleri.

jobs:
  build:
    runs-on: ubuntu-latest
    outputs:
      build_number: ${{ steps.build_info.outputs.number }}

  deploy:
    needs: [build]
    runs-on: ubuntu-latest
    steps:
      - run: echo "Build num: ${{ needs.build.outputs.build_number }}"

needs.build.outputs.build_number → “build” job’undan dönen output.

12) inputs

• Ne içerir?

  • Manuel tetiklenebilir (workflow_dispatch) Workflow’larda ya da Reusable Workflow’larda kullanıcıdan alınan input değerleri.

on:
  workflow_dispatch:
    inputs:
      environment:
        type: choice
        description: "Select environment"
        required: true
        options:
          - dev
          - staging
          - prod
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Env: ${{ github.event.inputs.environment }}"

Kısaca Nasıl Kullanırız?

• Bu context’lere, Workflow içindeki “expression syntax” ile, yani ${{ <context>.<property> }} şeklinde erişirsin.

• Örneğin, echo "Repo: ${{ github.repository }}" diyerek console’a yazdırabilirsin.

• Koşul ifadelerinde if: ${{ condition }} şeklinde de kullanılır. Örneğin:

if: ${{ secrets.MY_TOKEN != '' }}

Token boş değilse adım çalışsın.

Özet

• Context = Workflow içinde pek çok meta bilgiyi saklayan objeler.

• github → Tetikleme, branch, event, aktör bilgisi

• env ve vars → Ortam değişkenleri (yerel veya global tanımlı)

• runner → Makine/OS bilgisi

• secrets → Gizli anahtarlar/parolalar

• steps, jobs, needs → Adımlar arası veya job’lar arası çıktı/bağımlılık bilgisi

• matrix ve strategy → Matris stratejisinde sürüm ve platform varyasyonları

• inputs → Kullanıcının manuel tetiklemede veya Reusable Workflow’da girdiği değerler

Bu context’lerle, GitHub Actions içinde hem condition’lar (if), hem değişken atamalar, hem de step’ler arası veri alışverişi gibi dinamik özellikler elde edersin.

Accessing contextual information about workflow runs - GitHub Enterprise Server 3.10 DocsGitHub Docs