# Créer votre premier projet

Source : https://webgune.cloud/eu-eu/docs/premier-projet · Mis à jour le 2026-10-27

# 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

1. Depuis le tableau de bord, cliquez sur **Nouveau projet**.
2. Donnez-lui un nom clair (ex. `boutique-en-ligne`).
3. 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](/docs/deployer-github) |
| **Git** | un dépôt hébergé ailleurs (GitLab, Gitea…) | [Déployer depuis GitHub](/docs/deployer-github) |
| **Image Docker** | une image déjà construite | [Déployer une image Docker](/docs/deployer-docker) |
| **Archive** | un `.tar.gz` de vos sources, sans dépôt | [Comment fonctionnent les builds](/docs/builds-railpack) |
| **Base de données** | MySQL ou PostgreSQL gérée, ou un autre moteur en service | [Bases de données](/docs/bases-de-donnees) |
| **Template** | une stack prête à l'emploi (WordPress, n8n…) | [Déployer un template](/docs/templates-introduction) |

Au même moment, vous choisissez l'**environnement** du service :

- **Production** : public, sur `nom.webgune.dev` ou 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

```text
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 |