# Introduction to Ansible Configuration Files

### 1. Varsayılan Ansible Konfigürasyon Dosyası

* **Kurulum Sonrası Varsayılan Dosya**\
  Ansible kurulunca, genellikle `/etc/ansible/ansible.cfg` konumunda bir varsayılan konfigürasyon dosyası oluşturulur.
* **Bölümler (Sections)**\
  Bu dosya çeşitli bölümlere sahiptir (örn: `[defaults]`, `[inventory]`, `[privilege_escalation]`, `[ssh_connection]`, vb.).
  * En çok ayar genellikle `[defaults]` bölümünde yer alır.
  * Örnek ayarlar:
    * Varsayılan envanter dosyası (inventory) konumu
    * Log dosyası konumu
    * Modül veya rol dizinleri
    * SSH bağlantı zaman aşımı (timeout) süresi
    * Ansible’ın “facts” (sistem bilgileri) toplayıp toplamayacağı
    * Aynı anda kaç host’u paralel işleyebileceği (forks)

Bu varsayılan dosya, herhangi bir ek ayar belirtilmezse Ansible tarafından her zaman okunur.

### 2. Konfigürasyon Dosyası Öncelik Sırası

Ansible, **birden fazla konfigürasyon dosyası** bulunursa belli bir öncelik sırasına göre ayarları okur.  Yani, Ansible, ayarları (konfigürasyonları) **birden fazla yerden** okuyabilir. Ama **aynı ayar** farklı dosyalarda farklı değerlerle tanımlanırsa, **en yüksek öncelikli** olan kazanır. İşte öncelik sırası (en yüksek → en düşük):

1. **Environment Variable**
   * `ANSIBLE_CONFIG` adında bir değişken, konfigürasyon dosyasının tam yolunu gösterir.
   * Örneğin,

     ```bash
     export ANSIBLE_CONFIG=/opt/ansible-web.cfg
     ```
   * Bu şekilde ayarlanırsa, **ilk** olarak buradaki ayarlar kullanılır.
2. **Mevcut Çalışma Dizini (Current Directory)**
   * Ansible komutunu çalıştırdığın dizinde bir `ansible.cfg` dosyası varsa, **ikinci** olarak buradaki ayarlar geçerli olur.
3. **Kullanıcının Ev Dizini (Home Directory) İçindeki `.ansible.cfg`**
   * Örneğin, `/home/onur/.ansible.cfg` dosyası.
   * Eğer çevre değişkeni veya çalışma dizininde bir dosya yoksa, **üçüncü** sırada bu dosyayı kontrol eder.
4. **Varsayılan Sistem Dosyası**
   * `/etc/ansible/ansible.cfg`
   * **Hiçbir üstteki konfigürasyon yoksa** veya ilgili ayar oralarda belirtilmemişse, en son bu dosyanın değerleri kullanılır.

**Nasıl Düşünmeliyiz?**

* Eğer tek bir ayarı herkesten önce zorla değiştirmek istiyorsan → **Environment Variable** ile `ANSIBLE_CONFIG`kullan.
* Bulunduğun dizinde özel ayarlar istiyorsan → **`ansible.cfg`** dosyasını oraya koy.
* Tüm kullanıcılar için geçerli varsayılan bir ayar yapmak istiyorsan → **`/etc/ansible/ansible.cfg`** dosyasını düzenle.

**Örnek Senaryo:**

* `/etc/ansible/ansible.cfg` içinde `timeout=10` yazıyor.
* Kendi klasöründeki `ansible.cfg` içinde `timeout=20` yazarsan, senin klasöründe Ansible çalıştırıldığında **20** geçerli olur.
* Ayrıca `export ANSIBLE_CONFIG=/home/onur/diger_ayarlar.cfg` yapıp o dosyada `timeout=30` yazarsan, bu kez **30** geçerli olur.

Bu şekilde, Ansible hangi dosyanın ayarını seçeceğini belirli bir öncelik sırasına göre karar verir.

### 3. Konfigürasyon Dosyalarını ve Değerlerini Değiştirme Yöntemleri

**Ansible Konfigürasyonunu Değiştirmek İçin Üç Ana Yol Var:**

1. **Klasöre (Dizine) `ansible.cfg` Dosyası Kopyalamak**
   * Eğer `/etc/ansible/ansible.cfg` dosyası var ve bu dosyadaki ayarları biraz değiştirmek istiyorsan:
     1. Projende, örneğin `web-playbooks` klasörüne geç.
     2. Orada `ansible.cfg` adında **yeni** bir dosya oluştur (veya `/etc/ansible/ansible.cfg`’den kopyala).
     3. İçindeki sadece değiştirmek istediğin satırları düzenle (örn. `timeout=20`).
   * Artık o klasörde `ansible-playbook ...` komutunu çalıştırdığında, **o klasördeki `ansible.cfg`** ayarları geçerli olur.
2. **Environment Variable (Değişken) Kullanmak**
   * Eğer tek bir ayarı **hızlıca** değiştirmek istiyorsan, `ansible.cfg` dosyasıyla uğraşmadan terminalde şu şekilde yazabilirsin:

     ```bash
     ANSIBLE_GATHERING=explicit ansible-playbook myplaybook.yml
     ```

     Bu komut çalışırken `ANSIBLE_GATHERING` değeri **geçici** olarak `explicit` olur ve diğer tüm dosyalardaki `gathering` ayarlarını yok sayar.
   * Ya da önce değişkeni kalıcı yapmak istersen,

     ```bash
     export ANSIBLE_GATHERING=explicit
     ansible-playbook myplaybook.yml
     ```

     şeklinde iki satırda yazabilirsin. Bu sayede, o terminal oturumu boyunca (exit yapana kadar) `gathering` ayarı `explicit` kalır.
3. **Sadece Birkaç Ayar Değiştirmek İstediğinde**
   * Bazen tüm `ansible.cfg` dosyasını kopyalayıp düzenlemek yerine, **yalnızca 1-2 küçük ayar** değiştirmen gerekebilir.
   * Bu durumda, **environment variable** yöntemi çok pratiktir. Tek bir ayarı override (geçersiz kıl) etmek için:

     ```bash
     ANSIBLE_GATHERING=explicit ansible-playbook myplaybook.yml
     ```
   * Böylece sistemde başka yerde hangi ayar varsa varsın, bu tek komutluk değişken **her şeyin önüne geçer**.

#### Kısa Özet

* **Klasöre `ansible.cfg` kopyalamak**: Proje/klasör bazında kalıcı ayarlar yapmak istediğinde kullanılır.
* **Environment variable**: Hızlı veya tek seferlik ayar değişikliği için idealdir.

{% hint style="info" %}
*ANSIBLE\_GATHERING* sadece bir örnek. Ansible’ın konfigürasyon dosyasında yer alan hemen hemen her parametre, aynı mantıkla bir çevresel değişken (environment variable) olarak geçersiz kılınabilir. Yani `ANSIBLE_GATHERING=explicit` yerine başka bir ayarı da `ANSIBLE_XXX=...` şeklinde değiştirebilirsin.\
\
Ansible’da bir konfigürasyon parametresini çevresel değişken aracılığıyla değiştirmek istiyorsan, genellikle şu kural geçerlidir:

1. **Önce** ilgili parametrenin adını **büyük harflere** çevir.
2. **Başına** `ANSIBLE_` önekini (prefix) ekle.
3. Değerini atayıp komut çalıştır (veya `export` komutu kullan).

Örneğin, Ansible’ın `ansible.cfg` dosyasında şu parametrelerin olduğunu düşünelim:

* `gathering`
* `forks`
* `host_key_checking`
* `timeout`

Bunları çevresel değişken olarak atayabilmek için sırasıyla:

* `ANSIBLE_GATHERING=...`
* `ANSIBLE_FORKS=...`
* `ANSIBLE_HOST_KEY_CHECKING=...`
* `ANSIBLE_TIMEOUT=...`

şeklinde kullanman gerekir.
{% endhint %}


---

# 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/ansible-1/introduction-to-ansible-configuration-files.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.