Автоматизация серверов с помощью Ansible
Начните работу с Ansible: установка, инвентарь, плейбук, роли и шифрование секретов с помощью Ansible Vault для ваших серверов Debian и Ubuntu.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
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---
- 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: truebecome: 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:
---
web_domain: ваш-домен.com
web_root: /var/www/demo
app_config_dir: /etc/demo-appЗадачи
Файл roles/web/tasks/main.yml:
---
- 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: trueno_log: true не даёт секрету попасть в вывод Ansible.
Обработчик
Файл roles/web/handlers/main.yml. Обработчик выполняется только в том случае, если его вызвала какая-либо задача, и только один раз — в конце серии задач:
---
- name: Перезагрузить Nginx
ansible.builtin.service:
name: nginx
state: reloadedШаблон Jinja2
Файл roles/web/templates/site.conf.j2:
server {
listen 80;
listen [::]:80;
server_name {{ web_domain }};
root {{ web_root }};
index index.html;
location / {
try_files $uri $uri/ =404;
}
}Основной плейбук
Файл site.yml в корне проекта:
---
- name: Настроить веб-серверы
hosts: web
become: true
roles:
- webЗащита секретов с помощью Ansible Vault
Разделите обычные переменные и зашифрованные. Файл group_vars/web/vars.yml остаётся читаемым и ссылается на секрет:
---
app_token: "{{ vault_app_token }}"Создайте зашифрованный файл. Задайте надёжный пароль, когда команда его запросит:
EDITOR=nano ansible-vault create group_vars/web/vault.ymlЗапишите в него секрет:
---
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.