Project Peerings
Accordez un accès réseau privé contrôlé depuis des workloads d'un projet vers des ressources d'un autre projet au sein de la même organisation.
Par défaut, les projets sont entièrement isolés — les workloads d'un projet ne peuvent pas atteindre les ressources d'un autre. Les project peerings vous permettent de créer des exceptions précises et auditables à cette isolation.
Comment ça fonctionne
Un project peering crée une politique réseau unidirectionnelle qui autorise un workload source (ou tous les workloads d'un projet) à atteindre un service et un port spécifiques dans un projet cible. Les peerings opèrent au niveau réseau via les NetworkPolicy Kubernetes — ils ne créent pas de credentials de base de données ou de secrets.
Types de source supportés : containers, cron jobs.
Types de cible supportés : containers, bases de données PostgreSQL, poolers de connexions PgBouncer, bases de données MariaDB, instances Valkey, clusters NATS, custom services.
Lorsqu'un peering est Pending ou Active, SailOps affiche le endpoint interne que le workload source doit utiliser pour atteindre le service cible. Lorsque le peering autorise un seul port, le endpoint inclut le numéro de port pour que vous puissiez le coller directement :
<service>.<namespace>:<port>
Lorsque le peering autorise plusieurs ports, le endpoint affiche uniquement l'hôte (<service>.<namespace>) car il n'y a pas de port unique à choisir.
Les pods managés sont configurés avec un chemin de recherche DNS qui résout <service>.<namespace> entre projets. Vous n'avez pas besoin du suffixe complet svc.cluster.local — l'adresse courte affichée dans le peering est suffisante.
Les peerings sont directionnels. Si le projet A doit atteindre le projet B et que le projet B doit atteindre le projet A, vous devez créer deux peerings séparés.
Prérequis
- Au moins deux projets dans votre organisation
- Permission Maintainer sur les projets source et cible
- La ressource cible doit exposer au moins un port de service
Créer un peering
- Accédez à Project Peerings dans la barre latérale de l'organisation
- Cliquez sur Allow Access
- Configurez le peering :
| Champ | Description |
|---|---|
| From | Le projet contenant le workload qui a besoin d'accès |
| From workload | Choisissez Specific workload (uniquement le workload que vous sélectionnez) ou All workloads (tous les workloads du projet, y compris les futurs) |
| To project | Le projet contenant la ressource cible |
| To resource | Le service auquel autoriser l'accès. Pour les ressources qui exposent plusieurs Services Kubernetes (ex. un cluster PostgreSQL publie un primary -rw), seuls les Services éligibles sont listés. |
| Port | Le port TCP spécifique à ouvrir |
- Vérifiez le résumé et l'aperçu du Endpoint en bas du formulaire — c'est l'adresse que votre workload source utilisera pour atteindre la cible
- Cliquez sur Allow Access
Choisir All workloads est une autorisation plus large : tous les workloads du projet source, y compris les futurs, peuvent atteindre la ressource et le port cibles sélectionnés. Utilisez Specific workload lorsqu'un seul workload a besoin d'accès.
Statuts des peerings
| Statut | Description |
|---|---|
| Pending | Le peering est en cours d'activation. Les politiques réseau sont appliquées. |
| Active | Le peering est actif. Le trafic est autorisé. |
| Failed | L'activation a échoué. Le peering a été annulé en toute sécurité. |
| Revoked | Le peering a été révoqué manuellement ou nettoyé automatiquement. |
| Invalidated | Le peering a été invalidé car la ressource source ou cible a été supprimée, ou une limite organisationnelle a changé. |
Révoquer un peering
Vous pouvez révoquer un peering actif si vous avez la permission Maintainer sur le projet source ou le projet cible.
- Accédez à Project Peerings
- Trouvez le peering dans la liste
- Cliquez sur Revoke
- Confirmez la révocation
Révoquer un peering ferme immédiatement l'accès privé. Les connexions existantes peuvent être interrompues.
Consulter les peerings
La liste des peerings affiche les noms de service source et cible à côté de chaque entrée, facilitant l'identification des workloads et ressources connectés sans ouvrir les détails individuels de chaque peering.
Par défaut, seuls les peerings Pending et Active sont affichés. Les peerings terminés (Revoked, Invalidated, Failed) sont masqués car ils n'accordent plus d'accès. Pour les voir, activez la case Show ended peerings au-dessus de la liste.
Pour les peerings Pending et Active, la liste affiche également la colonne Endpoint avec l'adresse interne. Cliquez sur le bouton de copie à côté du endpoint pour le copier dans votre presse-papiers. Les peerings révoqués ou invalidés n'affichent pas de endpoint car la cible peut ne plus exister.
Filtrer les peerings
Utilisez les filtres en haut de la liste des peerings pour affiner les résultats :
- From — Filtrer par projet source
- To — Filtrer par projet cible
- Status — Filtrer par statut de peering (Pending, Active, Failed, Revoked, Invalidated)
- Show ended peerings — Inclure les peerings révoqués, invalidés et en échec dans la liste (désactivé lorsqu'un filtre de statut spécifique est sélectionné)
Limites
| Ressource | Limite |
|---|---|
| Peerings actifs par organisation | 100 |
Raisons de révocation
Lorsqu'un peering est révoqué ou invalidé, la raison est affichée :
| Raison | Description |
|---|---|
| Manually revoked | Un utilisateur a révoqué le peering |
| Creation failed safely | L'activation du peering a échoué et a été annulée |
| Source deleted | Le workload source a été supprimé |
| Target deleted | La ressource cible a été supprimée |
| Organization boundary changed | Un projet a été déplacé ou la structure organisationnelle a changé |
Bonnes pratiques
1. Préférer les workloads spécifiques
Utilisez la portée Specific workload pour limiter le rayon d'impact. N'utilisez All workloads que lorsque chaque workload du projet source a véritablement besoin d'accès.
2. Utiliser le port minimum requis
N'ouvrez que le port spécifique nécessaire. Ne créez pas plusieurs peerings pour des ports que vous n'utilisez pas.
3. Réviser les peerings régulièrement
Auditez périodiquement les peerings actifs et révoquez ceux qui ne sont plus nécessaires.
4. Coordonner avec votre équipe
Créer un peering nécessite un accès Maintainer sur les deux projets. Coordonnez-vous avec les mainteneurs des projets avant de créer un accès inter-projets.