Routing workflow to runner

Bu konu, özellikle self-hosted runner kullanırken hangi runner’ın job’u alacağına karar vermek için önemlidir.

1) Self-Hosted Runner Otomatik Etiketleri (Default Labels)

• self-hosted: Tüm self-hosted runner’larda otomatik bulunur.

• linux, windows, macOS: Runner’ın işletim sistemi.

• x64, ARM, ARM64: Donanım mimarisine göre eklenen etiketler.

runs-on: [self-hosted, linux, ARM64]

Bu job, linux + ARM64 etiketlerine sahip bir self-hosted runner’da çalışır. Runner etiketlerinin tümü uyuşmalı (mantık “AND”).

2) Custom Labels (Ör. gpu)

• Kendin özel etiketler ekleyebilirsin (ör. “gpu”, “ssd”, “high-memory”, vb.).

• GitHub Actions arayüzünden veya CLI ile runner’a eklenen bu etiketler, job’u hangi runner’ın alabileceğini daha spesifik hale getirir.

runs-on: [self-hosted, linux, x64, gpu]

Bu job, “gpu” etiketine sahip x64 Linux runner’ını arar.

3) Runners Groups

• Runner groups, özellikle organization veya enterprise düzeyinde, benzer runner’ları bir arada yönetme yöntemidir.

  • Örneğin “ubuntu-runners” adında bir grup oluşturup, Ubuntu tabanlı self-hosted runner’ları içine koyabilirsin.

• Neden?

  • Güvenlik sınırları oluşturmak (bazı projeler sadece bir grup runner’a erişebilsin).

  • Farklı departman/proje runner’larını ayrı gruplarda tutmak.

jobs:
  example:
    runs-on:
      group: ubuntu-runners
      labels: ubuntu-20.04-16core
    steps:
      ...

Bu job, “ubuntu-runners” adlı runner grubunda olup aynı zamanda “ubuntu-20.04-16core” etiketine sahip bir runner’a yönelir.

4) Labels ve Groups Birlikte

• Bir job için hem group: hem de labels: verebilirsin.

• Runner’ın bulunduğu grup + istenen etiketleri birlikte sağlaması gerekir.

• Mantık:

  • Runner önce “ubuntu-runners” grubunda olmalı,

  • Sonra “ubuntu-20.04-16core” etiketlerine de sahip olmalı.

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on:
      group: ubuntu-runners
      labels: ubuntu-20.04-16core
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

5) Özet ve Önemli Noktalar

1. Self-Hosted Runner’larda Etiket (Label) Sistemi

   • Varsayılan: “self-hosted”, OS, mimari.

   • Özel (custom): dilediğin isim.

   • Job, runs-on: [label1, label2] yazınca bu etiketlerin tümüne sahip runner aranır.

2. Runner Groups

   • Enterprise veya Team/Organization planlarında, runner’ları gruplara ayırabilirsin.

   • “group:” parametresiyle job’u belli bir grup runner’a yönlendirebilirsin.

3. Mantık “AND”

   • Bir job, hem belirli “labels” hem de “group” yazılmışsa, runner’ın hem doğru grupta hem de o etiketlere sahip olması gerekir.

4. Neden Gerekli?

   • Farklı donanım/OS özellikli runner’ları ayırt etmek (GPU, ARM, Windows vs.).

   • Güvenlik ve erişim kontrolü (bazı runner’lar sadece özel projeler için).

   • Daha iyi dağıtım (büyük bir self-hosted runner havuzunda job’u doğru yere yönlendirmek).

Bu şekilde, etiket ve grup kullanımını kombine ederek job’ları spesifik runner’lara route (yönlendirme) edebilirsin.