Практика: первый HTTP-образ

Задача QA начинается с ожидаемого поведения. Наш сервер должен принимать GET-запрос на порту 8000 и возвращать код 200, JSON и поле message со значением Hello, Docker!. Регистр букв, запятая и восклицательный знак входят в контракт.

HTTP/1.0 200 OK
Content-Type: application/json

{"message": "Hello, Docker!"}

Готовая заготовка использует BaseHTTPRequestHandler. Словарь преобразуется в JSON, затем в байты; длина рассчитывается после кодирования. Это позволяет указать корректный Content-Length. Основная работа здесь — упаковать существующий обработчик и исправить два намеренных дефекта, а не написать HTTP-протокол с нуля.

Пустой ответ с кодом 200 не удовлетворяет заданию. Так же как правильная строка, возвращённая с ошибкой 500. Проверки разделяют транспорт и содержимое, чтобы вы могли понять, что уже работает.

Dockerfile — текстовый рецепт сборки образа. В первом задании достаточно выбрать Python, назначить рабочую папку, скопировать код, документировать порт и задать команду по умолчанию. Никакие пакеты через pip устанавливать не требуется.

FROM python:3.12-alpine
WORKDIR /app
# Сюда добавьте COPY для app.py
EXPOSE 8000
# Сюда добавьте CMD в форме JSON-массива

WORKDIR /app определяет рабочую папку следующих инструкций и запуска приложения. Если файл находится в /app/app.py, команда python app.py найдёт его оттуда. Для CMD используйте отдельные строки массива для программы и аргумента: Python и имя файла.

Успешная сборка ещё не означает, что приложение запустилось: CMD сохраняет команду для будущего контейнера. Основные инструкции собраны в руководстве Docker по Dockerfile.

В app.py намеренно оставлены сообщение TODO и адрес 127.0.0.1. Первое нарушает контракт ответа. Второе ограничивает сервер loopback-интерфейсом самого контейнера: подключение снаружи не попадёт на него. Для нашей лаборатории нужен адрес прослушивания 0.0.0.0.

HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()

После запуска проверки сначала прочитайте её этап и логи. Ошибка «файл не найден» направляет к COPY, WORKDIR и CMD. Недоступный HTTP-сервис — к адресу и порту. Неверное сообщение — к словарю в обработчике. Меняйте одну причину за раз и запускайте проверку снова.

Для самостоятельного повторения после успешной сборки можно выполнить docker run --rm -p 127.0.0.1:8080:8000 qa-api:v1 и обратиться к http://localhost:8080. В браузерной лаборатории публикацию и запрос выполняет среда курса; открывать такой адрес на своём компьютере не требуется.