Локальный запуск — Versola Docs
/docs
До 1.00.7.5versola.ioGitHub
RUEN

Локальный запуск

Запустите полный стек Versola на своей машине через Docker и versola-cli, войдите в консоль администратора и затем снесите стек.

На этой странице вы запустите на своей машине весь стек — central, auth, edge, Postgres и прокси — и войдете в консоль администратора. Нужны установленный CLI и работающий Docker.

Локальный стек — одноразовое демо. Не открывайте его в сеть и не используйте для настоящих пользователей.

Требования

  • Docker с плагином Compose, запущенный.
  • Около 4 GiB памяти для Docker (три JVM и Postgres) и около 4 GiB свободного места на диске под образы. Обе проверки выполняет versola doctor.
  • Свободный порт 2821 на 127.0.0.1. На нем слушает локальный прокси.

1. Проверьте машину

versola doctor

Каждая проверка выводит результат: демон Docker, плагин Compose, порт 2821, память Docker и свободное место на диске. Если все в порядке, команда завершается строкой:

All checks passed — ready for `versola bootstrap local <version>`.

Если Docker не найден, doctor предложит открыть страницу установки в браузере. Сам он ничего не устанавливает.

2. Запустите bootstrap

Подставьте вместо <version> номер релиза Versola без префикса v, например 0.7.0. Последний релиз указан на странице релизов GitHub.

versola bootstrap local <version>

bootstrap последовательно выполняет три шага: configure (генерирует конфигурацию и секреты), migrate (создает схемы базы данных) и up (запускает контейнеры). При первом запуске он загружает образы, на это уходит несколько минут. По завершении команда выводит:

Versola <version> is running at http://localhost:2821
Login: admin / Admin1234!

После этого консоль администратора откроется в браузере. Чтобы этого не происходило, добавьте --no-browser:

versola bootstrap local <version> --no-browser

Консоль всегда доступна по адресу http://localhost:2821/central/admin/.

3. Войдите

  1. Введите логин admin и пароль Admin1234!.
  2. Введите одноразовый код 123456.
  3. Задайте новый пароль, когда его запросят.

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

Note: Повторные неверные коды или пароли временно блокируют учетную запись. С лимитами по умолчанию пять неверных одноразовых кодов или десять неверных паролей за час блокируют вход на 30 минут, и экран показывает Access Denied даже для правильного кода. Дождитесь окончания блокировки. Лимиты описаны в разделе Пользователь.

Проверить, что контейнеры работают, можно в любой момент:

versola status

Остановка и удаление

Остановить контейнеры, сохранив данные и образы:

versola down

versola down --volumes также удаляет том с данными Postgres. Чтобы удалить все, что создал локальный стек, выполните:

versola uninstall

uninstall останавливает стек, удаляет том Postgres, загруженные образы Docker и локальное состояние в ~/.versola/active. Он просит подтверждение (-y пропускает его). Каталог ~/.versola/openbao с учетными данными для других целей остается на месте, сам бинарник versola не удаляется: команда выводит его путь, чтобы вы удалили его вручную.

Apple Silicon

Образы auth, central, edge и versola-tools публикуются для linux/amd64 и linux/arm64, поэтому Docker на Apple Silicon загружает нативные образы, а эмуляцию настраивать не нужно.

Дальше