サーバレスでベンダーロックインを避ける方法

サーバレスでベンダーロックインを避ける方法

サーバレスでベンダーロックインを避ける方法

ここ数日、ノートアプリInkdropを題材にしてAWS Lambdaを触っていた。まずはherokuで運用してるAPIをLambdaで動かすことに成功した。良かった点は、koa.js製のコードベースをほぼ変更する必要が無かった事。小さなfunctionに小分けする必要すら無かった。思ってたよりすんなり行って拍子抜けしてる。

見方を変えると、このAPIがHerokuとLambdaの両方で動くようになったと評価できる。これは嬉しい誤算。帰り道が残されたのは安心感がある。サーバレスには興味あるけど、移行コストがかかりそうとかロックインされるんじゃないかと思っている人が多いと思う。でも工夫すれば案外手軽にできることが分かったので、参考にしてもらいたい。

アーキテクチャについては先日こちらに書いたとおり、AWS Lambda + API Gatewayという構成。APIを動かすにあたって以下の記事を参考にした。

この記事では、Lambda上でExpressフレームワークを動かす方法が書かれている。APIへのリクエストをAPI Gatewayで受け取ってLambda functionに転送している。つまりLambda向けのイベントハンドラを書かなくても、既存のコードがそのまま再利用できる。Expressだけでなくkoaでも動かせた:

<span id="014b" class="qv pi io qr b gz qw qx m qy qz">const serverless = require('aws-serverless-express')<br></br>const Koa = require('koa')</span><span id="e079" class="qv pi io qr b gz ra qx m qy qz">const app = new Koa()<br></br>app.proxy = true</span><span id="cf0b" class="qv pi io qr b gz ra qx m qy qz">〜〜〜</span><span id="884f" class="qv pi io qr b gz ra qx m qy qz">const server = serverless.createServer(app.callback())</span><span id="4871" class="qv pi io qr b gz ra qx m qy qz">exports.handle = function (event, ctx) {<br></br> return serverless.proxy(server, event, ctx)<br></br>}</span>

ポイントはkoaにHTTPをlistenさせないこと。代わりにAmazon謹製の aws-serverless-express を使う。

API本体は変更せずにLambda化できたという事は、ローカルでそのまま動かせる。だからいつもどおりローカルで開発が出来る!すばらしい。

自分は、上記のLambda部分を別のプロジェクトに分離した。そして git submodule でkoaプロジェクトをインポートする構成にした。プライベートnpmレジストリを持っている人なら、koaの方をパッケージ化して使うといいと思う。ローカルで動かしたいときは、koaプロジェクトを直接単体で動かす。

参考までに自分のケースを紹介する。LambdaプロジェクトはApexで管理してる。ディレクトリ構成はこんな感じ:

<span id="e8fe" class="qv pi io qr b gz qw qx m qy qz">.<br></br>├── functions<br></br>│ └── api<br></br>│ ├── node_modules<br></br>│ ├── index.js<br></br>│ ├── lib -> ../../src/lib<br></br>│ └── package.json<br></br>├── project.json<br></br>└── src (git submoduleで追加したkoaプロジェクト)</span>

functions/api/lib はwebpackでビルド済みのjsファイルが格納されたディレクトリへのシンボリックリンク。 functions/api/package.jsonはLambda上での実行に必要な依存モジュールの定義。このディレクトリ配下で予め npm installしておく。 package.json の内容は以下の通り:

ちなみに formidable は koa-body の依存モジュールだけどwebpackでうまくバンドル出来なかったから外に出した。

こんな感じで、従来のkoaアプリにLambdaを薄く被せたシンプルな構成に落ち着いた。

Lambdaって小さなfunctionをたくさん用意して使うものだというイメージがある。今の構成だと、1つの巨大なfunctionに全部やらせている。この使い方はアリなんだろうか?結論としては、アリだと思う。

Lambdaはコンテナベースで出来ていて、functionが呼ばれるとS3からプログラムのzipファイルを引っ張ってくる。そしてコンテナを作ってそれを走らせる。しばらく呼び出しが無ければコンテナはパージされる。動作時間のボトルネックはfunctionのファイルサイズとkoaの初期化だろう。

Inkdropのケースでは最初、functionのサイズが未圧縮状態で47MBにもなった。 node_modules がデカい。余計なファイルが入ってるからなぁ。zip後は8MB。さて、これを試しにデプロイしてAPIを叩いてみた。Lambda上ではコンテナが起動して最初の応答処理が完了するまでどれぐらいかかるだろうか?結果は 9秒。うーん、遅い。リージョンは us-east-1 で、ネットワーク遅延も含める。以下のログの通り、functionの動作自体は0.5秒と短い。やはり巨大なfunctionの読み込みに時間がかかっているようだ。

<span id="9ff9" class="qv pi io qr b gz qw qx m qy qz">Duration: 562.88 ms Billed Duration: 600 ms</span>

node_modules のファイルを全部ブッ込んでるのがいけないので、webpackで使用ファイルだけをバンドルに含めてみた。さらに aws-sdk を同梱しないようにした。実は、Lambdaのコンテナには標準でこのAWS SDKがインストールされてるらしい。だからfunctionに入れなくて良い。このSDKはlodashと依存関係があってとても大きいので、かなり削減できる。webpackで以下のように記述すればOK。

<span id="68c8" class="qv pi io qr b gz qw qx m qy qz">export default {<br></br> ...<br></br> externals: [ 'aws-sdk' ],<br></br> ...<br></br>}</span>

最終的にfunctionのサイズはzip後 580K まで縮小できた。その結果、コンテナ起動も合わせたレスポンス速度を2〜3秒程度にまで短縮できた(波があるけど・・)。これなら許容範囲。

コンテナは一度起動したら、すぐにはパージされずしばらく常駐する。その長さは公式で発表されていないけど、少なくとも10分は走ってる印象。Inkdropでは既に一定のユーザからAPIが呼び出されている状況だから、常にコンテナが一つ動いている状態になりそう。仮にコンテナがパージされても、起動を待たされる人は確率的にも少ない。

サーバレスの仲間として now というものもある。こちらは package.json や Dockerfile を持つプロジェクトをコマンド一発でデプロイできるサービス。負荷に合わせてインスタンスを自動でスケールしてくれる。

今回、AWS Lambda依存部が切り離せたおかげで、こういう他のインフラサービスにも気軽に乗り換えられる可能性が保持された。気が向いたらこっちも使ってみたい。

以上、Inkdropサーバレス化の作業記録でした。

Read more

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

💡本記事は英語ブログの日本語訳です。 どうも、TAKUYAです。 AIコーディングでは専らClaude Codeを使っています。最初はtmuxでターミナルの右側にペインを分割して使っていたのですが、幅が狭すぎてメッセージやdiffがまともに表示できず、使いづらかったです。 <Prefix>+zでペインを最大化すればいいのですが、毎回やるのは面倒でした。 そこで、ポップアップウィンドウでClaude Codeを起動するようにしました。キーバインドを押せばセッションが開き、閉じてもバックグラウンドで動き続けるので、すぐに再開できます。 この記事では、それを実現するためのtmuxの設定方法を紹介します。 動画で見る(英語): ポップアップウィンドウはサブプロセスを維持できない tmuxのdisplay-popupコマンドを使うとポップアップウィンドウを表示でき、ちょっとしたツールにすぐアクセスするのに便利です。 僕はlazygitでgitの状態をサッと確認するのに使っています: bind -r g display-popup -d '#{pane_current_path}'

By Takuya Matsuyama
Keychron K2 HEを無刻印化する手順

Keychron K2 HEを無刻印化する手順

どうもTAKUYAです。KeychronさんにK2 HEをお願いしたら音速で送ってくれたので、無刻印化してみました。どうやったのか過程をシェアします。 Unboxing 上はKeychron Q1です。これは3年間ぐらい使ってきました。キーキャップが若干くたびれていますね。でも問題なく今まで使えていました。そろそろ飽きてきたので新しいキーボードを試したいと思い、前から気になっていたK2 HEを試すことにしました(写真下)。 Amazon | 【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、2.4GHz・Bluetooth無線対応、QMKプログラム可能、アルミ+ウッドフレーム、USレイアウト、RGBライト、Mac Windows Linux対応 (ブラック) | Keychron | パソコン用キーボード 通販【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、

By Takuya Matsuyama
ノート駆動AIコーディング術の提案

ノート駆動AIコーディング術の提案

どうもTAKUYAです。みなさんはAIエージェントを普段のコーディングで活用されていますか。ちょっと面白いワークフローを思いついたのでシェアします。それは、ノート駆動のエージェンティック・コーディング・ワークフローです。最近Claude Codeのプランモードを使っていたら、ターミナル内で生成されたプランを読むのが辛かったんです。それで、じゃあMarkdownノートアプリであるInkdropをプランの保存先バックエンドとして使えば解決するんじゃないかと思って、 試してみました。こちらがそのデモです(英語): こちらがClaude Codeの設定ファイル群です: GitHub - inkdropapp/note-driven-agentic-coding-workflow at devas.lifeComplete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon w

By Takuya Matsuyama
2025年個人開発活動の振り返り

2025年個人開発活動の振り返り

どうもTAKUYAです。もう1月も半ばに差し掛かっているけど、2025年の自分の活動の振り返りをしたい。去年を一言で言うなら、本厄を満喫した年だった。 厄年とは、人生の節目にあたって、体調不良や災難が起こりやすいと経験的に言われる年齢のこと。数え年で42歳、確かにもう若さに任せた事は出来ないなと痛感した年だった。(ところであなたの国ではこのような年はありますか?) 夏に体調を崩して2~3ヶ月動けなくなった 暖かくなり花粉が飛び出した頃に、持病のアトピーが悪化しだして、まともに生活出来なくなってしまった。酷さで言うと、2019年に脱ステした時と同じぐらい。 脱ステに無事成功したから、この地獄は二度と味わうことはないだろうと高を括っていたが、まさか7年後にまた味わうとは思わなかった。当時の独身時代と違い、妻も子供もいる中で、周りに多大な迷惑をかける事となった。夏の子供との思い出が全く無い。悲しい。 現在はQoLもほとんど元の状態まで復活できた。写真を撮って症状の変化を記録したので、機会があればシェアしたい。食事療法など色々試したが、結局歩くのが一番自分に効いた。それ以来、一日一万歩

By Takuya Matsuyama