G\u00fcn\u00fcm\u00fcz\u00fcn karma\u015f\u0131k IT altyap\u0131lar\u0131nda, sunucular\u0131n ve di\u011fer sistemlerin tutarl\u0131 bir \u015fekilde yap\u0131land\u0131r\u0131lmas\u0131 ve y\u00f6netilmesi hayati \u00f6nem ta\u015f\u0131maktad\u0131r. Y\u00fczlerce veya binlerce sunucuyu manuel olarak yap\u0131land\u0131rmak, hem zaman al\u0131c\u0131 hem de hataya a\u00e7\u0131k bir s\u00fcre\u00e7tir. \u0130\u015fte bu noktada otomasyon ara\u00e7lar\u0131 devreye girer. Konfig\u00fcrasyon y\u00f6netimi ara\u00e7lar\u0131, altyap\u0131n\u0131z\u0131n durumunu tan\u0131mlaman\u0131za, da\u011f\u0131tman\u0131za ve s\u00fcrd\u00fcrmenize olanak tan\u0131r. Bu ara\u00e7lardan biri de a\u00e7\u0131k kaynakl\u0131 bir yaz\u0131l\u0131m olan Puppet’tir.<\/p>\n
Puppet, sistem y\u00f6neticilerinin sunucu yap\u0131land\u0131rmalar\u0131n\u0131 kod olarak tan\u0131mlamas\u0131na olanak tan\u0131yan, Ruby tabanl\u0131 bir konfig\u00fcrasyon y\u00f6netim arac\u0131d\u0131r. Bu sayede, “altyap\u0131 kod olarak” (Infrastructure as Code – IaC) prensibi benimsenir. Puppet, deklaratif bir dil kullanarak sistemlerin son durumunu tan\u0131mlar ve bu duruma ula\u015fmak i\u00e7in gerekli ad\u0131mlar\u0131 otomatik olarak atar. \u00d6rne\u011fin, belirli bir paketin y\u00fckl\u00fc olmas\u0131n\u0131, bir servisin \u00e7al\u0131\u015fmas\u0131n\u0131 veya bir dosyan\u0131n belirli bir i\u00e7eri\u011fe sahip olmas\u0131n\u0131 sa\u011flayabilirsiniz.<\/p>\n
Puppet’in temel mimarisi “Master-Agent” (Ana-Arac\u0131) modeline dayan\u0131r. Bu modelde, bir merkezi Puppet Master sunucusu bulunur ve bu sunucu, t\u00fcm konfig\u00fcrasyon tan\u0131mlar\u0131n\u0131 (manifestler, mod\u00fcller) bar\u0131nd\u0131r\u0131r. A\u011fdaki di\u011fer sunucular ise Puppet Agent olarak g\u00f6rev yapar. Agent’lar belirli aral\u0131klarla Master ile ileti\u015fime ge\u00e7erek kendi konfig\u00fcrasyonlar\u0131n\u0131 ister, Master’dan gelen komutlar\u0131 uygular ve konfig\u00fcrasyon durumlar\u0131n\u0131 Master’a raporlar.<\/p>\n
Bu makalede, Puppet’in 4. s\u00fcr\u00fcm\u00fcn\u00fc CentOS 7 i\u015fletim sistemi \u00fczerinde bir Master-Agent mimarisinde nas\u0131l kuraca\u011f\u0131n\u0131z\u0131 ve temel bir konfig\u00fcrasyonu nas\u0131l uygulayaca\u011f\u0131n\u0131z\u0131 ad\u0131m ad\u0131m anlataca\u011f\u0131z. Puppet 4, \u00f6nceki s\u00fcr\u00fcmlere g\u00f6re performans iyile\u015ftirmeleri, daha modern bir kod taban\u0131 ve baz\u0131 yeni \u00f6zellikler sunmu\u015ftur. CentOS 7 ise kurumsal ortamlarda yayg\u0131n olarak kullan\u0131lan stabil ve g\u00fcvenilir bir Linux da\u011f\u0131t\u0131m\u0131d\u0131r. Bu rehber, Puppet ile otomasyon d\u00fcnyas\u0131na ad\u0131m atmak isteyen sistem y\u00f6neticileri ve DevOps m\u00fchendisleri i\u00e7in kapsaml\u0131 bir ba\u015flang\u0131\u00e7 noktas\u0131 olacakt\u0131r.<\/p>\n
Puppet Master ve Agent kurulumuna ba\u015flamadan \u00f6nce, ortam\u0131n\u0131z\u0131n belirli gereksinimleri kar\u015f\u0131lad\u0131\u011f\u0131ndan emin olman\u0131z gerekmektedir. Bu gereksinimler, kurulumun sorunsuz ilerlemesi ve sistemin d\u00fczg\u00fcn \u00e7al\u0131\u015fmas\u0131 i\u00e7in kritik \u00f6neme sahiptir.<\/p>\n
sudo yum update -y<\/code><\/pre>\n<\/li>\n<\/ul>\nA\u011f Yap\u0131land\u0131rmas\u0131<\/h4>\n\n- Statik IP Adresleri:<\/strong> Hem Puppet Master hem de Puppet Agent sunucular\u0131n\u0131n statik IP adreslerine sahip olmas\u0131 \u00f6nerilir. Dinamik IP adresleri, sunucular yeniden ba\u015flat\u0131ld\u0131\u011f\u0131nda de\u011fi\u015febilir ve bu da ileti\u015fimi bozabilir.<\/li>\n
- Hostname \u00c7\u00f6z\u00fcmlemesi:<\/strong> Sunucular aras\u0131nda hostname ile ileti\u015fim kurulabilmesi i\u00e7in isim \u00e7\u00f6z\u00fcmlemesinin d\u00fczg\u00fcn \u00e7al\u0131\u015fmas\u0131 gerekir.\n
\n- Her iki sunucunun da kendi hostname’i do\u011fru bir \u015fekilde ayarlanmal\u0131d\u0131r. \u00d6rne\u011fin:\n
sudo hostnamectl set-hostname puppetmaster.example.com<\/code><\/pre>\nsudo hostnamectl set-hostname puppetagent.example.com<\/code><\/pre>\n<\/li>\n- DNS Kay\u0131tlar\u0131:<\/strong> E\u011fer bir DNS sunucunuz varsa, Master ve Agent sunucular\u0131n\u0131n A kay\u0131tlar\u0131n\u0131 ve PTR kay\u0131tlar\u0131n\u0131 (iste\u011fe ba\u011fl\u0131) eklemeniz en iyi y\u00f6ntemdir.<\/li>\n
\/etc\/hosts<\/code> Dosyas\u0131:<\/strong> DNS sunucusu olmayan ortamlarda veya k\u00fc\u00e7\u00fck kurulumlarda, her iki sunucunun \/etc\/hosts<\/code> dosyas\u0131na di\u011fer sunucunun IP adresi ve hostname’i eklenmelidir.\nPuppet Master’\u0131n \/etc\/hosts<\/code> dosyas\u0131na ekleyin:<\/strong><\/p>\n192.168.1.100 puppetmaster.example.com puppetmaster\n192.168.1.101 puppetagent.example.com puppetagent<\/code><\/pre>\nPuppet Agent’\u0131n \/etc\/hosts<\/code> dosyas\u0131na ekleyin:<\/strong><\/p>\n192.168.1.100 puppetmaster.example.com puppetmaster\n192.168.1.101 puppetagent.example.com puppetagent<\/code><\/pre>\nNot: IP adreslerini ve hostname’leri kendi ortam\u0131n\u0131za g\u00f6re d\u00fczenlemeyi unutmay\u0131n.<\/em><\/p>\n<\/li>\n- Ba\u011flant\u0131 Testi:<\/strong> Sunucular aras\u0131nda ping veya SSH ile ba\u011flant\u0131 kurabildi\u011finizden emin olun.\n
ping puppetmaster.example.com<\/code><\/pre>\nping puppetagent.example.com<\/code><\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nSELinux ve Firewall Durumu<\/h4>\n\n- SELinux:<\/strong> CentOS 7’de SELinux varsay\u0131lan olarak etkindir ve baz\u0131 durumlarda Puppet’in d\u00fczg\u00fcn \u00e7al\u0131\u015fmas\u0131n\u0131 engelleyebilir. Kurulum s\u0131ras\u0131nda sorun ya\u015famamak i\u00e7in ge\u00e7ici olarak devre d\u0131\u015f\u0131 b\u0131rakabilir veya uygun kurallar\u0131 ekleyebilirsiniz. G\u00fcvenlik nedeniyle kal\u0131c\u0131 olarak devre d\u0131\u015f\u0131 b\u0131rakmak yerine, gerekli izinleri tan\u0131mlamak daha do\u011fru bir yakla\u015f\u0131md\u0131r.\n
Ge\u00e7ici olarak devre d\u0131\u015f\u0131 b\u0131rakmak i\u00e7in:<\/strong><\/p>\nsudo setenforce 0<\/code><\/pre>\nKal\u0131c\u0131 olarak devre d\u0131\u015f\u0131 b\u0131rakmak i\u00e7in \/etc\/selinux\/config<\/code> dosyas\u0131n\u0131 d\u00fczenleyin:<\/strong><\/p>\nSELINUX=enforcing # Bunu enforcing yerine disabled yap\u0131n\nsudo reboot<\/code><\/pre>\nMakalenin ilerleyen b\u00f6l\u00fcmlerinde SELinux’u etkin tutmak i\u00e7in gerekli ayarlamalardan bahsedece\u011fiz.<\/em><\/p>\n<\/li>\n- Firewall (firewalld):<\/strong> CentOS 7’de varsay\u0131lan olarak
firewalld<\/code> etkindir. Puppet Master sunucusunun, Agent’lardan gelen ba\u011flant\u0131lar\u0131 kabul edebilmesi i\u00e7in 8140 TCP portunun a\u00e7\u0131lmas\u0131 gerekmektedir.\nPuppet Master’da 8140 portunu a\u00e7mak i\u00e7in:<\/strong><\/p>\nsudo firewall-cmd --add-port=8140\/tcp --permanent\nsudo firewall-cmd --reload<\/code><\/pre>\nPuppet Agent sunucusunda d\u0131\u015far\u0131dan gelen bir ba\u011flant\u0131 olaca\u011f\u0131 i\u00e7in \u00f6zel bir firewall ayar\u0131 yapmaya gerek yoktur. Ancak Agent’\u0131n Master’a 8140 portundan eri\u015febildi\u011finden emin olun.<\/p>\n<\/li>\n<\/ul>\n
Sistem Kaynaklar\u0131<\/h4>\n\n- Puppet Master:<\/strong> Puppet Master, Agent’lardan gelen istekleri i\u015fledi\u011fi ve konfig\u00fcrasyonlar\u0131 derledi\u011fi i\u00e7in daha fazla kayna\u011fa ihtiya\u00e7 duyar.\n
\n- RAM:<\/strong> En az 2 GB RAM (k\u00fc\u00e7\u00fck ortamlar i\u00e7in), daha b\u00fcy\u00fck ortamlar i\u00e7in 4 GB veya daha fazlas\u0131 \u00f6nerilir. Puppet Server Java tabanl\u0131 oldu\u011fu i\u00e7in bellek t\u00fcketimi y\u00fcksek olabilir.<\/li>\n
- CPU:<\/strong> En az 2 CPU \u00e7ekirde\u011fi.<\/li>\n<\/ul>\n<\/li>\n
- Puppet Agent:<\/strong> Agent’lar daha az kayna\u011fa ihtiya\u00e7 duyar.\n
\n- RAM:<\/strong> En az 512 MB RAM.<\/li>\n
- CPU:<\/strong> En az 1 CPU \u00e7ekirde\u011fi.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
Bu \u00f6n gereksinimleri tamamlad\u0131ktan sonra, Puppet Master ve Agent kurulum ad\u0131mlar\u0131na ge\u00e7meye haz\u0131r\u0131z.<\/p>\n
Master Sunucu Kurulumu<\/h3>\n
Puppet Master sunucusu, t\u00fcm konfig\u00fcrasyon y\u00f6netiminin merkezidir. Bu sunucu, Puppet manifestlerini, mod\u00fcllerini ve Agent’lar\u0131n konfig\u00fcrasyonunu derlemek i\u00e7in gereken t\u00fcm ara\u00e7lar\u0131 bar\u0131nd\u0131r\u0131r.<\/p>\n
Puppet Labs Deposu Ekleme<\/h4>\n
Puppet paketleri CentOS’un varsay\u0131lan depolar\u0131nda bulunmaz. Bu nedenle, Puppet Labs’\u0131n kendi deposunu sisteme eklememiz gerekmektedir. Bu depo, Puppet Server ve Agent paketlerini i\u00e7erir.<\/p>\n
sudo rpm -Uvh https:\/\/yum.puppet.com\/puppet4\/puppet4-release-el-7.noarch.rpm<\/code><\/pre>\nBu komut, Puppet 4 i\u00e7in gerekli olan RPM deposunu sisteminize ekleyecektir. yum<\/code> komutlar\u0131 art\u0131k bu depodan Puppet paketlerini bulabilir.<\/p>\nPuppet Server Kurulumu<\/h4>\n
Depoyu ekledikten sonra, puppetserver<\/code> paketini y\u00fckleyebiliriz:<\/p>\nsudo yum install -y puppetserver<\/code><\/pre>\nBu komut, Puppet Master sunucusunun \u00e7al\u0131\u015fmas\u0131 i\u00e7in gerekli olan t\u00fcm ba\u011f\u0131ml\u0131l\u0131klar\u0131 ve puppetserver<\/code> uygulamas\u0131n\u0131 y\u00fckleyecektir.<\/p>\nJava Bellek Ayarlar\u0131<\/h4>\n
Puppet Server, Java Sanal Makinesi (JVM) \u00fczerinde \u00e7al\u0131\u015f\u0131r ve varsay\u0131lan olarak belirli bir bellek miktar\u0131 ile yap\u0131land\u0131r\u0131l\u0131r. K\u00fc\u00e7\u00fck ortamlar i\u00e7in varsay\u0131lan ayarlar yeterli olabilirken, daha b\u00fcy\u00fck ortamlar veya y\u00fcksek y\u00fck alt\u0131nda \u00e7al\u0131\u015fan sunucular i\u00e7in JVM’e ayr\u0131lan belle\u011fi art\u0131rmak gerekebilir. Bu ayar, \/etc\/sysconfig\/puppetserver<\/code> dosyas\u0131nda yap\u0131l\u0131r.<\/p>\nsudo vi \/etc\/sysconfig\/puppetserver<\/code><\/pre>\nDosyay\u0131 a\u00e7t\u0131ktan sonra, JAVA_ARGS<\/code> de\u011fi\u015fkenini bulun ve -Xms<\/code> (ba\u015flang\u0131\u00e7 bellek boyutu) ve -Xmx<\/code> (maksimum bellek boyutu) de\u011ferlerini ayarlay\u0131n. \u00d6rne\u011fin, 2 GB bellek ay\u0131rmak i\u00e7in:<\/p>\nJAVA_ARGS=\"-Xms2g -Xmx2g -XX:MaxPermSize=256m\"<\/code><\/pre>\nNot: MaxPermSize<\/code> Puppet 8’den itibaren kald\u0131r\u0131lm\u0131\u015ft\u0131r, ancak Puppet 4’te hala kullan\u0131labilir. Ortam\u0131n\u0131z\u0131n RAM kapasitesine g\u00f6re bu de\u011ferleri ayarlay\u0131n.<\/em><\/p>\nFirewall Ayarlar\u0131<\/h4>\n
Puppet Master’\u0131n Agent’lardan gelen ba\u011flant\u0131lar\u0131 kabul edebilmesi i\u00e7in 8140 TCP portunun a\u00e7\u0131k olmas\u0131 gerekmektedir. Bu port, Puppet’in varsay\u0131lan ileti\u015fim portudur.<\/p>\n
sudo firewall-cmd --add-port=8140\/tcp --permanent\nsudo firewall-cmd --reload<\/code><\/pre>\nBu komutlar, firewalld<\/code> servisine 8140 portunu kal\u0131c\u0131 olarak a\u00e7mas\u0131n\u0131 s\u00f6yler ve ard\u0131ndan firewall kurallar\u0131n\u0131 yeniden y\u00fckler.<\/p>\nSELinux Ayarlar\u0131 (Opsiyonel ama \u00d6nemli)<\/h4>\n
E\u011fer SELinux’u devre d\u0131\u015f\u0131 b\u0131rakmak istemiyorsan\u0131z (ki bu g\u00fcvenlik a\u00e7\u0131s\u0131ndan \u00f6nerilen bir yakla\u015f\u0131md\u0131r), Puppet Server’\u0131n d\u00fczg\u00fcn \u00e7al\u0131\u015fmas\u0131 i\u00e7in baz\u0131 SELinux politikalar\u0131n\u0131n ayarlanmas\u0131 gerekebilir. Genellikle, Puppet’in varsay\u0131lan kurulumu i\u00e7in SELinux politikalar\u0131 yeterlidir. Ancak \u00f6zel mod\u00fcller veya dosya eri\u015fim sorunlar\u0131 ya\u015farsan\u0131z, a\u015fa\u011f\u0131daki gibi izinler eklemeniz gerekebilir:<\/p>\n
sudo semanage fcontext -a -t puppet_var_lib_t \"\/opt\/puppetlabs\/server\/data\/puppetserver(\/.*)?\"\nsudo restorecon -Rv \/opt\/puppetlabs\/server\/data\/puppetserver<\/code><\/pre>\nBu, Puppet Server’\u0131n veri dizinleri i\u00e7in do\u011fru SELinux ba\u011flam\u0131n\u0131 ayarlar. \u00c7o\u011fu durumda, Puppet’in kendi politikalar\u0131 zaten bu t\u00fcr eri\u015fimleri y\u00f6netir. E\u011fer setenforce 0<\/code> ile ge\u00e7ici olarak devre d\u0131\u015f\u0131 b\u0131rakt\u0131ysan\u0131z, kurulum sonras\u0131 testleri yap\u0131p SELinux’u tekrar enforcing<\/code> moduna al\u0131p sorun olup olmad\u0131\u011f\u0131n\u0131 g\u00f6zlemleyebilirsiniz. Sorun ya\u015farsan\u0131z, audit2allow<\/code> arac\u0131yla \u00f6zel kurallar olu\u015fturabilirsiniz.<\/p>\nPuppet Server Servisini Ba\u015flatma ve Etkinle\u015ftirme<\/h4>\n
T\u00fcm ayarlar\u0131 yapt\u0131ktan sonra, Puppet Server servisini ba\u015flatabilir ve sistem ba\u015flang\u0131c\u0131nda otomatik olarak ba\u015flamas\u0131 i\u00e7in etkinle\u015ftirebiliriz:<\/p>\n
sudo systemctl start puppetserver\nsudo systemctl enable puppetserver<\/code><\/pre>\nServisin durumunu kontrol etmek i\u00e7in:<\/p>\n
sudo systemctl status puppetserver<\/code><\/pre>\nDurumun “active (running)” oldu\u011funu g\u00f6rmelisiniz. Herhangi bir hata durumunda, log dosyalar\u0131n\u0131 (\/var\/log\/puppetlabs\/puppetserver\/puppetserver.log<\/code>) kontrol edin.<\/p>\nPath Ayarlar\u0131<\/h4>\n
Puppet komutlar\u0131n\u0131 (puppet<\/code>, puppetserver<\/code> vb.) do\u011frudan \u00e7al\u0131\u015ft\u0131rabilmek i\u00e7in, bu komutlar\u0131n bulundu\u011fu dizinlerin PATH ortam de\u011fi\u015fkeninde tan\u0131ml\u0131 olmas\u0131 faydal\u0131d\u0131r. Puppet 4, komutlar\u0131 \/opt\/puppetlabs\/bin<\/code> dizinine y\u00fckler. Bu dizin genellikle varsay\u0131lan olarak PATH’e eklenir, ancak emin olmak i\u00e7in kontrol edebilirsiniz:<\/p>\necho $PATH<\/code><\/pre>\nE\u011fer \/opt\/puppetlabs\/bin<\/code> PATH’te yoksa, kullan\u0131c\u0131 profilinize ekleyebilirsiniz:<\/p>\necho 'export PATH=$PATH:\/opt\/puppetlabs\/bin' >> ~\/.bashrc\nsource ~\/.bashrc<\/code><\/pre>\nBu ad\u0131m, Puppet komutlar\u0131n\u0131 her yerden kolayca \u00e7al\u0131\u015ft\u0131rman\u0131za olanak tan\u0131r.<\/p>\n
Agent Sunucu Kurulumu<\/h3>\n
Puppet Agent sunucular\u0131, Puppet Master’dan konfig\u00fcrasyonlar\u0131 al\u0131r ve kendi \u00fczerlerinde uygular. Her Agent, Master ile belirli aral\u0131klarla ileti\u015fime ge\u00e7er ve konfig\u00fcrasyon durumunu raporlar.<\/p>\n
Paket Deposu Ekleme<\/h4>\n
T\u0131pk\u0131 Master sunucusunda oldu\u011fu gibi, Agent sunucular\u0131na da Puppet Labs deposunu eklememiz gerekiyor:<\/p>\n
sudo rpm -Uvh https:\/\/yum.puppet.com\/puppet4\/puppet4-release-el-7.noarch.rpm<\/code><\/pre>\nPuppet Agent Kurulumu<\/h4>\n
Depoyu ekledikten sonra, puppet-agent<\/code> paketini y\u00fckleyebiliriz:<\/p>\nsudo yum install -y puppet-agent<\/code><\/pre>\nBu komut, Puppet Agent’\u0131n \u00e7al\u0131\u015fmas\u0131 i\u00e7in gerekli olan t\u00fcm ba\u011f\u0131ml\u0131l\u0131klar\u0131 ve uygulamay\u0131 y\u00fckleyecektir.<\/p>\n
Puppet Agent Yap\u0131land\u0131rmas\u0131<\/h4>\n
Agent’\u0131n Puppet Master’\u0131 bulabilmesi i\u00e7in \/etc\/puppetlabs\/puppet\/puppet.conf<\/code> dosyas\u0131nda server<\/code> ayar\u0131n\u0131 yapmam\u0131z gerekir.<\/p>\nsudo vi \/etc\/puppetlabs\/puppet\/puppet.conf<\/code><\/pre>\n[main]<\/code> b\u00f6l\u00fcm\u00fcn\u00fcn alt\u0131na veya bu b\u00f6l\u00fcm yoksa olu\u015fturarak a\u015fa\u011f\u0131daki sat\u0131r\u0131 ekleyin:<\/p>\n[main]\ncertname = puppetagent.example.com # Agent'\u0131n hostname'i\nserver = puppetmaster.example.com # Puppet Master'\u0131n hostname'i<\/code><\/pre>\ncertname<\/code> de\u011feri, Agent’\u0131n Puppet Master’a kendini tan\u0131taca\u011f\u0131 isimdir. Bu genellikle Agent’\u0131n tam nitelikli alan ad\u0131 (FQDN) olmal\u0131d\u0131r. server<\/code> de\u011feri ise Puppet Master sunucusunun FQDN’sidir.<\/p>\nFirewall Ayarlar\u0131<\/h4>\n
Puppet Agent sunucusu, Master’a ba\u011flant\u0131 ba\u015flatt\u0131\u011f\u0131 i\u00e7in gelen ba\u011flant\u0131lar\u0131 kabul etmesi gerekmez. Bu nedenle, Agent taraf\u0131nda \u00f6zel bir firewall kural\u0131 eklemeye gerek yoktur. Ancak, Agent’\u0131n Master’\u0131n 8140 portuna eri\u015febildi\u011finden emin olun.<\/p>\n
SELinux Ayarlar\u0131<\/h4>\n
Agent taraf\u0131nda da SELinux’un etkin olmas\u0131 durumunda, Puppet’in d\u00fczg\u00fcn \u00e7al\u0131\u015fabilmesi i\u00e7in gerekli izinlerin sa\u011flanmas\u0131 \u00f6nemlidir. Genellikle puppet-agent<\/code> paketi, kurulum s\u0131ras\u0131nda gerekli SELinux ba\u011flamlar\u0131n\u0131 ayarlar. Ancak, \u00f6zel durumlar veya dosya eri\u015fim sorunlar\u0131 ya\u015farsan\u0131z, hata mesajlar\u0131n\u0131 kontrol ederek uygun SELinux kurallar\u0131n\u0131 eklemeniz gerekebilir. \u00c7o\u011fu durumda, Puppet Agent varsay\u0131lan SELinux politikalar\u0131yla sorunsuz \u00e7al\u0131\u015f\u0131r.<\/p>\nPuppet Agent Servisini Ba\u015flatma ve Etkinle\u015ftirme<\/h4>\n
Yap\u0131land\u0131rmay\u0131 tamamlad\u0131ktan sonra, Puppet Agent servisini ba\u015flatabilir ve sistem ba\u015flang\u0131c\u0131nda otomatik olarak ba\u015flamas\u0131 i\u00e7in etkinle\u015ftirebiliriz:<\/p>\n
sudo systemctl start puppet\nsudo systemctl enable puppet<\/code><\/pre>\nServisin durumunu kontrol etmek i\u00e7in:<\/p>\n
sudo systemctl status puppet<\/code><\/pre>\nDurumun “active (running)” oldu\u011funu g\u00f6rmelisiniz. Agent varsay\u0131lan olarak 30 dakikada bir Master ile ileti\u015fime ge\u00e7meye \u00e7al\u0131\u015facakt\u0131r. Ancak biz bu i\u015flemi manuel olarak tetikleyece\u011fiz.<\/p>\n
Master-Agent Aras\u0131 \u0130leti\u015fim ve Sertifika \u0130mzalama<\/h3>\n
Puppet, Master ve Agent aras\u0131ndaki ileti\u015fimi g\u00fcvenli hale getirmek i\u00e7in SSL sertifikalar\u0131n\u0131 kullan\u0131r. Her Agent, ilk ba\u011flant\u0131s\u0131nda Master’dan bir sertifika ister ve Master bu iste\u011fi onaylay\u0131p imzalamadan \u00f6nce Agent’\u0131n kimli\u011fini do\u011frular. Bu, Master’\u0131n yaln\u0131zca yetkili Agent’larla ileti\u015fim kurmas\u0131n\u0131 sa\u011flar.<\/p>\n
Agent Taraf\u0131nda Sertifika \u0130ste\u011fi G\u00f6nderme<\/h4>\n
Agent sunucusunda, Master’a bir sertifika iste\u011fi g\u00f6ndermek i\u00e7in a\u015fa\u011f\u0131daki komutu \u00e7al\u0131\u015ft\u0131r\u0131n:<\/p>\n
sudo \/opt\/puppetlabs\/bin\/puppet agent --test --server puppetmaster.example.com<\/code><\/pre>\nVeya daha k\u0131sa haliyle:<\/p>\n
sudo puppet agent -t --server puppetmaster.example.com<\/code><\/pre>\nBu komut, Agent’\u0131n Master’a ba\u011flanmas\u0131n\u0131 ve bir sertifika iste\u011fi g\u00f6ndermesini sa\u011flar. Komutun \u00e7\u0131kt\u0131s\u0131nda, Agent’\u0131n sertifika iste\u011fi g\u00f6nderdi\u011fini ve Master’\u0131n imzalamas\u0131n\u0131 bekledi\u011fini belirten bir mesaj g\u00f6rmelisiniz (\u00f6rn. “Exiting; no certificate found and waitforcert is disabled”).<\/p>\n
Master Taraf\u0131nda Sertifika \u0130mzalama<\/h4>\n
Puppet Master sunucusuna ge\u00e7in. Agent’\u0131n sertifika iste\u011fini g\u00f6rmek i\u00e7in a\u015fa\u011f\u0131daki komutu kullan\u0131n:<\/p>\n
sudo \/opt\/puppetlabs\/bin\/puppet cert list<\/code><\/pre>\nBu komut, bekleyen sertifika isteklerinin bir listesini g\u00f6sterecektir. \u00c7\u0131kt\u0131da puppetagent.example.com<\/code> gibi Agent’\u0131n\u0131z\u0131n hostname’ini g\u00f6rmelisiniz (\u00f6rn. ” “puppetagent.example.com” (SHA256) …”).<\/p>\nAgent’\u0131n sertifikas\u0131n\u0131 imzalamak i\u00e7in:<\/p>\n
sudo \/opt\/puppetlabs\/bin\/puppet cert sign puppetagent.example.com<\/code><\/pre>\nSertifika ba\u015far\u0131yla imzaland\u0131\u011f\u0131nda, “Notice: Signed certificate for puppetagent.example.com” gibi bir mesaj g\u00f6rmelisiniz. T\u00fcm sertifikalar\u0131 listelemek i\u00e7in puppet cert list --all<\/code> komutunu kullanabilirsiniz.<\/p>\nAgent Taraf\u0131nda Sertifika Kontrol\u00fc<\/h4>\n
Sertifika imzaland\u0131ktan sonra, Agent sunucusuna geri d\u00f6n\u00fcn ve sertifikay\u0131 Master’dan almak ve konfig\u00fcrasyonu uygulamak i\u00e7in puppet agent<\/code> komutunu tekrar \u00e7al\u0131\u015ft\u0131r\u0131n:<\/p>\nsudo puppet agent -t --server puppetmaster.example.com<\/code><\/pre>\nBu sefer, Agent Master ile g\u00fcvenli bir \u015fekilde ileti\u015fim kurabilmeli ve herhangi bir konfig\u00fcrasyon de\u011fi\u015fikli\u011fi varsa bunlar\u0131 uygulayabilmelidir. E\u011fer hen\u00fcz bir konfig\u00fcrasyon tan\u0131mlamad\u0131ysak, “Notice: Applied catalog in …s” gibi bir mesaj g\u00f6rmelisiniz, bu da Agent’\u0131n Master’dan bir katalog ald\u0131\u011f\u0131n\u0131 ve uygulad\u0131\u011f\u0131n\u0131 g\u00f6sterir (\u015fu an i\u00e7in bo\u015f bir katalog olsa bile).<\/p>\n
Bu ad\u0131mlarla Master ve Agent aras\u0131ndaki g\u00fcvenli ileti\u015fim kurulmu\u015f ve sertifika de\u011fi\u015fimi tamamlanm\u0131\u015ft\u0131r. Art\u0131k Agent’lar, Master’dan konfig\u00fcrasyonlar\u0131 almaya haz\u0131rd\u0131r.<\/p>\n
Basit Bir Puppet Manifest Olu\u015fturma ve Uygulama<\/h3>\n
Puppet’in temel g\u00fcc\u00fc, sistemlerin istenen durumunu tan\u0131mlayan manifestler arac\u0131l\u0131\u011f\u0131yla konfig\u00fcrasyonlar\u0131 otomatikle\u015ftirmesidir. Bu b\u00f6l\u00fcmde, Agent sunucusunda basit bir dosya olu\u015fturmak i\u00e7in bir Puppet mod\u00fcl\u00fc olu\u015fturacak ve bunu uygulayaca\u011f\u0131z.<\/p>\n
Puppet Manifest Yap\u0131s\u0131<\/h4>\n
Puppet Master, konfig\u00fcrasyonlar\u0131 \/etc\/puppetlabs\/code\/environments\/production<\/code> dizininde tutar. Bu dizinin alt\u0131nda iki ana b\u00f6l\u00fcm vard\u0131r:<\/p>\n\nmanifests<\/code>: Ana site manifest dosyalar\u0131n\u0131 (\u00f6rn. site.pp<\/code>) i\u00e7erir.<\/li>\nmodules<\/code>: Yeniden kullan\u0131labilir konfig\u00fcrasyon birimleri olan mod\u00fclleri bar\u0131nd\u0131r\u0131r.<\/li>\n<\/ul>\nMaster \u00dczerinde Mod\u00fcl Olu\u015fturma<\/h4>\n
Agent’a bir kar\u015f\u0131lama mesaj\u0131 (MOTD – Message of the Day) dosyas\u0131 olu\u015fturacak basit bir mod\u00fcl olu\u015ftural\u0131m. Mod\u00fcl\u00fcm\u00fcz\u00fcn ad\u0131 my_motd<\/code> olsun.<\/p>\nsudo mkdir -p \/etc\/puppetlabs\/code\/environments\/production\/modules\/my_motd\/{manifests,files}<\/code><\/pre>\n\u015eimdi mod\u00fcl\u00fcn manifest dosyas\u0131n\u0131 olu\u015ftural\u0131m: \/etc\/puppetlabs\/code\/environments\/production\/modules\/my_motd\/manifests\/init.pp<\/code><\/p>\nsudo vi \/etc\/puppetlabs\/code\/environments\/production\/modules\/my_motd\/manifests\/init.pp<\/code><\/pre>\n\u0130\u00e7eri\u011fi a\u015fa\u011f\u0131daki gibi yap\u0131n:<\/p>\n
class my_motd {\n file { '\/etc\/motd':\n ensure => file,\n content => \"Bu sunucu Puppet taraf\u0131ndan y\u00f6netilmektedir. Ho\u015f geldiniz!\\n\",\n mode => '0644',\n owner => 'root',\n group => 'root',\n }\n}<\/code><\/pre>\nBu Puppet kodu, \/etc\/motd<\/code> yolunda bir dosya (file<\/code> kayna\u011f\u0131) olu\u015fturur. ensure => file<\/code> dosyan\u0131n var olmas\u0131n\u0131 sa\u011flar, content<\/code> i\u00e7eri\u011fini belirler, mode<\/code> dosya izinlerini ayarlar, owner<\/code> ve group<\/code> ise dosyan\u0131n sahibi ve grubunu belirler.<\/p>\nSite Manifest D\u00fczenleme<\/h4>\n
\u015eimdi bu mod\u00fcl\u00fc Agent sunucumuza uygulamak i\u00e7in site.pp<\/code> dosyas\u0131n\u0131 d\u00fczenlememiz gerekiyor. Bu dosya, belirli Agent’lara veya t\u00fcm Agent’lara hangi mod\u00fcllerin veya kaynaklar\u0131n uygulanaca\u011f\u0131n\u0131 tan\u0131mlar.<\/p>\nsudo vi \/etc\/puppetlabs\/code\/environments\/production\/manifests\/site.pp<\/code><\/pre>\nDosyan\u0131n i\u00e7eri\u011fini a\u015fa\u011f\u0131daki gibi yap\u0131n:<\/p>\n
node 'puppetagent.example.com' {\n class { 'my_motd': }\n}<\/code><\/pre>\nBu kod, puppetagent.example.com<\/code> hostname’ine sahip olan Agent’a my_motd<\/code> s\u0131n\u0131f\u0131n\u0131 uygulamas\u0131n\u0131 s\u00f6yler. E\u011fer t\u00fcm Agent’lara uygulamak isterseniz node default {}<\/code> blo\u011funu kullanabilirsiniz.<\/p>\nNot: Puppet Master’da yapt\u0131\u011f\u0131n\u0131z her de\u011fi\u015fiklikten sonra, Puppet Server’\u0131 yeniden ba\u015flatmak genellikle gerekmez, \u00e7\u00fcnk\u00fc Puppet Server de\u011fi\u015fiklikleri otomatik olarak alg\u0131lar. Ancak bazen \u00f6nbellek sorunlar\u0131 ya\u015farsan\u0131z yeniden ba\u015flatmak faydal\u0131 olabilir: sudo systemctl restart puppetserver<\/code><\/em><\/p>\nAgent Taraf\u0131nda Uygulama<\/h4>\n
Agent sunucusuna geri d\u00f6n\u00fcn ve Master’dan yeni konfig\u00fcrasyonu almak ve uygulamak i\u00e7in puppet agent<\/code> komutunu \u00e7al\u0131\u015ft\u0131r\u0131n:<\/p>\nsudo puppet agent -t --server puppetmaster.example.com<\/code><\/pre>\nKomutun \u00e7\u0131kt\u0131s\u0131nda, Puppet’in my_motd<\/code> s\u0131n\u0131f\u0131n\u0131 uygulad\u0131\u011f\u0131n\u0131 ve \/etc\/motd<\/code> dosyas\u0131n\u0131 olu\u015fturdu\u011funu veya g\u00fcncelledi\u011fini g\u00f6rmelisiniz. \u00d6rne\u011fin, “Notice: \/Stage[main]\/My_motd\/File[\/etc\/motd]\/content: content changed ‘…’ to ‘…'” gibi bir sat\u0131r g\u00f6rebilirsiniz.<\/p>\n\u015eimdi Agent sunucusunda \/etc\/motd<\/code> dosyas\u0131n\u0131n i\u00e7eri\u011fini kontrol edin:<\/p>\ncat \/etc\/motd<\/code><\/pre>\n\u00c7\u0131kt\u0131da “Bu sunucu Puppet taraf\u0131ndan y\u00f6netilmektedir. Ho\u015f geldiniz!” mesaj\u0131n\u0131 g\u00f6rmelisiniz.<\/p>\n
Tebrikler! Puppet Master-Agent kurulumunu ba\u015far\u0131yla tamamlad\u0131n\u0131z ve ilk konfig\u00fcrasyonunuzu uygulad\u0131n\u0131z. Puppet Agent varsay\u0131lan olarak 30 dakikada bir Master ile ileti\u015fime ge\u00e7erek konfig\u00fcrasyonu otomatik olarak kontrol edecek ve uygulayacakt\u0131r. Bu periyodu \/etc\/puppetlabs\/puppet\/puppet.conf<\/code> dosyas\u0131nda runinterval<\/code> ayar\u0131yla de\u011fi\u015ftirebilirsiniz.<\/p>\nS\u0131k Kar\u015f\u0131la\u015f\u0131lan Sorunlar ve \u00c7\u00f6z\u00fcmleri<\/h3>\n
Puppet kurulumu ve yap\u0131land\u0131rmas\u0131 s\u0131ras\u0131nda baz\u0131 yayg\u0131n sorunlarla kar\u015f\u0131la\u015f\u0131labilir. \u0130\u015fte bunlardan baz\u0131lar\u0131 ve olas\u0131 \u00e7\u00f6z\u00fcmleri:<\/p>\n
1. Sertifika Sorunlar\u0131<\/h4>\n\n- Sorun:<\/strong> Agent, Master’a ba\u011flanam\u0131yor ve “certificate verify failed” veya “hostname does not match the server certificate” gibi hatalar al\u0131yor.\n
\n- \u00c7\u00f6z\u00fcm:<\/strong>\n
\n- Hostname \u00c7\u00f6z\u00fcmlemesi:<\/strong> Master ve Agent’\u0131n hostname’lerinin do\u011fru bir \u015fekilde \u00e7\u00f6z\u00fcmlendi\u011finden emin olun (DNS veya
\/etc\/hosts<\/code> dosyas\u0131).<\/li>\n- Zaman Senkronizasyonu:<\/strong> Master ve Agent sunucular\u0131n\u0131n zamanlar\u0131n\u0131n senkronize oldu\u011fundan emin olun (NTP kullan\u0131n). Zaman farklar\u0131 sertifika hatalar\u0131na neden olabilir.<\/li>\n
- Yanl\u0131\u015f Sertifika:<\/strong> Agent daha \u00f6nce ba\u015fka bir Master ile ileti\u015fim kurduysa veya sertifikas\u0131 bozulduysa, Agent’taki ve Master’daki eski sertifikalar\u0131 temizlemeniz gerekebilir.\n
Agent’ta:<\/strong><\/p>\nsudo rm -rf \/etc\/puppetlabs\/puppet\/ssl<\/code><\/pre>\nMaster’da:<\/strong><\/p>\nsudo puppet cert clean puppetagent.example.com<\/code><\/pre>\nDaha sonra Agent’ta tekrar sertifika iste\u011fi g\u00f6nderin ve Master’da imzalay\u0131n.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
2. Firewall Engellemeleri<\/h4>\n\n- Sorun:<\/strong> Agent, Master’a ba\u011flanam\u0131yor ve “Connection refused” veya “Connection timed out” hatalar\u0131 al\u0131yor.\n
\n- \u00c7\u00f6z\u00fcm:<\/strong>\n
\n