Spec-Zone.ru › Ansible

Создание плейбука

Плейбуки — это чертежи автоматизации в формате YAML, которые Ansible использует для развертывания и настройки управляемых узлов.

Плейбук

Список сценариев, определяющих порядок выполнения операций Ansible — сверху вниз — для достижения общей цели.

Сценарий

Упорядоченный список задач, сопоставленный с управляемыми узлами в инвентаре.

Задача

Ссылка на один модуль, определяющий выполняемые Ansible операции.

Модуль

Единица кода или исполняемый файл, который Ansible запускает на управляемых узлах. Модули Ansible объединены в коллекции; для каждого модуля используется полное квалифицированное имя коллекции (FQCN).

Выполните следующие шаги, чтобы создать плейбук, который проверяет доступность ваших узлов и выводит сообщение «Привет, мир»:

  1. Создайте файл с именем playbook.yaml в каталоге ansible_quickstart, созданном ранее, со следующим содержимым:

    - name: My first play
      hosts: myhosts
      tasks:
       - name: Ping my hosts
         ansible.builtin.ping:
    
       - name: Print message
         ansible.builtin.debug:
           msg: Hello world
    
  2. Запустите плейбук.

    ansible-playbook -i inventory.ini playbook.yaml
    

Ansible выведет следующее:

PLAY [My first play] ****************************************************************************

TASK [Gathering Facts] **************************************************************************
ok: [192.0.2.50]
ok: [192.0.2.51]
ok: [192.0.2.52]

TASK [Ping my hosts] ****************************************************************************
ok: [192.0.2.50]
ok: [192.0.2.51]
ok: [192.0.2.52]

TASK [Print message] ****************************************************************************
ok: [192.0.2.50] => {
    "msg": "Hello world"
}
ok: [192.0.2.51] => {
    "msg": "Hello world"
}
ok: [192.0.2.52] => {
    "msg": "Hello world"
}

PLAY RECAP **************************************************************************************
192.0.2.50: ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.0.2.51: ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
192.0.2.52: ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

В этом выводе вы увидите:

  • Названия, которые вы указали для сценария и каждой задачи. Всегда используйте описательные названия, чтобы было проще проверять плейбуки и устранять неполадки.
  • Задача «Сбор фактов» выполняется неявно. По умолчанию Ansible собирает сведения об инвентаре, которые можно использовать в плейбуке.
  • Статус каждой задачи. У каждой задачи статус ok, что означает, что она выполнена успешно.
  • Сводка выполнения сценария, в которой приведены результаты всех задач плейбука для каждого узла. В этом примере три задачи, поэтому ok=3 указывает, что каждая задача выполнена успешно.

Поздравляем, вы начали использовать Ansible!

См. также

Плейбуки Ansible

Начните создавать плейбуки для реальных сценариев.

Работа с плейбуками

Подробно изучите плейбуки Ansible.

Советы и рекомендации по Ansible

Получите советы и рекомендации по использованию плейбуков.

Изучение переменных: факты и магические переменные

Узнайте больше о ключевом слове gather_facts в плейбуках.

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/getting_started/get_started_playbook.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API