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

Код завершения и healthcheck

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

Шаг 7 из 8 · лаба · 25 мин

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

Выкладке нужен скрипт: готов ли адрес принимать трафик. Ответ — строкой OK или FAIL и кодом завершения, даже когда сервер молчит.

Ситуация

Новую версию приложения выкладка пускает под трафик не сразу: сначала спрашивает скрипт ~/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 — ещё не выполнена

Ctrl+Enter

Запустит машину node1 · Ubuntu 24.04

Машина запускается

Подсказки

0 из 3

Сообщить о проблеме

Цели лабы

0 из 6

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

node1 Ubuntu 24.04

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

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

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

Цели лабы

0 из 6

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

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

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).