gRPCurl en BloomRPC

Bij het bouwen van gRPC-services is het essentieel om hulpmiddelen te hebben waarmee je ze eenvoudig kunt testen en gebruiken. In tegenstelling tot REST-API's, die vaak HTTP-clients zoals Postman of curl gebruiken, gebruikt gRPC een binair protocol (Protobuf via HTTP/2) dat traditionele hulpmiddelen niet begrijpen.

In deze les maak je kennis met twee populaire hulpmiddelen: gRPCurl voor interactie via de opdrachtregel en BloomRPC voor een gebruiksvriendelijke grafische interface.

gRPCurl is een krachtig hulpmiddel voor de opdrachtregel waarmee je met gRPC-servers kunt communiceren. Je kunt het zien als curl, maar dan speciaal ontworpen voor gRPC.

• Je kunt er services en methoden mee opvragen die door een gRPC-server beschikbaar worden gesteld.
• Je kunt er de Protobuf-berichttypen mee beschrijven die deze methoden gebruiken.
• Je kunt er RPC-methoden mee aanroepen met willekeurige Protobuf-berichten.

Het is bijzonder handig voor snel testen, scripts en foutopsporing.

gRPCurl is één binair bestand, waardoor het eenvoudig te installeren is. Je kunt vooraf gecompileerde binaire bestanden voor je besturingssysteem (Linux, macOS, Windows) downloaden vanaf de releasepagina op GitHub.

Als Go op je systeem is geïnstalleerd, kun je het ook installeren met de Go-toolchain:

Nadat je gRPCurl hebt geïnstalleerd, kun je er een actieve gRPC-server mee onderzoeken. Stel dat er een eenvoudige service Greeter actief is op localhost:50051. Eerst kunnen we de beschikbare services opvragen:

Om te begrijpen wat een specifieke service of methode verwacht, kunt u de opdracht describe gebruiken. Hiermee ziet u het Protobuf-schema voor de invoer en uitvoer.

Voor onze service Greeter beschrijven we de methode SayHello:

Laten we nu daadwerkelijk de methode SayHello aanroepen. We moeten het serveradres, de methodenaam en de invoergegevens als JSON-payload opgeven met de vlag -d.

De vlag -plaintext wordt gebruikt als uw server geen TLS/SSL gebruikt, wat gebruikelijk is bij lokale ontwikkeling.

Hoewel gRPCurl uitstekend geschikt is voor scripts, maakt een grafische gebruikersinterface (GUI) testen soms intuïtiever. BloomRPC is een populaire open-source-GUI-client voor gRPC-services.

Deze biedt een visuele manier om met uw services te werken, vergelijkbaar met de manier waarop Postman voor REST-API's werkt.

BloomRPC vereenvoudigt het testen van gRPC met verschillende gebruiksvriendelijke functies:

• Schemadetectie: importeert .proto-bestanden om services en methoden automatisch te detecteren.
• Aanvraageditor: biedt een intuïtieve JSON-editor voor het samenstellen van aanvraagberichten.
• Antwoordweergave: geeft antwoorden van de server duidelijk weer.
• Geschiedenis: bewaart eerdere aanvragen, zodat u ze eenvoudig opnieuw kunt uitvoeren of aanpassen.
• Ondersteuning voor streaming: ondersteunt alle vier gRPC-communicatiepatronen (uniaire, server-, client- en bidirectionele streaming).

Om BloomRPC te gebruiken, doet u doorgaans het volgende:

1. Protobuf-definitie toevoegen: laad uw .proto-bestanden (of een volledige map) in BloomRPC.
2. Service/methode selecteren: kies in de zijbalk de specifieke service en methode die u wilt testen.
3. Aanvraag bewerken: BloomRPC genereert automatisch een JSON-sjabloon voor het aanvraagbericht. Vul de vereiste gegevens in.
4. Aanvraag verzenden: klik op de knop 'Play' om de aanvraag naar uw gRPC-server te verzenden.
5. Antwoord bekijken: het antwoord van de server wordt weergegeven in het antwoordpaneel.

In deze les hebben we twee essentiële hulpmiddelen voor het werken met gRPC-services verkend:

• gRPCurl: een veelzijdige opdrachtregeltool voor scripting, foutopsporing en snelle interactie met gRPC-servers.
• BloomRPC: een gebruiksvriendelijke grafische interface die testen vereenvoudigt met visuele schemadetectie en bewerking van aanvragen en antwoorden.

Als u deze hulpmiddelen beheerst, verhoogt u uw productiviteit aanzienlijk bij het ontwikkelen en oplossen van problemen in toepassingen op basis van gRPC. Ze bieden verschillende, maar even waardevolle manieren om ervoor te zorgen dat uw gRPC-services werken zoals verwacht.