Руководство пользователя

Примечание

Повышение инклюзивности в открытом исходном коде

Компания Red Hat стремится заменить проблемную лексику в своем коде, документации и веб-ресурсах. Мы начинаем с этих четырех терминов: master, slave, blacklist и whitelist. Просим сообщать об упущенных терминах, создавая issue или pull request. Более подробная информация доступна в сообщении нашего CTO Криса Райта.

Добро пожаловать в Руководство пользователя Ansible! Это руководство о работе с Ansible, включая использование командной строки, работу с инвентарём, взаимодействие с данными, написание задач, плейбуков и playbooks; выполнение playbooks и справочные материалы. На этой странице описаны наиболее распространённые ситуации и вопросы, которые приводят читателей в этот раздел. Если вы предпочитаете традиционное содержание, вы можете найти его внизу страницы.

Начало работы

Мне нужен обзор работы Ansible. Где я могу найти:
- краткое видео-введение quick video overview
- текстовое введение text introduction
Я готов изучать Ansible. Какие концепции Ansible мне нужно изучить?
Я хочу использовать Ansible без написания playbook. Как использовать ad hoc команды?

Написание задач, плейбуков и playbooks

Я пишу свой первый playbook. Что мне нужно знать перед началом?
У меня есть конкретный случай использования задачи или плейбука:
- Выполнение задач с повышенными привилегиями или как другой пользователь с помощью become
- Повторение задачи один раз для каждого элемента в списке с помощью циклов
- Выполнение задач на другом компьютере с помощью делегирования
- Выполнение задач только при определенных условиях с помощью условных операторов и оценки условий с помощью тестов
- Группирование набора задач вместе с помощью блоков
- Выполнение задач только тогда, когда что-то изменилось, с помощью обработчиков
- Изменение способа, которым Ansible обрабатывает ошибки
- Установление удаленных значений среды
Я хочу использовать преимущества многоразовых артефактов Ansible. Как создать многоразовые файлы и роли?
Мне нужно включить один файл или playbook в другой. В чем разница между включением и импортом?
Я хочу запустить выбранные части моего playbook. Как добавить и использовать метки?

Работа с инвентарём

У меня есть список серверов и устройств, которые я хочу автоматизировать. Как создать инвентарь для их отслеживания?
Я использую облачные сервисы, и серверы и устройства постоянно запускаются и останавливаются. Как отслеживать их с помощью динамического инвентаря?
Я хочу автоматизировать определенные подмножества моего инвентаря. Как использовать шаблоны?

Взаимодействие с данными

Я хочу использовать один playbook для нескольких систем с различными атрибутами. Как использовать переменные для обработки различий?
Я хочу получить данные о моих системах. Как получить доступ к фактам Ansible?
Мне нужно получить доступ к конфиденциальным данным, таким как пароли, с помощью Ansible. Как защитить эти данные с помощью Ansible vault?
Я хочу изменить имеющиеся данные, чтобы использовать их в задаче. Как использовать фильтры для преобразования данных?
Мне нужно получить данные из внешнего хранилища данных. Как использовать lookups для доступа к базам данных и API?
Я хочу попросить пользователей playbook предоставить данные. Как получить пользовательский ввод с помощью подсказок?
Я часто использую определенные модули. Как оптимизировать свой инвентарь и playbooks, задавая значения по умолчанию для параметров модулей?

Выполнение playbooks

После того, как ваш playbook готов к запуску, вам могут понадобиться эти темы:

Выполнение «сухих» playbooks с помощью режима проверки и diff
Запуск playbooks при отладке с помощью шагов запуска и выполнения
Исправление задач во время выполнения с помощью отладчика Ansible
Управление выполнением playbooks с помощью стратегий и др.
Выполнение задач, плейбуков и playbooks асинхронно

Расширенные возможности и справка

Использование расширенного синтаксиса
Обработка сложных данных
Использование плагинов
Использование ключевых слов playbooks
Использование инструментов командной строки
Отклонение конкретных модулей
Обслуживание модулей

Традиционное содержание

Если вы предпочитаете прочитать всё Руководство пользователя, вот список страниц в порядке:

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/user_guide/index.html