RU

Приложения

Автоматизация серверов с помощью Ansible

Начните работу с Ansible: установка, инвентарь, плейбук, роли и шифрование секретов с помощью Ansible Vault для ваших серверов Debian и Ubuntu.

6 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Ansible позволяет описать конфигурацию ваших серверов в YAML-файлах и затем применить её по SSH. На управляемые серверы не нужно устанавливать никакой агент: им требуются только SSH и Python.

В этом руководстве вы создадите небольшой проект, который устанавливает Nginx, публикует демонстрационную страницу и размещает секрет, зашифрованный с помощью Ansible Vault.

Термин Значение
Управляющий узел Машина, на которой установлен Ansible и с которой вы запускаете команды
Управляемый узел Сервер, которым управляет Ansible
Инвентарь Список серверов и их групп
Задача Отдельное действие, выполняемое модулем
Плейбук YAML-файл, который сопоставляет задачи и серверы
Роль Повторно используемый набор задач, шаблонов и переменных
Vault Механизм шифрования конфиденциальных данных

Предварительные требования

  • Управляющий узел под Linux: ваш компьютер или сервер администрирования
  • Один или несколько управляемых серверов под Debian 12/13 или Ubuntu 22.04/24.04
  • SSH-пользователь на каждом управляемом сервере, входящий в группу sudo
  • SSH-аутентификация по ключу
  • Доступный с управляющего узла SSH-порт и порт 80 для демонстрационной страницы

Выбор управляющего узла

Доступная версия Ansible зависит от версии Python на управляющем узле:

Система управляющего узла Python Версия, устанавливаемая через pipx Статус
Debian 13 3.13 Ansible 15 (ansible-core 2.22) Рекомендуется
Ubuntu 24.04 3.12 Ansible 14 (ansible-core 2.21) Рекомендуется
Debian 12 3.11 Ansible 12 (ansible-core 2.19) Окончание поддержки в ноябре 2026 года
Ubuntu 22.04 3.10 Ansible 10 (ansible-core 2.17) Поддержка закончена

Это ограничение относится к управляющему узлу. Debian 12 и Ubuntu 22.04 по-прежнему можно использовать в качестве управляемых серверов.

Установка Ansible

На управляющем узле установите Ansible с помощью pipx — способа, описанного в официальной документации:

Терминал
sudo apt update
sudo apt install -y pipx
pipx ensurepath

Закройте и снова откройте сессию, чтобы применился PATH, затем установите полный пакет:

Терминал
pipx install --include-deps ansible
ansible --version

Подготовка SSH-доступа

Создайте ключ, если у вас его нет, затем скопируйте его на управляемый сервер:

Терминал
ssh-keygen -t ed25519 -C "ansible"
ssh-copy-id ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА
ssh -t ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА 'python3 --version && sudo -v'

При первом подключении вам предложат подтвердить отпечаток сервера: проверьте его, поскольку позже Ansible откажется работать с неизвестным хостом. Чтобы усилить защиту SSH-доступа, обратитесь к руководству Защитите ваш сервер.

Создание проекта

Терминал
mkdir -p ~/infra/group_vars/web
cd ~/infra
nano ansible.cfg
Конфигурация
[defaults]
inventory = inventory.ini
roles_path = roles

Написание инвентаря

Терминал
nano inventory.ini
Конфигурация
[web]
web1 ansible_host=IP_ВАШЕГО_СЕРВЕРА ansible_user=ВАШ_ПОЛЬЗОВАТЕЛЬ

Если ваш SSH-порт отличается от 22, добавьте ansible_port=ВАШ_ПОРТ в строку сервера. Затем проверьте инвентарь и подключение:

Терминал
ansible-inventory --graph
ansible all -m ansible.builtin.ping
ansible web -m ansible.builtin.command -a "uptime"

Модуль ping должен ответить pong. Он проверяет SSH-соединение и Python: это не сетевой ping.

Написание первого плейбука

Терминал
nano premier-playbook.yml
YAML
---
- name: Подготовить веб-серверы
  hosts: web
  become: true
  tasks:
    - name: Установить Nginx
      ansible.builtin.apt:
        name: nginx
        state: present
        update_cache: true
        cache_valid_time: 3600

    - name: Включить и запустить Nginx
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true

become: true выполняет задачи через sudo. Сначала проверьте, ничего не изменяя, затем примените:

Терминал
ansible-playbook premier-playbook.yml --check --diff
ansible-playbook premier-playbook.yml

Добавьте --ask-become-pass, если sudo запрашивает пароль. Затем запустите плейбук ещё раз: в итоговой сводке должно быть changed=0, так как нужное состояние уже достигнуто. Это и есть принцип идемпотентности.

Организация кода с помощью роли

Сгенерируйте структуру роли с именем web:

Терминал
ansible-galaxy role init --init-path roles web

Переменные по умолчанию

Файл roles/web/defaults/main.yml:

YAML
---
web_domain: ваш-домен.com
web_root: /var/www/demo
app_config_dir: /etc/demo-app

Задачи

Файл roles/web/tasks/main.yml:

YAML
---
- name: Установить Nginx
  ansible.builtin.apt:
    name: nginx
    state: present
    update_cache: true
    cache_valid_time: 3600

- name: Создать каталог сайта
  ansible.builtin.file:
    path: "{{ web_root }}"
    state: directory
    owner: root
    group: root
    mode: "0755"

- name: Опубликовать демонстрационную страницу
  ansible.builtin.copy:
    dest: "{{ web_root }}/index.html"
    content: "<h1>Сервер под управлением Ansible: {{ inventory_hostname }}</h1>\n"
    owner: root
    group: root
    mode: "0644"

- name: Развернуть конфигурацию сайта
  ansible.builtin.template:
    src: site.conf.j2
    dest: /etc/nginx/sites-available/demo.conf
    owner: root
    group: root
    mode: "0644"
  notify: Перезагрузить Nginx

- name: Включить сайт
  ansible.builtin.file:
    src: /etc/nginx/sites-available/demo.conf
    dest: /etc/nginx/sites-enabled/demo.conf
    state: link
  notify: Перезагрузить Nginx

- name: Создать каталог конфигурации приложения
  ansible.builtin.file:
    path: "{{ app_config_dir }}"
    state: directory
    owner: root
    group: root
    mode: "0750"

- name: Разместить секрет приложения
  ansible.builtin.copy:
    dest: "{{ app_config_dir }}/app.env"
    content: "APP_TOKEN={{ app_token }}\n"
    owner: root
    group: root
    mode: "0600"
  no_log: true

- name: Включить и запустить Nginx
  ansible.builtin.service:
    name: nginx
    state: started
    enabled: true

no_log: true не даёт секрету попасть в вывод Ansible.

Обработчик

Файл roles/web/handlers/main.yml. Обработчик выполняется только в том случае, если его вызвала какая-либо задача, и только один раз — в конце серии задач:

YAML
---
- name: Перезагрузить Nginx
  ansible.builtin.service:
    name: nginx
    state: reloaded

Шаблон Jinja2

Файл roles/web/templates/site.conf.j2:

Nginx
server {
    listen 80;
    listen [::]:80;
    server_name {{ web_domain }};
    root {{ web_root }};
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Основной плейбук

Файл site.yml в корне проекта:

YAML
---
- name: Настроить веб-серверы
  hosts: web
  become: true
  roles:
    - web

Защита секретов с помощью Ansible Vault

Разделите обычные переменные и зашифрованные. Файл group_vars/web/vars.yml остаётся читаемым и ссылается на секрет:

YAML
---
app_token: "{{ vault_app_token }}"

Создайте зашифрованный файл. Задайте надёжный пароль, когда команда его запросит:

Терминал
EDITOR=nano ansible-vault create group_vars/web/vault.yml

Запишите в него секрет:

YAML
---
vault_app_token: "ЗАМЕНИТЕ_НА_ВАШ_СЕКРЕТ"

После сохранения файл начинается с $ANSIBLE_VAULT, а его содержимое нечитаемо. Полезные команды:

Команда Действие
ansible-vault view group_vars/web/vault.yml Показать содержимое
ansible-vault edit group_vars/web/vault.yml Изменить содержимое
ansible-vault rekey group_vars/web/vault.yml Сменить пароль

Запуск развёртывания

Разрешите веб-трафик на управляемом сервере, если UFW активен, затем запустите имитацию и развёртывание:

Терминал
ssh -t ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА 'sudo ufw allow 80/tcp'
ansible-playbook site.yml --syntax-check --ask-vault-pass
ansible-playbook site.yml --check --diff --ask-vault-pass
ansible-playbook site.yml --ask-vault-pass

Для автоматизации храните пароль в файле вне проекта:

Терминал
install -m 600 /dev/null ~/.ansible-vault-infra
nano ~/.ansible-vault-infra
ansible-playbook site.yml --vault-password-file ~/.ansible-vault-infra

Проверка результата

Терминал
curl -H 'Host: ваш-домен.com' http://IP_ВАШЕГО_СЕРВЕРА/
ansible web -b -m ansible.builtin.stat -a "path=/etc/demo-app/app.env"
ansible-playbook site.yml --ask-vault-pass

Страница должна показывать имя web1, у файла app.env должен быть режим 0600, а последний запуск должен завершиться с changed=0.

Эта демонстрационная страница отдаётся по HTTP. Для реального сайта добавьте сертификат, следуя руководству Установка SSL-сертификата с Let's Encrypt.

Версионирование и резервное копирование проекта

Ansible не хранит состояние: эталоном является ваш проект. Поместите его в приватный Git-репозиторий и исключите локальные файлы:

Терминал
cd ~/infra
git init
printf '%s\n' '*.retry' '.vault-pass*' > .gitignore
git add .
git status
git commit -m "Начальный проект Ansible"

Перед первым коммитом убедитесь, что group_vars/web/vault.yml действительно зашифрован:

Терминал
head -n 1 group_vars/web/vault.yml

Сохраните пароль Vault в менеджере паролей отдельно от репозитория: без него секреты невозможно восстановить.

Обновление Ansible

Терминал
pipx upgrade --include-injected ansible
ansible --version

Если вы используете PPA, выполните sudo apt update, затем sudo apt install --only-upgrade ansible. После крупного обновления ознакомьтесь с руководством по переходу и снова запустите плейбуки с --check --diff.

Если что-то не работает

ansible: command not found

Каталога pipx нет в PATH. Выполните pipx ensurepath, затем откройте новую сессию.

UNREACHABLE и Permission denied (publickey,password)

Проверьте подключение с теми же параметрами, затем снова запустите Ansible в подробном режиме:

Терминал
ssh -p 22 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА
ansible all -m ansible.builtin.ping -vvv

Проверьте ansible_host, ansible_user, ansible_port и используемый ключ.

Host key verification failed

Отпечаток сервера неизвестен или изменился. После законной переустановки удалите старую запись, затем подключитесь снова и проверьте новый отпечаток:

Терминал
ssh-keygen -R IP_ВАШЕГО_СЕРВЕРА
ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

Missing sudo password

Добавьте --ask-become-pass или настройте sudo в соответствии с вашей политикой безопасности.

Attempting to decrypt but no vault secrets found

Плейбук читает зашифрованный файл без пароля. Добавьте --ask-vault-pass или --vault-password-file.

Decryption failed

Пароль не совпадает с паролем файла. Убедитесь также, что в файле пароля нет другого значения.

Could not get lock /var/lib/dpkg/lock-frontend

Выполняется другая операция APT, часто это автоматические обновления. Дождитесь её завершения или добавьте lock_timeout: 300 в задачу ansible.builtin.apt.

Ansible игнорирует ansible.cfg

Ansible игнорирует этот файл, если текущий каталог доступен для записи всем. Исправьте права командой chmod o-w ~/infra, затем проверьте результат с помощью ansible --version, которая показывает загруженный файл.

Что дальше

Чтобы создавать инфраструктуру или генерировать файлы до её настройки, обратитесь к руководству Первые шаги с Terraform. Чтобы централизованно хранить секреты, обратитесь к руководству Установка HashiCorp Vault.

Справочные материалы