Chaque projet sur votre serveur devient un site avec sa propre adresse et un HTTPS de confiance.
Adresses des sites
Chaque projet obtient https://<name>.dev.test. Le certificat est reconnu par votre ordinateur portable, le navigateur n'affiche donc aucun avertissement, et l'adresse fonctionne partout où votre ordinateur portable est connecté à votre tailnet.
PHP
- Toutes les versions de PHP de 7.4 à 8.5, choisies par site.
- Laravel et WordPress sont prioritaires.
- Les autres frameworks PHP et les projets PHP simples sont aussi pris en charge.
- Des extensions comme
mongodbetxdebugs'installent avec une commande ; consultez Extensions PHP.
Autres langages
Les projets Python, Ruby, Node.js, Go, .NET, Java et Flutter sont pris en charge. Aucun runtime de langage n'est installé par défaut : quand vous ajoutez un projet dans l'un de ces langages, rdev installe à ce moment-là le runtime dont il a besoin, et le réutilise pour les projets suivants.
Cela garde l'environnement léger, et les runtimes que vous n'utilisez jamais n'ont pas besoin de mises à jour.
Bases de données et services
Chaque projet peut utiliser MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense ou RustFS dans la version de votre choix, plus la capture des e-mails et un serveur de dump. À quoi sert chacun, les versions, les paramètres .env et comment exécuter quelque chose qui n'est pas dans la liste se trouvent dans Services.
Ajouter un projet
Vous pouvez ajouter un projet de trois façons :
- en demandant à votre agent IA, qui crée des sites via son accès MCP ;
- avec l'outil en ligne de commande
rdevsur le serveur ; - depuis le panneau web.
Tout dossier que vous créez dans ~/Code est servi immédiatement à l'adresse https://<folder>.dev.test, il suffit donc d'y cloner un projet PHP.
Recettes pour démarrer depuis un framework
Une recette démarre un nouveau projet à partir d'un framework dans un dossier ~/Code/<name> vide : rdev installe le langage, exécute l'installateur propre au framework, définit la commande du serveur de développement et sert l'application à l'adresse https://<name>.dev.test.
| Langage | Recettes |
|---|---|
| PHP | Laravel et WordPress (intégrés), Symfony, Statamic, CodeIgniter, CakePHP, Drupal |
| Node.js | Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (avec Capacitor), Expo (React Native), NestJS, Express, un projet Node.js vide |
| Python | Django, Flask, FastAPI, un projet Python vide (chacun dans son propre .venv) |
| Ruby | Ruby on Rails, Sinatra, un projet Rack vide |
| Go | Gin, Echo, Fiber, un module Go vide |
| .NET | ASP.NET Core Web API, Blazor, une application ASP.NET Core vide |
| Java | Spring Boot, Quarkus, Micronaut, un projet Java vide |
| Flutter | Une application Flutter pour le web, Android et iOS, avec un aperçu web en direct ; un serveur HTTP Dart (shelf) |
Les recettes mobiles (Ionic, Expo et Flutter) exécutent l'aperçu web de l'application sur le serveur ; les builds Android et iOS se font sur votre ordinateur portable. Expo Go, sur un téléphone qui est dans votre tailnet, peut aussi ouvrir un projet Expo directement depuis le serveur.
- Dans le panneau : ouvrez le serveur sous Serveurs, allez à l'onglet Recettes et choisissez Créer le projet sur une recette, ou choisissez-la comme type dans Ajouter un projet. Le projet apparaît ensuite dans l'onglet Projets.
- Sur le serveur :
rdev project recipesles liste ;rdev project add web --recipe nextjsen démarre une. - Depuis un agent : l'outil MCP qui ajoute des projets accepte un
recipe, vous pouvez donc demander « démarre un projet Django appelé api ».
Django et Rails sont configurés pour accepter les adresses *.dev.test ; les serveurs de développement basés sur Vite (Nuxt, Astro, SvelteKit) les autorisent aussi. Les recettes proviennent d'un catalogue signé par rdev, et le serveur refuse un catalogue dont la signature ne se vérifie pas, de sorte que de nouveaux frameworks arrivent sans mise à jour de rdev. Les recettes nécessitent rdev 0.2.0-beta.38 ou une version ultérieure.
Avec la ligne de commande
-
Cloner un dépôt et le servir comme projet :
rdev project add shop --git [email protected]:you/shop.git -
Démarrer un projet Python vide avec son runtime :
rdev project add api --lang python -
Servir un site avec une autre version de PHP :
rdev use shop 8.3Dans le panneau, cliquez sur le projet dans la colonne Projets de la carte PHP du serveur (Extensions PHP).
rdev project list affiche vos projets, rdev project start|stop|logs <name> contrôle le serveur de développement d'un projet non PHP, et rdev project remove <name> en supprime un (ses fichiers restent sauf si vous ajoutez --delete-files).
Depuis le panneau
Vous pouvez aussi ajouter un projet sans ouvrir de terminal : ouvrez le serveur sous Serveurs et choisissez Ajouter dans son onglet Projets, ou choisissez Ajouter un projet à côté d'un serveur sur le tableau de bord ; donnez-lui un nom et choisissez un type : une nouvelle application Laravel, un nouveau site WordPress, un clone d'un dépôt git, un projet PHP vide ou l'une des recettes. Le serveur prend la demande en compte en cinq minutes environ et le tableau de bord indique quand le projet est prêt à l'adresse https://<name>.dev.test. Le tableau Ajouté depuis le panneau du tableau de bord liste chaque projet et service que vous avez demandé, avec son serveur, son statut et, quand quelque chose a échoué, la raison. rdev ne se connecte jamais à votre serveur pour cela ; c'est votre serveur qui vient chercher ses demandes. Pour un dépôt git, vous pouvez aussi choisir son langage (PHP, Node.js, Python, Ruby, Go, .NET ou Java) ; laissé sur Détecter automatiquement, le serveur le déduit des fichiers du dépôt. Si votre choix et les fichiers ne concordent pas, le serveur applique votre choix et le signale dans le statut du projet.
L'onglet Projets liste chaque projet que le serveur signale, avec son adresse, ainsi que ceux que vous avez demandés qui sont encore en route ou ont échoué, avec la raison.
Corriger, supprimer et alias
Le menu ⋯ d'un projet dans l'onglet Projets :
- Modifier et réessayer (un projet dont la configuration a échoué) : le formulaire s'ouvre avec votre demande, par exemple l'URL du dépôt ou la recette. Corrigez-la et renvoyez-la. Retirer de la liste masque la demande échouée.
- Modifier et réinstaller (un projet sur le serveur) : le dossier du projet est supprimé et le projet est reconfiguré de zéro, avec le type que vous choisissez. Ses données sont conservées, de sorte que le nouveau projet les retrouve, sauf si vous cochez Supprimer aussi ses bases de données (voir ci-dessous ce que cela supprime). Commitez et poussez d'abord votre travail : les fichiers qui ne sont pas dans git sont perdus.
- Supprimer, conserver les données supprime le dossier du projet dans
~/Code, son site et son serveur de développement ; ses bases de données et ses fichiers dans le stockage restent. Supprimer complètement, avec les données supprime aussi les données du projet : les bases de données MySQL, MariaDB, PostgreSQL et MongoDB portant son nom (my-shoputilisemy_shop) et son bucket RustFS (my-shop), avec tous les fichiers qui y ont été téléversés. - Ajouter un alias donne au projet une autre adresse : l'alias
storefait ouvrir le même site àhttps://store.dev.test, sur votre ordinateur portable et sur chaque appareil de votre tailnet. Les points créent des sous-adresses commeapi.shop. Les alias s'affichent sous le projet ; le × sur l'un d'eux le supprime.
Le serveur exécute chaque action en quelques secondes ; cela nécessite rdev 1.0.3 ou une version ultérieure, et 1.0.4 pour supprimer les données MongoDB et RustFS. Sur le serveur lui-même, rdev domain add <name> store.dev.test ajoute un alias, et rdev project remove <name> --delete-files supprime un projet créé avec rdev project add (pour un site Laravel ou WordPress, supprimez son dossier).
Avant de supprimer des données, sachez ce que cela touche :
- C'est irréversible. La sauvegarde nocturne de Pro et Team contient les bases de données, vous pouvez donc les restaurer depuis le panneau ; elle ne contient pas les buckets RustFS, les fichiers téléversés sont donc perdus définitivement. Téléchargez d'abord ce dont vous avez besoin.
- Cela se fait par nom, pas par propriétaire. rdev supprime la base de données et le bucket portant le nom du projet. Si le
.envd'un autre projet pointe vers la même base de données ou le même bucket, ce projet perd aussi ses données. - Un service arrêté conserve ses données. rdev ne supprime que dans les services en cours d'exécution et indique ceux qu'il a ignorés ; démarrez-les et relancez la suppression, ou supprimez les données vous-même.
- Avec l'offre Team, l'environnement de chaque membre a ses propres services ; supprimer un projet dans le vôtre ne touche jamais les services partagés du propriétaire.
Ajouter un service à un projet
Un projet peut obtenir un service plus tard, quand il en a besoin :
rdev project service shop postgres
Dans le panneau, choisissez Ajouter un service sur un projet ou à côté d'un serveur. Le choix d'une version, les paramètres .env et le reste se trouvent dans Services.
Variables d'environnement depuis le panneau
Pour définir une clé d'API ou un autre secret sans ouvrir de terminal, ouvrez le serveur depuis Serveurs dans la barre latérale et utilisez Variables d'environnement : choisissez le projet, saisissez un nom et une valeur sous Ajouter ou modifier, et choisissez Chiffrer et enregistrer. Le serveur l'écrit dans le .env du projet en quelques secondes.
Les valeurs sont chiffrées dans votre navigateur avec la clé propre à votre serveur, de sorte que rdev.cloud ne les voit jamais et ne peut pas les afficher ensuite. Actuellement dans .env ne liste que les noms. Pour modifier une valeur, cliquez sur son nom : il passe dans Ajouter ou modifier, où vous saisissez la nouvelle valeur. Cliquez sur × sur un nom pour le supprimer ; supprimer APP_KEY ou les paramètres DB_ casse généralement l'application.