Ecosistema e strumenti

Panoramica

L’ecosistema Goa comprende librerie complementari che rispondono a esigenze comuni nello sviluppo di microservizi. Questi strumenti sono progettati per funzionare perfettamente con Goa, ma possono essere utilizzati anche in modo indipendente.

Librerie complementari

Modello - Diagrammi di architettura come codice

Model fornisce un DSL Go per descrivere l’architettura del software utilizzando il modello C4. Invece di disegnare diagrammi con strumenti grafici, si definisce l’architettura nel codice:

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)
        })
    })
})

Benefici:

• Documentazione dell’architettura a controllo di versione
• Generazione automatica di diagrammi (SVG, JSON)
• Editor grafico interattivo per il posizionamento
• Plugin Goa per progetti combinati di API e architettura

Per saperne di più: Documentazione del modello

Pulse - Infrastruttura di eventi distribuiti

Pulse fornisce primitive per la costruzione di sistemi distribuiti guidati dagli eventi. È indipendente dal trasporto e funziona con o senza servizi Goa:

• Streaming: Instradamento di eventi pub/sub tra microservizi
• Pools di lavoratori: Lavoratori dedicati con hashing coerente per l’invio di lavori
• Mappe replicate: Stato condiviso e coerente tra i nodi

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

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

**Casi d’uso

• Elaborazione asincrona di eventi
• Code di lavoro in background
• Caching distribuito
• Notifiche in tempo reale

Per saperne di più: Documentazione Pulse

Indizio - Osservabilità dei microservizi

Clue fornisce strumentazione per i servizi Goa costruiti su OpenTelemetry. Copre i tre pilastri dell’osservabilità:

// 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))

Caratteristiche:

• Tracciamento distribuito con propagazione automatica dell’intervallo di tempo
• Registrazione strutturata con buffering intelligente
• Raccolta ed esportazione di metriche
• Endpoint di controllo dello stato di salute
• Endpoint di debug per la risoluzione dei problemi in fase di esecuzione

Per saperne di più: Documentazione Clue

Guide alla documentazione

Sezione totale: ~7.500 gettoni

Iniziare

Scegliere la libreria che corrisponde alle proprie esigenze:

• **Necessitate di documentazione sull’architettura? ** Iniziate con Model
• **Costruire sistemi guidati dagli eventi? ** Iniziare con Pulse
• **Aggiungere l’osservabilità ai servizi Goa? ** Iniziare con Clue

Tutte le librerie sono disponibili tramite go get:

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