Учиться настраивать машины лучше на машине, которую не жалко. Вторую виртуалку поднимать не будем: цель для Ansible сделаем контейнером с SSH внутри. Для Ansible он похож на сервер — тот же SSH, тот же Python, тот же apt. Но отличия есть, и о них честно: внутри нет systemd, поэтому службы запускаются старыми скриптами из /etc/init.d; файл /etc/hosts Docker подкладывает снаружи, и заменить его целиком нельзя; файрвол ufw в контейнере не работает. Всё, что мы будем делать, на настоящем сервере выглядит так же, а где разница важна — скажем.
Работать будем в репозитории ~/infra, в новом каталоге ansible: описание машин — такой же код, как всё остальное.
Шаг 1. Поставить Ansible
Ansible ставится только на управляющую машину — у нас это стенд. Пакет из Ubuntu уже содержит популярные коллекции модулей.
sudo apt install -y ansibleansible --version | head -2ansible [core 2.16.3] config file = None
core 2.16.3 — версия ядра Ansible. config file = None — ansible.cfg пока не найден: мы его ещё не написали.
Ядро 2.16 из Ubuntu 24.04 уже старое: его поддержка у разработчиков закончилась в мае 2025 года. Для всего, что есть в курсе, его хватает, а на работе обычно ставят свежую версию программой pipx — она держит Ansible в отдельном каталоге и не мешает системному Python. Это одна команда, pipx install --include-deps ansible, когда понадобится.
Шаг 2. Ключ для Ansible
Ansible входит по SSH, значит, ему нужен ключ. Сделаем отдельный: -t — тип ключа, -N '' — без пароля, -f — имя файла.
ssh-keygen -t ed25519 -N '' -f ~/.ssh/ansible_labYour identification has been saved in /home/anton/.ssh/ansible_lab Your public key has been saved in /home/anton/.ssh/ansible_lab.pub
Шаг 3. Каталог цели
Цель соберём из Dockerfile, как в разделе 07. Рядом положим открытый ключ — он станет authorized_keys внутри.
mkdir -p ~/infra/ansible/target cd ~/infra/ansible/target cp ~/.ssh/ansible_lab.pub key.pub
Шаг 4. Dockerfile цели
Минимум, который Ansible требует от машины: SSH-сервер, Python и sudo.
FROM ubuntu:24.04 RUN apt-get update && apt-get install -y openssh-server python3 sudo RUN useradd -m -s /bin/bash -G sudo ansible RUN echo 'ansible ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/ansible RUN install -d -m 700 -o ansible -g ansible /home/ansible/.ssh COPY --chown=ansible --chmod=600 key.pub /home/ansible/.ssh/authorized_keys RUN mkdir /run/sshd CMD ["/usr/sbin/sshd", "-D", "-e"]
Вторая строка ставит SSH, Python и sudo. Третья заводит пользователя ansible в группе sudo, четвёртая разрешает ему sudo без пароля — Ansible не умеет вводить пароль на каждый шаг. Пятая создаёт каталог .ssh с правами 700 и владельцем ansible, а COPY кладёт в него ключ с правами 600.
Почему каталог отдельной строкой: если его нет, COPY создаст его сам и выдаст ему те же права 600, что и файлу. У каталога без права x в него нельзя войти, и SSH-сервер не прочитает ключ: вход оборвётся с Permission denied (publickey), а в docker logs target будет Could not open user 'ansible' authorized keys … Permission denied. Последняя строка запускает SSH-сервер на переднем плане, как главный процесс контейнера.
Шаг 5. Собрать и запустить
Собираем образ с именем target. Флаг -t задаёт имя образа.
docker build -t target .=> exporting to image => => naming to docker.io/library/target:latest
Запускаем: -d — в фоне, --name — имя контейнера, -p — порт 22 контейнера наружу как 2222, но только на петле 127.0.0.1.
docker run -d --name target -p 127.0.0.1:2222:22 targetdocker ps --filter name=targetCONTAINER ID IMAGE STATUS PORTS 5e8b1c2d9a07 target Up 10 seconds 127.0.0.1:2222->22/tcp
Флаг --filter оставляет только наш контейнер. Up и проброшенный порт — цель готова.
Шаг 6. Первый вход руками
Прежде чем звать Ansible, войдём сами. Это заодно сохранит отпечаток машины в known_hosts. Флаг -i — какой ключ, -p — порт.
ssh -i ~/.ssh/ansible_lab -p 2222 ansible@127.0.0.1 hostnameThe authenticity of host '[127.0.0.1]:2222' can't be established. Are you sure you want to continue connecting (yes/no)? yes 5e8b1c2d9a07
Ответь yes. Последняя строка — имя машины, оно совпадает с ID контейнера. Вход работает.
Шаг 7. Инвентарь
Описываем машину для Ansible.
cd ~/infra/ansible[lab] target ansible_host=127.0.0.1 ansible_port=2222 [lab:vars] ansible_user=ansible ansible_ssh_private_key_file=~/.ssh/ansible_lab
Шаг 8. Файл настроек
Чтобы не писать путь к инвентарю в каждой команде, кладём рядом ansible.cfg.
[defaults] inventory = inventory.ini
Ansible найдёт этот файл, только если ты запускаешь команды из ~/infra/ansible. Запомни это — половина вопросов «почему он не видит мои машины» отсюда.
Шаг 9. Проверить связь
Первая ad-hoc команда — модуль ping на всех машинах. Флаг -m выбирает модуль.
ansible all -m pingtarget | SUCCESS => { "ansible_facts": { "discovered_interpreter_python": "/usr/bin/python3" }, "changed": false, "ping": "pong" }
SUCCESS и pong — Ansible вошёл по SSH и запустил там Python. Блок ansible_facts сообщает, какой Python он нашёл на машине; дальше в выводах мы будем его опускать. Если видишь UNREACHABLE — не та комбинация порта, ключа и пользователя: сверь с шагом 6.
Шаг 10. Выполнить команду
Модуль command выполняет произвольную команду; параметры передаёт флаг -a. Посмотрим, сколько места на диске машины.
ansible all -m command -a 'df -h /'target | CHANGED | rc=0 >> Filesystem Size Used Avail Use% Mounted on overlay 59G 21G 36G 37% /
rc=0 — код возврата команды. Обрати внимание на CHANGED: command не знает, поменял он что-то или нет, и на всякий случай всегда говорит «поменял». Для разовых вопросов это неважно, для настройки — важно очень.
Шаг 11. Поставить пакет
Теперь модуль, который знает состояние. Флаг -b выполняет от root через sudo.
ansible all -b -m apt -a 'name=curl state=present'target | CHANGED => { "changed": true, "stdout": "...Setting up curl (8.5.0-2ubuntu10.6) ..." }
state=present — «пакет должен быть». Его не было — модуль поставил, отсюда CHANGED. Выполни ту же команду ещё раз:
ansible all -b -m apt -a 'name=curl state=present'target | SUCCESS => { "cache_update_time": 1790933331, "cache_updated": false, "changed": false }
"changed": false — пакет уже стоит, модуль ничего не делал. Это свойство называется идемпотентностью, и ради него Ansible и берут.
Шаг 12. Факты
Перед работой Ansible собирает факты о машине. Модуль setup их показывает, параметр filter оставляет только нужные.
ansible all -m setup -a 'filter=ansible_distribution*'target | SUCCESS => { "ansible_facts": { "ansible_distribution": "Ubuntu", "ansible_distribution_version": "24.04" } }
Эти значения можно использовать в описаниях: «если Ubuntu — ставь так». Сейчас достаточно знать, что они есть.
Шаг 13. Сдать
Выполни команду сдачи из блока ниже. Она проверит связь, повторит установку curl и покажет инвентарь.