## なにをするか Studuino モードの **hex を作る Lambda の土台**を用意する(🧱 infra)。arduino-cli・Studuino のボード定義・Studuino ライブラリを入れた**コンテナの Lambda** と API Gateway を作り、**決まった C++ のサンプル**をコンパイルして hex を返せるところまで。構文木の検査と C++ の書き出しは次の sub-issue(#2210)でやる。 **#2162 を待たずに進めてよい**(M8 = A)。 ## 守ること(infra-first) - **後方互換な変更だけ**(追加のみ。既存の Lambda・API の挙動を変えない)。 - PR は **develop 宛て**、本文は **`Refs #2209`**(`Closes` / `Fixes` を書かない。prod デプロイの成功で workflow が閉じる)。 - `cdk deploy` は AI がしない。stg は PR に `deploy-stg` ラベル、prod は develop へのマージで workflow が出す(`.claude/rules/infra/development.md`)。 ## 決まったこと(#2163 の本文が正) - M2 = A: コンテナの Lambda(API Gateway 経由)。ログインなし。 - S12 = C: 上限は推奨の倍から(**リクエスト 128KB/コンパイル 60 秒で打ち切り/IP ごとに 1 分 12 回・1 日 600 回**)。大きめにとり、**計測できるように**する(1 回ごとに、かかった時間・構文木の大きさ・hex の大きさ・成否・拒否の理由を構造化ログに出す。CloudWatch のメトリクス(回数・失敗・コンパイル時間)を見られるようにする)。数字は環境変数などで変えられるようにする。 - **smalruby.app(と開発環境・ブランチプレビュー)からしか呼べない**: 他の Lambda と同じ CORS の許可(`infra/shared/cors-origins.ts` が正本)に加え、ハンドラでも `Origin` を検査して許可外は 403。 - S7 = B: アーテックが公開している Studuino ライブラリ(GPL-2.0-or-later。#2163 の「S7 ライブラリのライセンスの確認」)を使う。 ## ライブラリの取り込み方 - **リポジトリに入れない**。コンテナを作るときに取得し、**取得元とハッシュ(sha256)を固定**する。 - アーテック社の公式の配布元があればそこから(#2211 の回答待ち)。 - 無ければ、人間が非公開の S3 などに置いたものを、ビルド時に取得する(どこに置くかは PR で提案して人間が置く)。 - 使うのは `Studuino`・`MMA8653`・`MPU6050`・`IRremoteForStuduino`・`ColorSensor` の 5 つ(本体が include する)。ほかの 4 つ(BusIO・MSA301・Clock・CircuitPlayground)は入れない。 - 各ライブラリの LICENSE・著作権表示はコンテナの中にそのまま残す。 - ボード定義(FQBN・MCU・クロック)はいまのファームウェア(`sr_studu`・ATmega168PA)の作り方を調べて合わせる。アーテック社の回答で推奨があれば従う。 - **prod に出す前に、アーテック社の回答(#2211)を確かめる**。回答が来るまでは stg まで。 ## 変える場所(目安) - 置き場所は `infra/smalruby-api` に足すか、新しい CDK プロジェクトにするかを PR で決める(コンテナの Lambda はビルドが重いので、新しいプロジェクトの方が他の Lambda のデプロイを遅くしない)。新しいプロジェクトにするなら、`Deploy Infra` の workflow と `bin/sync-worktree-env` が拾えるか確かめる(`.github/workflows/` は Bot の権限外。必要なら人間の作業として書き出す)。 - コンテナ: arduino-cli(版を固定)+AVR のコア+ライブラリ。コンパイルのキャッシュを効かせる。 - API: `POST /studuino/hex`(仮)。この段階では「決まったサンプルをコンパイルして返す」テスト用の口でよい(任意の C++ は受け付けない)。 ## テスト - CDK のスナップショット/単体テスト(その infra プロジェクトの jest。関係するファイルだけ)。 - stg(`deploy-stg`)で、サンプルの hex が返ること・許可外の Origin が 403 になること・上限を超えると 429 / 413 になること・ログとメトリクスが出ることを確かめる。 ## DoD - stg で hex が返る。かかった時間(コールドスタートとウォーム)を PR に書く(S12 の数字を決める材料)。 - docs(#2208 の `docs/studuino-mode/`、または infra プロジェクトの docs)に API・上限・計測の見方を書く。 親 EPIC: #2163 。
Activity
feat(infra): use artec's board definition and add medium/large samples
ci: re-run the checks that failed at install dependencies
docs(infra): note that the studuino library url was verified on stg
fix(infra): restore third-party.json broken by the previous commit
github-actions commentedon Nov 19, 2026
🚀 PR #2278 の infra を prod にデプロイしました(https://github.com/smalruby/smalruby3-editor/actions/runs/44544816039)。この Issue を閉じます。
後続の Issue(
autopilot-after: #2209)は、stg と prod に API が載ったのでブランチプレビュー(stg の API)で確認できます。