Введите не менее двух букв, чтобы искать по всем страницам документации.

↑ ↓ для навигации ↵ чтобы открыть esc чтобы закрыть

Работа с rdev

Сервисы

Базы данных, кэши, поиск и файловое хранилище работают внутри вашего окружения, рядом с вашими сайтами. rdev устанавливает каждый сервис, когда он впервые понадобится проекту, в выбранной вами версии, поддерживает его работу и записывает параметры подключения в .env проекта.

Что доступно

Сервис Для чего нужен Версии Порт по умолчанию
MySQL Реляционная база данных 8.0, 8.4, 9.7 3306
MariaDB Реляционная база данных 10.11, 11.4, 11.8, 12.3 3307
PostgreSQL Реляционная база данных; сборки -full добавляют pgvector, PostGIS, pgRouting и (начиная с 16) TimescaleDB 14, 15, 16, 17, 18 5432
MongoDB Документная база данных 7.0, 8.0, 9.0 27017
Redis Кэш, очереди и сессии 9.1 6379
Meilisearch Полнотекстовый поиск для Laravel Scout 1 7700
Typesense Полнотекстовый поиск для Laravel Scout 29, 30 8108
RustFS S3-совместимое файловое хранилище с веб-консолью на следующем порту 1 9000
Elasticsearch Поиск и аналитика для драйверов Scout и клиентов Elastic (работает без машинного обучения) 8.19, 9 9200
Qdrant Векторный поиск для ИИ-функций, например семантического поиска 1 6333
Перехват почты Перехватывает исходящую почту, чтобы ничего не попадало в настоящие почтовые ящики; SMTP 127.0.0.1:2525, просмотр в браузере по адресу https://rdev-mail.dev.test встроено
Dump-сервер Собирает отладочные дампы из вашего кода; 127.0.0.1:2304, просмотр в браузере по адресу https://rdev-dumps.dev.test встроено

Redis говорит на стандартном протоколе Redis: драйверы redis в Laravel и phpredis работают без изменений. Каждый сервис слушает только внутри вашего окружения, на 127.0.0.1; к веб-консоли, например RustFS, обращайтесь через подключение ноутбука.

Перехваченная почта и дампы в браузере

Откройте https://rdev-mail.dev.test в любом браузере в вашем tailnet, чтобы прочитать письма, отправленные вашими приложениями. Вы видите список (новые сверху), заголовки каждого письма, его текстовую и HTML-версии и вложения. Можно удалить одно письмо или все, а новые письма появляются сами. HTML-письма показываются с заблокированными скриптами и внешними изображениями.

https://rdev-dumps.dev.test показывает вызовы dump() и другие перехваченные события, новые сверху, с файлом и строкой, откуда они пришли. Очистите список кнопкой Clear.

Обе страницы работают на вашем сервере и доступны только через ваш tailnet, как и ваши проекты. Данные никогда не покидают ваш сервер, а превью никогда не сможет сделать их публичными. rdev mail list выводит оба адреса, а приложение для ноутбука открывает их кнопками Mail и Dumps на вкладке Sites. Имена rdev-mail и rdev-dumps зарезервированы, поэтому проект не может их использовать.

Базы данных в браузере

https://rdev-adminer.dev.test открывает на вашем сервере Adminer, менеджер баз данных. Выберите MySQL или PostgreSQL, сервер 127.0.0.1, пользователя root (MySQL) или postgres (PostgreSQL) и оставьте пароль пустым; для SQLite укажите путь к файлу базы. Как и страницы выше, он доступен только через ваш tailnet, а имя rdev-adminer зарезервировано. Он появился в rdev 1.2.0; на сервере, установленном раньше, сначала выполните sudo rdev host update.

Подключение сервиса к проекту

На сервере укажите проект и сервис:

rdev project service shop postgres

rdev устанавливает и запускает сервис, если он ещё не запущен, создаёт базу данных (MySQL, MariaDB, PostgreSQL) или бакет (RustFS) с именем проекта и записывает параметры подключения в .env проекта. Если у проекта нет .env, параметры выводятся на экран. MongoDB создаёт базу данных при первой записи вашего кода; для PHP-проекта rdev также устанавливает расширение PHP mongodb для версии PHP, которую использует сайт (см. Расширения PHP).

Когда проект Laravel получает новую базу данных MySQL, MariaDB или PostgreSQL, rdev также выполняет php artisan migrate --force, чтобы таблицы, в которых новое приложение хранит сессии, кэш и очередь, существовали и сайт продолжал работать. Это делается только для только что созданной базы данных, которая ещё пуста; существующая база данных остаётся как есть. Если миграция не удалась, сервис остаётся на месте, а сообщение объясняет причину, так что вы можете выполнить php artisan migrate самостоятельно.

В панели откройте сервер в разделе Серверы на боковой панели и выберите Добавить сервис в карточке Сервисы, вверху или рядом с проектом (такая же кнопка есть на дашборде), выберите сервис и, для сервисов с несколькими версиями, Версию. Строка проекта показывает, на каком этапе сервер: установка и запуск сервиса, создание базы данных, запись .env, выполнение миграций. Уведомление сообщает, когда всё готово. Первая установка сервиса может занять несколько минут. Ваш ИИ-агент может сделать то же самое через свой доступ по MCP; попросите у него «базу данных PostgreSQL для shop».

Новый проект может получить свои сервисы той же командой:

rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis

Что попадает в .env

Сервис Параметры
MySQL, MariaDB, PostgreSQL DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (без пароля: к ней может обратиться только ваше окружение)
MongoDB MONGODB_URI, MONGODB_DATABASE, для пакета mongodb/laravel-mongodb
Redis REDIS_HOST, REDIS_PORT
Meilisearch SCOUT_DRIVER=meilisearch, MEILISEARCH_HOST
Typesense SCOUT_DRIVER=typesense, TYPESENSE_HOST, TYPESENSE_PORT, TYPESENSE_PROTOCOL, TYPESENSE_API_KEY
Elasticsearch ELASTICSEARCH_HOST (http://127.0.0.1:9200) и ELASTIC_HOST (127.0.0.1:9200); без SCOUT_DRIVER, так как во Laravel нет встроенного драйвера Elasticsearch: задайте его для используемого вами пакета
Qdrant QDRANT_HOST, QDRANT_PORT, QDRANT_URL
RustFS AWS_ACCESS_KEY_ID=rdev, AWS_SECRET_ACCESS_KEY=rdev-secret, AWS_DEFAULT_REGION, AWS_BUCKET, AWS_ENDPOINT, AWS_URL, AWS_USE_PATH_STYLE_ENDPOINT=true

Значения этих ключей, уже имеющиеся в .env, заменяются; остальные строки остаются как есть.

Открыть базу данных в настольном приложении

Просматривать и редактировать базы данных можно любым приложением для баз данных на ноутбуке, например TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Сервисы слушают только внутри вашего окружения, поэтому выберите в приложении вариант SSH (SSH-туннель): SSH-хост — адрес вашего сервера в Tailscale (HostName в записи rdev в ~/.ssh/config), пользователь dev, порт 22 и SSH-ключ, с которым входит ваш ноутбук. Затем подключитесь к базе по адресу 127.0.0.1 с портом и учётными данными из таблицы выше. Для этого нужен подключённый ноутбук; данные идут через ваш tailnet и никогда не проходят через rdev.cloud.

Нет приложения под рукой или вы на телефоне или планшете? https://rdev-adminer.dev.test открывает Adminer в браузере (см. раздел об Adminer выше).

Настройки по умолчанию

Каждый сервис слушает только 127.0.0.1 внутри вашего окружения, поэтому снаружи до них не добраться, и все они настроены для разработки:

Сервис Учётные данные Что полезно знать
MySQL, MariaDB Пользователь root, без пароля Каждый проект получает базу данных со своим именем (my-shop становится my_shop).
PostgreSQL Пользователь postgres, без пароля (аутентификация trust) Без сокета Unix: подключайтесь к 127.0.0.1. База данных на проект, как выше.
MongoDB Без аутентификации База данных появляется при первой записи в неё из вашего кода.
Redis Без пароля Хранится только в памяти: перезапуск сервиса очищает кэш, очереди и сессии.
Meilisearch Без master key Режим разработки, аналитика отключена.
Typesense API-ключ rdev-typesense CORS включён, поэтому страница на вашем ноутбуке может обращаться к нему напрямую.
Elasticsearch Без пользователя и пароля (безопасность отключена) Один узел с 512 МБ памяти; машинное обучение не входит.
Qdrant Без API-ключа gRPC на порту после HTTP-порта (6334); телеметрия отключена.
RustFS Ключ доступа rdev, секретный ключ rdev-secret Бакет на проект; веб-консоль на следующем порту (9001).

В панели пункт Конфигурация в меню ⋯ сервиса показывает то же самое для версии и порта, которые использует ваш сервер, вместе со строками .env его первого проекта, готовыми к копированию. Чтобы изменить параметр, используйте rdev service set (см. ниже; MySQL, MariaDB, PostgreSQL и Redis), например rdev service set redis appendonly yes, чтобы данные Redis сохранялись между перезапусками.

Выбор версии

Добавьте к сервису @ и версию или линейку релизов:

rdev project service shop [email protected]

Это устанавливает последний MySQL 8.0 и переключается на него. Без версии вы получите уже установленную или самую новую. Чтобы увидеть все версии, которые можно установить:

rdev service available

Одновременно работает одна версия каждого сервиса:

  • MySQL и MariaDB хранят отдельные данные для каждой линейки релизов (8.0, 8.4, 9.7…). Переход на более новую линейку начинается с копии данных более старой линейки, которую новый сервер обновляет; данные старой линейки остаются как были, так что можно вернуться. Переход на более старую линейку начинается с пустых данных, потому что старый сервер не может прочитать более новые данные.
  • PostgreSQL и MongoDB хранят отдельные данные для каждой основной версии (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Новая основная версия начинается пустой; перенесите данные с помощью pg_dump или mongodump.
  • Meilisearch и Typesense пересобирают свои индексы из вашего приложения (php artisan scout:import) после смены версии.

MySQL использует порт 3306, а MariaDB — 3307, поэтому оба можно установить и запускать одновременно; проекты получают правильный порт в своём .env. До rdev 0.2.0-beta.37 MariaDB использовала 3306; после этого обновления задайте DB_PORT=3307 в .env проекта, который её использует, либо сохраните старый порт командой rdev service set-port mariadb 3306. Для выбора версий нужен rdev 0.2.0-beta.18 или новее.

Расширения PostgreSQL

Сборки -full PostgreSQL включают pgvector (векторный поиск для ИИ-функций), PostGIS и pgRouting (карты и маршруты) и, начиная с версии 16, TimescaleDB (временные ряды). Выберите одну по её полной версии, как её выводит rdev service available:

rdev project service shop [email protected]

Затем включите расширение в своей базе данных, например в миграции:

CREATE EXTENSION IF NOT EXISTS vector;

То же относится к postgis, pgrouting и timescaledb. rdev автоматически предзагружает TimescaleDB, если сборка его включает.

Управление сервисами

Карточка Сервисы на странице вашего сервера перечисляет каждый установленный сервис с его версией, признаком работы, портом и проектами, которые вы подключили из панели. Меню ⋯ в строке запускает, останавливает или перезапускает его, переустанавливает ту же версию (данные сохраняются) или удаляет, сохраняя данные для последующей установки либо удаляя и их. Строка, настройка которой не удалась, показывает причину в том же меню, и её можно повторить или убрать из списка. Сервер выполняет каждое действие за секунды, и таблица обновляется; для этого нужен rdev 0.2.0-beta.24 или новее на сервере.

На самом сервере:

Команда Что делает
rdev service available Выводит версии, которые можно установить
rdev service start mysql / stop / restart Запускает, останавливает или перезапускает сервис
rdev service logs mysql Показывает последние строки его лога
rdev service set-port mysql 3307 Переносит его на другой порт (при следующем перезапуске)
rdev service set mysql max_connections 300 Задаёт параметр конфигурации (при следующем перезапуске; MySQL, MariaDB, PostgreSQL и Redis)
rdev service change-version mysql 9.7.4 Переключается на другую версию
rdev service uninstall mysql 9.7.4 Удаляет версию; добавьте --purge, чтобы удалить и её данные

Сервисы запускаются вместе с вашим окружением. Удаление проекта никогда не удаляет его базу данных; удалите её сами, когда она вам больше не нужна.

Команды и резервные копии

На тарифе Team окружение каждого участника обращается к сервисам владельца по имени rdev-team, рядом со своими собственными приватными (Команды).

Ночная резервная копия данных на Pro и Team включает все базы данных MySQL, MariaDB, PostgreSQL и MongoDB и вашу папку ~/Code и восстанавливает их из панели (Резервные копии). MySQL и MariaDB копируются каждая на своём порту; MongoDB — одним архивом всех её баз данных. Поисковые индексы и бакеты RustFS пересобираются из вашего приложения и ваших собственных копий.

Сервис, которого нет в списке

Вам не нужно ждать нас, чтобы запустить что-то другое:

  • Сервис, написанный на Node.js, Python, Ruby или Go, работает как проект. rdev устанавливает его среду выполнения, запускает команду, выдаёт ей порт и перезапускает, если она остановилась:

    rdev project add realtime --lang node --command "npx soketi start --port={port}"
    
  • Другое программное обеспечение помещается в вашу домашнюю папку, например скачанный бинарный файл в ~/.local/bin, и запускается из команды проекта таким же образом. Ваша домашняя папка — это часть окружения, которую сохраняет rdev host update; всё, что установлено в другом месте через sudo apt, пропадает после следующего обновления окружения.

  • Хотите, чтобы он поддерживался так же, как сервисы выше, с версиями, панелью, настройками .env и резервными копиями? Напишите нам, указав сервис и то, для чего вы его используете. Мы добавляем сервисы, которые нужны нескольким клиентам, и сообщаем, на каком этапе дело.

Ваш ИИ-агент может настроить первые два варианта за вас; попросите его «запустить Elasticsearch для проекта shop».