Aller au contenu principal

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​

  1. Allez au tableau de bord de votre organisation
  2. Cliquez sur Nouveau Projet (ou le bouton +)
  3. Entrez le nom du projet (ex : "Production")
  4. Sélectionnez une Location (fournisseur et région)
  5. 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.

attention

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)
Règles de Nommage

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 :

SectionInformation
RessourcesTous les conteneurs, bases de données, etc.
MétriquesGraphiques d'utilisation agrégés
AlertesAlertes 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​

  1. Depuis le tableau de bord de l'organisation
  2. Voir tous les projets en grille ou liste
  3. 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 :

  1. Allez dans l'onglet Projects de votre organisation
  2. Cliquez sur Reorder (nécessite le rôle MAINTAINER ou OWNER)
  3. Glissez les projets dans l'ordre souhaité, ou utilisez les boutons fléchés
  4. 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​

  1. Cliquez sur le nom du projet dans l'en-tête
  2. Sélectionnez dans le menu déroulant
  3. Ou utilisez le sélecteur de projet dans la barre latérale

Paramètres du Projet​

  1. Ouvrez votre projet
  2. Cliquez sur Paramètres
  3. 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)
Accès inter-projets

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 :

  1. Ouvrez le projet suspendu
  2. Cliquez sur Reprendre le Projet
  3. Les ressources seront remises à l'échelle selon leur configuration précédente
attention

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.

  1. Allez dans les Paramètres du projet
  2. Ouvrez l'onglet Avancé
  3. Cliquez sur Supprimer le Projet
  4. Tapez le nom du projet pour confirmer
  5. 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.

attention

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 :

  1. Ouvrez le projet (il affichera une bannière d'attente de suppression)
  2. Cliquez sur Restaurer le Projet
  3. Le projet est restauré en état Suspendu le temps que ses workloads reprennent ; il passe en Actif peu après
info

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​

RessourceLimite par Projet
Conteneurs100
Bases de données20
Gateways50
Instances de cache20

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 :

  1. Allez dans Organisation > Facturation
  2. Voir la répartition Par Projet
  3. 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

Sujets Connexes​