Foreman Yaşam Döngüsü Aracı Kurulumu
Bu yazıda Foreman ismi verilen yönetim aracının kurulumu ve Puppet ile kullanımı ele alınacaktır. Daha önce Puppet konusunda yayınlanan 5 yazıya buradan erişebilirsiniz.
Daha önce yayınlanan “Puppet Merkezi İstemci Yönetimi” isimli yazıda Foreman’den bahsedilmiş ancak kurulumu ve kullanım detayları bu yazıya bırakılmıştır.
İçindekiler
- 1 Foreman Kurulumu ve Kullanımı
- 1.1 Gereksinimler
- 1.2 Foreman Kurulumu
- 1.3 Modül Kurulumu ve Foreman’a Eklenmesi
- 1.4 Varsayılan NTP Havuzunun Değiştirilmesi
- 1.5 Foreman Sunucusunun NTP Modülünü Kullanmak Üzere Ayarlanması
- 1.6 Puppet Konfigürasyonunun Görüntülenmesi
- 1.7 Puppet Agent’ın Çalıştırılması
- 1.8 Foreman’a Yeni Sunucu Eklenmesi
- 1.9 Foreman ile Sunucuların Yönetilmesi
Foreman Kurulumu ve Kullanımı
Foreman sunucu altyapılarını yönetmek üzere kullanılan açık kaynak kodlu, tam teşekkülü bir yaşam döngüsü aracıdır. Sunucu havuzunuzu yönetmek üzere provizyonlama, konfigüre etme ve izleme imkanı sunan Foreman kullanışlı bir web arayüzüne sahiptir. Ayrıca yönetim amaçlı PI ve komut satırı seçenekeleri de mevcuttur.
Foreman tüm Linux versiyonlarında çalışmakla birlikte Puppet ve Chef gibi otomasyon araçları ile birlikte etkileşimli olarak kullanılabilmektedir. Bu yazıda sadece Puppet ile birlikte kullanılmak üzere Ubuntu 14.04 sunucuda Foreman kurulumu ele alınacaktır.
Gereksinimler
Foreman kurulumuna geçmeden önce sunucu havuzunuzda Puppet kurulmuş olmalıdır. Henüz kurulumu tamamlamadıysanız Puppet kurulumu ile ilgili yazıya göz atabilirsiniz.
Kurulum tamamlandığında Foreman sunucusu aynı zamanda puppet-master olarak görev yapacaktır. Bu yazıda Foreman kurulumu mevcut puppet-master sunucusunda yapılmıştır. Bu durumda mevcut site.pp dosyasının üzerine yazılacağı unutulmamalıdır.
Foreman Kurulumu
Foreman kurulumuna geçmeden önce kurulum yapılacak sunucunun isminin alan adı ile birlikte kullanılabilmesi için hosts ve hostname dosyalarında değişiklik yapılmalıdır.
|
1 2 3 4 |
sudo vi /etc/hosts ... 10.61.2.116 puppet-master.vm1.huseyincotuk.com puppet-master ... |
|
1 2 |
sudo vi /etc/hostname puppet-master.vm1.huseyincotuk.com |
|
1 |
sudo hostname --file /etc/hostname |
Ardından Foreman kurulumu için yapılacak ilk adım foreman-installer kurmak olmalıdır. Foreman installer Foreman ile birlikte, puppet master ve agent, Apache web sunucusu (SSL ve Passenger ile birlikte) kuracaktır. Foreman installer kurmak için ilgili repolar eklenerek public key tanımlanmalıdır.
|
1 2 3 4 |
sudo sh -c 'echo "deb http://deb.theforeman.org/ trusty 1.10" > /etc/apt/sources.list.d/foreman.list' sudo sh -c 'echo "deb http://deb.theforeman.org/ plugins 1.10" >> /etc/apt/sources.list.d/foreman.list' wget -q http://deb.theforeman.org/pubkey.gpg -O- | sudo apt-key add - sudo apt-get update && sudo apt-get install foreman-installer |
Önce aşağıdaki komut ile 10.61.2.116 IP adresine gidildiği doğrulanmalıdır. Aksi halde /etc/hosts dosyası yeniden gözden geçirilmelidir.
|
1 2 3 4 |
ping $(hostname -f) PING puppet-master.vm1.huseyincotuk.com (10.61.2.116) 56(84) bytes of data. 64 bytes from puppet-master.vm1.huseyincotuk.com (10.61.2.116): icmp_seq=1 ttl=64 time=0.047 ms 64 bytes from puppet-master.vm1.huseyincotuk.com (10.61.2.116): icmp_seq=2 ttl=64 time=0.040 ms |
Kurulum tamamlandığında foreman-installer çalıştırılmalıdır.
|
1 |
sudo foreman-installer |
İşlem tamamlandığında aşağıdaki gibi bir çıktı alınması gerekmektedir. Şifre xxxxx şeklinde gizlenmiştir.
|
1 2 3 4 5 6 7 8 |
Installing Notice: /Stage[main]/Foreman::Database/Foreman::Ra [99%] [] Installing Done [100%] [] Success! * Foreman is running at https://puppet-master.vm1.huseyincotuk.com Initial credentials are admin / xxxxx * Foreman Proxy is running at https://puppet-master.vm1.huseyincotuk.com:8443 * Puppetmaster is running at port 8140 The full log is at /var/log/foreman-installer/foreman-installer.log |
Ardından Foreman web arayüzüne belirtilen adresten verilen kullanıcı ve şifre ile erişilebilirsiniz. Aşağıdaki gibi bir giriş ekranı gelmelidir.
Giriş yaptıktan sonra karşınıza aşağıdaki gibi bir yönetim paneli gelecektir. Sadece bir sunucu “good host” durumunda görünmelidir.
Öncelikle üstteki panelden hesaba ait şifre güncellenmelidir.
Modül Kurulumu ve Foreman’a Eklenmesi
Ardından Foreman çalışan puppet-master sunucusuna NTP modülü eklenecektir. Bunun için https://forge.puppetlabs.com/ adresine gidilerek NTP modülü arandığında istenilen modülün sonuçlar arasından puppetlabs/ntp olduğu görülecektir. Desteklenen versiyon v.b. detayları alabilmek ve nasıl çalıştığını anlamak için üzerine tıklayarak daha detaylı bilgiye erişilebilmektedir.
Foreman çalıştırılan Puppet-master sunucusu üzerinde NTP modülünü kurmak için aşağıdaki komut kullanılabilir.
|
1 2 3 4 5 6 7 |
ubuntu@puppet-master:~$ sudo puppet module install -i /etc/puppet/environments/production/modules puppetlabs/ntp Notice: Preparing to install into /etc/puppet/environments/production/modules ... Notice: Downloading from https://forgeapi.puppetlabs.com ... Notice: Installing -- do not interrupt ... /etc/puppet/environments/production/modules └─┬ puppetlabs-ntp (v4.1.2) └── puppetlabs-stdlib (v4.10.0) [/etc/puppet/modules] |
Puppet-master üzerinde kurulan modülün kullanılabilmesi için Foreman’a eklenmesi gerekmektedir. Bunun için arayüz üzerinden “configure” menüsünden “classes” seçilmelidir.
Açılan ekrandan “import from puppet-master” bölümüne tıklanarak sunucudaki sınıfların aktarılması sağlanmalıdır.
Aktarma sonrasında üretim (production) ortamı seçilerek yanında bulunan modüllerin Foreman’a eklenmesi sağlanmalıdır.
Böylece bu örnekte kullanıma hazır olan apache, concat, ntp ve stdlib modülleri Foreman ile kullanılabilecek hale getirilmiş olacaktır.
Varsayılan NTP Havuzunun Değiştirilmesi
NTP havuzunda mevcut lokasyona en yakın sunucuları seçmek üzere “Puppet classes” arama yapılarak ntp sınıfları bulunmalı ve ntp sınıfının üzerine tıklanarak düzenleme moduna geçilmelidir.
Açılan ekranda “smart class parameter” sekmesine geçilerek solda yer alan panelden “servers” seçilmelidir. Ardından “override” seçeneği işaretlenerek “key type” array olarak seçilmeli ve varsayılan değer olarak kullanılacak NTP sunucuları eklenmelidir. Değer olarak [“0.tr.pool.ntp.org”,”1.tr.pool.ntp.org”,”2.tr.pool.ntp.org”,”3.tr.pool.ntp.org”] kullanılabilir.
Foreman Sunucusunun NTP Modülünü Kullanmak Üzere Ayarlanması
İhtiyaçlara göre düzenlenen NTP modülü artık Foreman sunucusu ile birlikte kullanılmaya hazır hale gelmiştir. Buna göre “hosts” menüsü altından “all hosts” bölümüne gidilerek Foreman sunucusu seçilmeli ve yanındaki “edit” butonu ile eklenecek modüller düzenlenmelidir.
Açılan ekranda “Puppet Classes” sekmesi altında “available classes” bölümünde kullanılabilecek sınıflar listelenecektir. NTP modülünün yanındaki “+” işaretine tıklanarak alt sınıflar listelenebilir.
Alttaki “ntp” sınıfının yanındaki “+” seçilerek sınıfın “included classes” altına eklenmesi sağlanmalıdır.
Değişiklikler “submit” butonu ile kaydedilmelidir.
Puppet Konfigürasyonunun Görüntülenmesi
Değişikliklerin ardından karşınıza Foreman sunucusunun özet sayfası gelecektir. Herhangi bir Puppet agent kontrol ettiğinde karşılacağı bilgi YAML sekmesi altında görülebilmektedir.
Puppet Agent’ın Çalıştırılması
İstenilen değişiklikler sonrası etkilerini görmek üzere Foreman sunucusunda agent aşağıdaki komut ile çalıştırılabilmektedir.
|
1 2 3 4 5 6 7 |
ubuntu@puppet-master:~$ sudo puppet agent --test Info: Retrieving pluginfacts Info: Retrieving plugin Info: Loading facts Info: Caching catalog for puppet-master.vm1.huseyincotuk.com Info: Applying configuration version '1452693571' Notice: Finished catalog run in 0.37 seconds |
Tekrar web arayüzüne dönüldüğünde YAML sekmesinin yanıdaki “reports” sekmesinde yapılan değişiklikleri izlemek mümkündür.
Foreman’a Yeni Sunucu Eklenmesi
Foreman sunucusu kurulduktan sonra yapılacak ilk iş Foreman ile yönetilmek üzere yeni sunucular eklemek olacaktır. Bunun için öncelikle bu sunuculara Puppet agent kurulması ve yapılandırılması gerekmektedir. Halen yapmadıysanız daha önce bahsi geçen “Puppet Kurulumu” yazısından takip ederek kurulumu tamamlayabilirsiniz.
İlgili kurulum dokümanında bahsi geçen sertifika imzalama işlemi komut satırı vasıtasıyla Puppet ile yapılabildiği gibi Foreman web arayüzü üzerinden de yapılabilmektedir. Bunun için “Infrastructure” menüsünden “Smart Proxies” bölümü altından sertifikalara geçmek gerekmektedir.
Sertifikalar seçildiğinde imzalanan sertifikalar ve varsa bekleyen sertifikalar listelenecektir.
İmzalanmamış her kayıdın yanında çıkacak olan “sign” butonu kullnılarak veya tek seferde hepsini imzalamak için üstteki “autosign entries” butonuna tıklanarak bekleyen sertifikalar imzalanabilir.
Foreman ile Sunucuların Yönetilmesi
Bekleyen sertifikaların da imzalanması ile birlikte istemcilerde puppet agent çalışmasının ardından Foreman ile yönetilen tüm sunucular “Hosts” menüsü altından “All hosts” bölümünden listelenebilir.
Buradan seçilen bir sunucuya tıklanarak açılan pencerede “Run Puppet” seçeneğinin pasif olduğu görülecektir.
Bu durum daha önce yapılan çalışmada mcollective ile kullanabilmek için puppet.conf içerisindeki “listen=true” seçeneğinin kaldırılmasından kaynaklanmaktadır. “puppet kick” komutunda olduğu gibi Foreman sunucusu üzerinden istemcilerde puppet çalıştırmak için puppet agent’ların “daemon” modunda çalışması gerekmektedir. Ayrıca foreman ayarlarında “Administer” menüsünden “Settings/Puppet” başlığı altında puppetrun “enable” edilmelidir. Son olarak Foreman sunucusunda foreman kullanıcısına “puppet kick” çalıştırmak için sudo yetikisi verilmelidir.
|
1 2 3 4 5 6 |
sudo vi /etc/sudoers ... ## Allow foreman-proxy to do puppetrun Defaults:foreman-proxy !requiretty foreman-proxy ALL = NOPASSWD: /usr/bin/puppet kick * ... |
Yapılan değişiklikler kaydedildikten sonra aynı sunucuda “Run puppet” seçeneğinin aktif olduğu görülebilir. Bu butona tıklanarak seçilen sunucuda Puppet’ın çalışması sağlanabilir.
Böylece Foreman kurulumu tamamlanmış, sunucuların foreman ile nasıl yönetilecekleri örneklerle gösterilmiştir.