Créer un cluster NATS
Déployez un cluster NATS entièrement géré pour vos besoins de messagerie.
Prérequis
Avant de créer un cluster NATS, assurez-vous d'avoir :
- Un compte SailOps actif
- Un projet créé dans votre organisation
- Les permissions appropriées (rôle Admin ou Développeur)
Création d'un cluster
Étape 1 : Accéder à Message Queue
- Connectez-vous à votre tableau de bord SailOps
- Sélectionnez votre projet dans la barre latérale
- Cliquez sur Message Queue dans la navigation
Étape 2 : Cliquer sur Créer un cluster
Cliquez sur le bouton Créer un cluster NATS pour ouvrir le formulaire de création.
Étape 3 : Configurer les paramètres de base
Nom du cluster
Entrez un nom unique pour votre cluster :
- Doit commencer par une lettre
- Peut contenir des lettres, chiffres, tirets et underscores
- Ne peut pas être changé après la création
Exemples : my-nats, production-mq, events-cluster
Version NATS
Sélectionnez la version NATS :
| Version | Recommandation |
|---|---|
| 2.10 | Stable, bien testée |
| 2.11 | Dernière version stable |
| 2.12 | Dernières fonctionnalités |
Étape 4 : Configurer les ressources
Classe de calcul
Choisissez en fonction de votre charge de travail :
| Classe | Idéale pour |
|---|---|
| Eco | Développement, tests, faible trafic |
| Standard | Charges de production |
| Production | Systèmes critiques, ressources garanties |
Flavor
Sélectionnez l'allocation de ressources. Les ressources varient selon la classe de calcul :
Classe Eco (ratio 1:2)
| Flavor | CPU | Mémoire | Recommandé pour |
|---|---|---|---|
| Small | 0.5 | 1 Gi | Développement |
| Medium | 1 | 2 Gi | Tests |
| Large | 2 | 4 Gi | Production faible trafic |
| XLarge | 3 | 6 Gi | Charges moyennes |
Classe Standard (ratio 1:4)
| Flavor | CPU | Mémoire | Recommandé pour |
|---|---|---|---|
| Small | 1 | 4 Gi | Développement |
| Medium | 2 | 8 Gi | Production |
| Large | 4 | 16 Gi | Haut débit |
| XLarge | 15 | 58 Gi | Échelle entreprise |
Classe Production (ratio 1:4)
| Flavor | CPU | Mémoire | Recommandé pour |
|---|---|---|---|
| Small | 1 | 4 Gi | Développement critique |
| Medium | 2 | 8 Gi | Production |
| Large | 4 | 16 Gi | Haut débit |
| XLarge | 6 | 28 Gi | Mission critique |
Réplicas
Configurez la taille du cluster :
| Réplicas | Description |
|---|---|
| 1 | Nœud unique, développement uniquement |
| 3 | Haute disponibilité (recommandé) |
| 5 | Tolérance aux pannes maximale |
Utilisez toujours 3 réplicas ou plus pour les déploiements en production afin d'assurer la haute disponibilité.
Étape 5 : Activer JetStream
JetStream fournit des capacités de persistance :
- Streams - Stockage persistant des messages
- Key-Value - Configuration distribuée
- Object Store - Stockage de fichiers volumineux
JetStream est activé par défaut et recommandé pour la plupart des cas d'utilisation. Désactivez-le uniquement si vous avez besoin d'un pub/sub pur sans persistance.
Étape 6 : Vérifier et créer
- Vérifiez votre configuration
- Cliquez sur Créer le cluster
- Attendez que le cluster soit prêt (généralement 1-2 minutes)
Informations de connexion
Une fois votre cluster prêt, vous verrez les détails de connexion :
Connexion interne
Pour les containers du même projet :
nats://{cluster-name}.{namespace}:4222
Exemple :
nats://my-nats.my-project-abc123:4222
Exemples de code de connexion
Node.js
import { connect } from 'nats';
const nc = await connect({
servers: 'nats://my-nats.my-project-abc123:4222'
});
// Publier un message
await nc.publish('events.user.signup', JSON.stringify({ userId: '123' }));
// S'abonner aux messages
const sub = nc.subscribe('events.user.*');
for await (const msg of sub) {
console.log(`Reçu : ${msg.data}`);
}
Go
import "github.com/nats-io/nats.go"
nc, err := nats.Connect("nats://my-nats.my-project-abc123:4222")
if err != nil {
log.Fatal(err)
}
defer nc.Close()
// Publier un message
nc.Publish("events.user.signup", []byte(`{"userId":"123"}`))
// S'abonner aux messages
nc.Subscribe("events.user.*", func(m *nats.Msg) {
fmt.Printf("Reçu : %s\n", string(m.Data))
})
Python
import asyncio
import nats
async def main():
nc = await nats.connect("nats://my-nats.my-project-abc123:4222")
# Publier un message
await nc.publish("events.user.signup", b'{"userId":"123"}')
# S'abonner aux messages
async def message_handler(msg):
print(f"Reçu : {msg.data.decode()}")
await nc.subscribe("events.user.*", cb=message_handler)
asyncio.run(main())
Tâches post-création
Après avoir créé votre cluster, considérez :
1. Créer des streams
Si vous utilisez JetStream, créez des streams pour la messagerie persistante :
- Accédez aux détails de votre cluster
- Cliquez sur l'onglet JetStream
- Cliquez sur Créer un stream
- Configurez les sujets et la rétention
2. Configurer des stores Key-Value
Pour la configuration distribuée :
- Allez dans la section Key-Value
- Cliquez sur Créer un store KV
- Configurez le stockage et l'historique
3. Configurer le monitoring
Configurez des alertes pour :
- Les seuils de nombre de connexions
- Les anomalies de taux de messages
- Le retard des consumers
4. Mettre à jour votre application
Ajoutez la chaîne de connexion NATS aux variables d'environnement de votre application.
Mise à l'échelle de votre cluster
Mise à l'échelle verticale
Augmentez les ressources en :
- Accédant aux paramètres du cluster
- Cliquant sur Mettre à jour
- Sélectionnant un flavor plus grand
- Appliquant les changements (mise à jour progressive)
Mise à l'échelle horizontale (Réplicas)
Augmentez les réplicas pour :
- Une meilleure disponibilité
- Une meilleure tolérance aux pannes
- De meilleures performances
Réduire les réplicas peut causer une perte de données dans JetStream. Augmentez toujours les réplicas, ne les réduisez pas en production.
Dépannage
Cluster non prêt
Si le cluster reste dans l'état "Création" :
- Vérifiez les quotas de ressources du projet
- Vérifiez la configuration réseau
- Contactez le support si les problèmes persistent
Connexion refusée
Si les clients ne peuvent pas se connecter :
- Vérifiez la chaîne de connexion
- Vérifiez si le cluster est en cours d'exécution
- Assurez-vous que les containers sont dans le même projet
- Vérifiez les policies réseau
Erreurs d'authentification
Si l'authentification échoue :
- Vérifiez que les identifiants sont corrects
- Vérifiez si un mot de passe a été défini lors de la création
- Réinitialisez le mot de passe si nécessaire