# 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.

```yaml
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.

```yaml
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.

```yaml
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ı.

```yaml
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://note.onurbolatoglu.com/github-actions/routing-workflow-to-runner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.