Provision
—— XP

Практика: машина для опытов и первые команды

практика~30 минут+550 XP

Учиться настраивать машины лучше на машине, которую не жалко. Вторую виртуалку поднимать не будем: цель для Ansible сделаем контейнером с SSH внутри. Для Ansible он похож на сервер — тот же SSH, тот же Python, тот же apt. Но отличия есть, и о них честно: внутри нет systemd, поэтому службы запускаются старыми скриптами из /etc/init.d; файл /etc/hosts Docker подкладывает снаружи, и заменить его целиком нельзя; файрвол ufw в контейнере не работает. Всё, что мы будем делать, на настоящем сервере выглядит так же, а где разница важна — скажем.

Работать будем в репозитории ~/infra, в новом каталоге ansible: описание машин — такой же код, как всё остальное.

Шаг 1. Поставить Ansible

Ansible ставится только на управляющую машину — у нас это стенд. Пакет из Ubuntu уже содержит популярные коллекции модулей.

ubuntu@stand:~$
sudo apt install -y ansible
ubuntu@stand:~$
ansible --version | head -2
ubuntu@stand:~$
ansible [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 — имя файла.

ubuntu@stand:~$
ssh-keygen -t ed25519 -N '' -f ~/.ssh/ansible_lab
ubuntu@stand:~$
Your 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 внутри.

ubuntu@stand:~$
mkdir -p ~/infra/ansible/target
cd ~/infra/ansible/target
cp ~/.ssh/ansible_lab.pub key.pub

Шаг 4. Dockerfile цели

Минимум, который Ansible требует от машины: SSH-сервер, Python и sudo.

nano ~/infra/ansible/target/Dockerfile
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 задаёт имя образа.

ubuntu@stand:~$
docker build -t target .
ubuntu@stand:~$
 => exporting to image
 => => naming to docker.io/library/target:latest

Запускаем: -d — в фоне, --name — имя контейнера, -p — порт 22 контейнера наружу как 2222, но только на петле 127.0.0.1.

ubuntu@stand:~$
docker run -d --name target -p 127.0.0.1:2222:22 target
ubuntu@stand:~$
docker ps --filter name=target
ubuntu@stand:~$
CONTAINER ID   IMAGE    STATUS          PORTS
5e8b1c2d9a07   target   Up 10 seconds   127.0.0.1:2222->22/tcp

Флаг --filter оставляет только наш контейнер. Up и проброшенный порт — цель готова.

Шаг 6. Первый вход руками

Прежде чем звать Ansible, войдём сами. Это заодно сохранит отпечаток машины в known_hosts. Флаг -i — какой ключ, -p — порт.

ubuntu@stand:~$
ssh -i ~/.ssh/ansible_lab -p 2222 ansible@127.0.0.1 hostname
ubuntu@stand:~$
The 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.

ubuntu@stand:~$
cd ~/infra/ansible
nano ~/infra/ansible/inventory.ini
[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.

nano ~/infra/ansible/ansible.cfg
[defaults]
inventory = inventory.ini

Ansible найдёт этот файл, только если ты запускаешь команды из ~/infra/ansible. Запомни это — половина вопросов «почему он не видит мои машины» отсюда.

Шаг 9. Проверить связь

Первая ad-hoc команда — модуль ping на всех машинах. Флаг -m выбирает модуль.

ubuntu@stand:~$
ansible all -m ping
ubuntu@stand:~$
target | 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. Посмотрим, сколько места на диске машины.

ubuntu@stand:~$
ansible all -m command -a 'df -h /'
ubuntu@stand:~$
target | CHANGED | rc=0 >>
Filesystem      Size  Used Avail Use% Mounted on
overlay          59G   21G   36G  37% /

rc=0 — код возврата команды. Обрати внимание на CHANGED: command не знает, поменял он что-то или нет, и на всякий случай всегда говорит «поменял». Для разовых вопросов это неважно, для настройки — важно очень.

Шаг 11. Поставить пакет

Теперь модуль, который знает состояние. Флаг -b выполняет от root через sudo.

ubuntu@stand:~$
ansible all -b -m apt -a 'name=curl state=present'
ubuntu@stand:~$
target | CHANGED => {
    "changed": true,
    "stdout": "...Setting up curl (8.5.0-2ubuntu10.6) ..."
}

state=present — «пакет должен быть». Его не было — модуль поставил, отсюда CHANGED. Выполни ту же команду ещё раз:

ubuntu@stand:~$
ansible all -b -m apt -a 'name=curl state=present'
ubuntu@stand:~$
target | SUCCESS => {
    "cache_update_time": 1790933331,
    "cache_updated": false,
    "changed": false
}

"changed": false — пакет уже стоит, модуль ничего не делал. Это свойство называется идемпотентностью, и ради него Ansible и берут.

Шаг 12. Факты

Перед работой Ansible собирает факты о машине. Модуль setup их показывает, параметр filter оставляет только нужные.

ubuntu@stand:~$
ansible all -m setup -a 'filter=ansible_distribution*'
ubuntu@stand:~$
target | SUCCESS => {
    "ansible_facts": {
        "ansible_distribution": "Ubuntu",
        "ansible_distribution_version": "24.04"
    }
}

Эти значения можно использовать в описаниях: «если Ubuntu — ставь так». Сейчас достаточно знать, что они есть.

Шаг 13. Сдать

Выполни команду сдачи из блока ниже. Она проверит связь, повторит установку curl и покажет инвентарь.

Практика 01+550 XP

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

  • Ansible достучался до машины
  • Повторная установка ничего не меняет
  • Инвентарь описан
Команда сдачи — выполни на своей машине
команда
cd ~/infra/ansible; ansible all -m ping; ansible all -b -m apt -a 'name=curl state=present'; cat inventory.ini

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.