Docker Compose: запускаем первое приложение

🧭 Отправная точка

Сервис заметок на FastAPI работает на компьютере разработчика и сохраняет данные в PostgreSQL. После переноса API в контейнер подключение к базе перестаёт работать. Причина может быть в адресе: localhost внутри контейнера указывает на сам контейнер, а PostgreSQL запущен отдельно.

При совместном запуске сервисов возникают и другие вопросы. База может быть запущена, но ещё не готова принимать соединения. После удаления контейнера могут исчезнуть записи, если не настроено постоянное хранение. Docker Compose помогает управлять этими сервисами, а для диагностики нужно понимать, как устроены сеть, порты, проверки готовности и тома.

На курсе вы создадите два небольших приложения. Сервис заметок на FastAPI с PostgreSQL соберёте поэтапно вместе с учебными материалами. Затем самостоятельно разработаете HTTP-счётчик на FastAPI с Redis и примените те же принципы к другому хранилищу.

🎯 Цель курса — научиться собирать и запускать Python-приложения с зависимостями через Docker Compose, сохранять данные при пересоздании контейнеров и находить причины типичных ошибок подключения.

⚙️ Что вы будете делать

• 📦 Собирать и запускать контейнеры. Создадите Dockerfile для FastAPI, соберёте образ и запустите HTTP-сервис. Разберётесь, чем образ отличается от контейнера, как работает процесс внутри него и зачем различать внутренний и опубликованный порты.

• 🔗 Настраивать взаимодействие сервисов. Опишете запуск FastAPI и PostgreSQL в Docker Compose, настроите переменные окружения, имена сервисов и сеть. Проверите доступ к базе по имени сервиса и научитесь отличать запуск контейнера от готовности приложения принимать запросы.

• 💾 Сохранять данные. Подключите именованный том к PostgreSQL и проверите, что заметки остаются после штатного удаления и повторного создания контейнеров. Для самостоятельного счётчика настроите Redis, журнал AOF и том, затем сравните значения до и после повторного запуска проекта.

• 🔎 Находить и исправлять ошибки. Научитесь использовать docker compose config, ps и logs, проверять сетевые настройки, состояние хранилища и HTTP-ответы. В итоговой практике восстановите подключение FastAPI к Redis после контролируемой ошибки в конфигурации.

🔥 Чем отличается курс

Программа построена вокруг двух приложений с понятным поведением. Сначала вы запустите сервис заметок без контейнеров, затем добавите Dockerfile, PostgreSQL и Compose. Во втором проекте самостоятельно создадите счётчик, перенесёте хранение значения из памяти приложения в Redis и настроите совместный запуск.

Каждый этап можно проверить обычным HTTP-запросом. Например, запущенный контейнер ещё не подтверждает, что API может подключиться к базе. Вы сравните состояние сервисов, результаты проверок готовности и ответы приложения, чтобы определить, где возникла проблема.

Сохранность данных тоже проверяется на практике. Для PostgreSQL вы сравните заметки до и после пересоздания контейнеров. Для Redis настроите запись изменений в AOF и убедитесь, что счётчик сохранил значение при штатном docker compose down и последующем up с тем же именованным томом. Удаление тома и внезапная потеря питания в этот опыт не входят.

Для самостоятельной диагностики вы будете сопоставлять конфигурацию Compose с состоянием контейнеров и журналами. После исправления повторите исходный HTTP-запрос и проверите, что данные остались прежними. Так результат можно подтвердить наблюдаемым поведением приложения.

📚 Дополнительные бесплатные материалы

• 📄 Docker Compose: что это, как работает и как запустить приложение
• 📄 Команды Docker Compose: up, down, build, logs, exec — шпаргалка
• 📄 Kubernetes с нуля: Pod, Deployment, Service и Ingress
• 📄 Readiness и Liveness Probes в Kubernetes: почему их путают

🎯 Итоговый проект

К завершению курса у вас будут два локальных Compose-проекта: сервис заметок с PostgreSQL и HTTP-счётчик с Redis. Для каждого подготовите Dockerfile и конфигурацию запуска, проверите взаимодействие контейнеров и хранение данных.

В финальном задании подключение счётчика к Redis будет нарушено. Вы воспроизведёте ошибку через HTTP, изучите настройки и журналы, найдёте причину и исправите конфигурацию API. Redis, его том и сохранённое значение при этом должны остаться без изменений.

Затем повторите тот же HTTP-запрос, получите исходное значение счётчика и убедитесь, что приложение снова работает с Redis. Сохраните исправленную конфигурацию в собственном Git-репозитории.

Курс бесплатный, задания проверяются самостоятельно. В результате у вас останутся два работающих приложения и практический опыт запуска, хранения данных и диагностики Docker Compose.

🧪 Поддержка

🧪 Самопроверка вместо ожидания ручной рецензии. Вы сверяете результат по критериям задания, ответам и предусмотренным в курсе локальным проверкам. Разборы самостоятельных упражнений доступны там, где они предусмотрены программой.

Индивидуальная проверка работ преподавателем и персональные консультации в этом курсе не предусмотрены. Формат рассчитан на самостоятельное прохождение.

🚀 О XNova

XNova — практические курсы и учебные проекты для разработчиков, тестировщиков и инженеров. Мы разбираем технологии на работающих примерах: с кодом, наблюдаемым результатом и объяснением инженерных решений.

🔗 xnova.dev — другие курсы и материалы XNova.

📬 Контакты и сообщество

Продолжить знакомство с XNova, следить за новыми материалами или задать организационный вопрос можно здесь:

• 📣 Telegram-канал: @xnova_dev — анонсы курсов, статьи и новости проекта.
• 💬 Написать XNova: @xnova_contact — контакт для вопросов о курсах и проекте.
• ✉️ Почта: contact@xnova.dev — если удобнее написать письмом.
• 💻 GitHub: xnova-tech — открытые учебные проекты и примеры.