Как да извикаме ролите в Ansible плейбука?

Ролите в Ansible могат да бъдат извиквани по няколко начина в рамките на плейбук.

1. Използване на ключовата дума roles на ниво плейбук:

   # playbooks/my_playbook.yml
   - име: Приложение на роли към сървъри
     hosts: webservers
     become: да
     roles:
       - role: common  # Извикване на ролята 'common'
       - role: nginx   # Извикване на ролята 'nginx'
         vars:         # Предаване на променливи към ролята
           nginx_port: 8080
       - another_role # Съкратена форма на извикване
   

   Този начин се използва за извикване на роли, които ще се изпълняват последователно за всички хостове, определени в секцията hosts.

2. Използване на модула include_role в списъка с задачи:

   # playbooks/my_playbook.yml
   - име: Приложение на роли с условия
     hosts: appservers
     tasks:
       - име: Включване на ролята за база данни (само за dev)
         include_role:
           name: database
         when: env == 'dev' # Условно извикване на ролята
   
       - име: Включване на ролята за приложение
         include_role:
           name: app
         vars:
           app_version: 1.2.0 # Предаване на променливи към ролята
   

   Модулът include_role изпълнява ролята, сякаш е списък с задачи, включен в текущия плейбук. Позволява използването на условия (when) и цикли (loop) за контрол на изпълнението на ролята.

3. Използване на модула import_role в списъка с задачи:

   # playbooks/my_playbook.yml
   - име: Импортиране на ролята за приложение
     hosts: appservers
     tasks:
       - име: Импортиране на ролята за всички хостове
         import_role:
           name: app
         vars:
           app_config_file: /etc/app/config.conf # Предаване на променливи
   

   Модулът import_role се обработва на етапа на парсиране на плейбука, преди неговото фактическо изпълнение. Това означава, че всички директиви като when ще се прилагат към всички задачи в ролята, а не само към самото извикване на ролята. Променливите, предадени чрез vars, ще бъдат достъпни вътре в ролята.

Основната разлика между include_role и import_role е във времето на обработка: import_role се обработва статично на етапа на парсиране, а include_role — динамично по време на изпълнение на плейбука. Това влияе върху възможността за използване на условия и цикли:

Функция	include_role	import_role
Обработка	Динамична	Статична
Използване на when за извикване	Да	Не
Използване на loop за извикване	Да	Не
Възможност за използване на променливи, дефинирани по-рано в плейбука	Да	Не

Изборът между тези методи зависи от изискваната гъвкавост и време на обработка. За простото включване на роли обикновено е достатъчно ключовата дума roles или import_role. За по-сложни сценарии с условия и цикли се използва include_role.