# Variable Types

### 1. String (Metin) Değişkenleri

* **Tanım**: Metinsel ifadeleri saklamak için kullanılır.
* **Örnek**:

  ```yaml
  username: "admin"
  ```

  Burada `username` adlı değişkenin değeri bir **string** metnidir.
* **Nerede Tanımlanabilir?**
  * Playbook içerisinde `vars:` altında
  * Envanter dosyasında (örn. `web1 ansible_host=... role="frontend"`)
  * Komut satırından `--extra-vars "username=admin"` şeklinde

**Kullanım Senaryosu**: Sunucu adları, kullanıcı isimleri, dosya yolları, mesaj metinleri vb. **metin tabanlı** bilgilerin saklanması.

***

### 2. Number (Sayı) Değişkenleri

* **Tanım**: Tamsayı (integer) veya ondalıklı (float) değerleri tutar.
* **Örnek**:

  ```yaml
  max_connections: 100
  max_load: 1.5
  ```

  Burada `max_connections=100` (int), `max_load=1.5` (float).
* **Matematiksel İşlemler**\
  Ansible görevlerinde, bu değerler üzerinde toplama, çıkarma, karşılaştırma gibi işlemler yapılabilir.

**Kullanım Senaryosu**: Port numaraları, kaynak limitleri (CPU, bellek), tekrar sayıları (retry, max\_attempts) vb.

***

### 3. Boolean (Mantıksal) Değişkenleri

* **Tanım**: **true** veya **false** (doğru/yanlış) değeri saklar (ayrıca `yes/no`, `on/off` gibi truthy-falsy formatlarını da Ansible anlar).
* **Örnek**:

  ```yaml
  debug_mode: true
  maintenance_mode: false
  ```
* **Kullanım**: Koşullu ifadelerde (`when:`) veya görevlerin etkin/pasif hale getirilmesinde sıkça kullanılır.

**Kullanım Senaryosu**: Özellikle `when:` şartlarında, “Eğer `debug_mode` açıksa ek log yaz, değilse yazma” gibi kontrol akışları.

***

### 4. List (Dizi) Değişkenleri

* **Tanım**: Sıralı bir koleksiyon. İçinde her türlü veri tipi (string, number, dictionary vs.) bulunabilir.
* **Örnek**:

  ```yaml
  packages:
    - nginx
    - postgresql
    - git
  ```
* **Erişim**:
  * Tüm liste: `{{ packages }}`
  * Tek bir öğe: `{{ packages[0] }}` → `nginx`
* **Döngülerde Kullanım**: `loop: "{{ packages }}"` ile listedeki her bir öğe için görev yürütülebilir.

**Kullanım Senaryosu**: Toplu paket kurulumu, sunucu listeleri, çoklu parametre değerleri, vs.

***

### 5. Dictionary (Sözlük) Değişkenleri

* **Tanım**: Anahtar (key) - değer (value) çiftlerinden oluşan koleksiyon.
* **Örnek**:

  ```yaml
  user:
    name: "admin"
    password: "secret"
  ```

  Burada `user.name` ve `user.password` şeklinde erişilebilir.
* **Erişim**:

  ```yaml
  debug:
    msg: "User = {{ user.name }}, Password = {{ user.password }}"
  ```
* **Genişletilebilir**: Değerler de **list**, **dictionary** veya farklı türde veri olabilir.

**Kullanım Senaryosu**: Bir host veya servise ait detaylı bilgileri tek yapıda saklamak (örneğin kullanıcı bilgisi, servis konfigürasyonu, network ayarları gibi).

***

### 6. Değişkenleri Playbook’ta Kullanma

#### Örnek Kurulum Senaryosu

```yaml
- name: Install and Configure Services
  hosts: web
  vars:
    debug_mode: true
    packages:
      - nginx
      - php-fpm
      - git
    server_config:
      port: 8080
      doc_root: "/var/www/html"
  tasks:
    - name: Print debug info if debug_mode is true
      debug:
        msg: "We are in debug mode!"
      when: debug_mode

    - name: Install required packages
      package:
        name: "{{ item }}"
        state: present
      loop: "{{ packages }}"

    - name: Configure the service
      template:
        src: myconfig.j2
        dest: /etc/myconfig.conf
      vars:
        http_port: "{{ server_config.port }}"
        root_path: "{{ server_config.doc_root }}"
```

1. **Boolean Örneği**: `debug_mode` değişkeni `when: debug_mode` ifadesiyle koşullu görev çalıştırır.
2. **List Örneği**: `packages` içinde `nginx`, `php-fpm`, `git` tanımlı, `loop` ile sırayla kurulurlar.
3. **Dictionary Örneği**: `server_config` adlı sözlükten `port` ve `doc_root` alınarak `template` modülünde kullanılır.

{% hint style="info" %}
`item`, Ansible’ın **loop (döngü)** mekanizmasında **otomatik** olarak kullanılan bir “geçici değişken”dir. Listenin her bir elemanı, sırayla `item` isminde saklanır.
{% endhint %}

***

### 7. Sonuç ve İpuçları

* **Tür Seçimi**: Mümkünse veriyi doğru türe göre saklayın. Örneğin sayısal değerler `number`, evet/hayır durumları `boolean`, birden çok paket `list`, iç içe parametreler `dictionary`.
* **Esneklik**: Doğru tür kullanımı, playbook’larınızı daha okunabilir ve bakımı kolay hale getirir.
* **Erişim Söz Dizimi**:
  * String, number, boolean → Direkt `{{ variable }}`
  * List → `{{ list_name }}`, `{{ list_name[index] }}`
  * Dictionary → `{{ dict_name.key }}`, `{{ dict_name['key'] }}`
* **Yaml Formatı**: Ansible, YAML düzenine duyarlı olduğu için girintilere dikkat etmek önemlidir.

Bu şekilde, Ansible’ın **String**, **Number**, **Boolean**, **List** ve **Dictionary** değişken türlerini anladınız. Farklı veri türlerini uygun senaryolarda doğru kullanmak, **daha temiz, esnek ve yeniden kullanılabilir** Ansible kodları yazmanıza yardımcı olur.


---

# 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/variable-types.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.