Projets
Les projets regroupent les ressources liées et fournissent une isolation entre les environnements.
Qu'est-ce qu'un Projet ?
Un projet est :
- Un namespace - Les ressources sont isolées par projet
- Un environnement - Sépare production, staging, développement
- Une unité de facturation - Suivez les coûts par projet
- Une portée d'accès - Contrôlez les permissions des membres par projet
Structure d'un Projet
Projet : Production
├── Conteneurs
│ ├── api-server
│ ├── web-frontend
│ └── worker
├── Bases de données
│ └── main-db
├── Gateways
│ └── main-gateway
├── Cache
│ └── session-store
└── Paramètres du Projet
├── Overview
├── Members
├── Docker Registry
├── DNS Providers
├── API Keys
└── Alerts
Créer un Projet
Étapes
- Allez au tableau de bord de votre organisation
- Cliquez sur Nouveau Projet (ou le bouton +)
- Entrez le nom du projet (ex : "Production")
- Sélectionnez une Location (fournisseur et région)
- Cliquez sur Créer
Location du projet
Lors de la création d'un projet, vous choisissez une location — une paire fournisseur et région qui détermine l'emplacement de déploiement de toutes les ressources du projet. Les locations disponibles sont listées dans la fenêtre de création.
La location est permanente. Une fois un projet créé dans une location donnée, il ne peut pas être déplacé. Tous les conteneurs, bases de données et services du projet s'exécutent dans cette location.
Conventions de Nommage
Noms valides :
production
staging
development
client-bigco
api-v2
Mon Projet
my_project
project.1
Noms invalides :
-projet (commence par un tiret)
projet- (termine par un tiret)
mon--projet (caractères spéciaux consécutifs)
Les noms de projets doivent commencer et se terminer par un caractère alphanumérique. Ils peuvent contenir des espaces, points, tirets ou underscores, mais pas de manière consécutive. Les noms sont uniques par organisation (insensible à la casse) — vous ne pouvez pas créer deux projets nommés « Production » et « production » dans la même organisation. Les projets supprimés libèrent leur nom pour réutilisation, mais les projets en attente de suppression conservent le leur.
Slug du Projet
Le slug est utilisé dans :
- Les URLs internes
- Les noms DNS
- Les appels API
Projet : Environment de Production
Slug : environment-de-production
DNS interne : {service-name}.{namespace}
Exemple : backend.environment-de-production-abc123
Tableau de Bord du Projet
Vue d'Ensemble
Le tableau de bord du projet affiche :
| Section | Information |
|---|---|
| Ressources | Tous les conteneurs, bases de données, etc. |
| Métriques | Graphiques d'utilisation agrégés |
| Alertes | Alertes actives pour ce projet |
| Événements | Événements récents |
Comptage des Ressources
Vue rapide des ressources :
Conteneurs : 5 en cours, 1 arrêté
Bases de données : 2 actives
Gateways : 1 active
Cache : 1 actif
Gérer les Projets
Voir les Projets
- Depuis le tableau de bord de l'organisation
- Voir tous les projets en grille ou liste
- Cliquez sur un projet pour l'ouvrir
Réordonner les projets
Vous pouvez réordonner les projets pour contrôler leur ordre d'affichage dans la barre latérale et le tableau de bord de l'organisation :
- Allez dans l'onglet Projects de votre organisation
- Cliquez sur Reorder (nécessite le rôle MAINTAINER ou OWNER)
- Glissez les projets dans l'ordre souhaité, ou utilisez les boutons fléchés
- Cliquez sur Save
L'ordre est partagé dans toute l'organisation — chaque membre voit le même ordre. Les nouveaux projets sont ajoutés à la fin. Si un projet est créé ou supprimé pendant que vous réordonnez, la sauvegarde échoue avec un avertissement ; la liste se rafraîchit automatiquement pour que vous puissiez réordonner à nouveau.
Changer de Projet
- Cliquez sur le nom du projet dans l'en-tête
- Sélectionnez dans le menu déroulant
- Ou utilisez le sélecteur de projet dans la barre latérale
Paramètres du Projet
- Ouvrez votre projet
- Cliquez sur Paramètres
- Configurez les options
Isolation des Projets
Isolation Réseau
Par défaut, les ressources ne peuvent communiquer qu'au sein du même projet :
✓ Conteneur A → Base de données (même projet)
✓ Conteneur A → Conteneur B (même projet)
✗ Conteneur A → Base de données (projet différent)
Vous pouvez créer des exceptions contrôlées à l'isolation des projets en utilisant les Project Peerings. Les peerings permettent à des workloads spécifiques d'un projet d'atteindre un port de service container dans un autre projet au sein de la même organisation.
Résolution DNS
Le DNS interne ne résout qu'au sein du projet. Le format est {service-name}.{namespace} :
backend.my-project-abc123
my-database.my-project-abc123
Secrets et Configuration
Les variables d'environnement et secrets sont limités au projet :
API_KEY en Production ≠ API_KEY en Staging
Patterns de Projets Courants
Basé sur l'Environnement
Organisation : MaSociété
├── production # Environnement live
├── staging # Tests pré-production
└── development # Environnement de développement
Basé sur l'Équipe
Organisation : GrandeCorp
├── frontend-team # Ressources frontend
├── backend-team # Services backend
└── data-team # Traitement des données
Basé sur le Client
Organisation : Agence
├── client-acme # Acme Corporation
├── client-bigco # BigCo Industries
└── internal # Projets propres de l'agence
Basé sur le Produit
Organisation : SaaS Company
├── main-app # Produit principal
├── analytics # Plateforme analytics
├── docs # Site de documentation
└── blog # Blog de l'entreprise
Cycle de Vie des Projets
Création de Projets
La création est asynchrone : l'API accepte le projet et répond 202 avec celui-ci en phase Provisioning. Un worker en arrière-plan met en place le namespace et les ressources. Le projet passe en Active une fois prêt, ou en Failed si la mise en place n'a pas pu aboutir.
Tant qu'un projet est en provisioning, aucune ressource ne peut y être créée. La barre latérale affiche une icône d'horloge clignotante, et le tableau de bord du projet affiche une bannière. Si la création échoue, la bannière explique quoi faire — supprimer le projet et en créer un autre.
Bonnes pratiques :
- Utilisez des noms descriptifs
- Choisissez la bonne localisation (fournisseur et région) — elle est permanente
- Attendez que le projet soit actif avant de créer des ressources
Projets Actifs
Gardez les projets organisés :
- Nettoyage régulier des ressources inutilisées
- Surveillez les coûts par projet
- Révisez les accès périodiquement
Projets en Échec
Un projet qui n'a pas pu être créé reste listé en phase Failed. Il ne peut contenir aucune ressource et ne sera pas relancé. Supprimez-le depuis Paramètres > Avancé et créez-en un nouveau.
Suspension et reprise de projets
Les projets peuvent être suspendus, ce qui met à zéro toutes les ressources (conteneurs, bases de données, caches, etc.). C'est utile pour :
- Économies — Les projets suspendus n'entraînent pas de frais de calcul
- Désactivation temporaire — Mettez un projet en pause sans le supprimer
- Expiration d'essai — Les projets peuvent être automatiquement suspendus à l'expiration d'un essai
Pour reprendre un projet suspendu :
- Ouvrez le projet suspendu
- Cliquez sur Reprendre le Projet
- Les ressources seront remises à l'échelle selon leur configuration précédente
Pendant la suspension, tous les conteneurs, bases de données et services sont arrêtés. Le stockage persistant est conservé, mais aucun frais de calcul ne s'applique.
Suppression de projets
Un projet doit être vide avant de pouvoir être supprimé — supprimez d'abord ses conteneurs, bases de données et autres ressources. S'il en reste, la suppression est refusée et la réponse liste ce qui reste.
- Allez dans les Paramètres du projet
- Ouvrez l'onglet Avancé
- Cliquez sur Supprimer le Projet
- Tapez le nom du projet pour confirmer
- Cliquez sur Supprimer le projet
Le projet passe en état En attente de suppression :
- Toutes les charges de travail sont immédiatement suspendues (mises à zéro)
- Aucune nouvelle ressource ne peut être créée
- Le projet est programmé pour une suppression définitive après un délai de grâce
- Vous pouvez restaurer le projet à tout moment avant l'échéance
Les projets en phase Provisioning ou Failed peuvent aussi être supprimés.
Après le délai de grâce, le projet et ses paramètres sont définitivement supprimés et ne peuvent pas être récupérés. Les logs, métriques et entrées d'audit expirent selon leur propre calendrier de rétention.
Suppression immédiate
Si vous n'avez pas besoin d'un délai de grâce, cochez Supprimer ce projet et ses paramètres maintenant dans la fenêtre de confirmation. Le projet est supprimé immédiatement — il n'y a pas d'échéance et aucune possibilité de restauration. Le nom du projet est libéré pour réutilisation immédiatement.
Restaurer un projet supprimé
Si vous changez d'avis, vous pouvez restaurer un projet en attente de suppression avant l'échéance :
- Ouvrez le projet (il affichera une bannière d'attente de suppression)
- Cliquez sur Restaurer le Projet
- Le projet est restauré en état Suspendu le temps que ses workloads reprennent ; il passe en Actif peu après
La restauration n'est pas possible après une suppression immédiate, ni si l'organisation parente est archivée. Résolvez d'abord le statut de facturation de l'organisation.
Quotas des Projets
Limites par Défaut
| Ressource | Limite par Projet |
|---|---|
| Conteneurs | 100 |
| Bases de données | 20 |
| Gateways | 50 |
| Instances de cache | 20 |
Augmenter les Limites
Contactez le support pour des limites plus élevées.
Suivi des Coûts
Coûts par Projet
Voir les coûts de chaque projet :
- Allez dans Organisation > Facturation
- Voir la répartition Par Projet
- Explorez les ressources spécifiques
Allocation des Coûts
Utilisez les projets pour l'allocation des coûts :
Budget Engineering :
├── production 500 €/mois
├── staging 100 €/mois
└── development 50 €/mois
Total : 650 €/mois
Budget Marketing :
└── marketing-site 75 €/mois
Total : 75 €/mois
Contrôle d'Accès
Permissions au Niveau Projet
Les membres peuvent avoir différents rôles par projet :
Alice :
├── production → Reporter
├── staging → Developer
└── development → Maintainer
Bob :
├── production → Maintainer
├── staging → Maintainer
└── development → Maintainer
Héritage des Rôles
Les propriétaires de l'organisation ont un accès complet à tous les projets.
Bonnes Pratiques
1. Séparer les Environnements
Ne jamais mélanger production et développement :
✓ Projet séparé pour la production
✓ Projet séparé pour le staging
✓ Projet séparé pour le dev
✗ Tout dans un seul projet
2. Nommage Cohérent
Utilisez un schéma de nommage cohérent :
✓ prod, staging, dev
✓ production, pre-prod, development
✓ live, test, sandbox
✗ Conventions de nommage mixtes
3. Documenter les Projets
Ajoutez des descriptions expliquant :
- But du projet
- Équipe responsable
- Ressources clés
- Informations de contact
4. Nettoyage Régulier
Révisions mensuelles :
- Supprimer les ressources inutilisées
- Mettre à jour la documentation
- Réviser les accès
5. Utiliser des Labels
Taguez les ressources pour l'organisation :
labels:
environment: production
team: backend
service: api