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

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

Korzystanie z rdev

Usługi

Bazy danych, cache, wyszukiwanie i przechowywanie plików działają wewnątrz Twojego środowiska, obok Twoich witryn. rdev instaluje każdą usługę przy pierwszej potrzebie projektu, w wybranej wersji, utrzymuje ją przy życiu i zapisuje ustawienia połączenia w .env projektu.

Co jest dostępne

Usługa Do czego służy Wersje Domyślny port
MySQL Relacyjna baza danych 8.0, 8.4, 9.7 3306
MariaDB Relacyjna baza danych 10.11, 11.4, 11.8, 12.3 3307
PostgreSQL Relacyjna baza danych; buildy -full dodają pgvector, PostGIS, pgRouting i (od 16) TimescaleDB 14, 15, 16, 17, 18 5432
MongoDB Dokumentowa baza danych 7.0, 8.0, 9.0 27017
Redis Cache, kolejki i sesje 9.1 6379
Meilisearch Wyszukiwanie pełnotekstowe, dla Laravel Scout 1 7700
Typesense Wyszukiwanie pełnotekstowe, dla Laravel Scout 29, 30 8108
RustFS Przechowywanie plików zgodne z S3, z konsolą WWW na następnym porcie 1 9000
Elasticsearch Wyszukiwanie i analityka, dla sterowników Scout i klientów Elastic (działa bez uczenia maszynowego) 8.19, 9 9200
Qdrant Wyszukiwanie wektorowe dla funkcji AI, takich jak wyszukiwanie semantyczne 1 6333
Przechwytywanie poczty Przechwytuje wychodzące e-maile, aby nic nie trafiło do prawdziwych skrzynek; SMTP 127.0.0.1:2525, podgląd w przeglądarce pod https://rdev-mail.dev.test wbudowane
Serwer zrzutów Zbiera zrzuty debugowania z Twojego kodu; 127.0.0.1:2304, podgląd w przeglądarce pod https://rdev-dumps.dev.test wbudowane

Redis mówi standardowym protokołem Redis: sterowniki redis Laravela i phpredis działają bez zmian. Każda usługa nasłuchuje tylko wewnątrz Twojego środowiska, na 127.0.0.1; do konsoli WWW, takiej jak RustFS, docierasz przez swoje połączenie z laptopa.

Przechwycona poczta i zrzuty w przeglądarce

Otwórz https://rdev-mail.dev.test w dowolnej przeglądarce w swoim tailnecie, aby przeczytać pocztę wysłaną przez Twoje aplikacje. Zobaczysz listę (najnowsze na górze), nagłówki każdej wiadomości, jej wersję tekstową i HTML oraz załączniki. Możesz usunąć jedną wiadomość lub wszystkie, a nowa poczta pojawia się sama. Poczta HTML jest wyświetlana z zablokowanymi skryptami i zdalnymi obrazami.

https://rdev-dumps.dev.test wyświetla wywołania dump() i inne przechwycone zdarzenia, najnowsze na górze, wraz z plikiem i linią, z której pochodzą. Wyczyść listę przyciskiem Clear.

Obie strony działają na Twoim serwerze i są dostępne tylko przez Twój tailnet, tak jak Twoje projekty. Dane nigdy nie opuszczają Twojego serwera, a podgląd nigdy nie może ich upublicznić. rdev mail list wypisuje oba adresy, a aplikacja na laptopa otwiera je przyciskami Mail i Dumps na karcie Sites. Nazwy rdev-mail i rdev-dumps są zarezerwowane, więc projekt nie może ich używać.

Bazy danych w przeglądarce

https://rdev-adminer.dev.test otwiera na Twoim serwerze Adminer, menedżer baz danych. Wybierz MySQL lub PostgreSQL, serwer 127.0.0.1, użytkownika root (MySQL) lub postgres (PostgreSQL) i zostaw puste hasło; dla SQLite podaj ścieżkę do pliku bazy. Tak jak strony powyżej jest dostępny tylko przez Twój tailnet, a nazwa rdev-adminer jest zarezerwowana. Jest dostępny od rdev 1.2.0; na serwerze zainstalowanym wcześniej najpierw uruchom sudo rdev host update.

Daj projektowi usługę

Na serwerze podaj projekt i usługę:

rdev project service shop postgres

rdev instaluje i uruchamia usługę, jeśli jeszcze nie działa, tworzy bazę danych (MySQL, MariaDB, PostgreSQL) lub bucket (RustFS) nazwany od projektu i zapisuje ustawienia połączenia w .env projektu. Projekt bez .env dostaje ustawienia wypisane na ekranie. MongoDB tworzy bazę danych przy pierwszym zapisie z Twojego kodu; dla projektu PHP rdev instaluje też rozszerzenie PHP mongodb dla wersji PHP używanej przez witrynę (zobacz Rozszerzenia PHP).

Gdy projekt Laravel dostaje nową bazę danych MySQL, MariaDB lub PostgreSQL, rdev uruchamia też php artisan migrate --force, więc tabele, w których nowa aplikacja trzyma sesje, cache i kolejkę, istnieją, a witryna nadal działa. Robi to tylko dla właśnie utworzonej bazy, która jest jeszcze pusta; istniejąca baza danych zostaje bez zmian. Jeśli migracja się nie powiedzie, usługa zostaje na miejscu, a komunikat mówi dlaczego, więc możesz uruchomić php artisan migrate samodzielnie.

W panelu otwórz serwer z Serwery na pasku bocznym i wybierz Dodaj usługę w jego karcie Usługi, u góry lub obok projektu (panel ma ten sam przycisk), wybierz usługę i, dla usług z kilkoma wersjami, Wersję. Wiersz projektu pokazuje, na jakim etapie jest serwer: instalowanie i uruchamianie usługi, tworzenie bazy danych, zapisywanie .env, uruchamianie migracji. Powiadomienie mówi, kiedy jest gotowe. Pierwsza instalacja usługi może potrwać kilka minut. Twój agent AI może zrobić to samo przez swój dostęp MCP; poproś go o „bazę danych PostgreSQL dla shop”.

Nowy projekt może dostać swoje usługi w tym samym poleceniu:

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

Co trafia do .env

Usługa Ustawienia
MySQL, MariaDB, PostgreSQL DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (bez hasła: dostęp ma tylko Twoje środowisko)
MongoDB MONGODB_URI, MONGODB_DATABASE, dla pakietu 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) i ELASTIC_HOST (127.0.0.1:9200); bez SCOUT_DRIVER, ponieważ Laravel nie ma wbudowanego sterownika Elasticsearch: ustaw go dla używanego pakietu
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

Wartości już obecne w .env dla tych kluczy są zastępowane; pozostałe linie zostają bez zmian.

Otwieranie bazy danych w aplikacji desktopowej

Bazy danych możesz przeglądać i edytować dowolną aplikacją bazodanową na laptopie, na przykład TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Usługi nasłuchują tylko wewnątrz środowiska, więc wybierz w aplikacji opcję SSH (tunel SSH): host SSH to adres Tailscale serwera (HostName we wpisie rdev w ~/.ssh/config), użytkownik dev, port 22 i klucz SSH, którym loguje się laptop. Następnie połącz się z bazą pod 127.0.0.1, używając portu i danych logowania z tabeli powyżej. Wymaga to połączonego laptopa; dane płyną przez Twój tailnet i nigdy nie przechodzą przez rdev.cloud.

Nie masz pod ręką aplikacji albo jesteś na telefonie lub tablecie? https://rdev-adminer.dev.test otwiera Adminera w przeglądarce (zobacz sekcję o Adminerze powyżej).

Ustawienia domyślne

Każda usługa nasłuchuje wyłącznie na 127.0.0.1 wewnątrz Twojego środowiska, więc nic spoza niego nie może się z nią połączyć, a wszystkie są skonfigurowane pod programowanie:

Usługa Dane dostępowe Warto wiedzieć
MySQL, MariaDB Użytkownik root, bez hasła Każdy projekt dostaje bazę danych o swojej nazwie (my-shop zmienia się w my_shop).
PostgreSQL Użytkownik postgres, bez hasła (uwierzytelnianie trust) Brak gniazda Unix: łącz się z 127.0.0.1. Baza danych na projekt, jak wyżej.
MongoDB Brak uwierzytelniania Baza danych pojawia się, gdy Twój kod zapisze do niej po raz pierwszy.
Redis Bez hasła Przechowywane tylko w pamięci: restart usługi czyści pamięć podręczną, kolejki i sesje.
Meilisearch Brak master key Tryb deweloperski, analityka wyłączona.
Typesense Klucz API rdev-typesense CORS jest włączony, więc strona na Twoim laptopie może odpytywać go bezpośrednio.
Elasticsearch Brak użytkownika i hasła (zabezpieczenia wyłączone) Pojedynczy węzeł z 512 MB pamięci; uczenie maszynowe nie jest wliczone.
Qdrant Brak klucza API gRPC na porcie następującym po porcie HTTP (6334); telemetria wyłączona.
RustFS Klucz dostępu rdev, klucz tajny rdev-secret Bucket na projekt; konsola webowa jest na następnym porcie (9001).

W panelu Konfiguracja w menu ⋯ usługi pokazuje to samo dla wersji i portu używanych przez Twój serwer, razem z liniami .env jej pierwszego projektu, gotowymi do skopiowania. Aby zmienić opcję, użyj rdev service set (zobacz niżej; MySQL, MariaDB, PostgreSQL i Redis), na przykład rdev service set redis appendonly yes, aby zachować dane Redis po restartach.

Wybór wersji

Dodaj @ i wersję lub linię wydań do usługi:

rdev project service shop [email protected]

Instaluje to najnowszy MySQL 8.0 i przełącza na niego. Bez wersji dostajesz tę już zainstalowaną albo najnowszą. Aby zobaczyć każdą wersję, którą możesz zainstalować:

rdev service available

Naraz działa jedna wersja każdej usługi:

  • MySQL i MariaDB przechowują osobne dane dla każdej linii wydań (8.0, 8.4, 9.7…). Przejście na nowszą linię zaczyna się od kopii danych starszej linii, które nowszy serwer uaktualnia; dane starszej linii zostają bez zmian, więc możesz wrócić. Przejście na starszą linię zaczyna się od pustych danych, ponieważ starszy serwer nie potrafi odczytać nowszych danych.
  • PostgreSQL i MongoDB przechowują osobne dane dla każdej wersji głównej (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Nowa wersja główna zaczyna się pusta; przenieś dane za pomocą pg_dump lub mongodump.
  • Meilisearch i Typesense odbudowują swoje indeksy z Twojej aplikacji (php artisan scout:import) po zmianie wersji.

MySQL używa portu 3306, a MariaDB 3307, więc oba mogą być zainstalowane i działać jednocześnie; projekty dostają właściwy port w swoim .env. MariaDB używała 3306 przed rdev 0.2.0-beta.37; po tej aktualizacji ustaw DB_PORT=3307 w .env projektu, który jej używa, albo zachowaj stary port poleceniem rdev service set-port mariadb 3306. Wybór wersji wymaga rdev 0.2.0-beta.18 lub nowszego.

Rozszerzenia PostgreSQL

Buildy -full PostgreSQL zawierają pgvector (wyszukiwanie wektorowe dla funkcji AI), PostGIS i pgRouting (mapy i trasy) oraz, od wersji 16, TimescaleDB (szeregi czasowe). Wybierz jeden według jego pełnej wersji, tak jak wymienia ją rdev service available:

rdev project service shop [email protected]

Potem włącz rozszerzenie w swojej bazie danych, na przykład w migracji:

CREATE EXTENSION IF NOT EXISTS vector;

To samo dotyczy postgis, pgrouting i timescaledb. rdev automatycznie ładuje TimescaleDB z wyprzedzeniem, gdy build go zawiera.

Zarządzanie usługami

Karta Usługi na stronie Twojego serwera wymienia każdą zainstalowaną usługę z jej wersją, informacją, czy działa, jej portem i projektami, którym dałeś ją z panelu. Menu ⋯ w wierszu uruchamia, zatrzymuje lub restartuje ją, instaluje ponownie tę samą wersję (dane są zachowane) albo ją odinstalowuje, zachowując jej dane do późniejszej instalacji lub usuwając je także. Wiersz, którego konfiguracja się nie powiodła, pokazuje przyczynę w tym samym menu i można go spróbować ponownie lub usunąć z listy. Serwer wykonuje każdą akcję w ciągu kilku sekund, a tabela za tym podąża; wymaga to rdev 0.2.0-beta.24 lub nowszego na serwerze.

Na samym serwerze:

Polecenie Co robi
rdev service available Wyświetla wersje, które możesz zainstalować
rdev service start mysql / stop / restart Uruchamia, zatrzymuje lub restartuje usługę
rdev service logs mysql Pokazuje ostatnie linie jej logu
rdev service set-port mysql 3307 Przenosi ją na inny port (przy następnym restarcie)
rdev service set mysql max_connections 300 Ustawia opcję konfiguracji (przy następnym restarcie; MySQL, MariaDB, PostgreSQL i Redis)
rdev service change-version mysql 9.7.4 Przełącza na inną wersję
rdev service uninstall mysql 9.7.4 Usuwa wersję; dodaj --purge, aby usunąć także jej dane

Usługi startują razem z Twoim środowiskiem. Usunięcie projektu nigdy nie usuwa jego bazy danych; usuń ją samodzielnie, gdy nie będzie już potrzebna.

Zespoły i kopie zapasowe

W planie Team każde środowisko członka dociera do usług właściciela pod nazwą rdev-team, obok własnych prywatnych (Zespoły).

Nocna kopia zapasowa danych w Pro i Team obejmuje każdą bazę danych MySQL, MariaDB, PostgreSQL i MongoDB oraz Twój folder ~/Code i przywraca je z panelu (Kopie zapasowe). MySQL i MariaDB są kopiowane każda na własnym porcie; MongoDB jako jedno archiwum wszystkich swoich baz danych. Indeksy wyszukiwania i buckety RustFS są odbudowywane z Twojej aplikacji i Twoich własnych kopii.

Usługa, której nie ma na liście

Nie musisz czekać na nas, aby uruchomić coś innego:

  • Usługa napisana w Node.js, Pythonie, Ruby lub Go działa jako projekt. rdev instaluje jej środowisko uruchomieniowe, uruchamia polecenie, nadaje jej port i uruchamia ją ponownie, jeśli się zatrzyma:

    rdev project add realtime --lang node --command "npx soketi start --port={port}"
    
  • Inne oprogramowanie trafia do Twojego katalogu domowego, na przykład pobrany plik binarny w ~/.local/bin, i startuje z polecenia projektu w ten sam sposób. Twój katalog domowy to ta część środowiska, którą zachowuje rdev host update; wszystko zainstalowane gdzie indziej przez sudo apt znika po następnej aktualizacji środowiska.

  • Chcesz, aby było wspierane jak usługi powyżej, z wersjami, panelem, ustawieniami .env i kopiami zapasowymi? Napisz do nas, podając usługę i do czego jej używasz. Dodajemy usługi, których potrzebuje kilku klientów, i informujemy Cię, na jakim jest etapie.

Twój agent AI może skonfigurować za Ciebie dwa pierwsze; poproś go o „uruchom Elasticsearch dla projektu shop”.