Образовательный проект «SnakeProject» Михаила Козлова

⇒ FreeBSD and Nix ⇐

CISCO

Voice(Asterisk\Cisco)

Microsoft

Powershell

Python

SQL\T-SQL

1С

Общая

WEB Разработка

ORACLE SQL \ JAVA

Мото

Стрельба, пневматика, оружие

Саморазвитие и психология

Роли Ansible

Роли Ansible

Есть большая вероятность, что кто-то до Вас уже разработал решение Вашей задачи.
Используйте готовые роли Ansible Galaxy или пишите свои.
По сути, роли - способ логического разделения файлов Ansible.

По умолчанию ansible ищет роли в каталогах:

• ./roles (уровень каталога c файлом playbook)
• /etc/ansible/roles

Возможно указать параметр roles_path в ansible.cfg для другого места поиска ролей.

Типовая структура роли ansible:

• defaults: переменные по умолчанию для роли, которые могут быть перезаписаны в playbook.
• vars: стандартные переменные роли, которые не должны быть перезаписаны в playbook.
• tasks: набор задач, которые выполняет роль.
• handlers: набор обработчиков, используемых в роли.
• templates: шаблоны Jinja2, используемых в роли.
• files: статические файлы.
• meta: метаданные роли, информация об авторе, лицензии, зависимостях и т.п.
• tests: может содержать доп. файлы инвентаря или playbook для тестирования роли.

Пример логической структуры каталогов с 3 плейбуками и двумя ролями:
├── using_all_roles.yml ├── using_only_role1.yml ├── using_only_role2.yml └── roles ├── role1 │ ├── files │ ├── templates │ ├── tasks │ ├── handlers │ ├── vars │ └── defaults └── role2 ├── files ├── templates ├── tasks ├── handlers ├── vars └── defaults

Как можно догадаться, первые три файла - playbook, использующие роли.

Способы, как можно указать роли в playbook:
- ключевое слово roles для статического импорта ролей
- модуль include_role для динамического импорта ролей
- модуль import_role

Синтаксис статического импорта роли в playbook

Первый вариант записи using_all_roles.yml:
--- - name: all_roles hosts: all gather_facts: false become: yes roles: - role1 - role2 tasks: - name: Print a message ansible.builtin.debug: msg: "this task runs after roles"

Второй вариант записи с полным путем using_all_roles.yml:
--- - name: all_roles hosts: all gather_facts: false become: yes roles: - role1: /etc/ansible/roles/role1 - role2: /etc/ansible/roles/role2 tasks: - name: Print a message ansible.builtin.debug: msg: "this task runs after roles"

Теги позволяют запускать определенную роль и игнорировать другие роли, пример:
--- - name: all_roles hosts: all gather_facts: false become: yes roles: - role1 tags: redhat - role2 tags: ubuntu

Запуск определенной роли(redhat), пример:
# ansible-playbook --tags redhat /etc/ansible/using_all_roles.yml -i hosts.yml

На примере установки сервиса nginx

В одной из статей уже делал пример nginx + ansible без ролей, возьмем за основу:
https://snakeproject.ru/rubric/article.php?art=terraform_ansible

Наша задача та-же - установить nginx + на основе шаблонов сделать конфиги

Galaxy - по сути репозиторий готовых плейбуков и ролей
См. документацию:
https://galaxy.ansible.com/ui/
Синтаксис установки: ansible-galaxy install название

# mkdir -p /root/ansible-nginx/{inventory,roles}

/root/ansible-nginx/inventory/hosts.yml:
all: hosts: webserver: ansible_ssh_host: 192.168.0.1 ansible_ssh_private_file: ~/.ssh/id_rsa domain: domain.ru

# ansible all -i inventory/hosts.yml -m ping
192.168.0.1 | SUCCESS => {
"changed": false, 
"ping": "pong"
}

/root/ansible-nginx/webserver.yml:
- name: deploy webserver hosts: webserver vars: nginx_user: www-data remote_user: root become: yes roles: - nginx

# cd /root/ansible-nginx/roles

# ansible-galaxy init nginx
- nginx was created successfully

Получили структуру nginx:
# tree roles/
roles/
└── nginx
    ├── README.md
    ├── defaults
    │          └── main.yml
    ├── handlers
    │          └── main.yml
    ├── meta
    │          └── main.yml
    ├── tasks
    │          └── main.yml
    ├── tests
    │          ├── inventory
    │          └── test.yml
    └── vars
        └── main.yml

/root/ansible-nginx/roles/nginx/tasks/main.yml:
# tasks file for nginx --- - name: Install Nginx Web Server on Ubuntu OS apt: name=nginx state=latest when: ansible_os_family == "Ubuntu" notify: - nginx systemd - name: Create home dir file: path: /var/www/{{ domain }} state: directory - name: Add index file template: src=templates/index.j2 dest=/var/www/{{ domain }}/index.html - name: Create nginx.conf template: src=templates/nginx.j2 dest=/etc/nginx/nginx.conf notify: - nginx systemd - name: Add virtual domain to NGINX for Ubuntu template: src=templates/vhost.j2 dest=/etc/nginx/sites-enabled/{{ domain }}.conf when: ansible_os_family == "Ubuntu" notify: - nginx systemd /root/ansible-nginx/roles/nginx/handlers/main.yml: --- - name: nginx systemd systemd: name: nginx enabled: yes state: started

/root/ansible-nginx/roles/nginx/vars/main.yml:
worker_processes: auto worker_connections: 512 days: ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']

/root/ansible-nginx/roles/nginx/templates/nginx.j2:
user {{ nginx_user }}; worker_processes {{ worker_processes }}; worker_priority -1; error_log /var/log/nginx/error.log warn; pid /var/run/nginx.pid; events { worker_connections {{ worker_connections }}; } http { gzip on; sendfile on; include /etc/nginx/mime.types; default_type application/octet-stream; include /etc/nginx/modules-enabled/*.conf; include /etc/nginx/conf.d/*.conf; include /etc/nginx/sites-enabled/*; }

/root/ansible-nginx/roles/nginx/templates/vhost.j2:
server { listen 80; server_name {{ domain }} www.{{ domain }}; root /var/www/{{ domain }}; access_log /var/log/nginx/{{ domain }}_access_log; error_log /var/log/nginx/{{ domain }}_error_log; location / { index index.html; } }

/root/ansible-nginx/roles/nginx/templates/index.j2:
Days of the week: {% for item in days%} {{ loop.index }} {{ item|upper }} {% endfor %}

Проверка синтаксиса и запуск:
# cd /root/ansible-nginx/
# ansible-playbook -i inventory/hosts.yml webserver.yml --syntax-check
# ansible-playbook -i inventory/hosts.yml webserver.yml

Комментарии пользователей