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

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Progetti e siti

Ogni progetto sul tuo server diventa un sito con il proprio indirizzo e HTTPS attendibile.

Indirizzi dei siti

Ogni progetto ottiene https://<name>.dev.test. Il certificato è considerato attendibile dal tuo laptop, quindi il browser non mostra avvisi, e l'indirizzo funziona ovunque il tuo laptop sia collegato alla tua tailnet.

PHP

  • Ogni versione di PHP dalla 7.4 alla 8.5, scelta per ogni sito.
  • Laravel e WordPress sono di prima classe.
  • Sono supportati anche altri framework PHP e progetti PHP semplici.
  • Estensioni come mongodb e xdebug si installano con un comando; vedi Estensioni PHP.

Altri linguaggi

I progetti Python, Ruby, Node.js, Go, .NET, Java e Flutter sono supportati. Nessun runtime di linguaggio è installato per impostazione predefinita: quando aggiungi un progetto in uno di questi linguaggi, rdev installa in quel momento il runtime di cui ha bisogno e lo riusa per i progetti successivi.

Questo mantiene l'ambiente leggero, e i runtime che non usi mai non hanno bisogno di aggiornamenti.

Database e servizi

Ogni progetto può usare MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense o RustFS nella versione che scegli, più cattura delle email e un server di dump. A cosa serve ciascuno, le versioni, le impostazioni .env e come eseguire qualcosa che non è nell'elenco sono in Servizi.

Aggiungere un progetto

Puoi aggiungere un progetto in tre modi:

  • chiedendo al tuo agente AI, che crea siti tramite il suo accesso MCP;
  • con lo strumento da riga di comando rdev sul server;
  • dal pannello web.

Qualsiasi cartella che crei in ~/Code viene servita subito come https://<folder>.dev.test, quindi basta clonarvi un progetto PHP.

Ricette: partire da un framework

Una ricetta avvia un nuovo progetto da un framework in una cartella ~/Code/<name> vuota: rdev installa il linguaggio, esegue l'installer del framework stesso, imposta il comando del server di sviluppo e serve l'app su https://<name>.dev.test.

Linguaggio Ricette
PHP Laravel e WordPress (integrati), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (con Capacitor), Expo (React Native), NestJS, Express, un progetto Node.js vuoto
Python Django, Flask, FastAPI, un progetto Python vuoto (ciascuno nel proprio .venv)
Ruby Ruby on Rails, Sinatra, un progetto Rack vuoto
Go Gin, Echo, Fiber, un modulo Go vuoto
.NET ASP.NET Core Web API, Blazor, un'app ASP.NET Core vuota
Java Spring Boot, Quarkus, Micronaut, un progetto Java vuoto
Flutter Un'app Flutter per web, Android e iOS, con anteprima web dal vivo; un server HTTP Dart (shelf)

Le ricette mobile (Ionic, Expo e Flutter) eseguono l'anteprima web dell'app sul server; le build per Android e iOS avvengono sul tuo laptop. Expo Go su un telefono che si trova nella tua tailnet può anche aprire un progetto Expo direttamente dal server.

  • Nel pannello: apri il server in Server, vai alla scheda Ricette e scegli Crea progetto su una ricetta, oppure sceglila come tipo in Aggiungi progetto. Il progetto compare poi nella scheda Progetti.
  • Sul server: rdev project recipes le elenca; rdev project add web --recipe nextjs ne avvia una.
  • Da un agente: lo strumento MCP che aggiunge progetti accetta una recipe, quindi puoi chiedere "avvia un progetto Django chiamato api".

Django e Rails sono configurati per accettare gli indirizzi *.dev.test; anche i server di sviluppo basati su Vite (Nuxt, Astro, SvelteKit) li ammettono. Le ricette provengono da un catalogo firmato da rdev, e il server rifiuta un catalogo la cui firma non risulta valida, così i nuovi framework arrivano senza un aggiornamento di rdev. Le ricette richiedono rdev 0.2.0-beta.38 o successivo.

Con la riga di comando

  • Clona un repository e servilo come progetto:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Avvia un progetto Python vuoto con il suo runtime:

    rdev project add api --lang python
    
  • Servi un sito con un'altra versione di PHP:

    rdev use shop 8.3
    

    Nel pannello, clicca il progetto nella colonna Progetti della scheda PHP del server (Estensioni PHP).

rdev project list mostra i tuoi progetti, rdev project start|stop|logs <name> controlla il server di sviluppo di un progetto non PHP, e rdev project remove <name> ne rimuove uno (i suoi file restano a meno che tu non aggiunga --delete-files).

Dal pannello

Puoi anche aggiungere un progetto senza aprire un terminale: apri il server in Server e scegli Aggiungi nella sua scheda Progetti, oppure scegli Aggiungi progetto accanto a un server nella dashboard; dagli un nome e scegli un tipo: una nuova app Laravel, un nuovo sito WordPress, un clone di un repository git, un progetto PHP vuoto o una delle ricette. Il server recepisce la richiesta entro circa cinque minuti e la dashboard mostra quando è pronto su https://<name>.dev.test. La tabella Aggiunto dal pannello nella dashboard elenca ogni progetto e servizio che hai richiesto, con il suo server, il suo stato e, quando qualcosa è fallito, il motivo. rdev non si collega mai al tuo server per questo; è il tuo server a chiedere le sue richieste. Per un repository git puoi anche scegliere il linguaggio (PHP, Node.js, Python, Ruby, Go, .NET o Java); lasciato su Rileva automaticamente, il server lo ricava dai file del repository. Se la tua scelta e i file non coincidono, il server usa la tua scelta e lo segnala nello stato del progetto.

La scheda Progetti elenca ogni progetto che il server segnala, con il suo indirizzo, e quelli che hai richiesto che sono ancora in arrivo o falliti, con il motivo.

Correggere, rimuovere e alias

Il menu ⋯ di un progetto nella scheda Progetti:

  • Modifica e riprova (un progetto la cui configurazione è fallita): il modulo si apre con ciò che hai richiesto, ad esempio l'URL del repository o la ricetta. Correggilo e invialo di nuovo. Rimuovi dall'elenco nasconde la richiesta fallita.
  • Modifica e reinstalla (un progetto sul server): la cartella del progetto viene eliminata e configurata di nuovo da zero, con il tipo che scegli. I suoi dati vengono mantenuti, quindi il nuovo progetto li ritrova, a meno che tu non selezioni Elimina anche i suoi database (qui sotto trovi cosa elimina). Fai prima commit e push del tuo lavoro: i file che non sono in git vanno persi.
  • Rimuovi, mantieni i dati elimina la cartella del progetto in ~/Code, il suo sito e il suo server di sviluppo; i suoi database e i file nello storage restano. Rimuovi completamente, con i dati elimina anche i dati del progetto: i database MySQL, MariaDB, PostgreSQL e MongoDB con il suo nome (my-shop usa my_shop) e il suo bucket RustFS (my-shop) con tutti i file caricati.
  • Aggiungi alias dà al progetto un altro indirizzo: l'alias store fa aprire lo stesso sito a https://store.dev.test, sul tuo laptop e su ogni dispositivo della tua tailnet. I punti creano sottoindirizzi come api.shop. Gli alias compaiono sotto il progetto; la × su uno di essi lo rimuove.

Il server esegue ogni azione in pochi secondi; serve rdev 1.0.3 o successivo, e 1.0.4 per eliminare i dati di MongoDB e RustFS. Sul server stesso, rdev domain add <name> store.dev.test aggiunge un alias e rdev project remove <name> --delete-files rimuove un progetto creato con rdev project add (per un sito Laravel o WordPress, elimina la sua cartella).

Prima di eliminare i dati, sappi cosa colpisce:

  • Non si può annullare. Il backup notturno di Pro e Team contiene i database, quindi puoi ripristinarli dal pannello; non contiene i bucket RustFS, quindi i file caricati vanno persi per sempre. Scarica prima ciò che ti serve.
  • Vale il nome, non il proprietario. rdev elimina il database e il bucket con il nome del progetto. Se il .env di un altro progetto punta allo stesso database o bucket, anche quel progetto perde i suoi dati.
  • Un servizio fermo mantiene i suoi dati. rdev elimina solo nei servizi in esecuzione e indica quali ha saltato; avviali ed esegui di nuovo la rimozione, oppure elimina i dati tu stesso.
  • Con un piano Team l'ambiente di ogni membro ha i propri servizi; rimuovere un progetto nel tuo non tocca mai i servizi condivisi del proprietario.

Aggiungere un servizio a un progetto

Un progetto può ottenere un servizio in seguito, quando ne ha bisogno:

rdev project service shop postgres

Nel pannello, scegli Aggiungi servizio su un progetto o accanto a un server. La scelta di una versione, le impostazioni .env e il resto sono in Servizi.

Variabili d'ambiente dal pannello

Per impostare una chiave API o un altro segreto senza aprire un terminale, apri il server da Server nella barra laterale e usa Variabili d'ambiente: scegli il progetto, inserisci un nome e un valore in Aggiungi o modifica, e scegli Cifra e salva. Il server lo scrive nel .env del progetto in pochi secondi.

I valori vengono cifrati nel tuo browser con la chiave del tuo server, quindi rdev.cloud non li vede mai e non può mostrarli in seguito. Ora nel .env elenca solo i nomi. Per cambiare un valore, clicca sul suo nome: si sposta in Aggiungi o modifica, dove digiti il nuovo valore. Clicca × su un nome per rimuoverlo; rimuovere APP_KEY o le impostazioni DB_ di solito rompe l'app.