Provision
—— XP

Миссия: репозиторий, который можно передать

практика~40 минут+375 XP

Репозиторий, который понимает только его автор, — это не инфраструктура, а личный блокнот. Задача миссии — довести ~/infra до состояния, когда его можно отдать коллеге: он откроет README, поймёт, что где лежит, а в runbook найдёт, что делать ночью, когда сайт лёг.

Команд здесь почти нет: каждая уже встречалась в разделе. Если что-то не получается, git status подскажет, где ты.

Требования

Всё делается через ветку, как в команде, хотя ревьюера пока нет.

Что должно получиться
Ветка под задачу
Работа идёт в ветке feature/handover, а не прямо в main.
README
Что лежит в репозитории: каталог nginx с двумя сайтами, .env.example и зачем он нужен.
Runbook
docs/runbook.md: порядок быстрой отладки nginx из урока «Инструменты» прошлого раздела, с nginx -t.
Маленькие коммиты
README и runbook — разными коммитами; в сообщении первого есть слово README.
Слияние
Ветка влита в main и удалена.
Версия
Тег v1.1.0 с описанием на последнем коммите main после слияния. v1.0.0 мог остаться от урока про теги, поэтому версия следующая.
Сервер
main и тег отправлены в ~/git-server/infra.git.
Чистота
Ни .env, ни *.log в репозитории; git status чист.

Подсказка 1. Начать с ветки

Сначала убедись, что main свежий и чистый: git status, затем git pull. Ветку создаёт git switch -c с именем.

Подсказка 2. Runbook

Runbook — инструкция дежурному, короткая и по шагам. Начать можно так, дальше допиши сам: что делать при 502, 403 и 504, по уроку про логи.

nano docs/runbook.md, начало
# Runbook стенда

## Сайт не открывается
1. systemctl status nginx
2. sudo nginx -t
3. sudo tail -n 20 /var/log/nginx/error.log

Каталог docs создай заранее через mkdir -p. Хороший образец того, как пишут runbook, — разделы «Troubleshooting» в документации популярных проектов: коротко, по симптомам, с командой на каждый шаг.

Подсказка 3. Тег и отправка

Тег ставится после слияния, стоя на main, — тогда он указывает на итоговый коммит. Отправить нужно две вещи: ветку и тег.

ubuntu@stand:~$
git push                   # ветка main
git push origin v1.1.0     # тег, обычный push его не берёт

Проверить, что тег дошёл, можно командой git ls-remote --tags origin: флаг --tags просит у сервера список его тегов.

Если что-то не сходится

rejected при push — на сервере есть коммиты, которых нет у тебя: сначала git pull, потом снова git push. Тег оказался не на том коммите — удали его git tag -d v1.1.0 и поставь заново, пока он не отправлен. В git status висит .env — проверь .gitignore.

Как это решал бы инженер

Разбор откроется, когда миссию примут: сначала проведи правку через весь цикл сам.

Решение откроется после сдачи.

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

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

  • Что должно быть в README инфраструктурного репозитория?
    Что в нём лежит и где, как это применить, какие переменные нужно заполнить и где взять секреты. Цель — чтобы новый человек поднял систему без автора.
  • Зачем помечать версию тегом, если есть хеш коммита?
    Тег — понятное людям имя, по которому CI/CD собирает релиз и по которому откатываются. Хеш запомнить и назвать в разговоре невозможно.
Практика 07+375 XP

Самостоятельно провести правку через весь цикл Git: ветка, коммиты, слияние в main, тег версии и push вместе с тегом — без секретов и мусора в репозитории.

  • main совпадает с сервером
  • Тег версии создан с описанием
  • Тег отправлен на сервер
  • Есть README
  • README добавлен отдельным коммитом
  • Есть runbook дежурного
  • В runbook есть быстрая отладка nginx
  • Секретов в репозитории нет
  • Ветка задачи слита и удалена
Команда сдачи — выполни на своей машине
команда
cd ~/infra; git status -sb; git branch; git tag -n; git ls-remote --tags origin; git ls-files; git log --oneline -5; head -12 docs/runbook.md

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