Node.js のサーバーをなるべく自動生成に頼って Go にリプレイスした話 / A story about replacing a Node.js server with Go, relying on automatic generation as much as possible.

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Copyright © Bitkey Inc. All rights reserved. 大高浩太郎 Kotaro Otaka / @otakakot 2020.04 2022.11 2024.07 新卒社会人として Web業界にてエンジニア人生開幕 AWS Lambda など Serverless による開発を経験株式会社ビットキーへジョイン技術本部 / プラットフォーム開発部 BKP & HubCoreModule 認証・認可基盤を Go で実装したり GitHub Actions でピタゴラスイッチ作ったり The Go gopher was designed by Renée French. The icon was designed by @avocadoneko. 2021.04 先輩のススメで Go に出会う趣味で勉強、そして推し始める（Gopherくんかわいい … ）

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev なぜリプレイス？リプレイスも楽したい共通基盤「bitkey platform」サーバーを Go で実装一箇所だけ Node.js が存在脆弱性対応・バージョン・トレンド etc 管理する言語は少なくしたい The Go gopher was designed by Renée French.

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev Node.js による実装 ● API は 7 つほど提供 ○ 使っていない機能もいくつか ● Express によるサーバー実装 ○ OpenAPI などの仕様書はなし ● Sequelize によるマイグレーションおよびORM ● Cloud Key Management は公式の SDK を利用

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev 自動生成ライブラリ〜 API 編〜 ● スキーマファースト（OpenAPI）を採用 ↔ コードファースト ○ コードファーストより実装量が少なそう ○ そもそも API の仕様書がなかったのでほしかった ○ bitkey platform のAPIも OpenAPI (swagger) を採用している ● 比較検討したライブラリどちらも OpenAPI をもとにコードを生成 ○ oapi-codegen ○ ogen 　※ スター数が多いopenapi-generator というライブラリもあるがかっちりとしたフレームワークという印象だったので除外

Slide 19

Slide 19 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev 自動生成ライブラリ〜 API 編〜特徴　oapi-codegen ● ルーティングエンジンとして echo をデフォルトで採用 ● ほかにも chi, Gin, gorilla/mux などが選択可能 ○ Go 1.22 のルーティングにも対応 ● client や type のみなど個別に生成が可能

Slide 20

Slide 20 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev 自動生成ライブラリ〜 API 編〜特徴　ogen ● ルーティングは独自機構による実装 ● 生成されたコードでは reﬂect や interface{} を使っていない ● Optional や Nullable に対応 ● OpenTelemetry に対応 ● 開発しているときの実装感覚が gRPC (proto) のコード生成に近い

Slide 21

Slide 21 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev 自動生成ライブラリ〜 API 編〜 ● OpenAPI は自力で Express のコードを読んで作成 ○ 生成AIの力を借りたら楽にできたかもしれない ● より厳密に実装ができる（補完によるサジェストも強力） ○ 特にレスポンス ○ oapi-codegen は型は生成してくれるがAPI単位で担保できない → ogen を採用

Slide 22

Slide 22 text

Slide 23

Slide 23 text

Copyright © Bitkey Inc. All rights reserved. #gofar_dev 自動生成ライブラリ〜 API 編〜 ● oapi-codegen のおすすめポイント ○ echo など慣れ親しんだライブラリがある場合 ○ ミドルウェア（リクエストごとの共通処理）の実装 ○ echo などライブラリとしてミドルウェアのサポートが豊富 ● 実は bitkey platform がまだ swagger ○ OpenAPI に移行するなら oapi-codegen を採用したい

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Slide 28

Slide 28 text

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

Slide 37

Slide 37 text

Slide 38

Slide 38 text

Slide 39

Slide 39 text

Slide 40

Slide 40 text