Projets & Services
Concepts
Projet
Un projet regroupe des services liés (ex: toute la stack d'une application). Les projets sont des conteneurs organisationnels — ils n'ont pas d'état en eux-mêmes.
Service
Un service est un processus géré par Runeya. Chaque service a :
- Une commande à exécuter
- Un répertoire de travail
- Des variables d'environnement
- Des logs en streaming
- Un agent assigné (local par défaut)
Créer un projet
- Cliquez "+ Projet" dans la sidebar gauche
- Donnez un nom (ex:
backend,frontend,infra) - Le projet apparaît dans la liste
Créer un service
Dans un projet, cliquez "+ Service" puis renseignez :
Onglet Général
| Champ | Description | Exemple |
|---|---|---|
| Nom | Identifiant affiché | api, worker |
| Description | Notes optionnelles | API REST principale |
| Commande | Commande exécutée | node dist/index.js |
| Répertoire | Chemin de travail | /home/user/my-app |
| Shell | Active le mode shell | false (recommandé) |
Shell mode
Activez shell: true uniquement si votre commande nécessite des redirections (|, >, &&). Préférez décomposer en sous-commandes ou scripts.
Onglet Environnement
Attachez des environnements au service pour injecter des variables. Voir Environnements & Variables.
Onglet Logs
Configurez les parsers de logs appliqués au flux de sortie du service. Voir Logs & Parsers.
Contrôler un service
| Action | Description |
|---|---|
| ▶ Start | Démarre le processus |
| ⏹ Stop | Arrêt gracieux (SIGTERM → 10s → SIGKILL) |
| 🔄 Restart | Stop + Start |
| 🗑 Delete | Supprime la configuration (ne touche pas vos fichiers) |
États d'un service
stopped ──► starting ──► running
▲ │
└────────── stopping ◄───┘
│
stopped / error| État | Couleur | Description |
|---|---|---|
stopped | Gris | Processus arrêté |
starting | Jaune | Démarrage en cours |
running | Vert | Processus actif |
stopping | Orange | Arrêt gracieux en cours |
error | Rouge | Processus terminé avec code d'erreur |
Identifiants stables
L'ID d'un service est stable entre les redémarrages de Runeya. Il sert de processId côté agent — ce 1:1 mapping garantit qu'un service garde son historique de logs et sa configuration même après un redémarrage du serveur.