Инструкция по запуску приложения на локальном компьютере
Для запуска приложения вам потребуется установить Docker и Docker Compose на ваш компьютер. Следуйте шагам ниже:
1. Установите Docker и Docker Compose
Если Docker и Docker Compose еще не установлены, выполните следующие действия:
-
Для Windows и macOS:
Скачайте и установите Docker Desktop. Docker Compose будет установлен автоматически вместе с Docker Desktop. -
Для Linux:
Установите Docker и Docker Compose, следуя официальной документации:
Установка Docker
Установка Docker Compose
2. Скачайте архив с проектом
Скачать архив можно Тут
3. Распакуйте архив
Распакуйте скачанный архив в удобную для вас директорию. Например, в папку projects на вашем рабочем столе.
4. Откройте терминал
Для работы с Docker Compose вам нужно использовать терминал (или командную строку). Вот как это сделать:
-
Windows:
Нажмите Win + R, введите cmd и нажмите Enter. Или используйте PowerShell. Если вы используете WSL (Windows Subsystem for Linux), откройте терминал WSL. -
macOS:
Откройте приложение "Терминал" через поиск (Spotlight) или из папки "Утилиты". -
Linux:
Откройте терминал через меню приложений или с помощью сочетания клавиш Ctrl + Alt + T.
5. Перейдите в директорию с проектом
В терминале выполните команду cd, чтобы перейти в папку с вашим проектом. Например, если вы распаковали архив в папку projects на рабочем столе, выполните:
cd /*путь до папки с проектом*/ваша_папка_с_проектом
Примечание:
~обозначает домашнюю директорию пользователя.- Если вы не знаете, где находится ваша папка, вы можете перетащить папку в терминал, и путь вставится автоматически (на macOS и Linux).
- Чтобы проверить, какие файлы находятся в текущей директории, выполните команду
ls(на macOS/Linux) илиdir(на Windows).
В папке cd ~/Desktop/projects/ваша_папка_с_проектом/database , хранится база приложения.
Изначально папка пустая, но после первого запуска в ней создадутся файлы базы данных, ну удаляйте их, иначе потеряете все данные которые внесете в приложение!!!
6. Соберите и запустите приложение
Теперь, когда вы находитесь в директории с проектом, выполните команду для сборки и запуска приложения:
docker-compose up -d
7. Войти в административную часть
После успешного запуска контейнеров откройте браузер и перейдите в административное меню, оно работает на порту 91.
Т.е. адрес будет http://localhost:91/admin
логин: admin
пароль: admin123
8. Создаем пользователя для работы в приложении
По умолчанию в системе уже есть один пользователь
логин: test@example.com
пароль: testueser123
Вы можете его удалить или изменить.
В административной части приложения, нужно перейти в раздел "Пользователи", адрес будет http://localhost:91/admin/rainlab/user/users
Там добавляем нового пользователя и сразу его активируем.
Все теперь используя почту и логин этого пользователя, можно использовать самое приложение.
9. Проверьте работу приложения
Если в пункте 8 вы не удаляли пользователя и не меняли пароль, то можно использовать следующие
логин: test@example.com
пароль: testueser123
Приложение работает на порту 92. Т.е. адрес будет http://localhost:92, переходим по этому адресу и вводим почту и пароль, которые вы указали в пункте 8
10. Остановка приложения
Если вам нужно остановить приложение, выполните команду в той же директории:
docker-compose down
Эта команда остановит и удалит контейнеры, но сохранит данные в томах (volumes), если они используются.
11. Дополнительные команды
-
Просмотр логов:
Чтобы просмотреть логи работы контейнеров, выполните:docker-compose logs -f -
Пересборка образов:
Если вы внесли изменения в Dockerfile или зависимости, пересоберите образы:docker-compose up --build -
Очистка Docker:
Если вам нужно удалить все неиспользуемые образы, тома и контейнеры, выполните:docker system prune -f
Примечания
- Убедитесь, что порты 91,92 и 5001, не конфликтуют с другими приложениями на вашем компьютере.
Пример работы с терминалом
Если вы новичок в работе с терминалом, вот несколько полезных команд:
cd <папка>— перейти в указанную папку.cd ..— перейти на уровень выше (в родительскую папку).ls(macOS/Linux) илиdir(Windows) — показать содержимое текущей папки.pwd— показать текущую директорию.clear(macOS/Linux) илиcls(Windows) — очистить экран терминала.
12. Дополнительные команды для очистки Docker
Удалить/очистить все данные Докера (контейнеры, образы, тома и сети) Одной строкой
docker stop $(docker ps -qa) && docker rm $(docker ps -qa) && docker rmi -f $(docker images -qa) && docker volume rm $(docker volume ls -q) && docker network rm $(docker network ls -q)
Описание команд
👎 Остановка всех контейнеров
docker stop $(docker ps -qa)
✊ Удаление всех контейнеров
docker rm $(docker ps -qa)
✌️ Удаление всех образов
docker rmi -f $(docker images -qa)
👋 Удаление всех томов
docker volume rm $(docker volume ls -q)
✋ Удаление всех сетей
docker network rm $(docker network ls -q)
Следующие команды не должны выводить какие-либо элементы, если вы все удалили:
docker ps -a
docker images -a
docker volume ls
👉 Следующая команда показывает только сети по умолчанию:
docker network ls
:: Следующая команда удаляет неиспользуемые образы
docker system prune