Il tuo primo scenario in 5 minuti
Questo tutorial ti porta da zero a uno scenario in esecuzione. Uno scenario è un insieme di micro avviati insieme per testare un flusso (per esempio, «Checkout ordini»).
1. Aggiungi i tuoi micro
Sezione intitolata “1. Aggiungi i tuoi micro”Nel rail sinistro, vai a Micro e clicca su + Aggiungi micro. Scegli la cartella del repository di un micro: MicroLab rileva automaticamente la sua tecnologia, porte, infrastruttura e dipendenze, e genera la sua descrizione (il manifesto). Ripetilo per ogni micro che vuoi usare.
Il repo è su un server Git e non lo hai ancora in locale? Usa Importa micro da Git: clona il repository e rileva il micro in un passaggio.
2. Componi lo scenario
Sezione intitolata “2. Componi lo scenario”Vai alla sezione Scenari e clicca su Nuovo scenario. Dagli un nome e seleziona i micro che lo compongono. Salvalo.
Nel pannello Dipendenze vedrai, per ogni chiamata da un micro a un altro core, come si risolve. Per ogni dipendenza scegli:
- local — punta al peer avviato nello stesso scenario (testare la comunicazione reale tra i tuoi micro).
- cloud — punta all’ambiente DEV (può richiedere VPN).
- mock — punta al server di mock di MicroLab (lavorare senza VPN né avviare il core).
Dettaglio in Dipendenze.
3. Verifica l’ambiente
Sezione intitolata “3. Verifica l’ambiente”Prima di avviare qualsiasi cosa, apri la Verifica dell’ambiente (rail destro). Ti dice se hai il necessario —strumenti, repository, Docker, database, credenziali— prima di scoprirlo con un errore a metà avvio. Gli avvisi non bloccano; gli errori sì.
4. Avvia lo scenario
Sezione intitolata “4. Avvia lo scenario”Assicurati che Docker sia avviato (sezione Docker del rail destro) e clicca su
▶ Avvia nella barra superiore. MicroLab avvia l’infrastruttura, risolve le porte,
riscrive gli URL tra micro e avvia ciascuno. Ogni micro passa da Stopped → Starting
→ Healthy.
5. Osserva e testa
Sezione intitolata “5. Osserva e testa”Con lo scenario in esecuzione, il dock inferiore ti dà:
- Log — in diretta, filtrabili per micro e per livello.
- Chiamate mock — ciò che i mock ricevono (con l’opzione di trasformare una chiamata in uno stub).
- Stato — grafici di CPU, memoria e log per micro.
Nella vista Tabella o Schede dello scenario hai, per micro, il suo stato, la porta e le scorciatoie (aprire Swagger/health, copiare l’URL, vedere i log, riavviare solo quel micro).
6. Ferma quando hai finito
Sezione intitolata “6. Ferma quando hai finito”Clicca su ■ Ferma. MicroLab ferma i micro, i container e l’infrastruttura.
- Impara a fare il mock di una dipendenza senza VPN.
- Sfoglia L’app desktop sezione per sezione.