gRPCurl og BloomRPC

Når du bygger gRPC-tjenester, er det avgjørende å ha verktøy som gjør det enkelt å teste og samhandle med dem. I motsetning til REST API-er, som ofte bruker HTTP-klienter som Postman eller curl, bruker gRPC en binærprotokoll (Protobuf over HTTP/2) som tradisjonelle verktøy ikke kan forstå.

I denne leksjonen introduseres to populære verktøy: gRPCurl for interaksjon via kommandolinjen og BloomRPC for et brukervennlig grafisk grensesnitt.

gRPCurl er et kraftig kommandolinjeverktøy som lar deg samhandle med gRPC-servere. Tenk på det som curl, men spesielt utviklet for gRPC.

• Det kan liste opp tjenester og metoder som en gRPC-server eksponerer.
• Det kan beskrive Protobuf-meldingstypene som brukes av disse metodene.
• Det kan kalle RPC-metoder med vilkårlige Protobuf-meldinger.

Det er svært nyttig for rask testing, skripting og feilsøking.

gRPCurl er én enkelt binærfil, noe som gjør det enkelt å installere. Du kan laste ned forhåndskompilerte binærfiler fra GitHub-utgivelsessiden for operativsystemet ditt (Linux, macOS eller Windows).

Hvis du har Go installert, kan du alternativt installere det ved hjelp av Go-verktøykjeden:

Når gRPCurl er installert, kan du bruke det til å undersøke en kjørende gRPC-server. Se for deg en enkel Greeter-tjeneste som kjører på localhost:50051. Først kan vi liste opp de tilgjengelige tjenestene:

For å forstå hva en bestemt tjeneste eller metode forventer, kan du bruke kommandoen describe. Den viser Protobuf-skjemaet for inndataene og utdataene.

La oss beskrive metoden SayHello for tjenesten Greeter:

La oss nå faktisk kalle metoden SayHello. Vi må angi serveradressen, metodenavnet og inndataene som en JSON-nyttelast ved hjelp av flagget -d.

Flagget -plaintext brukes hvis serveren ikke benytter TLS/SSL, noe som er vanlig under lokal utvikling.

gRPCurl er ypperlig for skripting, men noen ganger gjør et grafisk brukergrensesnitt (GUI) testing mer intuitiv. BloomRPC er en populær GUI-klient med åpen kildekode for gRPC-tjenester.

Den gir deg en visuell måte å samhandle med tjenestene på, omtrent slik Postman fungerer for REST-API-er.

BloomRPC gjør gRPC-testing enklere med flere brukervennlige funksjoner:

• Skjemagjenkjenning: Importerer .proto-filer for automatisk å finne tjenester og metoder.
• Redigering av forespørsler: Tilbyr en intuitiv JSON-editor for å opprette forespørselsmeldinger.
• Visning av svar: Viser svar fra serveren på en tydelig måte.
• Historikk: Lagrer tidligere forespørsler, slik at det er enkelt å kjøre dem på nytt eller endre dem.
• Støtte for strømming: Håndterer alle de fire gRPC-kommunikasjonsmønstrene (enveis-, server-, klient- og toveisstrømming).

For å bruke BloomRPC gjør du vanligvis følgende:

1. Legg til Protobuf-definisjon: Last inn .proto-filene dine (eller en hel mappe) i BloomRPC.
2. Velg tjeneste/metode: Velg den bestemte tjenesten og metoden du vil teste, fra sidestolpen.
3. Rediger forespørselen: BloomRPC genererer automatisk en JSON-mal for forespørselsmeldingen. Fyll inn de nødvendige dataene.
4. Send forespørselen: Klikk på «Play»-knappen for å sende forespørselen til gRPC-serveren.
5. Vis svaret: Svaret fra serveren vises i svarpanelet.

I denne leksjonen utforsket vi to viktige verktøy for arbeid med gRPC-tjenester:

• gRPCurl: Et allsidig kommandolinjeverktøy for skripting, feilsøking og rask samhandling med gRPC-servere.
• BloomRPC: Et brukervennlig grafisk grensesnitt som forenkler testing med visuell skjemagjenkjenning og redigering av forespørsler og svar.

Når du behersker disse verktøyene, øker produktiviteten betydelig når du utvikler og feilsøker gRPC-baserte applikasjoner. De tilbyr ulike, men like verdifulle, måter å kontrollere at gRPC-tjenestene fungerer som forventet på.