Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Servizi

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_dump o mongodump.
  • 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 che rdev host update conserva; qualsiasi cosa installata altrove con sudo apt sparisce dopo il successivo aggiornamento dell'ambiente.

  • Lo vuoi supportato come i servizi qui sopra, con versioni, pannello, impostazioni .env e 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".