Установка Ansible AWX на Debian 7.1

Решили мы как то упростить администрирование небольшой группы серверов на FreeBSD. Серверов этих самых, вроде бы и не много, но всё же часто бывает нужно выполнить ряд однотипных задач на всех разом.
Долго думали, выбирали, сравнивали, и всё же пришли к варианту установить систему Ansible. А для наглядности к ней прикрутить web-мордочку с названием AWX.
Но вот незадача, сервера у нас на FreeBSD, а в качестве “рабочего” Linux’а выбран Debian. Ansible AWX поддерживает в качестве официальных RHEL/Fedora и Ubuntu.
Как мы все помним, Ubuntu вышла из Debian, а значит должна помнить о предке. Будем разбираться как поставить AWX на Debian.
Исходные данные: свежеустановленный Debian 7.1 Wheezy с включенной вариантами конфигурации “SSH сервер” и “Системные утилиты”.

Инсталятор AWX представляет собой sh скрипт (чуть подробнее об этом ниже), но единственное что делает этот скрипт — запускает playbook для ansible, из чего следует, что перед запуском этого скрипта следует установить сам ansible.

root@awx:~# apt-get install ansible Чтение списков пакетов… Готово Построение дерева зависимостей Чтение информации о состоянии… Готово E: Не удалось найти пакет ansible 

Но тут ждёт неожиданность в wheezy его нет, так что придётся подключать репозитарий testing. Я использую зеркала яндекса, так что в свой файл /etc/apt/sources.list я добавил строку:

deb http://mirror.yandex.ru/debian/ testing main contrib non-free 

Далее, обновляем списки пакетов:

root@awx:~# apt-get update 

И ставим сам ansible с необходимыми зависимостями:

root@awx:~# apt-get install ansible 

Соглашаемся со всем, что нам вменяют и ждём завершения установки. После чего скачиваем awx, его к сожалению в пакетах нет.

wget http://ansibleworks.com/releases/awx/setup/awx-setup-latest.tar.gz 

Распаковываем

root@awx:~# tar xzvf awx-setup-latest.tar.gz 

Смотрим, с чем нам предстоит иметь дело.

root@awx:~/awx-setup-1.3.1# ls group_vars  myhosts  README.md  roles  setup.sh  site.yml 

Прочитав файл README.md мы узнаем, что нам необходимо изменить данные аутентификации для PostgreSQL в файле group_vars/all, а так же предупреждение о том, что pg_hba.conf и supervisord.conf будут перезаписаны. Так, что если ставите не на чистую систему, следует сделать соответствующие бейкапы.

Пока всё понятно, теперь рассмотрим из чего состоит инсталятор про который уже упоминалось выше:

root@awx:~/awx-setup-1.3.1# cat setup.sh #!/bin/bash  getopts "e:" EXTRA_ARGS if [ "$OPTARG" != "" ]; then   echo "Running with extra args: ${OPTARG}"   sudo ANSIBLE_ERROR_ON_UNDEFINED_VARS=True ansible-playbook -i myhosts -c local -v -e "$OPTARG" site.yml else   sudo ANSIBLE_ERROR_ON_UNDEFINED_VARS=True ansible-playbook -i myhosts -c local -v site.yml fi 

Из содержимого видно, что главная и единственная задача этого файла запустить playbook site.yml на группу узлов указанных в файле myhosts (в котором только 127.0.0.1) из этой же директории. Следующий параметр -c local указывает механизм доставки команд на целевую машину, в нашем случае ansible и целевая машина это одно и тоже.

Так же из любопытного, можно заметить, что предлагается использовать sudo. Но так как у нас чистая установка Debian в неё это самое sudo, в отличии от Ubuntu, не входит. Значит либо удаляем команду, либо доставляем sudo.
Я удалил вызов sudo, а так же добавил для более подробной отладки ещё две буквы “v”.
Вид файла после моего редактирования:

getopts "e:" EXTRA_ARGS if [ "$OPTARG" != "" ]; then   echo "Running with extra args: ${OPTARG}" ANSIBLE_ERROR_ON_UNDEFINED_VARS=True ansible-playbook -i myhosts -c local -vvv -e "$OPTARG" site.yml else   ANSIBLE_ERROR_ON_UNDEFINED_VARS=True ansible-playbook -i myhosts -c local -vvv site.yml fi 

Теперь перейдём к самому интересному, файлу site.yml

root@awx:~/awx-setup-1.3.1# cat site.yml --- # This playbook deploys the AWX application (database, web and worker) to a # single server.  - hosts: all   tasks:     - name: group hosts by distribution       group_by: key="{{ ansible_distribution }}-{{ ansible_distribution_version }}"  - hosts: RedHat-6*:CentOS-6*:SL-6*   user: root   roles:     - { role: packages_el6 }     - { role: postgres, pg_hba_location: "/var/lib/pgsql/data/pg_hba.conf" }     - { role: awx_install }     - { role: supervisor, sup_init_name: "supervisord", sup_conf_location: "/etc/supervisord.conf" }     - { role: httpd, httpd_init_name: "httpd" }     - { role: iptables }     - { role: misc }  - hosts: Ubuntu-12*:Ubuntu-13*   user: root   roles:     - { role: packages_ubuntu }     - { role: postgres, pg_hba_location: "/etc/postgresql/9.1/main/pg_hba.conf" }     - { role: awx_install }     - { role: supervisor, sup_init_name: "supervisor", sup_conf_location: "/etc/supervisor/conf.d/awx.conf" }     - { role: httpd, httpd_init_name: "apache2" }     - { role: misc } 

Варианта для Debian’а не видно, но тут уже видно 2 готовых варианта сценария, для основанных на RHEL и для Ubuntu, а как известно Ubuntu является прямым потомком Debian’a. Ставить будем именно по убунтовскому варианту установки, для этого добавим упоминание о нашей ОС в этот playbook:

- hosts: Ubuntu-12*:Ubuntu-13*:Debian* 

Так как postgresql мы будем ставить версии 9.3 немного исправим путь до его конфигурационных файлов

    - { role: postgres, pg_hba_location: "/etc/postgresql/9.3/main/pg_hba.conf" } 

В остальном, для нас тут больше ничего интересного.
Пройдёмся по отдельным ролям, и первой будет packages_ubuntu

root@awx:~/awx-setup-1.3.1# cat roles/packages_ubuntu/tasks/main.yml --- # Tasks to install required packages for awx  - name: install ubuntu awx apt repository   template: src=awx_repo.j2 dest=/etc/apt/sources.list.d/awx_repo.list  - name: install python-pip package for ubuntu 12.04   apt: name=python-pip   when: ansible_lsb.codename == "precise"  - name: install django 1.5.4 via pip for ubuntu 12.04   pip: name=django version=1.5.4   when: ansible_lsb.codename == "precise"  - name: install django via apt for ubuntu 12.10 or later   apt: name=python-django   when: ansible_lsb.codename != "precise"  - name: install required packages via apt   apt: name={{ item }}   with_items:     - apache2     - libapache2-mod-wsgi     - postgresql     - python-psycopg2     - python-setuptools     - python-ldap     - supervisor     - git     - subversion     - mercurial  - name: install awx package via apt   apt: name=awx update_cache=yes force=yes state=latest 

Первая интересная нам строка template: src=awx_repo.j2 dest=/etc/apt/sources.list.d/awx_repo.list — подключения репозитария, смотрим в файл:

root@awx:~/awx-setup-1.3.1# cat roles/packages_ubuntu/templates/awx_repo.j2 deb {{ aw_repo_url }}/deb {{ansible_lsb.codename}} non-free 

Вроде всё ясно, 2 переменные, в первом случае URL репозитария указанного в файле group_vars/all, во втором случае кодовое имя операционной системы, у нас это whezzy, но так как в репозитарии для wheezy ничего нет, мы будем маскироваться под Ubuntu Raring Ringtail.
После “маскировки” файл принимает следующий вид.

root@awx:~/awx-setup-1.3.1# cat roles/packages_ubuntu/templates/awx_repo.j2 deb {{ aw_repo_url }}/deb raring non-free 

В следующей части проверяется, не Precise Pangolin ли у нас:

- name: install python-pip package for ubuntu 12.04   apt: name=python-pip   when: ansible_lsb.codename == "precise"  - name: install django 1.5.4 via pip for ubuntu 12.04   pip: name=django version=1.5.4   when: ansible_lsb.codename == "precise"  - name: install django via apt for ubuntu 12.10 or later   apt: name=python-django   when: ansible_lsb.codename != "precise" 

Так как у него (Precise Pangolin) в репозитарии Django старой версии, и авторы AWX ставят более новую (1.5.4) альтернативным путём. Нам эта проблема не грозит, так что можно ничего не менять. Так же меняем условие в файле обработчика для httpd, c Ubunu на Debian:

root@awx:~/awx-setup-1.3.1# cat roles/httpd/handlers/main.yml --- # Handlers for common notifications.  - name: restart httpd   service: name=httpd state=restarted   when: ansible_distribution in ["CentOS","RedHat"]  - name: restart apache2   service: name=apache2 state=restarted   when: ansible_distribution in ["Ubuntu"] 

В последней строчке Ubuntu меняем на Debian.
Аналогичные действия нужно произвести и для следующей роли postgres:

root@awx:~/awx-setup-1.3.1# cat roles/postgres/tasks/main.yml # Tasks for configuring PostgreSQL server.  - name: init postgresql   command: service postgresql initdb creates=/var/lib/pgsql/data/PG_VERSION   when: ansible_distribution != "Ubuntu"   tags: postgresql 

Скрещиваем пальцы и запускаем

root@awx:~/awx-setup-1.3.1# ./setup.sh   PLAY RECAP ******************************************************************** 127.0.0.1                  : ok=30   changed=12   unreachable=0    failed=0 

Инсталятор настройки apache помещает в папку

root@awx:~/awx-setup-1.3.1# ls /etc/apache2/conf.d awx.conf  awx-plain.conf 

Содержимое данной папки не включается в основной конфиг апача, так что нам нужно их переместить:

mv /etc/apache2/conf.d/awx* /etc/apache2/sites-enabled/ 

Дальше ничего сложно, конфигурируем апач, удаляем дублирующиеся вызовы модулей и пользуемся.