Bash: обработка текста и скрипты / Ступень 7 из 9 · шаг 7 из 8

Напиши healthcheck по договору

~25 мин

Не запущена Запускается обычно ~20 с

Ситуация

Новую версию приложения выкладка пускает под трафик не сразу: сначала спрашивает скрипт ~/bash-lab/healthcheck.sh, готов ли адрес. Выкладка смотрит на код завершения, дежурный читает строку вывода. Скрипта пока нет — есть заготовка со строкой shebang.

Для проб на машине работает тестовое приложение http://127.0.0.1:8181:

Путь	Ответ
`/ready`	200
`/unready`	503
`/empty`	204
`/redirect`	302 на `/ready`
`/slow`	200, но через 10 секунд

На порту 8182 никто не слушает.

Задача

Допиши ~/bash-lab/healthcheck.sh по договору с выкладкой:

Выкладка запускает скрипт по пути: ~/bash-lab/healthcheck.sh URL.
Сервер ответил 200 — скрипт печатает в stdout строку OK и выходит с кодом 0.
Сервер ответил иначе (503, 204, 302, 404) — FAIL и код 1. За перенаправлением скрипт не идёт.
Сервер не принимает соединение — FAIL и код 1.
Ответа нет 2 секунды — FAIL и код 1; скрипт заканчивается сам не позже чем через 3 секунды.
Без адреса или с двумя аргументами — stdout пуст, в stderr строка Usage: healthcheck.sh URL, код 2.

Когда сервер ответил — с любым кодом, — stderr остаётся пустым: строку там выкладка считает сбоем самой проверки.

Проверка запускает твой скрипт от student на этих адресах и на своих — с другими путями и ответами.

Интернета на машине нет, всё нужное уже установлено.

Цели лабы

0 из 6

~/bash-lab/healthcheck.sh запускается по пути как команда — ещё не проверялась
Ответ 200 — в stdout OK, код 0, stderr пуст — ещё не проверялась
Любой другой ответ сервера — FAIL, код 1, stderr пуст — ещё не проверялась
Сервер не принимает соединение — FAIL, код 1 — ещё не проверялась
Ответа нет 2 секунды — FAIL, код 1, скрипт заканчивается сам за 3 секунды — ещё не проверялась
Без адреса или с двумя аргументами — Usage в stderr, stdout пуст, код 2 — ещё не проверялась

Подсказки

открыто 0 из 3 · открываются по одной

Подсказка 1

Показать решение после 3 неудачных проверок

Для запуска машины нужен вход

Машина запускается на твой аккаунт, там же хранится прогресс. Читать можно без входа.

После входа вернёшься на эту лабу.

Сеть · подобрано по лабе

curl — HTTP-запросы из консоли

Шпаргалка

$_ — вставить в терминал

curl -i http://site.lab.test/ код, заголовки, тело
curl -I http://site.lab.test/ только заголовки (HEAD)
curl -v -o /dev/null http://site.lab.test/ весь обмен
curl -s -o /dev/null -w '%{http_code}\n' http://site.lab.test/
curl -H 'Host: docs.lab.test' http://127.0.0.1/
curl --resolve shop.lab.test:443:127.0.0.1 https://shop.lab.test/
curl --cacert ca.pem https://shop.lab.test/ доверять своему CA
curl --unix-socket /run/app/app.sock http://localhost/
curl -X POST -H 'Content-Type: application/json' -d '{"a":1}' URL

Таблица ниже — основные ключи. -s прячет и прогресс, и ошибки; в скриптах его пишут вместе с -S, чтобы ошибка осталась видна.

Код ответа для проверки

bash

curl -s -o /dev/null -w '%{http_code}\n' http://site.lab.test/
curl -sf -o /dev/null http://site.lab.test/health || echo FAIL

Первая команда печатает код; 000 — ответа HTTP не было. Вторая полагается на код выхода: -f превращает 4xx и 5xx в ошибку 22.

Сайт по имени без DNS

bash

curl -H 'Host: docs.lab.test' http://127.0.0.1/
curl --resolve docs.lab.test:443:127.0.0.1 https://docs.lab.test/

-H 'Host: …' меняет только заголовок — сервер выберет сайт по нему. Для HTTPS нужен --resolve: имя из адреса идёт и в SNI, и в проверку сертификата.

HTTPS со своим CA

bash

curl --cacert ca.pem https://shop.lab.test/
curl -v --cacert ca.pem https://shop.lab.test/ -o /dev/null 2>&1 \
  | grep -E 'subject:|issuer:|expire date|verify'

--cacert добавляет доверенный корень для одного запроса. -v показывает, какой сертификат пришёл и чем закончилась проверка: SSL certificate verify ok. или причина отказа.

Запрос в unix-сокет

bash

curl --unix-socket /run/app/app.sock http://localhost/

Соединение идёт в файл сокета, имя localhost попадает только в Host. Права и ошибки сокетов — unix-sockets.

Данные и заголовки

bash

curl -X POST -d 'a=1&b=2' http://site.lab.test/form
curl -H 'Content-Type: application/json' -d '{"k":"v"}' URL
curl -H 'Authorization: Bearer TOKEN' https://api.lab.test/x
curl -O https://site.lab.test/file.tar.gz     # имя файла из адреса

С -d curl сам выбирает POST, -X POST можно не писать.

curl: (7) Failed to connect … Couldn't connect to server

На адресе и порту никто не слушает или соединение режет файрвол. Проверь sudo ss -tlnp на сервере. С --unix-socket curl пишет то же самое — Failed to connect to localhost port 80 — и когда нет файла, и когда нет прав.

curl: (6) Could not resolve host

Имя не нашлось: опечатка, нет записи в DNS или в /etc/hosts. Проверь getent hosts <имя> (dns-resolv) или обойди DNS через --resolve.

curl: (60) SSL certificate problem

Сертификат не прошёл одну из трёх проверок: доверие (unable to get local issuer certificate, self-signed certificate), имя (no alternative certificate subject name matches) или срок (certificate has expired). Разбор каждой — openssl-tls.

curl: (35) … wrong version number

https:// ушёл на порт, где сервер говорит обычным HTTP. Поправь схему или порт.

Код 0, а сайт отвечает ошибкой

Без -f ответ 404 или 502 — нормальный ответ для curl. В проверках смотри -w '%{http_code}' или добавляй -f.

curl: (52) Empty reply from server

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

-k вместо исправления

-k (--insecure) отключает проверку сертификата целиком. Проверка с -k проходит и при подмене сервера, и при истёкшем сертификате. Нужен свой CA — --cacert.

Пароли в командной строке

-u user:pass и -H 'Authorization: …' видны в истории оболочки и в ps других пользователей. Для скриптов — файл с правами 600 (-K файл или --netrc).