Provision
—— XP

Проект в портфолио и рассказ о нём

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

Авторы на Хабре, которые рассказывают о поиске работы DevOps, сходятся в одном: выложенный пет-проект с автоматизацией выката заметно сильнее строчки «прошёл курс». Но только если его можно понять, не созваниваясь с автором. Работающая система, о которой знаешь только ты, ничего не доказывает.

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

README по порядку

Порядок разделов в README подчиняется одной мысли: читатель уходит в любой момент, поэтому самое важное — сверху. Каркас, который работает:

  # final — сервис с выкатом по коммиту и наблюдением
  одна фраза: что это и зачем
  схема

  ## Как устроено        путь запроса и путь изменения
  ## Как поднять с нуля  terraform, ansible, git push
  ## Выкат и откат       что происходит после push, время отката
  ## Наблюдение          панели, алерты, время обнаружения
  ## Бэкап               расписание, где копии, время восстановления
  ## Чего намеренно нет  и почему
  ## Разборы и решения   ссылки на docs/

Разберём один раздел — «Чего намеренно нет». Туда пишется: одна машина приложения без реплики, GitLab по HTTP в закрытой сети, реестр образов без авторизации, выкат без кнопки. Каждый пункт с причиной. Это самый недооценённый раздел: он показывает, что ты знаешь пределы своей системы, — а это как раз то, что отличает инженера от человека, повторившего инструкцию.

Цифры из прошлых практик — время отката, время обнаружения, время восстановления — тоже идут в README. Цифра «откат за 22 секунды, проверено» стоит больше абзаца прилагательных.

Цифры убеждают того, кто дочитал. А тот, кто открыл README на десять секунд, должен понять систему с одного взгляда — по схеме под первой фразой.

Схема прямо в репозитории

Схему не нужно рисовать в графическом редакторе и прикладывать картинкой: и GitLab, и GitHub умеют рисовать диаграммы Mermaid прямо из текста в README. Текст правится в том же коммите, что и система, и схема не устаревает. Схема пишется в обычный блок кода, у которого после трёх обратных кавычек стоит слово mermaid. Начало выглядит так:

README.md — блок кода с пометкой mermaid
flowchart LR
  user[Пользователь] -->|HTTPS| nginx
  nginx --> app --> db[(PostgreSQL)]
  git[GitLab] -->|конвейер| app
  app -.метрики, журналы.-> ops[Prometheus, Loki]

Стрелка --> — связь, текст между |…| — подпись на стрелке, пунктир -.…-> — поток наблюдения, а не запросов. Две машины удобно обвести рамками через subgraph; синтаксис — в документации Mermaid.

На схеме должно быть видно три вещи: куда идёт запрос пользователя, как туда доезжает изменение и кто за всем этим смотрит. Если по схеме нельзя ответить на вопрос «что будет, если упадёт final-ops?» — на ней чего-то не хватает.

Схема и README пишутся для чужих глаз, а значит, до публикации репозиторий надо проверить на то, что чужим видеть не положено.

Перед публикацией

Твой GitLab на final-ops из интернета не виден, поэтому репозиторий выкладывается копией на GitHub или GitLab.com. В GitLab это делается зеркалом: Settings → Repository → Mirroring repositories, и каждый push уезжает туда сам.

Перед первой публикацией — проверка на секреты по всей истории, а не только по текущим файлам: пароль, удалённый в пятом коммите, лежит в четвёртом. Для этого есть сканер gitleaks:

ubuntu@stand:~$
gitleaks git .
ubuntu@stand:~$
INF 47 commits scanned.
INF no leaks found

Подкоманда git значит «сканировать историю коммитов», точка — текущий репозиторий. Если нашлось — менять секрет, а не только чистить историю: он уже мог утечь.

Ещё два пункта перед публикацией: публичный адрес и ключи. Адреса из частных сетей вроде 10.10.1.11 не опасны, публичные адреса облака лучше заменить. Файлы .env, токен бота и состояние Terraform уже не попали в историю благодаря .gitignore из первой практики — проверка лишь подтверждает это.

Строка в резюме

В резюме проект занимает две-три строки, и написаны они глаголами действия. Автор статьи «Я DevOps, который искал работу» на Хабре (2025) советует ровно это: не «участвовал в настройке CI/CD», а «собрал CI/CD с нуля». Для итогового проекта:

  Пет-проект: сервис с выкатом по коммиту
  · поднял две машины Terraform, настройку описал ролями Ansible
  · развернул свой GitLab, собрал конвейер проверка → сборка → выкат,
    откат кнопкой Rollback за 20 секунд
  · настроил Prometheus, Grafana, Loki и оповещения через Alertmanager
  · бэкап PostgreSQL на вторую машину, восстановление проверено
  · провёл учебную аварию и написал разбор

Каждая строка начинается с глагола и заканчивается проверяемым результатом. И ссылка на репозиторий — первой строкой блока. Если делал девятый этап, добавь строку про k3s, свой чарт и Argo CD — её спросят первой в платформенной команде.

Одно предупреждение. Этот курс проходят и другие люди, и рекрутер, который видел десяток одинаковых блоков, узнает шаблон с первой строки. Пиши своими словами и своими цифрами: что сломалось именно у тебя, сколько длился именно твой откат, что ты добавил сверх курса. Проект, похожий на чужие, — нормально; одинаковый текст — нет.

Рассказ на две минуты

На собеседовании почти всегда звучит «расскажите о своём проекте». Две минуты — это примерно 250 слов, и у хорошего рассказа есть порядок.

Сначала задача, одной фразой: «Хотел собрать сервис так, как его эксплуатируют в небольшой компании: выкат без входа на сервер, наблюдение, бэкап». Затем как устроено — по пути запроса и пути изменения, как на схеме. Потом одна авария: что сломалось, как ты её нашёл и что изменил после. Это самая сильная часть рассказа — именно о реальных случаях с падением сервиса спрашивают интервьюеры в разборах Слёрма о найме джунов. И в конце — чего нет и что сделал бы дальше: реплика базы, HTTPS для GitLab, Vault для секретов.

Рассказ стоит один раз проговорить вслух с секундомером. Первая попытка почти всегда длится пять минут и тонет в подробностях настройки Alloy — их оставь на уточняющие вопросы.

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

Портфолио
Публичный репозиторий с работающим проектом, README и разборами. Доказательство, которое можно отправить ссылкой. ↩ к тексту
Mermaid
Язык диаграмм из текста. GitLab и GitHub рисуют его прямо в README, и схема меняется вместе с кодом. ↩ к тексту
gitleaks
Сканер секретов в истории Git: пароли, токены и ключи во всех коммитах, а не только в текущих файлах. ↩ к тексту
Зеркало репозитория
Копия, которую GitLab сам обновляет после каждого push. Так закрытый репозиторий становится видимым снаружи.

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

  • Что будет, если упадёт машина с мониторингом?
    Приложение продолжит работать, но пропадут оповещения и история метрик за время простоя. Честный ответ — это точка отказа, и лечится она вторым Prometheus или внешней проверкой доступности, которой пока нет.
  • Почему основной выкат на Compose, а не в Kubernetes?
    Для одного сервиса на одной машине Compose проще и прозрачнее; Kubernetes оправдан, когда сервисов и машин много. Если делал девятый этап — показать, что поменялось при переносе: Ingress вместо nginx, Helm-чарт вместо compose.yaml, Argo CD и коммит тега вместо задачи deploy.
  • Где у вас хранятся секреты?
    Пароль базы — в защищённой переменной GitLab, токен бота, если подключён Telegram, — файлом на служебной машине, в репозитории ничего. Следующий шаг — Vault, как в разделе про HashiStack.
  • Что было самым сложным?
    Отвечать конкретным случаем: ошибка, как выглядела, как нашёл, что изменил. Общие слова вроде «было много нового» ничего не говорят.

Что дальше

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

Проверь себя+300 XPдве попытки
1
README
Что должно стоять в README итогового проекта первым?
2
README
Зачем в README раздел «Чего намеренно нет»?
3
Перед публикацией
Почему перед публикацией проверяют всю историю, а не только текущие файлы?
4
Рассказ на две минуты
С чего начинать рассказ о проекте на собеседовании?
ответь на все вопросы, чтобы проверить

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