ICO wiki - User contributions [en]

Ansible

2014-01-13T16:30:55Z

Ptomusk: /* Erinevused levinud alternatiividega */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Toetatud on Linux ja teised Unixilaadsed operatsioonisüsteemid, Windows servermasinana toetatud ei ole.<ref name="ansible_installation"/>
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

Neljast konkurendist on Ansible'l hetkel kõige rohkem erinevaid autoreid, mis annab tunnistust tervest ja aktiivsest arendajaskonnast.<ref>Ansible pulse, https://github.com/ansible/ansible/pulse/monthly</ref><ref>Puppet pulse, https://github.com/puppetlabs/puppet/pulse/monthly</ref><ref>Chef pulse, https://github.com/opscode/chef/pulse/monthly</ref><ref>SaltStack pulse, https://github.com/saltstack/salt/pulse/monthly</ref> Ansible ajakohasusest annab aimu ka [[Ubuntu]] repositooriumist kättesaadavate pakkide võrdlus, milles praegusele ''(12.04)'' LTS versioonile on [[GitHub]]'is projekti enda uusima versiooniga võrreldes ajakohane versioon saadaval vaid Ansible'le.
<ref>Ansible GitHub releases, https://github.com/ansible/ansible/releases</ref>
<ref>Puppet GitHub releases, https://github.com/puppetlabs/puppet/releases</ref>
<ref>Chef GitHub releases, https://github.com/opscode/chef/releases</ref>
<ref>SaltStack GitHub releases, https://github.com/saltstack/salt/releases</ref>
<ref>Ansible package for Ubuntu (precise), http://packages.ubuntu.com/precise-backports/ansible</ref>
<ref>Puppet package for Ubuntu (precise), http://packages.ubuntu.com/precise-updates/puppet</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.

;Silver Vesi
:Olles analüüsinud Ansiblet ja tema alternatiive pean tõdema, et väiksemal skaalal ja triviaalsete muudatuste tegemiseks võtaksin kasutusele Ansible, samas kui suuremas võrgus kus on mitmeid erinevaid operatsioonisüsteeme, kasutaksin pigem Puppetit. Ansiblet on lihtsam kasutada ja üles seada, tema süntaks on märksa lihtsam, aga Puppetil on taga kommuun mille toel on juurde arendatud meeletult mooduleid millega kergema vaevaga automatiseerida ka keerukamaid toiminguid.
;Peeter Tomusk
:Ansible kasutamine on süsteemiadministraatorile mugav ja omane, kuna sarnaneb vägagi skriptide kirjutamisele, seetõttu on ka implementeerimise õpikõver [[Puppet]]'i ja [[Chef]]'iga võrreldes oluliselt väiksem. Rakendades olemasolevaid lahendusi ([[SSH]]) tundub Ansible baasil keskhalduse kasutuselevõtmine loogilise jätkuna seniste haldusmeetodite järel ning võimaldab süsteemi haldavatel isikutel enda oskustepagasit orgaaniliselt täiendada. Autor soovitab kõigil, kes ei ole enda süsteemide keskset haldust teostavat tarkvaralahendust veel valinud, proovida esmalt Ansible't.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-13T16:10:25Z

Ptomusk: /* Erinevused levinud alternatiividega */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Toetatud on Linux ja teised Unixilaadsed operatsioonisüsteemid, Windows servermasinana toetatud ei ole.<ref name="ansible_installation"/>
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

Neljast alternatiivist on Ansible'l hetkel kõige rohkem erinevaid autoreid, mis annab tunnistust tervest ja aktiivsest arendajaskonnast.<ref>Ansible pulse, https://github.com/ansible/ansible/pulse/monthly</ref><ref>Puppet pulse, https://github.com/puppetlabs/puppet/pulse/monthly</ref><ref>Chef pulse, https://github.com/opscode/chef/pulse/monthly</ref><ref>SaltStack pulse, https://github.com/saltstack/salt/pulse/monthly</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.

;Silver Vesi
:Olles analüüsinud Ansiblet ja tema alternatiive pean tõdema, et väiksemal skaalal ja triviaalsete muudatuste tegemiseks võtaksin kasutusele Ansible, samas kui suuremas võrgus kus on mitmeid erinevaid operatsioonisüsteeme, kasutaksin pigem Puppetit. Ansiblet on lihtsam kasutada ja üles seada, tema süntaks on märksa lihtsam, aga Puppetil on taga kommuun mille toel on juurde arendatud meeletult mooduleid millega kergema vaevaga automatiseerida ka keerukamaid toiminguid.
;Peeter Tomusk
:Ansible kasutamine on süsteemiadministraatorile mugav ja omane, kuna sarnaneb vägagi skriptide kirjutamisele, seetõttu on ka implementeerimise õpikõver [[Puppet]]'i ja [[Chef]]'iga võrreldes oluliselt väiksem. Rakendades olemasolevaid lahendusi ([[SSH]]) tundub Ansible baasil keskhalduse kasutuselevõtmine loogilise jätkuna seniste haldusmeetodite järel ning võimaldab süsteemi haldavatel isikutel enda oskustepagasit orgaaniliselt täiendada. Autor soovitab kõigil, kes ei ole enda süsteemide keskset haldust teostavat tarkvaralahendust veel valinud, proovida esmalt Ansible't.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-13T16:08:53Z

Ptomusk: /* Erinevused levinud alternatiividega */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Toetatud on Linux ja teised Unixilaadsed operatsioonisüsteemid, Windows servermasinana toetatud ei ole.<ref name="ansible_installation"/>
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

Neljast konkurendist on Ansible'l hetkel kõige rohkem erinevaid autoreid, mis annab tunnistust tervest ja aktiivsest arendajaskonnast.<ref>Ansible pulse, https://github.com/ansible/ansible/pulse/monthly</ref><ref>Puppet pulse, https://github.com/puppetlabs/puppet/pulse/monthly</ref><ref>Chef pulse, https://github.com/opscode/chef/pulse/monthly</ref><ref>SaltStack pulse, https://github.com/saltstack/salt/pulse/monthly</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.

;Silver Vesi
:Olles analüüsinud Ansiblet ja tema alternatiive pean tõdema, et väiksemal skaalal ja triviaalsete muudatuste tegemiseks võtaksin kasutusele Ansible, samas kui suuremas võrgus kus on mitmeid erinevaid operatsioonisüsteeme, kasutaksin pigem Puppetit. Ansiblet on lihtsam kasutada ja üles seada, tema süntaks on märksa lihtsam, aga Puppetil on taga kommuun mille toel on juurde arendatud meeletult mooduleid millega kergema vaevaga automatiseerida ka keerukamaid toiminguid.
;Peeter Tomusk
:Ansible kasutamine on süsteemiadministraatorile mugav ja omane, kuna sarnaneb vägagi skriptide kirjutamisele, seetõttu on ka implementeerimise õpikõver [[Puppet]]'i ja [[Chef]]'iga võrreldes oluliselt väiksem. Rakendades olemasolevaid lahendusi ([[SSH]]) tundub Ansible baasil keskhalduse kasutuselevõtmine loogilise jätkuna seniste haldusmeetodite järel ning võimaldab süsteemi haldavatel isikutel enda oskustepagasit orgaaniliselt täiendada. Autor soovitab kõigil, kes ei ole enda süsteemide keskset haldust teostavat tarkvaralahendust veel valinud, proovida esmalt Ansible't.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-13T16:07:53Z

Ptomusk: /* Tutvustus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Toetatud on Linux ja teised Unixilaadsed operatsioonisüsteemid, Windows servermasinana toetatud ei ole.<ref name="ansible_installation"/>
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>
Neljast konkurendist on Ansible'l kõige rohkem erinevaid autoreid, mis annab tunnistust tervest ja aktiivsest arendajaskonnast.<ref>Ansible pulse, https://github.com/ansible/ansible/pulse/monthly</ref><ref>Puppet pulse, https://github.com/puppetlabs/puppet/pulse/monthly</ref><ref>Chef pulse, https://github.com/opscode/chef/pulse/monthly</ref><ref>SaltStack pulse, https://github.com/saltstack/salt/pulse/monthly</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.

;Silver Vesi
:Olles analüüsinud Ansiblet ja tema alternatiive pean tõdema, et väiksemal skaalal ja triviaalsete muudatuste tegemiseks võtaksin kasutusele Ansible, samas kui suuremas võrgus kus on mitmeid erinevaid operatsioonisüsteeme, kasutaksin pigem Puppetit. Ansiblet on lihtsam kasutada ja üles seada, tema süntaks on märksa lihtsam, aga Puppetil on taga kommuun mille toel on juurde arendatud meeletult mooduleid millega kergema vaevaga automatiseerida ka keerukamaid toiminguid.
;Peeter Tomusk
:Ansible kasutamine on süsteemiadministraatorile mugav ja omane, kuna sarnaneb vägagi skriptide kirjutamisele, seetõttu on ka implementeerimise õpikõver [[Puppet]]'i ja [[Chef]]'iga võrreldes oluliselt väiksem. Rakendades olemasolevaid lahendusi ([[SSH]]) tundub Ansible baasil keskhalduse kasutuselevõtmine loogilise jätkuna seniste haldusmeetodite järel ning võimaldab süsteemi haldavatel isikutel enda oskustepagasit orgaaniliselt täiendada. Autor soovitab kõigil, kes ei ole enda süsteemide keskset haldust teostavat tarkvaralahendust veel valinud, proovida esmalt Ansible't.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-13T16:06:13Z

Ptomusk: /* Kokkuvõte */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref> Toetatud on Linux ja teised Unixilaadsed operatsioonisüsteemid, Windows servermasinana toetatud ei ole.<ref name="ansible_installation"/>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>
Neljast konkurendist on Ansible'l kõige rohkem erinevaid autoreid, mis annab tunnistust tervest ja aktiivsest arendajaskonnast.<ref>Ansible pulse, https://github.com/ansible/ansible/pulse/monthly</ref><ref>Puppet pulse, https://github.com/puppetlabs/puppet/pulse/monthly</ref><ref>Chef pulse, https://github.com/opscode/chef/pulse/monthly</ref><ref>SaltStack pulse, https://github.com/saltstack/salt/pulse/monthly</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.

;Silver Vesi
:Olles analüüsinud Ansiblet ja tema alternatiive pean tõdema, et väiksemal skaalal ja triviaalsete muudatuste tegemiseks võtaksin kasutusele Ansible, samas kui suuremas võrgus kus on mitmeid erinevaid operatsioonisüsteeme, kasutaksin pigem Puppetit. Ansiblet on lihtsam kasutada ja üles seada, tema süntaks on märksa lihtsam, aga Puppetil on taga kommuun mille toel on juurde arendatud meeletult mooduleid millega kergema vaevaga automatiseerida ka keerukamaid toiminguid.
;Peeter Tomusk
:Ansible kasutamine on süsteemiadministraatorile mugav ja omane, kuna sarnaneb vägagi skriptide kirjutamisele, seetõttu on ka implementeerimise õpikõver [[Puppet]]'i ja [[Chef]]'iga võrreldes oluliselt väiksem. Rakendades olemasolevaid lahendusi ([[SSH]]) tundub Ansible baasil keskhalduse kasutuselevõtmine loogilise jätkuna seniste haldusmeetodite järel ning võimaldab süsteemi haldavatel isikutel enda oskustepagasit orgaaniliselt täiendada. Autor soovitab kõigil, kes ei ole enda süsteemide keskset haldust teostavat tarkvaralahendust veel valinud, proovida esmalt Ansible't.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-13T15:37:34Z

Ptomusk: /* Erinevused levinud alternatiividega */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref> Toetatud on Linux ja teised Unixilaadsed operatsioonisüsteemid, Windows servermasinana toetatud ei ole.<ref name="ansible_installation"/>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>
Neljast konkurendist on Ansible'l kõige rohkem erinevaid autoreid, mis annab tunnistust tervest ja aktiivsest arendajaskonnast.<ref>Ansible pulse, https://github.com/ansible/ansible/pulse/monthly</ref><ref>Puppet pulse, https://github.com/puppetlabs/puppet/pulse/monthly</ref><ref>Chef pulse, https://github.com/opscode/chef/pulse/monthly</ref><ref>SaltStack pulse, https://github.com/saltstack/salt/pulse/monthly</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.
Autori tahe käesoleva artikli kirjutamisel on anda ülevaade erinevatest seadistamise võimalustes ja nüanssidest. Võimaldades huvitatud osapoolel saada esmane kasutamiskogemus ja rakendamisoskus. Artiklis kirjeldatud näide on küll kasulik ent ei rahulda kindlasti reaalsete süsteemide haldamisel vajalikku terviklikkust.

Olulisim artikli väljund on pakkuda informatsiooni [[Puppet]]'i ja [[Chef]]'i alternatiivide kohta, millest üheks on Ansible.

;Silver Vesi
:Olles analüüsinud Ansiblet ja tema alternatiive pean tõdema, et väiksemal skaalal ja triviaalsete muudatuste tegemiseks võtaksin kasutusele Ansible, samas kui suuremas võrgus kus on mitmeid erinevaid operatsioonisüsteeme, kasutaksin pigem Puppetit. Ansiblet on lihtsam kasutada ja üles seada, ent Puppetil on taga märksa suurem arendajate kommuun, seega saaks temaga ära teha keerukamaid operatsioone vähema vaevaga, sest paljude toimingute jaoks on vastavad moodulid juba loodud.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-13T15:06:20Z

Ptomusk: /* Tutvustus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ansible/ansible/blob/devel/COPYING</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.
Autori tahe käesoleva artikli kirjutamisel on anda ülevaade erinevatest seadistamise võimalustes ja nüanssidest. Võimaldades huvitatud osapoolel saada esmane kasutamiskogemus ja rakendamisoskus. Artiklis kirjeldatud näide on küll kasulik ent ei rahulda kindlasti reaalsete süsteemide haldamisel vajalikku terviklikkust.

Olulisim artikli väljund on pakkuda informatsiooni [[Puppet]]'i ja [[Chef]]'i alternatiivide kohta, millest üheks on Ansible.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-12T06:39:24Z

Ptomusk: /* Playbook'ide rakendamine */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml
: '''NB: Seadistusfailide ajalugu ja muudatusi on (rangelt) soovituslik hallata versioonihaldussüteemiga ([[SVN]], [[CVS]], [[Git]] või [[Mercurial]])!

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.
Autori tahe käesoleva artikli kirjutamisel on anda ülevaade erinevatest seadistamise võimalustes ja nüanssidest. Võimaldades huvitatud osapoolel saada esmane kasutamiskogemus ja rakendamisoskus. Artiklis kirjeldatud näide on küll kasulik ent ei rahulda kindlasti reaalsete süsteemide haldamisel vajalikku terviklikkust.

Olulisim artikli väljund on pakkuda informatsiooni [[Puppet]]'i ja [[Chef]]'i alternatiivide kohta, millest üheks on Ansible.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-12T02:28:01Z

Ptomusk: /* Kokkuvõte */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml

==Kokkuvõte==
Ansible hoomatavus temaga väheseid kogemusi omavale isikule ning sihtarvutisse agendi paigaldamise vajaduse puudumine võimaldavad vähese vaevaga rakendada keskset haldust ka olukordades, milles tema konkurentide kasutamine ratsionaalsena ei tundu.
Autori tahe käesoleva artikli kirjutamisel on anda ülevaade erinevatest seadistamise võimalustes ja nüanssidest. Võimaldades huvitatud osapoolel saada esmane kasutamiskogemus ja rakendamisoskus. Artiklis kirjeldatud näide on küll kasulik ent ei rahulda kindlasti reaalsete süsteemide haldamisel vajalikku terviklikkust.

Olulisim artikli väljund on pakkuda informatsiooni [[Puppet]]'i ja [[Chef]]'i alternatiivide kohta, millest üheks on Ansible.

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-12T02:12:44Z

Ptomusk: /* Veebiserveri seadistus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: webservers''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''webservers''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: install apache and php packages''' - Konkreetse seadistussammu nimi on ''install apache and php packages''
: ''' apt: pkg=$item state=latest update_cache=yes''' - Paigalda [[APT]]'iga muutujate loetelus olevate pakkide uusim versioon ning uuenda repositooriumite kirjeldused<ref>apt module syntax, http://docs.ansible.com/apt_module.html</ref>
: ''' with_items:''' - Muutujate loetelu algus
: ''' - apache2''' - Muutujate loetelu element ''apache2''
: ''' - php5''' - Muutujate loetelu element ''php5''
: ''' - php5-cli''' - Muutujate loetelu element ''php5-cli''
: ''' - php-pear''' - Muutujate loetelu element ''php-pear''
: ''' - libapache2-mod-php5''' - Muutujate loetelu element ''libapache2-mod-php5''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' - name: install PHP_CodeSniffer''' - Konkreetse seadistussammu nimi on ''install PHP_CodeSniffer''
: ''' command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer''' - Käivita sihtmasinas käsk ''pear install PHP_CodeSniffer'', ainult juhul kui viidatud faili/kataloogi pole olemas<ref>command module syntax, http://docs.ansible.com/command_module.html</ref>
: ''' - name: set php memory limit''' - Konkreetse seadistussammu nimi on ''set php memory limit''
: ''' ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP''' - Seadista ''.ini'' tüüpi failis ''/etc/php5/apache2/php.ini'' muutuja ''memory_limit''väärtuseks ''512M''<ref>ini_file module syntax, http://docs.ansible.com/ini_file_module.html</ref>
: ''' - name: enable ssl''' Konkreetse seadistussammu nimi on ''enable ssl''
: ''' file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link''' - Loo muutuja väärtusega failist kataloogis ''/etc/apache2/mods-available/'', kataloogi ''/etc/apache2/mods-enabled/'' muutuja väärtusega koopia, mille tüübiks on sümboolne link
: ''' with_items:''' - Muutujate loetelu algus
: ''' - ssl.conf''' - Muutujate loetelu element ''ssl.conf''
: ''' - ssl.load''' - Muutujate loetelu element ''ssl.load''
: ''' notify: restart apache''' - Teavita vajadusepõhist haldurit ''restart apache'' rakendamise nõudest
: ''' handlers:''' - Vajadusepõhiste haldurite algus
: ''' - name: restart apache''' - Konkreetse halduri nimi on ''restart apache''
: ''' service: name=apache2 enabled=yes state=restarted''' - Teenus, nimega ''apache2'' tuleb alglaadimisel käivitada ning hetkel peab tema staatus ''taaskäivitunud''<ref>service module syntax, http://docs.ansible.com/service_module.html</ref>
: '''...''' - YAML'i süntaksis faili lõpp

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml

==Kokkuvõte==

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-12T01:46:52Z

Ptomusk: /* Kasulikk materjale */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml

==Kokkuvõte==

== Kasulikke materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation

==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-12T01:35:59Z

Ptomusk: /* Süsteemide seadistamine */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref> Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_playbooks">Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">Ansible installation manual, http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>Why is it called Ansible, http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>AnsibleWorks homepage, http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega [[Puppet]] ja [[Chef]] on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]]. <ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>

[[SaltStack]] on Ansible'ga vägagi sarnane, ent erineb klientidega suhtlemise osas, kasutades [[0mq]]'d ning täiendades seda enda poolt [[AES]] krüpteeringuga (milles võib aeg-ajalt esineda vigasid<ref>SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc</ref>). Ansible poolt kasutatav [[SSH]] ei lisa süsteemi täiendavaid ründevektoreid.<ref name="ansible_and_salt">Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/</ref>

== Kasutamine ==
=== Paigaldamine ===
Ansible paigaldamiseks on võimalik tõmmata see otse projekti [https://github.com/ansible/ansible GitHub'i repost] või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.<ref name="ansible_installation"/>
;Ansible paigaldamine [[APT]]'i abil
sudo apt-get install ansible
;Versiooni (ja paigaldatuse kontroll)
ansible --version

===Esmane seadistamine===
Süsteemne seadistusfail on ''/etc/ansible/ansible.cfg'', kuid iga kasutaja võib isiklike seadete hoidmiseks tekitada faili ''.ansible.cfg'' enda kodukataloogi. Kasutaja kodukataloogis olevad seaded on süsteemse seadistusfaili suhtes ülemuslikud.<ref name="ansible_man">ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook</ref>

'''Need muudatused on (rangelt) soovituslik sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.''' 
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[defaults]'''''''!'''
Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine
hostfile=~/ansible/hosts
Kasutatava protokolli muutmine [[SSH]]'ks et vähendada turvariske.<ref name="ansible_and_salt"/> ''Autori isikliku kogemuse põhjal on [[Python]]'i [[paramiko]] teek kapriisne ning ei pruugi sobida keerukamateks lahendusteks''.
transport=ssh
Juhul kui teil ei ole seadistatud [[OpenSSH:_võtmetega_autentimine|SSH võtmega autentimine]] on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.
: '''NB: Järgnevad muudatused asuvad sektsioonis''' '''''[ssh_connection]'''''''!'''
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
Kasutaja sedistusfaili eeldatav sisu pärast muudatusi
[defaults]
transport=ssh
hostfile=~/ansible/hosts
[ssh_connection]
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame kataloogi, milles hoida Ansible tööks olulisi faile ja samaaegselt ka sihtmasinate loendi faili.
mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:
[main:children]
webservers

[webservers]
192.168.56.1

Kirjete selgitus:
: '''[main:children]''' - Loogiline grupp, mis koosneb alamgruppidest
: '''webservers''' - Kõik grupi ''webservers'' masinad kuuluvad ka gruppi ''main''
: '''[webservers]''' - Loogiline grupp sihtmasinaid
: '''192.168.56.1''' - Sihtmasin mis kuulub gruppi ''webservers (ja main)''

===Süsteemide seadistuse kirjeldamine===
Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
mkdir ~/ansible/playbooks
====Põhiseaded====
Tekitame põhifaili kus hoida üldist seadistust
touch ~/ansible/playbooks/main.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax">YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref> 
Lisame sellese faili järgnevad read
---
- hosts: main
user: student
gather_facts: no
sudo: yes
tasks:
- name: Copy MOTD
copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes

- include: ~/ansible/playbooks/apache.yml

...
Kirjete selgitus:
: '''---''' - YAML'i süntaksis faili algus
: '''- hosts: main''' - Selles failis määratletud seadistused rakendadatkse sihtmasinatele, mis kuuluvad gruppi ''main''
: ''' user: student''' - Kasutajanimi, kellena sihtmasinasse sisse logitakse, ehk [[SSH]] kasutaja
: ''' gather_facts: no''' - Sihtmasinate kohta käiva info kogumise keelamine: käesoleva näite raames ei ole see vajalik ning säästab käivitamisel aega
: ''' sudo: yes''' - Seadistuse elluviimiseks eskaleerutakse juurkasutaja õigustesse
: ''' tasks:''' - Sellele reale järgnevad seadistussammude kirjeldused
: ''' - name: Copy MOTD''' - Konkreetse seadistussammu nimi on ''Copy MOTD''
:: ''(Igal seadistussammul peab olema nimi ning sellele on võimalik soovi korral viidata)''
: '''copy: src=~/ansible/files/motd.txt dest=/etc/motd backup=yes''' - Kopeerida kohaliku masina fail ''~/ansible/files/motd.txt'' sihtmasinasse, nimega ''/etc/motd'' ning varundada praegune sihtmasinas eksisteeriv fail<ref>copy module syntax, http://docs.ansible.com/copy_module.html</ref>
: '''- include: ~/ansible/playbooks/apache.yml''' - Impordi seadistusfail ''~/ansible/playbooks/apache.yml'' ja rakenda ka selles olevad seadistused
: '''...''' - YAML'i süntaksis faili lõpp
====Seadistuse abifailid====
Loome kataloogi kus hoida sihtmasinatesse kopeeritavaid faile
mkdir ~/ansible/files
Loome MOTD faili, mida sihtmasinatesse kopeerida
echo "This is the Ansible MOTD" > ~/ansible/files/motd.txt
====Veebiserveri seadistus====
Tekitame faili, milles hoida Apache veebiserveri seadistust
touch ~/ansible/playbooks/apache.yml
: '''NB: Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref name="yaml_syntax"/>
Lisame sellese faili järgnevad read
---
- hosts: webservers
user: student
gather_facts: no
sudo: yes
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest update_cache=yes
with_items:
- apache2
- php5
- php5-cli
- php-pear
- libapache2-mod-php5
notify: restart apache
- name: install PHP_CodeSniffer
command: pear install PHP_CodeSniffer creates=/usr/share/php/data/PHP_CodeSniffer
- name: set php memory limit
ini_file: dest=/etc/php5/apache2/php.ini option=memory_limit value=512M section=PHP
- name: enable ssl
file: src=/etc/apache2/mods-available/$item dest=/etc/apache2/mods-enabled/$item state=link
with_items:
- ssl.conf
- ssl.load
notify: restart apache

handlers:
- name: restart apache
service: name=apache2 enabled=yes state=restarted

...
Kirjete selgitus:

===Süsteemide seadistamine===
====Eeldused====
* Sihtmasinas on töötav [[SSH]] server
* ''Playbook'''is määratud kasutajal on lubatud teha [[SSH]] ühendusi sihtmasinasse
* Kui seadistamine nõuab juurkasutaja õigustesse eskaleerimist, on ''playbook''is määratud kasutajal lubatud seda teha
====Playbook'ide rakendamine====
Seadistusi rakendatakse käsuga '''ansible-playbook'''. 
Käsu täiendavatest argumentidest saab [[Linux]]'i käsule omaselt ülevaate ''--help'' argumendiga.
ansible-playbook --help
Olulisemad argumendid:
* '''-k''' - Küsi [[SSH]] ühenduse loomiseks parooli
* '''-K''' - Küsi ''sudo'' käsu jaoks parooli
: '''NB: Kasutades Ansible't ilma võtmega autentimiseta, on vajalik paigaldada pakk ''sshpass''!'''
sudo apt-get install sshpass

Rakendame kõigi sihtmasinate peal põhiseadistuse (ja kõik pärinevad lisaseadistused), kasutades parooliga autentimist ning andes ette sudo parooli.
ansible-playbook -k -K ~/ansible/playbooks/main.yml

==Kokkuvõte==

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-12T01:14:30Z

Ptomusk: /* Veebiserveri seadistus */

Ansible

2014-01-12T01:03:53Z

Ptomusk: /* Veebiserveri seadistus */

Ansible

2014-01-12T01:02:15Z

Ptomusk: /* Veebiserveri seadistus */

Ansible

2014-01-12T00:44:48Z

Ptomusk: /* Veebiserveri seadistus */

Ansible

2014-01-12T00:37:03Z

Ptomusk: /* Süsteemide seadistuse kirjeldamine */

Ansible

2014-01-12T00:27:20Z

Ptomusk: /* Süsteemide seadistuse kirjeldamine */

Ansible

2014-01-12T00:16:30Z

Ptomusk: /* Süsteemide seadistuse kirjeldamine */

Ansible

2014-01-12T00:14:04Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-12T00:10:46Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-12T00:09:20Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-12T00:03:06Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-11T23:53:33Z

Ptomusk: /* Süsteemide seadistuse kirjeldamine */

Ansible

2014-01-11T23:34:41Z

Ptomusk: /* Süsteemide seadistuse kirjeldamine */

Ansible

2014-01-11T23:33:23Z

Ptomusk: /* Süsteemide seadistuse kirjeldamine */

Ansible

2014-01-11T22:33:07Z

Ptomusk: /* Süsteemide seadistamine */

Ansible

2014-01-11T22:31:43Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-11T22:18:14Z

Ptomusk: /* Erinevused levinud alternatiividega */

Ansible

2014-01-11T22:15:02Z

Ptomusk: /* Süsteemide seadistamine */

Ansible

2014-01-11T22:14:37Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-11T22:11:34Z

Ptomusk: /* Veebiserveri jaoks vajalike pakkide paigaldamine */

Ansible

2014-01-11T21:56:26Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-11T21:55:31Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-11T21:45:06Z

Ptomusk: /* Konfifaili lisamine/muutmine */

Ansible

2014-01-11T21:35:11Z

Ptomusk: /* Syntaks */

Ansible

2014-01-11T21:33:51Z

Ptomusk: /* Esmane seadistamine */

Ansible

2014-01-11T19:52:03Z

Ptomusk: /* Paigaldamine */

Ansible

2014-01-11T19:41:24Z

Ptomusk: /* Tutvustus */

Ansible

2014-01-11T19:40:01Z

Ptomusk: /* Erinevused levinud alternatiividega */

Ansible

2014-01-11T17:07:03Z

Ptomusk: /* Tutvustus */

Ansible

2014-01-11T17:02:05Z

Ptomusk: /* Erinevused levinud alternatiividega */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref>http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref>http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==
Ansible peamine erinevus oma konkurentidega (näiteks [[Puppet]] või [[Chef]]) on agendi kui sellise puudumine. Klientide seadistamiseks kasutatakse juba (enamus juhtudel) olemasolevaid vahendeid - [[SSH]] ja [[Python]].<ref>Review: Puppet vs. Chef vs. Ansible vs. Salt, http://www.infoworld.com/d/data-center/review-puppet-vs-chef-vs-ansible-vs-salt-231308?page=0,1</ref>
, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.<ref name="ansible_installation"/>

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible (kõik käsud soovitavalt juurkasutaja õigustes!):

apt-get install ansible

Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

ansible --version

ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts

[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

dpkg -l|grep apache

ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

dpkg -l|grep php5

ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-11T16:55:52Z

Ptomusk: /* Erinevused levinud alternatiividega */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref>http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref>http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==

Ansible peamine erinevus oma konkurentidega, sh. Puppet ja Chef on see, et ta on loodud mitte ainult agendi(kliendi)vabana, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.<ref name="ansible_installation"/>

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible (kõik käsud soovitavalt juurkasutaja õigustes!):

apt-get install ansible

Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

ansible --version

ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts

[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

dpkg -l|grep apache

ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

dpkg -l|grep php5

ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-11T16:55:29Z

Ptomusk: /* Tutvustus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref>http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>

Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref>http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref name="ansible_installation">http://docs.ansible.com/intro_installation.html</ref>

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>http://www.ansibleworks.com/faq/</ref>

Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>http://www.ansibleworks.com/</ref>

== Erinevused levinud alternatiividega ==

Ansible peamine erinevus oma konkurentidega, sh. Puppet ja Chef on see, et ta on loodud mitte ainult agendi(kliendi)vabana, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible (kõik käsud soovitavalt juurkasutaja õigustes!):

apt-get install ansible

Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

ansible --version

ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts

[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

dpkg -l|grep apache

ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

dpkg -l|grep php5

ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-11T16:52:17Z

Ptomusk: /* Tutvustus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref>http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>
 
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref>http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.<ref>http://docs.ansible.com/intro_installation.html</ref>
 
Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>
 
Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.<ref>http://www.ansibleworks.com/faq/</ref>
 
Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>http://www.ansibleworks.com/</ref>
 

== Erinevused levinud alternatiividega ==

Ansible peamine erinevus oma konkurentidega, sh. Puppet ja Chef on see, et ta on loodud mitte ainult agendi(kliendi)vabana, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible (kõik käsud soovitavalt juurkasutaja õigustes!):

apt-get install ansible

Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

ansible --version

ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts

[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

dpkg -l|grep apache

ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

dpkg -l|grep php5

ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-11T13:36:43Z

Ptomusk: /* Tutvustus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref>http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>
 
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref name="ansible_doc">http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.
 
Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>
 
Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.
 
Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>http://www.ansibleworks.com/</ref>
 

== Erinevused levinud alternatiividega ==

Ansible peamine erinevus oma konkurentidega, sh. Puppet ja Chef on see, et ta on loodud mitte ainult agendi(kliendi)vabana, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible:

apt-get install ansible

Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

ansible --version

ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts
[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

root@puppet:/# ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

student@client:~$ dpkg -l|grep apache
ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

student@client:~$ dpkg -l|grep php5
ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-11T13:33:54Z

Ptomusk: /* Tutvustus */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL])<ref>https://github.com/ekarak/ansible/blob/master/license/gpl.txt</ref> konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.<ref>http://server.dzone.com/articles/ansible-cm-deployment-and-ad</ref>
 
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.<ref>http://docs.ansible.com/playbooks_intro.html</ref>
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.
 
Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [[Cobbler]]'i ning olnud [[Puppet]]'i arendaja.<ref>http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc</ref>
 
Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.
 
Ansible'ile on võimalik osta ka ärikliendi tuge.<ref>http://www.ansibleworks.com/</ref>
 

== Erinevused levinud alternatiividega ==

Ansible peamine erinevus oma konkurentidega, sh. Puppet ja Chef on see, et ta on loodud mitte ainult agendi(kliendi)vabana, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible:

root@puppet:/# apt-get install ansible
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

root@puppet:/# ansible --version
ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts
[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

root@puppet:/# ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

student@client:~$ dpkg -l|grep apache
ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

student@client:~$ dpkg -l|grep php5
ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Ansible

2014-01-11T13:23:49Z

Ptomusk: /* Viited */

== Tutvustus ==
Ansible on vabavaraline ([http://www.gnu.org/licenses/gpl.html GPL]) konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.
 
Konfiguratsiooni hoidmiseks kasutatakse [http://www.yaml.org/ YAML]'i faile mis võivad olla omavahel hierarhiliselt seotud.
Ansible on kirjutatud Python'is ning seadistuse vahendamiseks kasutatakse SSH protokolli (Python'i paramiko teeki või OS'i ssh käsku rakendades).
Hallatava masina eelduseks on sissetulevate SSH ühenduste lubamine ja Python'i interpretaatori olemasolu (vähemalt versioon 2.4), eraldiseisvat klienti või agenti ei ole.
 
Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud [http://en.wikipedia.org/wiki/Cobbler_(software) Cobbler]'i ning olnud [[Puppet]]'i arendaja.
 
Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.
 
Ansible'ile on võimalik osta ka ärikliendi tuge firmalt [http://www.ansibleworks.com/ AnsibleWorks].
 

== Erinevused levinud alternatiividega ==

Ansible peamine erinevus oma konkurentidega, sh. Puppet ja Chef on see, et ta on loodud mitte ainult agendi(kliendi)vabana, vaid lisaks puudub igasugune vajadus seadistada klientarvuteid, sest toimingud teostatakse üle SSH protokolli. Lisaks, kuna ta on kirjutatud Pythonis, peab serverarvutisse olema paigaldatud Python 2.4 või uuem.

== Kasutamine ==
=== Paigaldamine ===

Installeerime Ansible:

root@puppet:/# apt-get install ansible
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following NEW packages will be installed:
ansible
0 upgraded, 1 newly installed, 0 to remove and 24 not upgraded.
Need to get 0 B/245 kB of archives.
After this operation, 1,219 kB of additional disk space will be used.
Selecting previously unselected package ansible.
(Reading database ... 140139 files and directories currently installed.)
Unpacking ansible (from .../ansible_1.1+dfsg-1~ubuntu12.04.1_all.deb) ...
Processing triggers for man-db ...
Setting up ansible (1.1+dfsg-1~ubuntu12.04.1) ...

Kontrollime, et sai ilusti peale:

root@puppet:/# ansible --version
ansible 1.1

=== Esmane seadistamine ===

Avame konfifaili ja muudame ära mõnede parameetrite väärtused:

vi /etc/ansible/ansible.cfg

Muudame protokolli SSH'ks, sest see on paindlikum:

# connection to use when -c <connection_type> is not specified
transport=paramiko
>>
transport=ssh

Lülitame sisse parooliga audentimise:

ssh_args=-o PasswordAuthentication=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r
>>
ssh_args=-o PasswordAuthentication=yes -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ansible-ssh-%h-%p-%r

Tekitame grupi milles on kõik webserverid mida hallata tahame, antud juhul üksainus:

vi /etc/ansible/hosts
[webservers]
192.168.56.1

=== Syntaks ===

=== Veebiserveri jaoks vajalike pakkide paigaldamine ===

Tekitame skriptide, ehk kohalikus keeles playbookide jaoks eraldi kausta ja selle sisse yml faili nimega apache.yml:

mkdir /etc/ansible/playbooks
vi apache.yml

Faili sisuks järgnev. Installime veebiserveri jaoks vajalikud komponendid:

---
- hosts: webservers
user: student
vars:
gather_facts: False
sudo: True
tasks:
- name: install apache and php packages
apt: pkg=$item state=latest force=yes
with_items:
- apache2
- php5
- php5-cgi
- php5-cli
- php5-curl
- php5-ldap
...

Käivitame playbooki:

root@puppet:/# ansible-playbook -k -K /etc/ansible/playbooks/apache.yml

Sisestame ssh ja sudo parooli ning mõne aja pärast saame tagasisidet teostatud toimingute kohta:

SSH password:
sudo password:
PLAY [webservers] *********************
TASK: [install apache and php packages] *********************
changed: [192.168.56.1] => (item=apache2,php5,php5-cgi,php5-cli,php5-curl,php5-ldap)
PLAY RECAP *********************
192.168.56.1 : ok=1 changed=1 unreachable=0 failed=0

Kontrollime tulemust klientarvutis (192.168.56.1):

student@client:~$ dpkg -l|grep apache
ii apache2 2.2.22-1ubuntu1.4 Apache HTTP Server metapackage
ii apache2-mpm-worker 2.2.22-1ubuntu1.4 Apache HTTP Server - high speed threaded model
ii apache2-utils 2.2.22-1ubuntu1.4 utility programs for webservers
ii apache2.2-bin 2.2.22-1ubuntu1.4 Apache HTTP Server common binary files
ii apache2.2-common 2.2.22-1ubuntu1.4 Apache HTTP Server common files

student@client:~$ dpkg -l|grep php5
ii php5 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (metapackage)
ii php5-cgi 5.3.10-1ubuntu3.9 server-side, HTML-embedded scripting language (CGI binary)
ii php5-cli 5.3.10-1ubuntu3.9 command-line interpreter for the php5 scripting language
ii php5-common 5.3.10-1ubuntu3.9 Common files for packages built from the php5 source
ii php5-curl 5.3.10-1ubuntu3.9 CURL module for php5
ii php5-ldap 5.3.10-1ubuntu3.9 LDAP module for php5

=== Konfifaili lisamine/muutmine ===

== Kasulikk materjale ==
* https://www.youtube.com/watch?v=PDRdCqFp2sY Continuous Deployment with Ansible
* http://www.ansibleworks.com/tech/ How Ansible Works
* http://docs.ansible.com/modules.html Documentation
==Kasutatud kirjandus==
<references />

== Autorid ==
[https://wiki.itcollege.ee/index.php/User:Svesi Silver Vesi] AK31 
[https://wiki.itcollege.ee/index.php/User:Ptomusk Peeter Tomusk] AK41

Systemd

2014-01-10T12:07:07Z

Ptomusk: /* Tehniline kirjeldus */

[[Category: Operatsioonisüsteemide administreerimine ja sidumine]]
==Sissejuhatus==
===Eeldused lugejale===
* Saab iseseivalt hakkama Linux'i käsureaga [https://wiki.itcollege.ee/index.php/Osadmin_spikker]
* On kursis erinevate teenuste olemasoluga ja nende haldamise vajadusega [https://wiki.itcollege.ee/index.php/Category:IT_infrastruktuuri_teenused]
* Suudab enda privileege iseseisvalt eskaleerida juurkasutajaks [https://wiki.itcollege.ee/index.php/Sudo_ja_sudoers ]

===systemd üldine kirjeldus===
''Järgnev alampeatükk on refereeritud systemd [http://freedesktop.org/wiki/Software/systemd/ kodulehelt].'' 
Systemd on Linux'i süsteemi ja teenuste haldur. 
Kirjutatud C keeles, võimaldamaks suuremat töökiirust võrreldes eellastega, kuid sellest hoolimata on tagasiühilduv [[SystemV]] ja [[LSB]] käivitusskriptidega.
;Põhilised disainielemendid
* Agressiivne teenuste käivitamise paralleliseerimine
* Sõltuvustepõhine teenuste käivitamine
* Sokkelite ja D-Bus'il põhinevalt vajadusepõhine teenuste käivitamine
* Protsesside haldamine [[cgroup]]'ide abil
* Kettajagude külgehaakimise vajadusepõhine haldamine
;Nimi ja selle kasutamine
Systemd kirjutatakse alati läbivalt väikeste tähtedega, kuid erandkorras on lubatud lause alguses kasutada suurt algustähte. 
Rooma number D ehk 500 ja V ehk 5 võimaldavad ka hoomata systemd ja [[SystemV]] järglaslikku seost.
;Loojad
[http://en.wikipedia.org/wiki/Lennart_Poettering Lennart Poettering] ja [http://en.wikipedia.org/wiki/Kay_Sievers Kay Sievers]

==systemd==
===Tehniline kirjeldus===
Systemd käivitab võimalikult palju teenuseid paralleelselt. Võimaldamaks süsteemi kiiremat käivitumist ei oodata iga teenuse tööks vajalike teiste teenuste startimist, vaid pakutakse neile sokleid, mille abil nad omavahel suhtlevad, ning kõnealune osa süsteemi käivitumisest viiakse parallelselt jadamisi loogikale üle alles reaalse vajaduse tekkimisel. Niimoodi on võimalik käivitada näiteks Samba server oluliselt varem kui väljajagatav kettajagu on kettakontrolli läbinud, mis võimaldab näiteks kasutada Sambat kasutajate autentimiseks oluliselt varem kui seda võimaldataks [[SystemV]] puhul. Lisaväärtusena võimaldab soklite kasutamine teenuste omavahelist suhtlust puhverdada ning ka juhul kui kasutaja tõesti soovib näitena toodud kettajagu kasutada esineb süsteemis vea asemel vaid mõningane viivitus. Soklite ja reaalsete teenuste vahelise suhtluse haldamine võimaldab ka vahepeal vea tõttu seiskunud teenuseid vajadusel taaskäivitada kui nende järele peaks mõnel teisel teenusel vajadus tekkima.

===Teenuste haldamine===
Järgnevalt eeldame et teie poolt hallatava teenuse nimi on määratud muutuja '''_teenus''' väärtuseks.
Samuti on oluline meeles pidada et enamike teenuste haldamine on võimalik vaid juurkasutaja õigustes! 
''Refereerituna systemctl'i [http://www.freedesktop.org/software/systemd/man/systemctl.html manuaal]ist''
====Teenuste loetelu ja kirjeldus====
;Olemasolevate teenuste nimekiri
systemctl --list-units
;Süsteemi käivitumisel ebaõnnestunud teenused
systemctl --failed

====Käivitamine/Peatamine====
;Teenuse käivitamine
systemctl start $_teenus
;Teenuse peatamine
systemctl stop $_teenus
;Teenuse taaskäivitamine
systemctl restart $_teenus
;Teenuse seadistuse taaslaadimine
systemctl reload $_teenus
;Teenuse oleku ülevaade
systemctl status $_teenus

====Restartimisel käivitatavad teenused====
'''Teenuse määramine restardi käigus käivitavaks või mitte-käivitatavaks ei oma teenuse praeguse oleku suhtes tagajärgi!'''
;Kontroll kas teenus käivitatakse automaatselt
systemctl is-enabled $_teenus
;Teenuse määramine vaikimisi käivitatavaks
systemctl enable $_teenus
;Teenuse määramine vaikimisi mitte-käivitatavaks
systemctl disable $_teenus

===Süsteemi haldamine===
'''Süsteemi haldamiseks tavakasutaja õigustes on vajalik [[polkit]]!'''[http://www.freedesktop.org/wiki/Software/polkit/]
;Operatsionisüsteemi taaskäivitamine
systemctl reboot
;Operatsioonisüsteemi seiskamine
systemctl poweroff

==systemd'd vaikimisi kasutavad distributsioonid==
* Arch Linux (oktoober 2012) [https://www.archlinux.org/news/systemd-is-now-the-default-on-new-installations/]
* Fedora (mai 2011) [http://h-online.com/-1249820]
* Frugalware Linux (august 2011) [http://frugalware.org/news/223]
* Mageia (mai 2012) [http://h-online.com/-1582479]
* openSUSE (september 2012) [http://news.opensuse.org/2012/09/05/opensuse-12-2-green-means-go/]
* Sabayon Linux (august 2013) [http://www.sabayon.org/release/press-release-sabayon-1308]
* siduction (detsember 2013) [http://news.siduction.org/2013/12/siduction-2013-2-rc1-released-with-systemd/]
==Kokkuvõte==
Systemd pakutavad võimalused ning eelised teiste süsteemihalduritega võrreldes on väga arvukad ning käesolevat artiklit tuleks pigem võtta lühitutvustusena mitte ülevaatena. Autori senine isiklik kogemus on ülimalt positiivne ning ta on veendunud et systemd on parim valik hetkel eksisteerivatest valikutest.

==Kasulikke materjale==
* http://freedesktop.org/wiki/Software/systemd systemd koduleht
* http://www.freedesktop.org/wiki/Software/systemd/TipsAndTricks/ Mõned näited keerukamatest protseduuridest
* https://wiki.archlinux.org/index.php/systemd systemd vägagi põhjalik ülevaade Arch Linux'i wikis
* http://0pointer.de/blog/projects/systemd.html systemd kirjeldus selle autori (Lennart Poettering'i) poolt
* https://www.youtube.com/watch?v=TyMLi8QF6sw FOSDEM'i konverentsi raames Lennart Poettering'i poolt systemd'd tutvustava esitluse video

==Töö esitamise tähtajaks valminud versioon==
[https://wiki.itcollege.ee/index.php?title=Systemd&diff=cur&oldid=72823 Diff praeguse versiooniga]
==Autor==
Peeter Tomusk AK41

Systemd

2014-01-10T12:06:06Z

Ptomusk: /* systemd üldine kirjeldus */

[[Category: Operatsioonisüsteemide administreerimine ja sidumine]]
==Sissejuhatus==
===Eeldused lugejale===
* Saab iseseivalt hakkama Linux'i käsureaga [https://wiki.itcollege.ee/index.php/Osadmin_spikker]
* On kursis erinevate teenuste olemasoluga ja nende haldamise vajadusega [https://wiki.itcollege.ee/index.php/Category:IT_infrastruktuuri_teenused]
* Suudab enda privileege iseseisvalt eskaleerida juurkasutajaks [https://wiki.itcollege.ee/index.php/Sudo_ja_sudoers ]

===systemd üldine kirjeldus===
''Järgnev alampeatükk on refereeritud systemd [http://freedesktop.org/wiki/Software/systemd/ kodulehelt].'' 
Systemd on Linux'i süsteemi ja teenuste haldur. 
Kirjutatud C keeles, võimaldamaks suuremat töökiirust võrreldes eellastega, kuid sellest hoolimata on tagasiühilduv [[SystemV]] ja [[LSB]] käivitusskriptidega.
;Põhilised disainielemendid
* Agressiivne teenuste käivitamise paralleliseerimine
* Sõltuvustepõhine teenuste käivitamine
* Sokkelite ja D-Bus'il põhinevalt vajadusepõhine teenuste käivitamine
* Protsesside haldamine [[cgroup]]'ide abil
* Kettajagude külgehaakimise vajadusepõhine haldamine
;Nimi ja selle kasutamine
Systemd kirjutatakse alati läbivalt väikeste tähtedega, kuid erandkorras on lubatud lause alguses kasutada suurt algustähte. 
Rooma number D ehk 500 ja V ehk 5 võimaldavad ka hoomata systemd ja [[SystemV]] järglaslikku seost.
;Loojad
[http://en.wikipedia.org/wiki/Lennart_Poettering Lennart Poettering] ja [http://en.wikipedia.org/wiki/Kay_Sievers Kay Sievers]

==systemd==
===Tehniline kirjeldus===
Systemd käivitab võimalikult palju teenuseid paralleelselt. Võimaldamaks süsteemi kiiremat käivitumist ei oodata iga teenuse tööks vajalike teiste teenuste startimist vaid pakutakse neile sokleid, mille abil nad omavahel suhtlevad, ning kõnealune osa süsteemi käivitumisest viiakse parallelselt jadamisi loogikale üle alles reaalse vajaduse tekkimisel. Niimoodi on võimalik käivitada näiteks Samba server oluliselt varem kui väljajagatav kettajagu on kettakontrolli läbinud, mis võimaldab näiteks kasutada Sambat kasutajate autentimiseks oluliselt varem kui seda võimaldataks [[SystemV]] puhul. Lisaväärtusena võimaldab soklite kasutamine teenuste omavahelist suhtlust puhverdada ning ka juhul kui kasutaja tõesti soovib näitena toodud kettajagu kasutada esineb süsteemis vea asemel vaid mõningane viivitus. Soklite ja reaalsete teenuste vahelise suhtluse haldamine võimaldab ka vahepeal vea tõttu seiskunud teenuseid vajadusel taaskäivitada kui nende järele peaks mõnel teisel teenusel vajadus tekkima.

===Teenuste haldamine===
Järgnevalt eeldame et teie poolt hallatava teenuse nimi on määratud muutuja '''_teenus''' väärtuseks.
Samuti on oluline meeles pidada et enamike teenuste haldamine on võimalik vaid juurkasutaja õigustes! 
''Refereerituna systemctl'i [http://www.freedesktop.org/software/systemd/man/systemctl.html manuaal]ist''
====Teenuste loetelu ja kirjeldus====
;Olemasolevate teenuste nimekiri
systemctl --list-units
;Süsteemi käivitumisel ebaõnnestunud teenused
systemctl --failed

====Käivitamine/Peatamine====
;Teenuse käivitamine
systemctl start $_teenus
;Teenuse peatamine
systemctl stop $_teenus
;Teenuse taaskäivitamine
systemctl restart $_teenus
;Teenuse seadistuse taaslaadimine
systemctl reload $_teenus
;Teenuse oleku ülevaade
systemctl status $_teenus

====Restartimisel käivitatavad teenused====
'''Teenuse määramine restardi käigus käivitavaks või mitte-käivitatavaks ei oma teenuse praeguse oleku suhtes tagajärgi!'''
;Kontroll kas teenus käivitatakse automaatselt
systemctl is-enabled $_teenus
;Teenuse määramine vaikimisi käivitatavaks
systemctl enable $_teenus
;Teenuse määramine vaikimisi mitte-käivitatavaks
systemctl disable $_teenus

===Süsteemi haldamine===
'''Süsteemi haldamiseks tavakasutaja õigustes on vajalik [[polkit]]!'''[http://www.freedesktop.org/wiki/Software/polkit/]
;Operatsionisüsteemi taaskäivitamine
systemctl reboot
;Operatsioonisüsteemi seiskamine
systemctl poweroff

==systemd'd vaikimisi kasutavad distributsioonid==
* Arch Linux (oktoober 2012) [https://www.archlinux.org/news/systemd-is-now-the-default-on-new-installations/]
* Fedora (mai 2011) [http://h-online.com/-1249820]
* Frugalware Linux (august 2011) [http://frugalware.org/news/223]
* Mageia (mai 2012) [http://h-online.com/-1582479]
* openSUSE (september 2012) [http://news.opensuse.org/2012/09/05/opensuse-12-2-green-means-go/]
* Sabayon Linux (august 2013) [http://www.sabayon.org/release/press-release-sabayon-1308]
* siduction (detsember 2013) [http://news.siduction.org/2013/12/siduction-2013-2-rc1-released-with-systemd/]
==Kokkuvõte==
Systemd pakutavad võimalused ning eelised teiste süsteemihalduritega võrreldes on väga arvukad ning käesolevat artiklit tuleks pigem võtta lühitutvustusena mitte ülevaatena. Autori senine isiklik kogemus on ülimalt positiivne ning ta on veendunud et systemd on parim valik hetkel eksisteerivatest valikutest.

==Kasulikke materjale==
* http://freedesktop.org/wiki/Software/systemd systemd koduleht
* http://www.freedesktop.org/wiki/Software/systemd/TipsAndTricks/ Mõned näited keerukamatest protseduuridest
* https://wiki.archlinux.org/index.php/systemd systemd vägagi põhjalik ülevaade Arch Linux'i wikis
* http://0pointer.de/blog/projects/systemd.html systemd kirjeldus selle autori (Lennart Poettering'i) poolt
* https://www.youtube.com/watch?v=TyMLi8QF6sw FOSDEM'i konverentsi raames Lennart Poettering'i poolt systemd'd tutvustava esitluse video

==Töö esitamise tähtajaks valminud versioon==
[https://wiki.itcollege.ee/index.php?title=Systemd&diff=cur&oldid=72823 Diff praeguse versiooniga]
==Autor==
Peeter Tomusk AK41