VS Code で開発している API を Postman 拡張機能でデバッグしたい

2023-12-05 Postman 日本上陸記念イベントLT
https://www.postman.com/jp/events/postman-japan-launch/

Transcript

1. VS Code で開発している API を Postman 拡張機能でデバッグしたい Let’s debug API with VS Code and the Postman extension! Atsushi Morimoto (@74th) VS Code Meetup Organizer Postman 日本上陸記念イベント 2023-12-05
2. VS Code MeetupとはAbout VS Code Meetup Japan 人気のエディタ VS Code の日本コミュニティ。 Japanese community of the popular editor VS Code. 二ヶ月に1度ほど、ミートアップイベントを開催。 Meetup events are held about once every two months. 1Dayイベントを約年1回ペースで開催。次は 2024年4月20日(土)の予定！ 1Day events are held approximately once a year. The next one is scheduled for Saturday, April 20, 2024! 前回のイベントではPostmanさんとコラボイベントを実施！（Youtube公開中） The last event was a collaborative event with Postman! (Youtube available)
3. Atsushi Morimoto @74th • 本職 データエンジニア・アーキテクト • 『VS Code実践ガイド』（技術評論社）を執筆。 Author of "VS Code Practical Guide" • 『VS Codeデバッグ技術 2nd Edition』 （同人誌・技術書典11）では148ページに渡り、 VS Codeのデバッグ実践方法を解説。 ”VS Code Debugging Practice Guide”(fun tech book) • VS Codeのツールが登場すると、 デバッグ機能とのユースケースを考えるのが趣味。 When VS Code tools are available,I enjoy thinking about use cases with debugging capabilities. ↓ • Postman拡張機能で便利にデバッグしたい…… I’ll try to use Postman extension for debugging ......
4. VS Codeのデバッグ（ステップ実行）Debugging VS Code (step execution) • ユニットテストはデバッグ実行できる。Unit tests are debuggable. • APIようなプログラムも、デバッガを有効にして起動できる。 API-like programs can also be launched with the debugger enabled. • デバッグ起動した状態で、Postmanを動かせば、ステップ実行ができる。 With the debugger activated, you can run Postman for step execution. TodoList API RestAPI Client Token Validation API Mock gRPC Client gRPC Open API Open API
5. 実演Demo
6. 所感Impression • わりとサクッと実現できた。I was able to achieve this rather quickly. • 単体テストはUsecase層（Clean Architecture)しかやってなかったが、 Gateway層が手軽になるのは助かる。 The only unit test I did was the Usecase layer (Clean Architecture), It would be great if the Gateway layer could be done more easily. • VS Codeの機能がまだ限定的で、今後に期待したい（特にgRPC）。 VS Code's functionality is still limited, and I hope to see more of it in the future (especially gRPC). • 実務では10以上のサービスと連携するので、モックはありがたいかも。 In practice, we will be integrating with more than 10 services, so mocks may be helpful. ◦ ただし、全てのサービスでモック実装は1チームで使うには大変。 However, implementing mocks for all services would be difficult for one team to use.
7. まとめConclusion • gRPC、REST Clientとして、Postman経由でGateway層からテスト、VS Codeの中でデバッグができた。 As gRPC and REST Client, we were able to test from the Gateway layer via Postman and debug within VS Code. • Microservice開発するならば、モックがあると捗る。 If you are developing a microservice, it is very useful to have a mock.