Українська
Локальна база даних у Docker
Крок 1. Опис контейнера бази даних
Навіщо. Chatex зберігає дані в PostgreSQL 18. Можна було б встановити PostgreSQL в систему, але для розробки контейнер краще:
- він запускається й зупиняється однією командою і не працює постійно як системна служба;
- кожен розробник має точно ту саму версію й налаштування;
- його можна видалити разом з даними й створити заново за секунди, коли хочеться чистого старту;
- тести (тема 6) використовують той самий образ, тож розробка й тести поводяться однаково.
Docker Compose описує контейнери у файлі YAML, тож налаштування живуть у репозиторії, а не в довгій команді docker run, яку кожен набирає по-своєму.
Що зробити. Створіть compose.yaml у корені репозиторію:
yaml
# Local PostgreSQL for development: docker compose up -d
# Matches the connection string in Source/Chatex.Api/appsettings.Development.json and the dotnet-ef default.
name: chatex
services:
postgres:
image: postgres:18-alpine
environment:
POSTGRES_DB: chatex
POSTGRES_USER: postgres
POSTGRES_PASSWORD: postgres
ports:
- "5432:5432"
volumes:
- postgres-data:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres -d chatex"]
interval: 5s
timeout: 3s
retries: 10
restart: unless-stopped
volumes:
postgres-data:Рядок за рядком:
name: chatex– назва проєкту; Docker додає її як префікс до контейнера й тому (chatex-postgres-1,chatex_postgres-data).image: postgres:18-alpine– офіційний образ PostgreSQL 18, зібраний на невеликому Alpine Linux.environment– під час першого запуску образ створює базу данихchatexі користувачаpostgresіз паролемpostgres. Такий пароль прийнятний лише тому, що контейнер доступний тільки з вашого комп’ютера; робочий сервер (тема 23) отримає справжні секрети.ports: "5432:5432"– порт 5432 вашого комп’ютера веде до порту 5432 контейнера, стандартного порту PostgreSQL.volumes– дані зберігаються в іменованому томі Dockerpostgres-dataпоза контейнером. Зупинка чи навіть видалення контейнера зберігає дані; їх прибирає лише видалення тому.healthcheck– кожні 5 секунд Docker виконуєpg_isreadyвсередині контейнера; контейнер вважається справним (healthy), коли PostgreSQL приймає з’єднання.restart: unless-stopped– після перезавантаження комп’ютера Docker знову запускає контейнер, якщо ви не зупинили його самі.
Крок 2. Запуск PostgreSQL
Що зробити. Переконайтеся, що Docker Desktop працює, і запустіть контейнер у фоні:
powershell
docker compose up --detach --wait--detach повертає вам термінал, --wait чекає, поки перевірка стану повідомить healthy. Під час першого запуску завантажується образ (близько 100 МБ).
Перевірка
powershell
docker compose psСписок показує службу postgres зі станом Up … (healthy) і портом 0.0.0.0:5432->5432/tcp. Тепер запитайте в PostgreSQL його версію через psql, клієнт командного рядка всередині контейнера:
powershell
docker compose exec postgres psql -U postgres -d chatex -c "select version();"Відповідь починається з PostgreSQL 18..
База даних поки порожня: таблиці з’являться в темі 4, коли їх створить EF Core. Щоб пізніше зазирнути в базу даних, можна використати psql, як вище, вікно бази даних у Rider чи Visual Studio або окремий клієнт на кшталт DBeaver чи pgAdmin з параметрами з’єднання: хост localhost, порт 5432, база даних chatex, користувач і пароль postgres.
Корисні команди на потім:
| Команда | Що робить |
|---|---|
docker compose stop | зупиняє контейнер, дані лишаються |
docker compose up --detach --wait | запускає його знову |
docker compose logs postgres | показує журнал PostgreSQL |
docker compose down --volumes | видаляє контейнер і дані, для чистого старту |
Крок 3. Інструмент командного рядка EF Core
Навіщо. У темі 4 ми створюємо таблиці бази даних за допомогою міграцій EF Core, а міграціями керує інструмент командного рядка dotnet ef. Інструмент можна встановити глобально на комп’ютер, але тоді в кожного розробника може бути своя версія. Локальний інструмент фіксується у файлі dotnet-tools.json репозиторію, а dotnet tool restore встановлює саме цю версію.
Що зробити. Створіть маніфест інструментів і встановіть інструмент у версії, що збігається з пакетами EF Core:
powershell
dotnet new tool-manifestpowershell
dotnet tool install dotnet-ef --version 10.0.14Маніфест у корені репозиторію тепер містить цей інструмент:
json
{
"version": 1,
"isRoot": true,
"tools": {
"dotnet-ef": {
"version": "10.0.14",
"commands": [
"dotnet-ef"
],
"rollForward": false
}
}
}Після клонування репозиторію на іншому комп’ютері одна команда встановлює інструменти з маніфеста:
powershell
dotnet tool restoreПеревірка
powershell
dotnet ef --versionВивід закінчується 10.0.14.