release(v1.0.0): подготовить первый стабильный релиз Docker SQL Lab

[yaleksandr89]

Что сделано

Подготовлен первый стабильный релиз Docker SQL Lab с независимыми MySQL и PostgreSQL, опциональным Adminer и учебными базами данных.

Инфраструктура

• добавлен PostgreSQL наряду с MySQL;
• MySQL и PostgreSQL можно запускать отдельно или одновременно;
• Adminer остаётся опциональным и подключается к обеим СУБД;
• разделены data- и init-каталоги MySQL и PostgreSQL;
• настроены healthcheck и проверки доступности сервисов;
• исправлен make reinit-all CONFIRM=1: после переинициализации запускаются MySQL, PostgreSQL и Adminer.

Доступы

• настроен общий учебный пользователь через DB_USER / DB_PASSWORD;
• учебный пользователь получает доступ ко всем пользовательским базам соответствующей СУБД;
• административные credentials MySQL и PostgreSQL хранятся отдельно;
• пароли не захардкожены в Compose, SQL, CI или документации.

Учебные базы

Обязательные базы:

• MySQL: demo;
• PostgreSQL: demo.

Опциональные учебные базы:

• MySQL: Sakila и Chinook;
• PostgreSQL: Pagila и Chinook.

Добавлены команды подготовки samples, проверки импорта и безопасной переинициализации.

Makefile

Добавлены и актуализированы команды для:

• инициализации окружения;
• запуска MySQL, PostgreSQL и Adminer в разных режимах;
• проверки подключений и доступов;
• подготовки учебных баз;
• проверки storage paths и SQL imports;
• остановки и переинициализации стенда.

CI

GitHub Actions проверяет:

• конфигурацию Docker Compose;
• storage paths;
• подготовку и импорт SQL samples;
• запуск MySQL и PostgreSQL;
• доступ учебного пользователя;
• состояние сервисов.

Документация

• русский язык используется по умолчанию;
• добавлены переводы на английский, немецкий, испанский, французский и китайский;
• документация разделена на тематические страницы;
• добавлены quick start, troubleshooting и описание жизненного цикла init/reinit;
• добавлены два скринкаста с вариантами первого запуска;
• уточнено, что backup нужен только для пользовательских данных, которые требуется сохранить;
• добавлены лицензия и сведения о сторонних учебных данных.

Community

• включены GitHub Discussions;
• добавлено приветственное обсуждение;
• добавлен .github/FUNDING.yml со ссылками на Boosty и Sponsr.

Проверки

Фактически выполнялись:

make help
make check-env
make config
make test-storage-paths
make up-no-ui
make check
make test-sql-imports
make status
make down
git diff --check

Дополнительно необходимо подтвердить итоговый runtime-сценарий для reinit-all:

make up
make samples-mysql
make samples-postgres
make reinit-all CONFIRM=1
make status
make check

После reinit-all ожидаются запущенные сервисы:

• MySQL;
• PostgreSQL;
• Adminer.

Важные замечания

• init-скрипты официальных Docker images выполняются только для пустых data-каталогов;
• команды reinit-* удаляют текущие данные выбранной СУБД;
• резервная копия требуется только при наличии пользовательских данных, которые нужно сохранить;
• .docker.env, data-каталоги, backups, временные samples и секреты не коммитятся.