Créer votre premier projet
Créer votre premier projet
Un projet regroupe les services qui composent une même application : le frontend, l'API, la base de données. Chaque projet a son propre espace réseau : ses services se parlent entre eux, sans être joignables par ceux des autres projets.
Créer le projet
- Depuis le tableau de bord, cliquez sur Nouveau projet.
- Donnez-lui un nom clair (ex.
boutique-en-ligne). - Validez : le projet est prêt, encore vide, et s'ouvre sur son canvas.
Ajouter un premier service
Sur le canvas, + Nouveau service, puis choisissez une source :
| Source | Pour quoi | Guide |
|---|---|---|
| GitHub | un dépôt GitHub, reconstruit à chaque push | Déployer depuis GitHub |
| Git | un dépôt hébergé ailleurs (GitLab, Gitea…) | Déployer depuis GitHub |
| Image Docker | une image déjà construite | Déployer une image Docker |
| Archive | un .tar.gz de vos sources, sans dépôt | Comment fonctionnent les builds |
| Base de données | MySQL ou PostgreSQL gérée, ou un autre moteur en service | Bases de données |
| Template | une stack prête à l'emploi (WordPress, n8n…) | Déployer un template |
Au même moment, vous choisissez l'environnement du service :
- Production : public, sur
nom.webgune.devou votre domaine ; - Préproduction : privé, sur
nom.preprod.webgune.dev, accessible avec le jeton du projet ; - Développement : privé, sur
nom.dev.webgune.dev, lancé avec le serveur de développement de votre framework (réservé aux services Git).
Exemple de structure
Projet "boutique-en-ligne"
├── frontend Next.js, déployé depuis GitHub
├── api Node.js, déployé depuis GitHub
└── boutique PostgreSQL, base gérée rattachée au projet
Faire communiquer les services
Les services d'un même projet se joignent par le réseau interne, sans passer par Internet. Le panneau Réseau de chaque service affiche son adresse privée, à utiliser par exemple pour relier votre frontend à votre api. L'adresse publique passe par Internet : elle est plus lente et inutile pour du trafic interne.
Une base gérée se joint, elle, avec l'hôte et les identifiants affichés sur sa page (connexion directe, en TLS).
Les onglets du projet
| Onglet | Contenu |
|---|---|
| Architecture | le canvas : services, liens, état en direct |
| Vue d'ensemble | santé des services et derniers déploiements |
| Données | les bases du projet et leurs tables |
| Activité | qui a fait quoi, et quand |
| Trafic | requêtes HTTP, codes de réponse, latence, chemins les plus vus |
| Observability | CPU, mémoire, réseau, disque par service |
| Registry | les images construites, par service |
| Logs · Redirections · Settings | journaux, redirections de domaines, réglages et membres |