Ansible: Difference between revisions

Revision as of 01:33, 12 January 2014

Tutvustus

Ansible on vabavaraline (GPL)^[1] konfiguratsiooni ja seadistuse haldamise tarkvaraplatvorm.^[2]

Konfiguratsiooni hoidmiseks kasutatakse YAML'i faile mis võivad olla omavahel hierarhiliselt seotud.^[3] 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.^[4]

Tarkvara loojaks on Michael DeHaan, kes eelnevalt on loonud Cobbler'i ning olnud Puppet'i arendaja.^[5]

Nimetus "Ansible" on pärit O.S.Card'i raamatust Enderi mäng, kus kirjeldatakse samanimelist valguse kiirusest kiiremat suhtlusprotokolli.^[6]

Ansible'ile on võimalik osta ka ärikliendi tuge.^[7]

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. ^[8]

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^[9]). Ansible poolt kasutatav SSH ei lisa süsteemi täiendavaid ründevektoreid.^[10]

Kasutamine

Paigaldamine

Ansible paigaldamiseks on võimalik tõmmata see otse projekti GitHub'i repost või paigaldada operatsioonisüüsteemi pakihaldustarkvara abil.^[4]

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.^[11]

Järgnevad muudatused tuleb sisse viia kas kasutaja seadistusfailis või süsteemses seadistusfailis.
Kasutatava protokolli muutmine SSH'ks et vähendada turvariske.^[10] 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 SSH võtmega autentimine on vajalik muuta ssh ühenduse seadistust, lubamaks parooliga autentimist.

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

Seadistatavaid sihtmasinaid kirjeldava faili teekonna muutmine

hostfile=~/ansible/hosts

Tekitame eelmainitud kataloogi ja faili

mkdir ~/ansible && touch ~/ansible/hosts

Lisame sihtmasinate faili mõned kirjed:

[main]
192.168.1.1
children:webservers

[webservers]
192.168.56.1

Kirjete selgitus:

[main] - Loogiline grupp sihtmasinaid

192.168.1.1 - Sihtmasin mis kuulub gruppi main

children:webservers - Kõik grupi webservers masinad kuuliuvad 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

Tekitame põhifaili kus hoida üldist seadistust

touch ~/ansible/playbooks/main.yml

Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!^[12]
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^[13]

- include: ~/ansible/playbooks/apache.yml - Impordi seadistusfail ~/ansible/playbooks/apache.yml ja rakenda ka selles olevad seadistused

... - YAML'i süntaksis faili lõpp

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

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
 ...

Süsteemide seadistamine

Käivitame playbooki:

 ansible-playbook -k -K ~/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

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

↑ Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt
↑ Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad
↑ Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html
↑ ^4.0 ^4.1 Ansible installation manual, http://docs.ansible.com/intro_installation.html
↑ Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc
↑ Why is it called Ansible, http://www.ansibleworks.com/faq/
↑ AnsibleWorks homepage, http://www.ansibleworks.com/
↑ 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
↑ SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc
↑ ^10.0 ^10.1 Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/
↑ ansible-playbook man page, http://linux.die.net/man/1/ansible-playbook
↑ YAML syntax, http://docs.ansible.com/YAMLSyntax.html
↑ http://docs.ansible.com/copy_module.html

Autorid

Silver Vesi AK31
Peeter Tomusk AK41

[1] Ansible license in GitHub, https://github.com/ekarak/ansible/blob/master/license/gpl.txt

[2] Ansible: CM, Deployment, and Ad-hoc Task Execution All in One, http://server.dzone.com/articles/ansible-cm-deployment-and-ad

[ansible_playbooks-3] Ansible Playbooks, http://docs.ansible.com/playbooks_intro.html

[ansible_installation-4] 4.0 ^4.1 Ansible installation manual, http://docs.ansible.com/intro_installation.html

[5] Michael DeHaan's bio, http://investing.businessweek.com/research/stocks/private/person.asp?personId=233466314&privcapId=233465248&previousCapId=233465248&previousTitle=AnsibleWorks,%20Inc

[6] Why is it called Ansible, http://www.ansibleworks.com/faq/

[7] AnsibleWorks homepage, http://www.ansibleworks.com/

[8] 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

[9] SaltStack AES bug, https://github.com/saltstack/salt/commit/5dd304276ba5745ec21fc1e6686a0b28da29e6fc

[ansible_and_salt-10] 10.0 ^10.1 Ansible and Salt: A detailed comparison, http://missingm.co/2013/06/ansible-and-salt-a-detailed-comparison/

[ansible_man-11] sible-playbook man page, http://linux.die.net/man/1/ansible-playbook

[12] YAML syntax, http://docs.ansible.com/YAMLSyntax.html

[13] ttp://docs.ansible.com/copy_module.html

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

@@ Line 55: / Line 55: @@
 ===Süsteemide seadistuse kirjeldamine===
+Loome kataloogi kus hoida seadistuse kirjelduse kogumeid ehk Ansible mõistes ''playbook'''e
+ mkdir ~/ansible/playbooks
+Tekitame põhifaili kus hoida üldist seadistust
+ touch ~/ansible/playbooks/main.yml
+'''Näidete kopeerimisel tuleb olulist tähelepanu pöörata taanetele, kuna need on YAML'i süntaksi osa!'''<ref>YAML syntax, http://docs.ansible.com/YAMLSyntax.html</ref><br/>
+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>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
+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
-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:
@@ Line 79: / Line 114: @@
        - php5-ldap
    ...
 ===Süsteemide seadistamine===

Ansible: Difference between revisions

Revision as of 01:33, 12 January 2014

Contents

Tutvustus

Erinevused levinud alternatiividega

Kasutamine

Paigaldamine

Esmane seadistamine

Süsteemide seadistuse kirjeldamine

Süsteemide seadistamine

Kokkuvõte

Kasulikk materjale

Kasutatud kirjandus

Autorid

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools