Provision
—— XP

План по этапам

теория~8 минут+300 XP

Самый частый способ застрять в итоговом проекте — начать со всего сразу: поднимать сервер, параллельно писать конвейер и мониторинг, а через месяц так и не понять, почему ничего не работает целиком. Без порядка проект превращается в месяц правок без конца; с порядком это два-три выходных.

План проекта — список этапов, где у каждого есть понятный результат и способ его проверить. Этапы идут не в случайном порядке, а как работы в ремонте, где плитку не кладут до проводки: каждый следующий опирается на предыдущий. Конвейеру нужен сервер, куда выкатывать, мониторингу — сервис, за которым смотреть, учебному инциденту — мониторинг, который его поймает. Зато на каждом шаге у тебя есть что-то работающее, и если сломалось — ты точно знаешь, на каком шаге.

Восемь этапов и девятый

Порядок ниже выстроен так, чтобы каждый этап опирался только на уже сделанное. Время — честная оценка для человека, который прошёл курс, с поиском опечаток и одной-двумя граблями на этап.

ЭтапРезультатВремя
1. КаркасРепозиторий, раскладка каталогов, пустой README30 мин
2. Машины и настройкаДве машины из Terraform, настроенные Ansible2–3 ч
3. Приложение за nginxСайт по HTTPS, база внутри, всё через Compose2 ч
4. GitLab и конвейерКоммит доезжает до сервера сам3 ч
5. Мониторинг и журналыПанели, оповещение получателю, поиск по логам3 ч
6. БэкапКопия по расписанию на другой машине, проверенное восстановление1,5 ч
7. Учебный инцидентПойманная по алерту авария и её разбор1,5 ч
8. ПортфолиоREADME, схема, рассказ о проекте1–2 ч
9. По желанию: k3sТо же приложение в кластере: свой чарт, вход по HTTPS, Argo CD3–4 ч

Разберём одну строку, чтобы было понятно, как читать остальные. Этап 4 стоит после третьего не случайно: конвейер автоматизирует выкат, который ты уже один раз сделал руками на третьем этапе. Если поменять их местами, падающий конвейер будет прятать от тебя ошибку в конфиге nginx за чужим логом раннера.

Этапы 5 и 6 можно менять местами — они не зависят друг от друга. А седьмой без пятого невозможен: инцидент ловится по алерту, и если алерта нет, ловить нечем. Девятый идёт последним и по желанию: Kubernetes добавляет движущихся частей, и разбираться с ним стоит, когда всё остальное уже работает.

Сложи часы: выходит 14–16 часов у того, кто прошёл курс, то есть два-три выходных. Если ты новичок и ещё ищешь опечатки в YAML подолгу, смело умножай на полтора.

Ещё одно предупреждение заранее. Практики финала устроены иначе, чем раньше: шаг здесь крупнее и часто звучит как «сделай как в разделе 13». Это не небрежность, а проверка: ты делаешь знакомое сам, а урок напоминает только новое. Застрял на шаге — открой тот раздел, на который он ссылается.

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

Где пишется каждый файл

У проекта три машины: рабочая и две новые. Если писать файлы то там, то тут, через неделю половина окажется не в репозитории, и конвейер не соберётся. Поэтому правило одно на весь проект.

Все файлы пишутся на рабочей машине, в ~/final, и там же коммитятся. На машины проекта они попадают копией через rsync — программу, которая копирует каталог по SSH и при повторе передаёт только изменённое. На final-app и final-ops ты только запускаешь команды: docker compose up, systemctl, проверки. Руками там ничего не редактируешь.

Копия каталога целиком выглядит так:

ubuntu@stand:~$
rsync -a ~/final/ final-app:final/

Флаг -a сохраняет права, время и вложенные каталоги. Косая черта после ~/final/ значит «содержимое каталога». Команда молчит, если всё прошло хорошо. Файл .env с паролем она тоже везёт: в git он не попадает, а на машине нужен.

Один репозиторий на всё

Всё, что описывает систему, живёт в одном репозитории ~/final. Так делают в небольших командах, когда инфраструктура одна и меняют её одни и те же люди. Каталоги делят его по инструментам, как ты привык в курсе:

  ~/final
  ├── README.md        что это, схема, как поднять
  ├── terraform/       машины, сеть, правила доступа
  ├── ansible/         пользователи, SSH, Docker, nginx
  ├── app/             Dockerfile приложения
  ├── deploy/          compose.yaml для final-app
  ├── ops/             GitLab и мониторинг для final-ops
  ├── backup/          скрипт копии и таймер
  ├── docs/            схема, решения, постмортем
  └── .gitlab-ci.yml   конвейер

Одно исключение появится только в девятом этапе: описание кластера по правилам GitOps живёт в отдельном репозитории final-deploy, о причинах — в уроке раздела 18.

Граница между terraform/ и ansible/ та же, что в разделах про них: Terraform создаёт машины, Ansible решает, что на них стоит. Перепутать легко — оба «про инфраструктуру», — но если Terraform начинает ставить пакеты, а Ansible создавать машины, через неделю никто не скажет, что где описано.

Первое, что попадает в репозиторий, — файл .gitignore. В нём пять строк: четыре не пускают в историю секреты, одна — сотни мегабайт скачанного.

  *.tfstate*        состояние Terraform: внутри адреса и пароли
  .terraform/       скачанные провайдеры, сотни мегабайт
  *.tfvars          значения переменных, например номер каталога облака
  .env              пароль базы для ручного запуска
  *.key             закрытый ключ сертификата сайта

Это то самое правило из раздела про Git: то, что однажды попало в историю, оттуда уже не вычистить простым удалением. Раскладка отвечает на вопрос «где лежит», но не на вопрос «почему так» — а именно его тебе зададут на собеседовании.

Журнал решений

В проекте будет десяток мест, где ты выберешь одно из двух: GitLab по HTTP или по HTTPS, shell-исполнитель раннера или Docker, свой реестр образов или встроенный в GitLab. Сейчас ты помнишь, почему выбрал. Через месяц на собеседовании — уже нет.

Поэтому заводится файл docs/decisions.md, и каждое решение записывается в нём тремя строками: что выбрал, из чего выбирал, почему. Это лёгкая версия того, что в командах называют записью архитектурного решения.

  ## Раннер — shell-исполнитель на final-app
  Из чего: shell или docker
  Почему: выкат идёт на ту же машину, docker внутри
          docker не нужен; цена — раннер видит всю машину

Так же записывается и самое заметное решение проекта. В разделе 12 выкат запускали кнопкой, а здесь он пойдёт сам по каждому коммиту в основную ветку:

  ## Выкат без кнопки
  Из чего: when: manual, как в разделе 12, или сразу по коммиту
  Почему: стенд один, пользователь один, проверять перед
          выкатом некому; цена — сломанный коммит сразу на сервере,
          поэтому дымовая проверка и откат кнопкой Rollback

Выкат по кнопке называют непрерывной поставкой: версия готова, решение принимает человек. Выкат сам по коммиту — непрерывным развёртыванием. В команде с живыми пользователями обычно выбирают первое; у тебя один стенд, и второе честно экономит время.

Обрати внимание на слово «цена». Решения без минусов не бывает, и честно записанный минус — лучший ответ на вопрос интервьюера «а почему не иначе?». Об этом подробнее в уроке про портфолио.

Словарь урока

Этап
Кусок работы с понятным результатом и способом его проверить. Заканчивается коммитом. ↩ к тексту
Журнал решений
Файл, где записано, что выбрано, из чего и почему. Помнит то, что забудешь ты.
Монорепозиторий
Один репозиторий на всю систему: код, инфраструктура, конвейер. Удобен, пока систему меняют одни и те же люди.

Что спросят на собеседовании

  • Почему вы выбрали именно этот инструмент?
    Отвечать из журнала решений: из чего выбирал, почему этот и какая у выбора цена. Ответ «так было в курсе» — слабый, ответ с ценой — сильный.
  • Как вы организуете репозиторий инфраструктуры?
    Каталоги по инструментам, секреты и состояние Terraform в .gitignore, README с тем, как поднять систему с нуля. Каждое изменение — коммит с понятным сообщением.

Что дальше

План есть, дальше — первые два этапа сразу: каркас репозитория, две машины из Terraform и их настройка Ansible.

Проверь себя+300 XPдве попытки
1
Один репозиторий
Что лежит в каталоге ansible итогового репозитория?
2
Этап заканчивается проверкой
Чем заканчивается каждый этап проекта?
3
Журнал решений
Зачем вести журнал решений в docs/decisions.md?
4
Где пишется файл
Где в итоговом проекте пишутся файлы настроек?
ответь на все вопросы, чтобы проверить

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