Ecosystème et outils

Aperçu

L’écosystème Goa comprend des bibliothèques complémentaires qui répondent à des besoins communs en matière de développement de microservices. Ces outils sont conçus pour fonctionner de manière transparente avec Goa mais peuvent également être utilisés indépendamment.

Bibliothèques compagnons

Modèle - Diagrammes d’architecture en tant que code

Model fournit un DSL Go pour décrire l’architecture logicielle en utilisant le modèle C4. Au lieu de dessiner des diagrammes dans des outils graphiques, vous définissez votre architecture dans le code :

var _ = Design("My System", "System description", func() {
    var System = SoftwareSystem("My System", "Does something useful")
    
    Person("User", "A user of the system", func() {
        Uses(System, "Uses")
    })
    
    Views(func() {
        SystemContextView(System, "Context", "System context diagram", func() {
            AddAll()
            AutoLayout(RankLeftRight)
        })
    })
})

Avantages:

• Documentation de l’architecture contrôlée par version
• Génération automatique de diagrammes (SVG, JSON)
• Editeur graphique interactif pour le positionnement
• Plugin Goa pour les conceptions combinées API + architecture

En savoir plus: Documentation du modèle

Pulse - Infrastructure d’événements distribués

Pulse fournit des primitives pour construire des systèmes distribués pilotés par les événements. Il est agnostique au niveau du transport et fonctionne avec ou sans les services Goa :

• Streaming : Routage d’événements pub/sub à travers des microservices
• Pools de travailleurs : Travailleurs dédiés avec un hachage cohérent pour la répartition des tâches
• Cartes répliquées : État partagé éventuellement cohérent entre les nœuds

// Publish events to a stream
stream.Add(ctx, "user.created", userEvent)

// Subscribe to events
reader.Subscribe(ctx, func(event *Event) error {
    return processEvent(event)
})

Cas d’utilisation:

• Traitement asynchrone des événements
• Files d’attente de travaux en arrière-plan
• Mise en cache distribuée
• Notifications en temps réel

En savoir plus: Pulse Documentation

Indice - Observabilité des microservices

Clue fournit une instrumentation pour les services Goa construits sur OpenTelemetry. Il couvre les trois piliers de l’observabilité :

// Configure OpenTelemetry
cfg := clue.NewConfig(ctx, "myservice", "1.0.0", metricExporter, spanExporter)
clue.ConfigureOpenTelemetry(ctx, cfg)

// Context-based logging
log.Info(ctx, "processing request", log.KV{"user_id", userID})

// Health checks
checker := health.NewChecker(health.NewPinger("db", dbAddr))

Caractéristiques:

• Traçage distribué avec propagation automatique de la portée
• Journalisation structurée avec mise en mémoire tampon intelligente
• Collecte et exportation de métriques
• Points d’extrémité pour les bilans de santé
• Points d’extrémité de débogage pour le dépannage en cours d’exécution

En savoir plus: Clue Documentation

Guides de documentation

Section totale: ~7 500 jetons

Démarrage

Choisissez la bibliothèque qui correspond à vos besoins :

• Documentation d’architecture? Commencez par Model
• Construire des systèmes pilotés par les événements? Commencez avec Pulse
• Ajouter de l’observabilité aux services Goa? Commencez avec Clue

Toutes les bibliothèques sont disponibles via go get :

go get goa.design/model
go get goa.design/pulse
go get goa.design/clue