Бази даних, кеші, пошук і файлове сховище працюють усередині вашого середовища поруч із вашими сайтами. 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 |
вбудовано | |
| Сервер дампів | Збирає дампи налагодження з вашого коду; 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».