Самый частый способ застрять в итоговом проекте — начать со всего сразу: поднимать сервер, параллельно писать конвейер и мониторинг, а через месяц так и не понять, почему ничего не работает целиком. Без порядка проект превращается в месяц правок без конца; с порядком это два-три выходных.
План проекта — список этапов, где у каждого есть понятный результат и способ его проверить. Этапы идут не в случайном порядке, а как работы в ремонте, где плитку не кладут до проводки: каждый следующий опирается на предыдущий. Конвейеру нужен сервер, куда выкатывать, мониторингу — сервис, за которым смотреть, учебному инциденту — мониторинг, который его поймает. Зато на каждом шаге у тебя есть что-то работающее, и если сломалось — ты точно знаешь, на каком шаге.
Восемь этапов и девятый
Порядок ниже выстроен так, чтобы каждый этап опирался только на уже сделанное. Время — честная оценка для человека, который прошёл курс, с поиском опечаток и одной-двумя граблями на этап.
| Этап | Результат | Время |
|---|---|---|
| 1. Каркас | Репозиторий, раскладка каталогов, пустой README | 30 мин |
| 2. Машины и настройка | Две машины из Terraform, настроенные Ansible | 2–3 ч |
| 3. Приложение за nginx | Сайт по HTTPS, база внутри, всё через Compose | 2 ч |
| 4. GitLab и конвейер | Коммит доезжает до сервера сам | 3 ч |
| 5. Мониторинг и журналы | Панели, оповещение получателю, поиск по логам | 3 ч |
| 6. Бэкап | Копия по расписанию на другой машине, проверенное восстановление | 1,5 ч |
| 7. Учебный инцидент | Пойманная по алерту авария и её разбор | 1,5 ч |
| 8. Портфолио | README, схема, рассказ о проекте | 1–2 ч |
| 9. По желанию: k3s | То же приложение в кластере: свой чарт, вход по HTTPS, Argo CD | 3–4 ч |
Разберём одну строку, чтобы было понятно, как читать остальные. Этап 4 стоит после третьего не случайно: конвейер автоматизирует выкат, который ты уже один раз сделал руками на третьем этапе. Если поменять их местами, падающий конвейер будет прятать от тебя ошибку в конфиге nginx за чужим логом раннера.
Этапы 5 и 6 можно менять местами — они не зависят друг от друга. А седьмой без пятого невозможен: инцидент ловится по алерту, и если алерта нет, ловить нечем. Девятый идёт последним и по желанию: Kubernetes добавляет движущихся частей, и разбираться с ним стоит, когда всё остальное уже работает.
Сложи часы: выходит 14–16 часов у того, кто прошёл курс, то есть два-три выходных. Если ты новичок и ещё ищешь опечатки в YAML подолгу, смело умножай на полтора.
Ещё одно предупреждение заранее. Практики финала устроены иначе, чем раньше: шаг здесь крупнее и часто звучит как «сделай как в разделе 13». Это не небрежность, а проверка: ты делаешь знакомое сам, а урок напоминает только новое. Застрял на шаге — открой тот раздел, на который он ссылается.
У финала три машины вместо одной, и самый частый вопрос на этом этапе звучит не «как», а «на какой машине я это пишу».
Где пишется каждый файл
У проекта три машины: рабочая и две новые. Если писать файлы то там, то тут, через неделю половина окажется не в репозитории, и конвейер не соберётся. Поэтому правило одно на весь проект.
Все файлы пишутся на рабочей машине, в ~/final, и там же коммитятся. На машины проекта они попадают копией через rsync — программу, которая копирует каталог по SSH и при повторе передаёт только изменённое. На final-app и final-ops ты только запускаешь команды: docker compose up, systemctl, проверки. Руками там ничего не редактируешь.
Копия каталога целиком выглядит так:
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.