Aller au contenu principal

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​

  1. Connectez-vous à votre tableau de bord SailOps
  2. Sélectionnez votre projet dans la barre latérale
  3. 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 :

VersionRecommandation
2.10Stable, bien testée
2.11Dernière version stable
2.12Dernières fonctionnalités

Étape 4 : Configurer les ressources​

Classe de calcul​

Choisissez en fonction de votre charge de travail :

ClasseIdéale pour
EcoDéveloppement, tests, faible trafic
StandardCharges de production
ProductionSystèmes critiques, ressources garanties

Flavor​

Sélectionnez l'allocation de ressources. Les ressources varient selon la classe de calcul :

Classe Eco (ratio 1:2)​
FlavorCPUMémoireRecommandé pour
Small0.51 GiDéveloppement
Medium12 GiTests
Large24 GiProduction faible trafic
XLarge36 GiCharges moyennes
Classe Standard (ratio 1:4)​
FlavorCPUMémoireRecommandé pour
Small14 GiDéveloppement
Medium28 GiProduction
Large416 GiHaut débit
XLarge1558 GiÉchelle entreprise
Classe Production (ratio 1:4)​
FlavorCPUMémoireRecommandé pour
Small14 GiDéveloppement critique
Medium28 GiProduction
Large416 GiHaut débit
XLarge628 GiMission critique

Réplicas​

Configurez la taille du cluster :

RéplicasDescription
1Nœud unique, développement uniquement
3Haute disponibilité (recommandé)
5Tolérance aux pannes maximale
Production

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
astuce

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​

  1. Vérifiez votre configuration
  2. Cliquez sur Créer le cluster
  3. 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 :

  1. Accédez aux détails de votre cluster
  2. Cliquez sur l'onglet JetStream
  3. Cliquez sur Créer un stream
  4. Configurez les sujets et la rétention

2. Configurer des stores Key-Value​

Pour la configuration distribuée :

  1. Allez dans la section Key-Value
  2. Cliquez sur Créer un store KV
  3. 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 :

  1. Accédant aux paramètres du cluster
  2. Cliquant sur Mettre à jour
  3. Sélectionnant un flavor plus grand
  4. 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
attention

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" :

  1. Vérifiez les quotas de ressources du projet
  2. Vérifiez la configuration réseau
  3. Contactez le support si les problèmes persistent

Connexion refusée​

Si les clients ne peuvent pas se connecter :

  1. Vérifiez la chaîne de connexion
  2. Vérifiez si le cluster est en cours d'exécution
  3. Assurez-vous que les containers sont dans le même projet
  4. Vérifiez les policies réseau

Erreurs d'authentification​

Si l'authentification échoue :

  1. Vérifiez que les identifiants sont corrects
  2. Vérifiez si un mot de passe a été défini lors de la création
  3. Réinitialisez le mot de passe si nécessaire

Prochaines étapes​