Kurulum

Bu depodaki playbook’ları çalıştırmak için Ansible’ın kurulu olduğu bir kontrol makinesi gerekir. Ansible control node yalnızca Linux/macOS/WSL üzerinde çalışır — Windows’ta doğrudan çalışmaz (yönetilen/hedef makine Windows olabilir ama kontrol makinesi olamaz).

Linux (Ubuntu/Debian) 

sudo apt update
sudo apt install -y ansible sshpass

# Daha güncel bir sürüm isterseniz pip ile:
python3 -m pip install --user ansible

sshpass, inventory’de ansible_ssh_pass ile şifre ile SSH bağlanırken gerekir. SSH anahtarı kullanıyorsanız zorunlu değildir; bu depodaki örnek inventory’ler şifre kullandığı için kurulum önerilir.

Doğrulama:

ansible --version
sshpass -V

macOS

Homebrew ile:

brew install ansible
brew install hudochenkov/sshpass/sshpass

Homebrew yoksa önce onu kurun:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

sshpass, inventory’de ansible_ssh_pass ile şifre ile SSH bağlanırken gerekir. SSH anahtarı kullanıyorsanız zorunlu değildir.

Doğrulama:

ansible --version
sshpass -V

Windows

Ansible control node Windows’ta native çalışmaz. İki seçenek:

Seçenek 1: WSL2 (önerilen)

  1. PowerShell’i yönetici olarak açıp: 
    wsl --install
  2. Bilgisayarı yeniden başlatın, Ubuntu kurulumunu tamamlayın (kullanıcı adı/şifre sorar).
  3. Açılan WSL2 Ubuntu terminalinde, yukarıdaki Linux (Ubuntu/Debian) adımlarını izleyin (ansible + sshpass).
  4. Bu repoyu WSL2 dosya sistemi içine (~/ altına) klonlayın — Windows tarafındaki /mnt/c/... üzerinden çalıştırmak SSH/performans sorunlarına yol açabilir.

Seçenek 2: Uzak bir Linux makine / VM üzerinden

Ansible’ı doğrudan bir Linux sunucusunda veya VM’de (VirtualBox, Hyper-V, bulut sağlayıcı vb.) kurup playbook’ları oradan çalıştırın; Windows makineniz sadece SSH ile o makineye bağlanmak için kullanılır.

Kurulumdan Sonra

  1. Bu repoyu klonlayın: 
    git clone <repo-url>
cd ansible-playbooks
  2. Örnek inventory’yi gerçek ortam dizinine kopyalayın: 
    mkdir -p inventories/musteri_a
cp inventories-example/musteri_a/hosts.ini inventories/musteri_a/hosts.ini
  3. inventories/musteri_a/hosts.ini içindeki örnek host/IP/kimlik bilgilerini kendi ortamınıza göre düzenleyin. SSH varsayılan 22 dışında bir port kullanıyorsa ansible_port=1993 gibi ekleyin.
  4. Inventory’yi doğrulayıp ilk playbook’u çalıştırın: 
    ansible-inventory -i inventories/musteri_a/hosts.ini --graph
ansible-playbook -i inventories/musteri_a/hosts.ini playbooks/01_check_pod_health.yml

Gerçek müşteri/production ortam inventory’leri bilinçli olarak .gitignore ile bu repodan hariç tutulmuştur.

Playbook Dokümantasyonu

Her playbook’un amacı, gereksinimleri ve örnek çıktısı docs/ klasöründe numaraya göre eşleşen dosyada anlatılır (ör. playbooks/04_check_k8s_versions.yml → docs/04_check_k8s_versions.md). Tam liste için README.md içindeki tabloya bakın.