Provision
—— XP

Документация на отдельном порту

задание · средний+300 XP бонус

Команда пишет внутреннюю документацию в обычных HTML-файлах и просит: «Подними нам её где-нибудь на стенде, только не трогай основной сайт». Основной сайт уже живёт на порту 80, и смешивать с ним чужие страницы не хочется: правка одного не должна ронять другое.

Самый простой способ развести их — отдельный порт. У nginx на это есть отдельный server-блок: свой listen, свой каталог с файлами, свой файл конфигурации. Такую же раскладку ты увидишь на любом сервере, где nginx обслуживает несколько сайтов.

Условие

Файлы документации лежат в /var/www/docs. Нужно:

  • Отдать их через nginx на порту 8088.
  • Описать сайт отдельным server-блоком в своём файле в /etc/nginx/sites-available, включённом ссылкой в sites-enabled. Файлы default и provision не трогать.
  • http://localhost:8088/ отдаёт главную страницу, а несуществующий путь — ответ 404.
  • Конфигурация проходит nginx -t, и nginx работает с новой версией.

Пригодятся nano, ln -s, nginx -t, systemctl reload и curl — всё из урока про конфигурацию и первой практики раздела.

Подготовка

Подготовка создаёт каталог документации с одной страницей. Каталог принадлежит root, поэтому все команды через sudo.

подготовка, шаг 1скрипт подготовки, выполняется целиком
sudo mkdir -p /var/www/docs
sudo nano /var/www/docs/index.html

Вставь в файл одну строку и сохрани.

/var/www/docs/index.htmlскрипт подготовки, выполняется целиком
<h1>Provision docs</h1>

Как понять, что готово

curl -s http://localhost:8088/ печатает <h1>Provision docs</h1>, а curl -sI по любому выдуманному пути — HTTP/1.1 404 Not Found. Основной сайт на порту 80 отвечает как раньше.

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

Разбор откроется, когда сдачу примут.

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

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

Сдача задания+300 XP

Добавить в nginx новый сайт с нуля: свой файл в sites-available, ссылка в sites-enabled, listen, root, проверка и перечитывание конфигурации.

  • Конфигурация проходит проверку
  • nginx слушает порт 8088
  • Сайт описан в своём файле
  • Корень сайта — /var/www/docs
  • Главная страница отдаётся
  • Несуществующая страница отвечает 404
Команда сдачи — выполни на своей машине
команда
sudo nginx -t 2>&1 | tail -1; ss -tln | grep 8088; grep -l 8088 /etc/nginx/sites-enabled/*; sudo nginx -T 2>/dev/null | grep -E 'root +/var/www/docs'; curl -s http://localhost:8088/; curl -sI http://localhost:8088/net-takogo | head -1