Användarverktyg

Webbverktyg


teknik:ansible:inledning

Ansible Inledning

Ansible är ett deploymentverktyg som används för att automatisera installation av paket, konfigurationsfiler och andra åtgärder på flera servrar samtidigt.

Kommandon

I Ansible 1.8 finns flera kommandon men de tre som kommer användas mest beskrivs lite kort här.

ansible

Detta är ett kommando som bara kan göra en uppgift/modul åt gången. Läs mer om moduler här.

Exempel

Detta kör modulen setup för alla servrar i gruppen mkbnet.

ansible -m setup mkbnet

ansible-playbook

Kör en så kallad spelbok, en fil full av uppgifter. Läs mer om spelböcker här.

Exempel

Kör spelboken mkbnet_test.yml-

ansible-playbook mkbnet_test.yml

ansible-vault

Hanterar krypterade filer. Detta är ibland nödvändigt för att lagra känslig information i variabler i ansible.

Exempel

Skapa en krypterad fil, redigera den krypterade filen och till sist kör en spelbok som använder den krypterade filen.

ansible-vault create group_vars/mkbnet.yml
ansible-vault edit group_vars/mkbnet.yml
ansible-playbook --ask-vault-pass mkbnet_hemlisar.yml

YAML

Ansible använder YAML-format för sina spelböcker. YAML är ett simpelt nyckel & värde språk där du anger en unik nyckel med kolon och sedan ett värde för den nyckeln. Det finns även stöd för listor.

Här är ett exempel på en lista i YAML.

- min_lista:
  - 1
  - 2
  - 3

Du kan även göra namngivna medlemmar i listor.

- min_lista:
  - namn: ett
    värde: 1
  - namn: två
    värde: 2

Användning av YAML i Ansible är väldigt nära besläktat med Python så för att hänvisa till en medlem i den listan kan man skriva t.ex. min_lista.namn.

Spelböcker

Spelböcker är en rad instruktioner som ska utföras. Ansible använder SSH för att ansluta till servrar så i princip loggar den in med SSH, överför skripts som ska motsvara din spelbok och sedan kör dem på servern.

En spelbok är en fil som kan innehålla flera spelningar, eller plays som Ansible kallar det i sin dokumentation. Så här kan en spelbok med två spelningar se ut.

---
- hosts: mkbnet
  sudo: True
  roles:
    - authorized_keys
    - bootstrap_common
    - scollector
    - nagios_agent

- hosts: ['mkbnetnaredir']
  user: mkbnetadm
  sudo: True
  roles:
    - dnsmasq
  tasks:
    - name: setup rsyslog
      copy: src=etc/rsyslog.conf dest=/etc/rsyslog.conf owner=root group=root mode=0644

En snabb förklaring av vad som syns här.

hosts: låter dig ange en grupp av servrar som du vill köra kommandon på. Värdet kan antingen vara namnet av en grupp, som ovan är mkbnet, eller en lista av enskilda värdnamn, som ovan är ['mkbnetnaredir']. Läs mer om servrar och servergrupper under Inventering.

sudo: anger om alla kommandon ska använda sudo eller inte.

roles: är en lista av roller som ska appliceras på alla hosts: i den körningen. Läs mer om roller under Roller.

tasks: är en lista av uppgifter som kan köras på maskinerna.

Roller

En roll är ett sätt att gruppera flera uppgifter som är gemensamma för många olika maskiner. Så om du t.ex. vill göra en generisk installation av en mjukvara så gör du det i en roll. Roller måste vara så generiska som möjligt och inte ha någon kund eller server-specifik information.

Alla roller lagras i mappen roles i gitförrådet.

En roll kan ses som ett paket så det finns en struktur av mappar och filer. Här är ett exempel på en roll.

- epel/
  - tasks/main.yml
  - defaults/main.yml

Rollen epel installerar EPEL paketförrådet på RedHat-system. Den består av två mappar som har var sin fil. main.yml är som en standardfil för alla mappar i en roll. Du kan ha fler filer där som inkluderas av main.yml men det är alltid main.yml som körs av ansible.

tasks/main.yml är en vanlig spelbok med en uppgift.

---
- name: install EPEL repository on RedHat
  yum: name={{ epel_url }} state=present
  when: ansible_os_family == 'RedHat'

defaults/main.yml är bara en samling variabler, standardvariabler som kan åsidosättas av andra variabler.

epel_url: http://ftp.lysator.liu.se/pub/epel/6/i386/epel-release-6-8.noarch.rpm

Just variabeln epel_url kan man se i spelboken ovan på rad 3 inom två parenteser.

Variabler

Precis som varje roll kan ha sina egna standardvariabler så kan detta även gälla för servrar och servergrupper.

Enskilda servrar kan ha sina egna variabler i host_vars/servernamn.yml, medan grupper av servrar kan ha gemensamma variabler i group_vars/gruppnamn.yml.

Här är ett exempel från filen host_vars/mkbnetnaredir.yml.

dnsmasq_config:
  - mkbnet.conf

Och här är ett exempel från filen group_vars/mkbnet.yml.

host_customer: MKB Net
host_local: False
ansible_ssh_user: mkbnetadm

Variabler har en prioriteringsordning, här visar jag ett exempel med högst prioritet först.

  • playbook vars
  • host_vars
  • group_vars
  • role vars

Läs mer om variablers prioriteringsordning och se en komplett lista av den här i ansibles dokumentation.

Inventering

Ansible använder en fil för att hålla reda på servrar och servergrupper. Den anges antingen av -i argumentet till ansible-kommandon, eller av miljövariabeln ANSIBLE_HOSTS.

Filen följer INI-format som är mycket simpelt. Här är ett exempel.

[mkbnet:children]
mkbnet-db
mkbnet-netadmin
 
[mkbnet-db]
mkbnetdb02
mkbnetdb03
 
[mkbnet-netadmin]
mkbnetnadb
mkbnetnamon1
mkbnetnamon2
mkbnetsrv01
mkbnetsrv02
mkbnetsrv03
mkbnetsrv04
mkbnetnaredir

Här visas tre grupper, två av dem har servrar i sig men den första gruppen mkbnet:children är en sorts huvudgrupp för de två andra.

Moduler

Moduler är allt som ansible kan göra på servrar. I de flesta installationer kan du hitta dem i /usr/share/ansible. De är kategoriserade under olika mappar baserat på deras funktionalitet.

När man skriver uppgifter så använder man alltid moduler. Här är ett exempel på en uppgift som använder copy-modulen för att kopiera en fil till servern.

- name: copy file to server
  copy: src=files/test.conf dest=/home/stemid/files/test.conf owner=stemid group=stemid mode=0640

Allt som är efter kolonet är argument till modulen, så det är vanligt att man öppnar en modulfil för att läsa dess argument. Alla moduler i ansible är skrivna i Python, eftersom det är vanliga textfiler så står det klara exempel på argument och hur man använder dem i början av filerna. Modulen copy ligger t.ex. i /usr/share/ansible/files/copy.

Moduler kan även användas direkt utan en spelbok, så här.

ansible -m copy -a 'src=files/test.conf dest=/home/stemid/files/test.conf owner=stemid group=stemid mode=0640' mkbnet

Detta kör copy-modulen på samma sätt som ovan, mot servergruppen mkbnet.

Se också

teknik/ansible/inledning.txt · Senast uppdaterad: 2015-02-10 08:42 av stemid