Ansible Introduction. Part 3

Командный модуль command

Модуль принимает имя команды и армументы. Переменные оболочки или операции (<,>,|,&) не будут работать с модулем command, т.к. обрабатываются оболочкой. Модуль command принимает следующие параметры:

• chdir: Используется для изменения текущей директории, в которой исполняется команда
• creates: Создает файл
• removes: Удаляет файл

Простейшая задача перезагрузки сервера:

- name: Reboot machine
    command: /sbin/shutdown -r now
    sudo: yes

Командный модуль raw

Этот модуль следует использовать, когда другие командные модули использовать не удается. Это простой запуск удаленных команд серверу по SSH. Данный модуль работает даже на серверах без установленного Python.

Пример установки пакета vim:

- name: Install vim
    raw: yum -y install vim-common
    sudo: yes

По окончанию выполнения операции, можно будет увидеть, что пакет установлен, но задача не будет помечена как changed. Лучше не использовать raw модуль когда возможно.

Командный модуль script

Этот модуль используется для копирования скрипта на удаленную машину и исполнения его. Модуль поддерживает параметры creates и removes.

Для примера, напишем скрипт для просмотра количества директорий в /etc и запустим его на удаленных серверах (~/ansible/playbooks/scripts/list_number_of_directories.sh)

#/bin/bash
ls -l /etc | egrep '^d' | wc -l

Задача, использующая модуль script выглядит так:

- name: List directories in /etc
    script: ~/ansible/playbooks/scripts/list_number_of_directories.sh /etc
    sudo: yes

Путь к файлу скрипта задается относительно месторасположения файла, использующего модуль script. Например, если данная задача описана в файле задачи, импортированном в playbook, расположение скрипта задается относительно файла задачи, а не playbook.

Командный модуль shell

Ключевое отличие модуля shell от модуля command в том, что он использует /bin/sh по умолчанию для запуска команд. Вы можете использовать переменные оболочки и другие функции оболочки.

Файловый модуль file

Модуль file позволяет вам изменять атрибуты файла. Можно создать файл, создать или удалить директории рекурсивно, создать или удалить символическую ссылку.

Проверим, что httpd.conf имеет правильные права владельца:

- name: Ensure httpd conf has right permissions and owner/group
    file: path=/etc/httpd/conf/httpd.conf owner=root group=root mode=0644
    sudo: yes

Так как скрипты Ansible позволяют достичь нужного состояния и при перезапуске скриптов - повторный запуск позволит убедиться и поправить при необходимости права на доступ к файлам.

Как создаются симлинки:

- name: Create a symlink in /tmp for httpd.conf
    file: src=/etc/httpd/conf/httpd.conf dest=/tmp/httpd.conf owner=root group=root state=link
    sudo: yes

Создание директории рекурсивно:

- name: Create recursive directories
    file: path=/tmp/dir1/dir2/dir3 owner=root group=root mode=0777
    sudo: yes

Файловый модуль copy

С помощью модуля copy можно копировать файлы на сервер.

- name: Copy file remotely
    copy: src=test2.conf dest=/etc/test2.conf owner=root group=root mode=0644
    sudo: yes

Модуль системы управления версиями git

В Ansible есть поддержка различных систем управления версиями (svn, bzr, hg и другие), но рассмотрим git:

Установка git на сервер:

- yum: name=git state=installed
  sudo: yes

Получим репозиторий со скриптами из этих статей:

- name: Checkout ansible–playground repository
    git: repo=https://github.com/trukhinyuri/ansible-playground.git dest=~/checkout
    sudo: yes

До и после выполнения задачи считается SHA, который позволяет понять, был ли репозиторий обновлен.

Если получаете файлы по SSH - используйте параметры accept_key и key_file для установки ключа для доступа к репозиторию. Если нужно использовать ключ accept_key=yes, key_file - указывает на путь к ключу. Если ключ находится в ~/.ssh - указывать key_file не нужно.

Зависимости ролей

Зависимости ролей позволяют автоматически исполнить зависимые роли при запуске конкретных ролей, у которых зависимости есть. Зависимости хранятся в roles/x/meta/main.yml. Вместе с зависимыми ролями могут быть переданы параметры. Путь к ролям может быть указан как в сокращенном виде, так и в полном. Также может быть использован репозиторий системы управления версиями.

---
dependencies:
    - { role: common, some_parameter: 3 }
    - { role: '/path/to/common/roles/foo', x: 1 }
    - { role: 'git+http://git.example.com/repos/role-foo,v1.1,foo' }

Если в зависимостях указана одна и та же роль несколько раз - она запустится только однажды. Если нужно несколько раз, можно в файле зависимостей попросить об этом явно.