Database, cache, ricerca e archiviazione di file girano all'interno del tuo ambiente, accanto ai tuoi siti. rdev installa ogni servizio la prima volta che un progetto ne ha bisogno, nella versione che scegli, lo mantiene in esecuzione e scrive le impostazioni di connessione nel .env del progetto.
Cosa è disponibile
| Servizio | A cosa serve | Versioni | Porta predefinita |
|---|---|---|---|
| MySQL | Database relazionale | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Database relazionale | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Database relazionale; le build -full aggiungono pgvector, PostGIS, pgRouting e (dalla 16) TimescaleDB |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Database documentale | 7.0, 8.0, 9.0 | 27017 |
| Redis | Cache, code e sessioni | 9.1 | 6379 |
| Meilisearch | Ricerca full-text, per Laravel Scout | 1 | 7700 |
| Typesense | Ricerca full-text, per Laravel Scout | 29, 30 | 8108 |
| RustFS | Archiviazione di file compatibile con S3, con una console web sulla porta successiva | 1 | 9000 |
| Elasticsearch | Ricerca e analisi, per i driver Scout e i client Elastic (gira senza machine learning) | 8.19, 9 | 9200 |
| Qdrant | Ricerca vettoriale per funzionalità AI come la ricerca semantica | 1 | 6333 |
| Cattura delle email | Intercetta le email in uscita così che nulla raggiunga caselle reali; SMTP 127.0.0.1:2525, da consultare nel browser su https://rdev-mail.dev.test |
integrata | |
| Server di dump | Raccoglie i dump di debug dal tuo codice; 127.0.0.1:2304, da consultare nel browser su https://rdev-dumps.dev.test |
integrato |
Redis parla il protocollo Redis standard: i driver redis di Laravel e phpredis funzionano senza modifiche. Ogni servizio ascolta solo all'interno del tuo ambiente, su 127.0.0.1; raggiungi una console web come quella di RustFS tramite la connessione del tuo laptop.
Email e dump catturati nel tuo browser
Apri https://rdev-mail.dev.test in qualsiasi browser della tua tailnet per leggere le email inviate dalle tue app. Vedi l'elenco (le più recenti per prime), le intestazioni di ogni messaggio, le versioni in testo semplice e HTML e gli allegati. Puoi eliminare un messaggio o tutti, e le nuove email compaiono da sole. Le email HTML vengono mostrate con script e immagini remote bloccati.
https://rdev-dumps.dev.test elenca le chiamate a dump() e gli altri eventi catturati, i più recenti per primi, con il file e la riga da cui provengono. Svuota l'elenco con Clear.
Entrambe le pagine girano sul tuo server e sono raggiungibili solo tramite la tua tailnet, come i tuoi progetti. I dati non lasciano mai il tuo server e un'anteprima non può mai renderle pubbliche. rdev mail list stampa entrambi gli indirizzi, e l'app per laptop li apre da Mail e Dumps nella scheda Sites. I nomi rdev-mail e rdev-dumps sono riservati, quindi un progetto non può usarli.
I database nel browser
https://rdev-adminer.dev.test apre Adminer, un gestore di database, sul tuo server. Scegli MySQL o PostgreSQL, server 127.0.0.1, utente root (MySQL) o postgres (PostgreSQL) e lascia vuota la password; per SQLite inserisci il percorso del file del database. Come le pagine sopra, è raggiungibile solo dalla tua tailnet e il nome rdev-adminer è riservato. Arriva con rdev 1.2.0; su un server installato prima, esegui prima sudo rdev host update.
Dare un servizio a un progetto
Sul server, indica il progetto e il servizio:
rdev project service shop postgres
rdev installa e avvia il servizio se non è ancora in esecuzione, crea un database (MySQL, MariaDB, PostgreSQL) o un bucket (RustFS) con il nome del progetto, e scrive le impostazioni di connessione nel .env del progetto. Un progetto senza .env riceve invece le impostazioni stampate. MongoDB crea il database la prima volta che il tuo codice vi scrive; per un progetto PHP rdev installa anche l'estensione PHP mongodb per la versione di PHP usata dal sito (vedi Estensioni PHP).
Quando un progetto Laravel ottiene un nuovo database MySQL, MariaDB o PostgreSQL, rdev esegue anche php artisan migrate --force, così le tabelle in cui una nuova app tiene sessioni, cache e coda sono presenti e il sito continua a funzionare. Lo fa solo per un database appena creato, che è ancora vuoto; un database esistente viene lasciato com'è. Se la migrazione fallisce, il servizio resta al suo posto e il messaggio ti dice perché, così puoi eseguire tu php artisan migrate.
Nel pannello, apri il server da Server nella barra laterale e scegli Aggiungi servizio nella sua scheda Servizi, in alto o accanto a un progetto (la dashboard ha lo stesso pulsante), scegli il servizio e, per i servizi con più versioni, la Versione. La riga del progetto mostra a che punto è il server: installazione e avvio del servizio, creazione del database, scrittura del .env, esecuzione delle migrazioni. Una notifica dice quando è pronto. Installare un servizio per la prima volta può richiedere qualche minuto. Il tuo agente AI può fare lo stesso tramite il suo accesso MCP; chiedigli "un database PostgreSQL per shop".
Un nuovo progetto può ottenere i suoi servizi con lo stesso comando:
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
Cosa finisce nel .env
| Servizio | Impostazioni |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (nessuna password: solo il tuo ambiente può raggiungerlo) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, per il pacchetto 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) e ELASTIC_HOST (127.0.0.1:9200); nessun SCOUT_DRIVER, dato che Laravel non ha un driver Elasticsearch integrato: impostalo per il pacchetto che usi |
| 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 |
I valori già presenti nel .env per queste chiavi vengono sostituiti; le altre righe restano come sono.
Aprire un database in un'app desktop
Puoi consultare e modificare i tuoi database con qualsiasi app per database sul tuo portatile, per esempio TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. I servizi ascoltano solo all'interno del tuo ambiente, quindi scegli l'opzione SSH (tunnel SSH) dell'app: l'host SSH è l'indirizzo Tailscale del tuo server (il HostName della voce rdev in ~/.ssh/config), utente dev, porta 22 e la chiave SSH con cui accede il tuo portatile. Poi collegati al database su 127.0.0.1 con la porta e le credenziali della tabella sopra. Serve un portatile collegato; i dati viaggiano sulla tua tailnet e non passano mai da rdev.cloud.
Nessuna app a portata di mano, o sei su telefono o tablet? https://rdev-adminer.dev.test apre Adminer nel browser (vedi la sezione Adminer sopra).
Impostazioni predefinite
Ogni servizio è in ascolto solo su 127.0.0.1 all'interno del tuo ambiente, quindi nulla all'esterno può raggiungerlo, e sono già configurati per lo sviluppo:
| Servizio | Credenziali | Da sapere |
|---|---|---|
| MySQL, MariaDB | Utente root, senza password |
Ogni progetto riceve un database con il suo nome (my-shop diventa my_shop). |
| PostgreSQL | Utente postgres, senza password (autenticazione trust) |
Nessun socket Unix: collegati a 127.0.0.1. Un database per progetto, come sopra. |
| MongoDB | Nessuna autenticazione | Un database compare la prima volta che il tuo codice vi scrive. |
| Redis | Nessuna password | Tenuto solo in memoria: riavviare il servizio svuota cache, code e sessioni. |
| Meilisearch | Nessuna master key | Modalità sviluppo, analisi disattivata. |
| Typesense | Chiave API rdev-typesense |
CORS è attivo, quindi una pagina sul tuo laptop può interrogarlo direttamente. |
| Elasticsearch | Nessun utente né password (sicurezza disattivata) | Un singolo nodo con 512 MB di memoria; il machine learning non è incluso. |
| Qdrant | Nessuna chiave API | gRPC sulla porta successiva a quella HTTP (6334); telemetria disattivata. |
| RustFS | Chiave di accesso rdev, chiave segreta rdev-secret |
Un bucket per progetto; la console web è sulla porta successiva (9001). |
Nel pannello, Configurazione nel menu ⋯ di un servizio mostra lo stesso per la versione e la porta usate dal tuo server, con le righe .env del suo primo progetto, pronte da copiare. Per cambiare un'opzione usa rdev service set (vedi sotto; MySQL, MariaDB, PostgreSQL e Redis), ad esempio rdev service set redis appendonly yes per conservare i dati di Redis tra i riavvii.
Scegliere una versione
Aggiungi @ e una versione o linea di release al servizio:
rdev project service shop [email protected]
Questo installa l'ultimo MySQL 8.0 e passa a quello. Senza una versione ottieni quella già installata, oppure la più recente. Per vedere ogni versione installabile:
rdev service available
Una sola versione di ciascun servizio è in esecuzione alla volta:
- MySQL e MariaDB conservano dati separati per ogni linea di release (8.0, 8.4, 9.7…). Passare a una linea più recente parte da una copia dei dati della linea più vecchia, che il server più recente aggiorna; i dati della linea più vecchia restano com'erano, così puoi tornare indietro. Passare a una linea più vecchia parte con dati vuoti, perché un server più vecchio non può leggere dati più recenti.
- PostgreSQL e MongoDB conservano dati separati per ogni versione principale (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Una nuova versione principale parte vuota; sposta i tuoi dati con
pg_dumpomongodump. - Meilisearch e Typesense ricostruiscono i loro indici dalla tua app (
php artisan scout:import) dopo un cambio di versione.
MySQL usa la porta 3306 e MariaDB la 3307, quindi entrambi possono essere installati e in esecuzione contemporaneamente; i progetti ottengono la porta giusta nel loro .env. MariaDB usava la 3306 prima di rdev 0.2.0-beta.37; dopo quell'aggiornamento, imposta DB_PORT=3307 nel .env di un progetto che lo usa, oppure mantieni la vecchia porta con rdev service set-port mariadb 3306. La scelta delle versioni richiede rdev 0.2.0-beta.18 o successivo.
Estensioni PostgreSQL
Le build -full di PostgreSQL includono pgvector (ricerca vettoriale per funzionalità AI), PostGIS e pgRouting (mappe e percorsi) e, dalla versione 16, TimescaleDB (serie temporali). Sceglila tramite la sua versione completa, come la elenca rdev service available:
rdev project service shop [email protected]
Poi attiva l'estensione nel tuo database, ad esempio in una migrazione:
CREATE EXTENSION IF NOT EXISTS vector;
Lo stesso vale per postgis, pgrouting e timescaledb. rdev precarica automaticamente TimescaleDB quando la build lo include.
Gestire i servizi
La scheda Servizi nella pagina del tuo server elenca ogni servizio installato con la sua versione, se è in esecuzione, la sua porta e i progetti a cui lo hai dato dal pannello. Il menu ⋯ su una riga lo avvia, lo ferma o lo riavvia, reinstalla la stessa versione (i dati vengono conservati), oppure lo disinstalla, conservando i suoi dati per una successiva installazione o eliminandoli anch'essi. Una riga la cui configurazione è fallita mostra il motivo nello stesso menu e può essere riprovata o rimossa dall'elenco. Il server esegue ogni azione in pochi secondi e la tabella la segue; serve rdev 0.2.0-beta.24 o successivo sul server.
Sul server stesso:
| Comando | Cosa fa |
|---|---|
rdev service available |
Elenca le versioni installabili |
rdev service start mysql / stop / restart |
Avvia, ferma o riavvia un servizio |
rdev service logs mysql |
Mostra le ultime righe del suo log |
rdev service set-port mysql 3307 |
Lo sposta su un'altra porta (al prossimo riavvio) |
rdev service set mysql max_connections 300 |
Imposta un'opzione di configurazione (al prossimo riavvio; MySQL, MariaDB, PostgreSQL e Redis) |
rdev service change-version mysql 9.7.4 |
Passa a un'altra versione |
rdev service uninstall mysql 9.7.4 |
Rimuove una versione; aggiungi --purge per eliminare anche i suoi dati |
I servizi partono insieme al tuo ambiente. Rimuovere un progetto non rimuove mai il suo database; eliminalo tu quando non ti serve più.
Team e backup
In un piano Team, ogni ambiente dei membri raggiunge i servizi del proprietario al nome rdev-team, accanto ai propri privati (Team).
Il backup notturno dei dati in Pro e Team include ogni database MySQL, MariaDB, PostgreSQL e MongoDB e la tua cartella ~/Code, e li ripristina dal pannello (Backup). MySQL e MariaDB vengono salvati ciascuno sulla propria porta; MongoDB come un unico archivio di tutti i suoi database. Gli indici di ricerca e i bucket RustFS vengono ricostruiti dalla tua app e dalle tue copie.
Un servizio che non è nell'elenco
Non devi aspettare noi per eseguire qualcos'altro:
-
Un servizio scritto in Node.js, Python, Ruby o Go gira come progetto. rdev installa il suo runtime, avvia il comando, gli assegna una porta e lo riavvia se si ferma:
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
Altro software va nella tua cartella home, ad esempio un binario scaricato in
~/.local/bin, e parte dal comando di un progetto nello stesso modo. La tua cartella home è la parte dell'ambiente cherdev host updateconserva; qualsiasi cosa installata altrove consudo aptsparisce dopo il successivo aggiornamento dell'ambiente. -
Lo vuoi supportato come i servizi qui sopra, con versioni, pannello, impostazioni
.enve backup? Scrivici indicando il servizio e per cosa lo usi. Aggiungiamo i servizi di cui hanno bisogno più clienti e ti diciamo a che punto siamo.
Il tuo agente AI può configurare per te i primi due; chiedigli di "far girare Elasticsearch per il progetto shop".