SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-10-23

Ansible unreachable host hatası nasıl yoksayılır?

Ansible unreachable durumundaki sunucuları ignore_unreachable parametresi ile yönetin. ignore_errors komutunun yetersiz kaldığı bağlantı hatalarını çözmek için izlenecek adımlar.

Erişilemeyen bir sunucu başarısız bir görev değildir

Ansible içinde erişilemeyen sunucuları yoksaymak için ignore_unreachable: true ayarını kullanırsınız ve bu anahtar çalışır. Önemli olan nokta, bunu ne zaman kullanacağınızı bilmektir; çünkü Ansible iki farklı sorunu iki farklı şekilde ele alır. Bir sunucuda çalışan ve hata döndüren görev bir başarısızlık (failure) durumudur. Ansible'ın hiçbir şekilde bağlantı kuramadığı sunucu ise erişilemez (unreachable) durumdadır. ignore_errors yalnızca ilk durumu kapsar. ignore_unreachable ise yalnızca ikinci durumu kapsar.

Play özetindeki fark aşağıdadır.

PLAY RECAP *********************************************************************
web1  : ok=7  changed=2  unreachable=0  failed=0  skipped=0  rescued=0  ignored=0
web2  : ok=0  changed=0  unreachable=1  failed=0  skipped=0  rescued=0  ignored=0

Ansible, web1 ile bağlantı kurdu ve yedi görev çalıştırdı. web2, unreachable=1 ve failed=0 değerlerini gösterir; bu, sunucu üzerinde hiçbir işlemin çalışmadığı anlamına gelir. Ansible bağlantı sağlayamadığı için sunucuyu play kapsamından çıkardı ve geri kalan işlemlerle devam etti. Eğer bu play bir güvenlik güncelleştirmesi yüklüyorsa, sunucularınızdan biri bu güncellemeyi almamış demektir.

Bir ana makinenin erişilemez olmasının nedenleri

Erişilemez durumu, bağlantının herhangi bir modül ana makineye ulaşmadan başarısız olduğu anlamına gelir. Okunacak bir modül çıktısı yoktur, yalnızca bir bağlantı hatası mevcuttur ve bu hata makineye temas eden ilk görevde ortaya çıkar.

fatal: [web2]: UNREACHABLE! => {"changed": false, "msg": "Failed to connect to the host via ssh: ssh: connect to host 203.0.113.20 port 22: Connection refused", "unreachable": true}

msg alanı gerçek nedeni taşır. Karşılaşacağınız durumlar şunlardır:

  • Connection refused: TCP bağlantısı reddedildi, yani o portta dinleme yapan bir servis yok. sshd durdurulmuş veya SSH başka bir porta taşınmış ancak envanterinizde hala 22 numaralı port yazılı.
  • Connection timed out: Hiçbir yanıt alınamadı. Bir güvenlik duvarı paketleri düşürüyor veya sunucu kapalı. Her deneme, varsayılan olarak 10 saniye olan tam bağlantı zaman aşımı süresine mal olur.
  • Host key verification failed.: ~/.ssh/known_hosts içindeki anahtar, sunucunun sunduğu anahtarla eşleşmiyor. Yeniden kurulan bir VPS, IP adresini korur ancak yeni bir ana makine anahtarı alır; bu nedenle yeniden kurulum sonrası bu durum beklenir, diğer zamanlarda ise ciddidir.
  • Permission denied (publickey): SSH yanıt verdi ancak anahtarınızı reddetti. Port düzgün çalışıyor, bu bir kimlik doğrulama sorunudur; genellikle yanlış ansible_user veya yüklenmemiş bir anahtardan kaynaklanır.
  • Timeout (12s) waiting for privilege escalation prompt: Bağlantı başarılı oldu ancak become başarısız oldu. sudo, asla gelmeyecek bir parola bekliyor.

Eksik bir Python yorumlayıcısı, insanların bu listede olmasını beklediği ancak orada yer almayan bir nedendir. SSH bağlantısı kurulduğu için ana makine erişilebilirdir. Modülün çalışacak bir ortamı yoktur:

fatal: [db1]: FAILED! => {"changed": false, "module_stdout": "/bin/sh: 1: /usr/bin/python3: not found\r\n", "msg": "The module failed to execute correctly, you probably need to set the interpreter", "rc": 127}

Bu satır FAILED! ifadesini belirtir ve özet raporu bunu failed altında sayar, bu nedenle ignore_unreachable ona asla dokunmaz. O ana makine için ansible_python_interpreter ayarını yapın veya üzerine python3 kurun.

Bir play içerisinde ulaşılamayan sunucuları yok sayma

Görev düzeyinde, anahtar kelime modülün yanında yer alır:

- name: Read the package list, and do not stop if the host is down
  ansible.builtin.command: dpkg -l
  register: packages
  changed_when: false
  ignore_unreachable: true

Play düzeyinde ise play içerisindeki her görev için varsayılan değeri belirler ve tek bir görev bunu tekrar değiştirebilir:

- name: Opportunistic fleet maintenance
  hosts: all
  ignore_unreachable: true
  tasks:
    - name: This runs, cannot connect, and the play carries on
      ansible.builtin.ping:

    - name: This one still ends the play for a host that is down
      ansible.builtin.ping:
      ignore_unreachable: false

Arka planda nelerin değiştiğini bilmek önemlidir. ignore_unreachable ayarlandığında, sunucu play içerisinden çıkarılmaz; bu nedenle sonraki her görev tekrar bağlanmayı dener ve aynı şekilde başarısız olur. Bu denemelerin her biri, ansible.cfg içerisindeki timeout değiştirilmediği sürece 10 saniye olan bağlantı zaman aşımını bekler. Ölü bir sunucuya karşı yirmi görevlik bir play, çalışma süresine yaklaşık 200 saniye ekler ve log dosyasına yirmi adet kırmızı satır düşer.

Bu yüzden bir kez kontrol edin ve ardından o sunucuyu temiz bir şekilde durdurun:

- name: Opportunistic fleet maintenance
  hosts: all
  gather_facts: false
  tasks:
    - name: Check that the host answers before doing any work
      ansible.builtin.ping:
      register: reachable
      ignore_unreachable: true

    - name: End the play for this host if it never answered
      ansible.builtin.meta: end_host
      when: reachable.unreachable | default(false)

    - name: Gather facts now that the connection is known good
      ansible.builtin.setup:

    - name: Refresh the package index
      ansible.builtin.apt:
        update_cache: true
      become: true

Bu yöntem, her görev için bir tane yerine, ölü sunucu başına yalnızca bir bağlantı denemesi yapılmasını sağlar. Ansible 2.8 ile eklenen end_host, mevcut sunucu için play'i başarısız olarak işaretlemeden sonlandırır. unreachable anahtarı, kayıtlı sonuç üzerinde yalnızca bağlantı başarısız olduğunda mevcuttur; bu nedenle default(false), yanıt veren her sunucuda koşulun geçerli kalmasını sağlar. Play düzeyinde veri toplama (fact gathering) kapalıdır, çünkü aksi takdirde örtük Gathering Facts görevi, kopuk bağlantıyla karşılaşan ilk görev olurdu; oysa siz bunun kendi ping göreviniz olmasını istersiniz.

ignore_unreachable hem bir play anahtar kelimesidir hem de bir görev anahtar kelimesidir. Bir rolün içine gömmek yerine, okuyucunun görebileceği şekilde playbook içerisinde tutun; çünkü bu ayar, bir çalıştırmanın hangi sunucuları eksik bırakabileceğine karar verir. Playbook ve roller arasındaki ayrım, bu tür bir ayarın hangi katmanda yer alması gerektiğini ele alır.

Neden ignore_errors burada yanlış araçtır

Ansible belgeleri bu sınırlama konusunda oldukça nettir. ignore_errors "yalnızca görev çalışabildiğinde ve 'failed' değerini döndürdüğünde işe yarar. Tanımlanmamış değişken hatalarını, bağlantı başarısızlıklarını, yürütme sorunlarını (örneğin eksik paketler) veya sözdizimi hatalarını görmezden gelmesini sağlamaz."

Bir bağlantı hatası asla failed: true ile bir görev sonucu haline gelmez. Bu durum ayrı bir bayrak olarak gelir ve Ansible bu bayrağa göre öncelikli işlem yapar: sunucu unreachable listesine alınır ve play dışına çıkarılır. Bir play içindeki on iki görevin tamamına ignore_errors: true ekleseniz bile, SSH portu kapalı olan bir sunucu ilk görevde durmaya devam eder. Bu konu, alandaki en yaygın kafa karışıklığıdır ve özellikle ilk playbook'unuzu bir VPS üzerinde yazmayı öğrenirken oluşturduğunuz eski playbook'larınızda bu ifadeyi aratmanız (grep) faydalı olacaktır.

Hata ayıklamayı bastırmadan önce yapın

Kalıcı hale gelen bir bastırma işlemi, sistem filosunun zamanla kontrolden çıkmasına neden olur; çünkü kimsenin erişemediği bir sunucu, aynı zamanda kimsenin yama yapmadığı bir sunucudur. Öncelikle bu sırayı takip edin. Buradaki her komut yalnızca okuma işlemi gerçekleştirir.

  1. ansible web2 -i inventory.ini -m ansible.builtin.ping -o, bir modülü tek bir ana bilgisayar üzerinde çalıştırır ve tek bir satır çıktı verir.
  2. Aynı komuta -vvvv ekleyin. Ansible, hedef kullanıcı, port, özel anahtar ve ilettiği seçenekler dahil olmak üzere oluşturduğu tam ssh komutunu yazdırır.
  3. Bu ssh komutunu -v ile kendiniz çalıştırın. Eğer standart ssh bağlantı kuramıyorsa, sorun Ansible'ın alt katmanındadır ve hiçbir playbook anahtar kelimesi bunu düzeltemez.
  4. msg dizisini okuyun ve yukarıdaki liste ile karşılaştırın. Connection refused ve Connection timed out iki farklı noktayı işaret eder; biri SSH servisini, diğeri ise ağ yolunu gösterir.
  5. Host key verification failed. için, ssh-keygen -F web2.example.com ile ne depoladığınıza bakın. Eğer sunucu yeniden oluşturulduysa, eski girişi ssh-keygen -R web2.example.com ile silin ve sağlayıcı konsolundan doğruladıktan sonra yeni anahtarı kabul edin. ansible.cfg içinde host_key_checking = False ayarını yapmak hatayı giderir, ancak aynı zamanda farklı bir makinenin o adreste yanıt verdiğini size bildirecek olan denetimi de devre dışı bırakır.
  6. Permission denied (publickey) için, Ansible'ın ne kullanması gerektiğini düşündüğünü doğrulayın. ansible-inventory -i inventory.ini --host web2, ansible_user ve ansible_port dahil olmak üzere geçerli değişkenleri yazdırır.
  7. SSH çalışıyor ancak modüller çalışmıyorsa, ansible web2 -m ansible.builtin.raw -a 'command -v python3 || echo none' ile yorumlayıcıyı kontrol edin. raw modülü, komutu kabuk (shell) üzerinden çalıştırır ve hedefte python bulunmasına gerek duymaz.

Ancak bu adımlardan sonra ana bilgisayarı görmezden gelmek bir alışkanlık değil, bilinçli bir karar haline gelir.

Özet, ulaşılamayan sunucuları ayrı sayar ve CI süreçleri bunu genellikle gözden kaçırır

ansible-playbook, başarı durumunda 0, en az bir sunucuya ulaşılamadığında 4, en az bir sunucuda hata oluştuğunda ve ulaşılamayan sunucu olmadığında ise 2 değerini döndürür. Bu kodlar hiçbir zaman birleştirilmez. Kaynak kod yorumları bunları bit flag güvenli olarak tanımlasa da, bir çalıştırmanın sonunda strateji önce ulaşılamayan sunucuları kontrol eder ve tek bir kod döndürür; bu nedenle hem hatalı hem de ulaşılamayan bir sunucunun olduğu bir çalıştırma 6 değil, 4 koduyla çıkar. Başarısız görevleri tespit etmek için 2 kodunu bekleyen bir pipeline, sunuculardan birinin kapalı olduğu durumlarda bu hataları kaçıracaktır. ansible komutu da aynı kodları döndürür. Bu bilgiler 2026-10-10 tarihinde ansible-core 2.21 kaynak kodu üzerinde doğrulanmıştır.

Şimdi ignore_unreachable: true ayarını yapın ve aynı yedi görevli play'i aynı ölü sunucu üzerinde çalıştırın:

PLAY RECAP *********************************************************************
web1  : ok=7  changed=2  unreachable=0  failed=0  skipped=0  rescued=0  ignored=0
web2  : ok=7  changed=0  unreachable=0  failed=0  skipped=0  rescued=0  ignored=7

web2, unreachable=0 değerini ve yedi görevin ok olduğunu raporlar ve çalıştırma 0 koduyla çıkar. Bu anahtar kelime ayarlandığında, Ansible o sunucu için dark olarak adlandırdığı ve unreachable sütununu dolduran sayaç yerine ok ve ignored sayaçlarını artırır. Kırmızı UNREACHABLE! satırları yazdırılmaya devam eder; yani özet ve çıkış kodu gerçeği yansıtmasa da log kayıtları dürüst kalır.

Playbook'u çalıştıran ve yalnızca $? değerini kontrol eden bir CI işi, bu çalıştırmayı başarılı olarak işaretler ve özet kısmında hiçbir makineye ulaşılamadığına dair bir bilgi yer almaz. Erişilebilirlik kontrolünü play'den önce ayrı bir adım haline getirin:

ansible all -i inventory.ini -m ansible.builtin.ping -o

Bu komut, sunucu başına bir satır yazdırır ve herhangi bir sunucuya ulaşılamazsa 4 koduyla çıkar; bu da pipeline'ın başarısız olması için bir neden sunar ve sunucu isimlerini loglarda görmenizi sağlar. ping, hedef üzerinde çalışan bir Python yorumlayıcısına ihtiyaç duyar, bu nedenle bağlantıdan biraz daha fazlasını doğrular ki genellikle istenen de budur. Ardından playbook'u ignore_unreachable ile çalıştırın, böylece ayakta olan sunucular değişikliklerini almaya devam eder.

any_errors_fatal ve toplu işlem genelinde max_fail_percentage

Bu iki anahtar kelime, filo genelinde bir sorun oluştuğunda ne yapılacağına karar verir ve ulaşılamayan sunucuları birbirinden farklı şekilde ele alırlar.

any_errors_fatal: true, ulaşılamayan bir sunucuya tepki verir. Ansible, mevcut görevi toplu işlemin geri kalanında tamamlar ve ardından o toplu işlemdeki tüm sunucular için oynatmayı durdurur. Bunu, yalnızca koordineli bir şema değişikliği gibi hep ya da hiç mantığıyla çalışması gereken durumlarda kullanın.

max_fail_percentage: 30, ulaşılamayan bir sunucuya tepki vermez. Kontrol mekanizması, başarısız olan sunucu sayısını toplu işlem boyutuna böler; ulaşılamayan sunucular ayrı bir listede tutulduğu için bu sayıya hiçbir zaman dahil edilmezler. Dördü ulaşılamayan on sunucu max_fail_percentage: 10 altında çalışmaya devam ederken, bir görevde başarısız olan iki sunucu oynatmayı durdurur. Dokümantasyon bir tuzak noktasına daha dikkat çeker: "Belirlenen yüzdeye eşit olunmamalı, bu yüzde aşılmalıdır." serial: 4 ile dört sunucudan ikisinin başarısız olması durumunda durdurma işlemi için 50 değil, 49 yazılmalıdır.

Ulaşılamayan sunucuların çalışmayı kendi başlarına durdurduğu bir durum mevcuttur. Toplu işlemdeki her sunucu başarısız olmuş veya ulaşılamaz durumdaysa, Ansible üzerinde çalışacak başka bir sunucu kalmadığı için oynatmayı NO MORE HOSTS LEFT ile sonlandırır.

serial: tüm filoda değişiklikleri kademeli uygulama

- name: Rolling nginx config update
  hosts: webservers
  serial: 2
  max_fail_percentage: 25
  tasks:
    - name: Deploy the site config
      ansible.builtin.template:
        src: site.conf.j2
        dest: /etc/nginx/conf.d/site.conf
        owner: root
        mode: "0644"
      become: true
      notify: Reload nginx
  handlers:
    - name: Reload nginx
      ansible.builtin.service:
        name: nginx
        state: reloaded
      become: true

serial: 2, tüm işlemi önce iki sunucu üzerinde çalıştırır, tamamlar ve ardından sonraki iki sunucuya geçer. serial: "25%", grubun boyutuyla orantılı olarak ölçeklenir. serial: [1, 5, 10] listesi, canary (erken uyarı) yapısıdır: önce bir sunucu, sonra beş, sonra on sunucu işlenir; kalan sunucular ise son gruptaki sayı kadar parçalar halinde çalıştırılır. max_fail_percentage her bir grup için ayrı ayrı ölçülür, bu nedenle ikisi birlikte çalışır. İlk makinede hata oluşursa, işlem kırk makineyi bozmadan durur. tek bir kontrol makinesinden Linux sunucu filosunu yönetmeyi tek bir komutla güvenli kılan özellik budur.

Erişilemeyen sunucuların ne zaman göz ardı edileceği, ne zaman edilmeyeceği

Fırsatçı işler için bu sunucuları göz ardı edin. Bir veri toplama çalışması veya saatlik sapma kontrolü, kapalı olan bir sunucuyu atladığında hiçbir şey kaybetmez; çünkü bir sonraki geçişte bu sunucu tekrar yakalanır. ignore_unreachable: true oyun seviyesi burada doğru cevaptır; ping adımıyla eşleştirildiğinde atlanan isimler birinin okuyabileceği bir yere düşer.

Güvenlik yaması çalışması için bu sunucuları asla göz ardı etmeyin. Bu çalışmanın değeri, her sunucunun düzeltmeye sahip olduğunun garantisidir; erişilemeyen durumunu bastırmak, "bir sunucu hala savunmasız" gerçeğini temiz ve yeşil bir özet haline getirir. İki haftadır erişilemeyen sunucu, muhtemelen en geride kalmış sunucudur. Bırakın o çalışma 4 hata koduyla sonlansın ve bir kişi durumu incelesin.

Her iki durumda da tek bir kural geçerlidir: durdurmayı bastırın, kaydı asla. Eğer bir sunucu atlandıysa, özet içinde, CI günlüğünde veya bir izleme uyarısında bunu belirten bir şey olmalıdır. Ansible, bir sunucunun varlığını yalnızca üzerinde bir oyun çalıştırıldığı saniyeler boyunca bilir; bu nedenle bir sunucunun Salı gününden beri kapalı olduğunu öğrenmek için kötü bir yerdir. Bu iş izleme sistemine aittir ve Zabbix kuran bir Ansible playbook ile tüm filoyu kapsayan bir görünüm bir öğleden sonra elde edilebilir.

FAQ

Ansible'da ignore_errors ve ignore_unreachable arasındaki fark nedir?

ignore_errors: true, sunucuda çalışan ve sıfır olmayan bir değerle çıkan komut gibi bir hata döndüren görevler için geçerlidir. ignore_unreachable: true ise Ansible'ın bağlantı kuramadığı ve hiçbir modülün çalışmadığı sunucular için geçerlidir. Bu iki ayar, görev sonucundaki farklı alanları okur ve hiçbiri diğerinin kapsadığı durumu karşılamaz. Ansible belgelerine göre ignore_errors, "tanımlanmamış değişken hatalarını, bağlantı hatalarını, yürütme sorunlarını (örneğin eksik paketler) veya sözdizimi hatalarını görmezden gelmez" ve kapalı bir SSH portu bir bağlantı hatasıdır.

ignore_unreachable, sunucuyu play özetinden gizler mi?

Aslında evet. Bu anahtar kelime ayarlandığında, Ansible o sunucuyu unreachable altında saymayı bırakır ve görev başına ok ve ignored olarak sayar; çalıştırma ise 0 koduyla çıkar. fatal: [host]: UNREACHABLE! satırları yazdırılmaya devam ettiği için özet ve çıkış kodu hatalı olsa da loglar doğrudur. ignored sütununu izleyin veya ulaşılamayan bir sunucunun sıfır olmayan bir çıkış kodu üretmesini sağlamak için ansible all -m ansible.builtin.ping -o komutunu ayrı bir adım olarak çalıştırın.

Bir sunucuya ulaşılamadığında ansible-playbook hangi çıkış kodunu döndürür?

4 kodunu döndürür. En az bir hatalı sunucunun olduğu bir çalıştırma, yalnızca ulaşılamayan sunucu olmadığında 2 kodunu döndürür. Hem hata hem de ulaşılamayan sunucunun olduğu bir çalıştırma da 4 döndürür, çünkü ulaşılamayan sunucu kontrolü önceliklidir ve iki kod asla 6 olacak şekilde birleştirilmez. Sorunsuz bir çalıştırma 0 döndürür. Bu kodlar 2026-10-10 tarihinde ansible-core 2.21 kaynak kodu üzerinde doğrulanmıştır. ignore_unreachable: true ayarını yapmak 4 kodunu ortadan kaldırır; bu yüzden sadece çıkış kodunu test eden bir pipeline, atlanan bir makineyi göremez.

Yanıt vermeyen bir sunucu için play'in geri kalanını nasıl atlarım?

İlk görevi ignore_unreachable: true ve register: reachable ile ansible.builtin.ping yapın, ardından when: reachable.unreachable | default(false) koşulu altında ansible.builtin.meta: end_host ile devam edin. end_host, o sunucu için play'i başarısız olarak işaretlemeden sonlandırır. Play üzerinde gather_facts: false ayarını yapın, böylece ping görevi bağlantı kopukluğunu yakalayan görev olur. Bu yapı olmadan ölü sunucu play içinde kalmaya devam eder ve sonraki her görev tekrar bağlantı zaman aşımını bekler.

Güvenlik yaması sırasında ulaşılamayan sunucuları görmezden gelmeli miyim?

Hayır. Bir yama çalıştırması, her sunucunun güncellemeyi aldığına dair garanti verdiği için değerlidir; ulaşılamayan sunucuları görmezden gelmek bu garantiyi yeşil bir özetle değiştirir. Çalıştırmanın 4 koduyla çıkmasına izin verin, yanıt vermeyen sunucuların isimlerini okuyun ve onları düzeltin. Görmezden gelme işlemi, bir sonraki geçişte eksik olanın yakalanacağı tekrarlanan fırsatçı çalıştırmalar için uygundur.

Bu yazı işinize yaradı mı?

#ansible#playbooks#error-handling#inventory#automation