Ansible Roles

1. Rol fikri ne?

• Nasıl gerçek hayatta biri doktor olsun diye lise → tıp fakültesi → staj → uzmanlık adımlarını tamamlarsak,

• Biz de “boş” bir sunucuyu mysql‐server yapmak için bir dizi task çalıştırıyoruz (paket kur, servis başlat, config yap).

Bu task setini tek bir pakete sarıyoruz → buna role diyoruz. Sonra playbook’ta sadece:

roles:
  - mysql

yazmak yetiyor; 1 sunucu da olsa 100 sunucu da olsa aynı reçete uygulanıyor.

2. Rol dizin yapısı (best practice)

roles/
└─ mysql/
   ├─ tasks/       # ana .yml dosyan (main.yml) burada
   ├─ handlers/    # notify ile tetiklenen restart vb.
   ├─ templates/   # Jinja2 şablonları
   ├─ files/       # düz kopyalanacak dosyalar
   ├─ vars/        # sabit değişkenler (yüksek öncelik)
   ├─ defaults/    # override edilebilir vars (düşük öncelik)
   └─ meta/        # rol bağımlılık bilgisi

İskeleti elle oluşturmakla uğraşma:

ansible-galaxy init mysql

3. Kendi rolünü yazma adımları

1. ansible-galaxy init myrole → klasör iskeleti oluşur.

2. roles/myrole/tasks/main.yml içine task’larını koy.

3. Gerekli template veya vars dosyalarını ilgili klasöre ekle.

4. Playbook dizininde roles/ klasörü varsa Ansible otomatik bulur.

   • Global yerse /etc/ansible/roles (cfg’de roles_path).

Örnek hızlı task:

# roles/mysql/tasks/main.yml
- name: Install MySQL packages
  yum:
    name: mysql-server
    state: present

- name: Enable & start service
  service:
    name: mysqld
    state: started
    enabled: true

Playbook’ta kullanımı:

- hosts: db
  roles:
    - mysql

4. Hazır rol kullanmak (Ansible Galaxy)

1. Ara

   ansible-galaxy search mysql

2. Kur

   ansible-galaxy install geerlingguy.mysql   # varsayılan path’e
   # veya proje içi:
   ansible-galaxy install geerlingguy.mysql -p ./roles

3. Çağır

   roles:
     - geerlingguy.mysql

Ek parametre geçmek istersen:

roles:
  - role: geerlingguy.mysql
    become: yes
    mysql_root_password: supersecret

5. Rol önceliği & değişken hiyerarşisi (özet)

Nerede tanımlı?	Öncelik
extra vars (-e)	🥇
play vars	🥈
role vars (vars/)	🥉
role defaults (defaults/)	🚦
group/host vars	daha düşük

Yani role içinde defaults/main.yml’a koyduklarını kullanıcı override edebilsin. Zorunlu sabitleri vars/main.yml’a koy.

6. Rol dizini nereye bakılır?

ansible-config dump | grep ROLE

Çıktıda DEFAULT_ROLES_PATH listesi gelir (global + user). Proje içi roles/ klasörü her zaman ilk bakılan yerlerden biridir.

7. Mini egzersiz (deneyip pekiştir)

1. ansible-galaxy init nginx komutuyla yeni rol oluştur.

2. tasks/main.yml içine apt install nginx && systemctl enable step’lerini ekle (Ubuntu düşün).

3. defaults/main.yml’a nginx_listen_port: 8080 koy.

4. Template klasörüne bir nginx.conf.j2 ekle, portu değişkenden çek.

5. Playbook yaz:

   - hosts: web
     roles:
       - role: nginx
         nginx_listen_port: 80   # override

6. Çalıştır, web sunucularında 80 portundan nginx geldiğini test et.

Özet:

• Role = belirli görevi (mysql, nginx, backup…) gerçekleştiren dosya grubu.

• İskelet: tasks, handlers, templates, vars, defaults, …

• Yazması: ansible-galaxy init role_name.

• Kullanması: playbook’ta roles: listesine ekle.

• Paylaşması/indirmesi: ansible-galaxy install, ansible-galaxy list.