Wpisz co najmniej dwie litery, aby przeszukać każdą stronę dokumentacji.

↑ ↓ aby nawigować ↵ aby otworzyć esc aby zamknąć

Korzystanie z rdev

Projekty i witryny

Każdy projekt na Twoim serwerze staje się witryną z własnym adresem i zaufanym HTTPS.

Adresy witryn

Każdy projekt dostaje https://<name>.dev.test. Certyfikatowi ufa Twój laptop, więc przeglądarka nie pokazuje ostrzeżeń, a adres działa wszędzie tam, gdzie laptop jest połączony z Twoim tailnetem.

PHP

  • Każda wersja PHP od 7.4 do 8.5, wybierana dla każdej witryny.
  • Laravel i WordPress są traktowane priorytetowo.
  • Inne frameworki PHP i zwykłe projekty PHP także są obsługiwane.
  • Rozszerzenia takie jak mongodb i xdebug instalują się jednym poleceniem; zobacz Rozszerzenia PHP.

Inne języki

Projekty Python, Ruby, Node.js, Go, .NET, Java i Flutter są obsługiwane. Domyślnie nie jest instalowane żadne środowisko językowe: gdy dodajesz projekt w jednym z tych języków, rdev instaluje w tym momencie potrzebne środowisko i używa go ponownie dla kolejnych projektów.

Dzięki temu środowisko pozostaje małe, a środowiska, których nigdy nie używasz, nie wymagają aktualizacji.

Bazy danych i usługi

Każdy projekt może używać MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense lub RustFS w wybranej wersji, plus przechwytywania poczty i serwera zrzutów. Do czego służy każda z nich, jakie są wersje, ustawienia .env i jak uruchomić coś, czego nie ma na liście, opisano w Usługi.

Dodawanie projektu

Projekt możesz dodać na trzy sposoby:

  • prosząc agenta AI, który tworzy witryny przez swój dostęp MCP;
  • za pomocą narzędzia wiersza poleceń rdev na serwerze;
  • z panelu WWW.

Każdy folder utworzony w ~/Code jest od razu serwowany jako https://<folder>.dev.test, więc wystarczy sklonować tam projekt PHP.

Przepisy: start od frameworka

Przepis rozpoczyna nowy projekt od frameworka w pustym folderze ~/Code/<name>: rdev instaluje język, uruchamia własny instalator frameworka, ustawia polecenie serwera deweloperskiego i serwuje aplikację pod adresem https://<name>.dev.test.

Język Przepisy
PHP Laravel i WordPress (wbudowane), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (z Capacitorem), Expo (React Native), NestJS, Express, pusty projekt Node.js
Python Django, Flask, FastAPI, pusty projekt Python (każdy we własnym .venv)
Ruby Ruby on Rails, Sinatra, pusty projekt Rack
Go Gin, Echo, Fiber, pusty moduł Go
.NET ASP.NET Core Web API, Blazor, pusta aplikacja ASP.NET Core
Java Spring Boot, Quarkus, Micronaut, pusty projekt Java
Flutter Aplikacja Flutter na web, Androida i iOS, z podglądem webowym na żywo; serwer HTTP w Darcie (shelf)

Przepisy mobilne (Ionic, Expo i Flutter) uruchamiają podgląd webowy aplikacji na serwerze; kompilacje na Androida i iOS odbywają się na Twoim laptopie. Expo Go na telefonie, który jest w Twoim tailnecie, może też otworzyć projekt Expo bezpośrednio z serwera.

  • W panelu: otwórz serwer w Serwery, przejdź do karty Przepisy i wybierz Utwórz projekt przy przepisie albo wybierz go jako typ w Dodaj projekt. Projekt pojawia się wtedy na karcie Projekty.
  • Na serwerze: rdev project recipes je wymienia; rdev project add web --recipe nextjs uruchamia jeden.
  • Od agenta: narzędzie MCP dodające projekty przyjmuje recipe, więc możesz poprosić „uruchom projekt Django o nazwie api”.

Django i Rails są skonfigurowane tak, aby akceptować adresy *.dev.test; serwery deweloperskie oparte na Vite (Nuxt, Astro, SvelteKit) także je dopuszczają. Przepisy pochodzą z katalogu podpisanego przez rdev, a serwer odrzuca katalog, którego podpis się nie zgadza, więc nowe frameworki pojawiają się bez aktualizacji rdev. Przepisy wymagają rdev 0.2.0-beta.38 lub nowszego.

Z wiersza poleceń

  • Sklonuj repozytorium i serwuj je jako projekt:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Uruchom pusty projekt Python z jego środowiskiem:

    rdev project add api --lang python
    
  • Serwuj witrynę z inną wersją PHP:

    rdev use shop 8.3
    

    W panelu kliknij projekt w kolumnie Projekty karty PHP serwera (Rozszerzenia PHP).

rdev project list pokazuje Twoje projekty, rdev project start|stop|logs <name> steruje serwerem deweloperskim projektu innego niż PHP, a rdev project remove <name> usuwa projekt (jego pliki zostają, chyba że dodasz --delete-files).

Z panelu

Projekt możesz też dodać bez otwierania terminala: otwórz serwer w Serwery i wybierz Dodaj na jego karcie Projekty albo wybierz Dodaj projekt obok serwera w panelu; nadaj mu nazwę i wybierz typ: nowa aplikacja Laravel, nowa witryna WordPress, klon repozytorium git, pusty projekt PHP lub jeden z przepisów. Serwer pobiera żądanie w ciągu około pięciu minut, a panel pokazuje, kiedy jest gotowy pod adresem https://<name>.dev.test. Tabela Dodano z panelu w panelu wymienia każdy projekt i usługę, o które poprosiłeś, wraz z serwerem, statusem i, gdy coś się nie powiodło, powodem. rdev nigdy nie łączy się w tym celu z Twoim serwerem; to Twój serwer prosi o swoje żądania. Dla repozytorium git możesz też wybrać język (PHP, Node.js, Python, Ruby, Go, .NET lub Java); przy Wykryj automatycznie serwer rozpozna go po plikach repozytorium. Gdy wybór nie zgadza się z plikami, serwer używa Twojego wyboru i zaznacza to w stanie projektu.

Karta Projekty wymienia każdy projekt zgłoszony przez serwer, z jego adresem, oraz te, o które poprosiłeś, a które są jeszcze w drodze lub zakończyły się niepowodzeniem, z powodem.

Naprawianie, usuwanie i aliasy

Menu ⋯ przy projekcie na karcie Projekty:

  • Edytuj i spróbuj ponownie (projekt, którego konfiguracja się nie powiodła): formularz otwiera się z Twoim zgłoszeniem, na przykład z adresem URL repozytorium lub przepisem. Popraw je i wyślij ponownie. Usuń z listy ukrywa nieudane zgłoszenie.
  • Edytuj i zainstaluj ponownie (projekt na serwerze): folder projektu zostanie usunięty, a projekt skonfigurowany od zera z wybranym typem. Jego dane zostają zachowane, więc nowy projekt je odnajdzie, chyba że zaznaczysz Usuń także jego bazy danych (co to usuwa, opisano poniżej). Najpierw zrób commit i push swojej pracy: pliki spoza gita przepadną.
  • Usuń, zachowaj dane usuwa folder projektu w ~/Code, jego stronę i serwer deweloperski; bazy danych i pliki w magazynie zostają. Usuń całkowicie, z danymi usuwa także dane projektu: bazy danych MySQL, MariaDB, PostgreSQL i MongoDB o jego nazwie (my-shop używa my_shop) oraz jego bucket RustFS (my-shop) ze wszystkimi przesłanymi do niego plikami.
  • Dodaj alias nadaje projektowi dodatkowy adres: alias store sprawia, że https://store.dev.test otwiera tę samą stronę, na Twoim laptopie i na każdym urządzeniu w Twoim tailnecie. Kropki tworzą podadresy, takie jak api.shop. Aliasy są widoczne pod projektem; × przy aliasie usuwa go.

Serwer wykonuje każdą akcję w ciągu kilku sekund; wymaga to rdev 1.0.3 lub nowszego, a usuwanie danych MongoDB i RustFS wymaga 1.0.4. Na samym serwerze rdev domain add <name> store.dev.test dodaje alias, a rdev project remove <name> --delete-files usuwa projekt utworzony przez rdev project add (w przypadku strony Laravel lub WordPress usuń jej folder).

Zanim usuniesz dane, sprawdź, czego to dotyczy:

  • Nie można tego cofnąć. Nocna kopia zapasowa w Pro i Team zawiera bazy danych, więc możesz je przywrócić z panelu; nie zawiera bucketów RustFS, więc przesłane pliki przepadają na zawsze. Najpierw pobierz to, czego potrzebujesz.
  • Liczy się nazwa, nie właściciel. rdev usuwa bazę danych i bucket o nazwie projektu. Jeśli .env innego projektu wskazuje tę samą bazę danych lub ten sam bucket, ten projekt również straci swoje dane.
  • Zatrzymana usługa zachowuje swoje dane. rdev usuwa tylko w działających usługach i podaje, które pominął; uruchom je i powtórz usuwanie albo usuń dane samodzielnie.
  • W planie Team środowisko każdego członka ma własne usługi; usunięcie projektu w Twoim środowisku nigdy nie dotyka współdzielonych usług właściciela.

Dodawanie usługi do projektu

Projekt może dostać usługę później, gdy jej potrzebuje:

rdev project service shop postgres

W panelu wybierz Dodaj usługę przy projekcie lub obok serwera. Wybór wersji, ustawienia .env i resztę opisano w Usługi.

Zmienne środowiskowe z panelu

Aby ustawić klucz API lub inny sekret bez otwierania terminala, otwórz serwer z Serwery na pasku bocznym i użyj Zmienne środowiskowe: wybierz projekt, wpisz nazwę i wartość w Dodaj lub zmień i wybierz Zaszyfruj i zapisz. Serwer zapisuje to w .env projektu w ciągu kilku sekund.

Wartości są szyfrowane w przeglądarce kluczem Twojego serwera, więc rdev.cloud nigdy ich nie widzi i nie może ich później pokazać. Teraz w .env wymienia tylko nazwy. Aby zmienić wartość, kliknij jej nazwę: przenosi się do Dodaj lub zmień, gdzie wpisujesz nową wartość. Kliknij × przy nazwie, aby ją usunąć; usunięcie APP_KEY lub ustawień DB_ zwykle psuje aplikację.