Введіть принаймні дві літери, щоб шукати по всіх сторінках документації.

↑ ↓ щоб переміщатися ↵ щоб відкрити esc щоб закрити

Використання rdev

Проєкти та сайти

Кожен проєкт на вашому сервері стає сайтом із власною адресою та довіреним HTTPS.

Адреси сайтів

Кожен проєкт отримує https://<name>.dev.test. Сертифікату довіряє ваш ноутбук, тож браузер не показує попереджень, а адреса працює всюди, де ваш ноутбук підключено до вашої tailnet.

PHP

  • Кожна версія PHP від 7.4 до 8.5, яку вибирають для кожного сайту окремо.
  • Laravel і WordPress — першочергові.
  • Інші фреймворки PHP і звичайні проєкти PHP теж підтримуються.
  • Розширення на кшталт mongodb і xdebug встановлюються однією командою; див. Розширення PHP.

Інші мови

Проєкти на Python, Ruby, Node.js, Go, .NET, Java і Flutter підтримуються. Жодне середовище виконання мови не встановлюється за замовчуванням: коли ви додаєте проєкт однією з цих мов, rdev установлює потрібне середовище виконання в цей момент і повторно використовує його для наступних проєктів.

Це тримає середовище компактним, а середовища виконання, якими ви ніколи не користуєтеся, не потребують оновлень.

Бази даних і сервіси

Кожен проєкт може використовувати MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense або RustFS у вибраній вами версії, а також перехоплення пошти та сервер дампів. Для чого кожен із них, їхні версії, налаштування .env і те, як запустити щось, чого немає в списку, описано на сторінці Сервіси.

Додавання проєкту

Проєкт можна додати трьома способами:

  • попросивши вашого агента ШІ, який створює сайти через свій MCP-доступ;
  • за допомогою інструмента командного рядка rdev на сервері;
  • з вебпанелі.

Будь-яка тека, створена вами в ~/Code, одразу обслуговується як https://<folder>.dev.test, тож досить клонувати туди проєкт PHP.

Рецепти: створення проєкту з фреймворка

Рецепт створює новий проєкт із фреймворка в порожній теці ~/Code/<name>: rdev встановлює мову, запускає власний інсталятор фреймворка, задає команду сервера розробки та обслуговує застосунок за адресою https://<name>.dev.test.

Мова Рецепти
PHP Laravel і WordPress (вбудовані), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (з Capacitor), Expo (React Native), NestJS, Express, порожній проєкт Node.js
Python Django, Flask, FastAPI, порожній проєкт Python (кожен у власному .venv)
Ruby Ruby on Rails, Sinatra, порожній проєкт Rack
Go Gin, Echo, Fiber, порожній модуль Go
.NET ASP.NET Core Web API, Blazor, порожній застосунок ASP.NET Core
Java Spring Boot, Quarkus, Micronaut, порожній проєкт на Java
Flutter Застосунок Flutter для вебу, Android та iOS із живим попереднім переглядом; HTTP-сервер на Dart (shelf)

Мобільні рецепти (Ionic, Expo і Flutter) запускають попередній перегляд застосунку для вебу на сервері; збірки під Android та iOS виконуються на вашому ноутбуці. Expo Go на телефоні, який перебуває у вашій tailnet, також може відкрити проєкт Expo просто із сервера.

  • На панелі: відкрийте сервер у розділі Сервери, перейдіть на вкладку Рецепти та виберіть Створити проєкт для рецепта або виберіть його як тип у Додати проєкт. Потім проєкт з’являється на вкладці Проєкти.
  • На сервері: rdev project recipes перелічує їх; rdev project add web --recipe nextjs запускає один.
  • З агента: інструмент MCP, що додає проєкти, приймає recipe, тож можна попросити «створи проєкт Django під назвою api».

Django і Rails налаштовані приймати адреси *.dev.test; сервери розробки на основі Vite (Nuxt, Astro, SvelteKit) теж їх дозволяють. Рецепти надходять із каталогу, підписаного rdev, а сервер відхиляє каталог, підпис якого не збігається, тож нові фреймворки з’являються без оновлення rdev. Для рецептів потрібен rdev 0.2.0-beta.38 або новіший.

За допомогою командного рядка

  • Клонуйте репозиторій і обслуговуйте його як проєкт:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Створіть порожній проєкт Python з його середовищем виконання:

    rdev project add api --lang python
    
  • Обслуговуйте сайт з іншою версією PHP:

    rdev use shop 8.3
    

    На панелі натисніть проєкт у стовпці Проєкти картки PHP сервера (Розширення PHP).

rdev project list показує ваші проєкти, rdev project start|stop|logs <name> керує сервером розробки проєкту не на PHP, а rdev project remove <name> видаляє проєкт (його файли залишаються, якщо ви не додасте --delete-files).

З панелі

Додати проєкт можна й без відкриття терміналу: відкрийте сервер у розділі Сервери та виберіть Додати на його вкладці Проєкти або виберіть Додати проєкт поруч із сервером на панелі керування; дайте йому назву та виберіть тип: новий застосунок Laravel, новий сайт WordPress, клон git-репозиторію, порожній проєкт PHP або один із рецептів. Сервер підхоплює запит приблизно за п’ять хвилин, а панель керування показує, коли проєкт готовий за адресою https://<name>.dev.test. Таблиця Додано з панелі на панелі керування перелічує кожен проєкт і сервіс, які ви запросили, з його сервером, статусом і, якщо щось не вдалося, причиною. rdev ніколи не підключається до вашого сервера для цього; ваш сервер сам запитує свої запити. Для git-репозиторію можна також вибрати мову (PHP, Node.js, Python, Ruby, Go, .NET або Java); з Визначити автоматично сервер визначить її за файлами репозиторію. Якщо вибір не збігається з файлами, сервер використає ваш вибір і повідомить про це в статусі проєкту.

Вкладка Проєкти перелічує кожен проєкт, про який повідомляє сервер, з його адресою, а також ті, які ви запросили й які ще в дорозі чи не вдалися, з причиною.

Виправлення, видалення та псевдоніми

Меню ⋯ біля проєкту на вкладці Проєкти:

  • Змінити й спробувати ще раз (проєкт, який не вдалося налаштувати): форма відкривається з вашим запитом, наприклад з URL репозиторію або рецептом. Виправте його й надішліть знову. Прибрати зі списку приховує невдалий запит.
  • Змінити й перевстановити (проєкт на сервері): папка проєкту видаляється, і проєкт налаштовується заново з нуля з обраним вами типом. Його дані зберігаються, тому новий проєкт знаходить їх, якщо тільки ви не позначите Також видалити його бази даних (що саме це видаляє, описано нижче). Спершу зробіть commit і push своєї роботи: файли, яких немає в git, буде втрачено.
  • Видалити, зберегти дані видаляє папку проєкту в ~/Code, його сайт і сервер розробки; бази даних і файли в сховищі залишаються. Видалити повністю, з даними також видаляє дані проєкту: бази даних MySQL, MariaDB, PostgreSQL і MongoDB з його іменем (my-shop використовує my_shop) та його бакет RustFS (my-shop) з усіма завантаженими в нього файлами.
  • Додати псевдонім надає проєкту ще одну адресу: псевдонім store робить так, що https://store.dev.test відкриває той самий сайт, на вашому ноутбуці та на кожному пристрої у вашому tailnet. Крапки створюють підадреси, наприклад api.shop. Псевдоніми показано під проєктом; × біля псевдоніма видаляє його.

Сервер виконує кожну дію за кілька секунд; для цього потрібен rdev 1.0.3 або новіший, а для видалення даних MongoDB і RustFS — 1.0.4. На самому сервері rdev domain add <name> store.dev.test додає псевдонім, а rdev project remove <name> --delete-files видаляє проєкт, створений командою rdev project add (для сайту Laravel або WordPress видаліть його папку).

Перш ніж видаляти дані, дізнайтеся, чого це торкнеться:

  • Це не можна скасувати. Нічна резервна копія в Pro і Team містить бази даних, тож їх можна відновити з панелі; бакетів RustFS у ній немає, тому завантажені файли зникають назавжди. Спершу завантажте те, що вам потрібно.
  • Видаляється за іменем, а не за власником. rdev видаляє базу даних і бакет з іменем проєкту. Якщо .env іншого проєкту вказує на ту саму базу даних або той самий бакет, цей проєкт теж втратить свої дані.
  • Зупинений сервіс зберігає свої дані. rdev видаляє дані лише в запущених сервісах і повідомляє, які пропустив; запустіть їх і повторіть видалення або видаліть дані самі.
  • У тарифі Team середовище кожного учасника має власні сервіси; видалення проєкту у вашому середовищі ніколи не торкається спільних сервісів власника.

Додавання сервісу до проєкту

Проєкт може отримати сервіс пізніше, коли той йому знадобиться:

rdev project service shop postgres

На панелі виберіть Додати сервіс для проєкту або поруч із сервером. Вибір версії, налаштування .env та решту описано на сторінці Сервіси.

Змінні середовища з панелі

Щоб задати ключ API чи інший секрет без відкриття терміналу, відкрийте сервер у розділі Сервери бічної панелі та скористайтеся Змінні середовища: виберіть проєкт, введіть назву та значення в розділі Додати або змінити і виберіть Зашифрувати та зберегти. Сервер записує її в .env проєкту за кілька секунд.

Значення шифруються у вашому браузері власним ключем вашого сервера, тож rdev.cloud ніколи їх не бачить і не може показати пізніше. Зараз у .env перелічує лише назви. Щоб змінити значення, натисніть його назву: вона переходить до Додати або змінити, де ви вводите нове значення. Натисніть × на назві, щоб видалити її; видалення APP_KEY або налаштувань DB_ зазвичай ламає застосунок.