Skip to content

feat(infra): Studuino の hex を作る Lambda の土台(arduino-cli+ライブラリのコンテナ・API Gateway・Origin 制限・上限・計測) #2209

Closed

Description

@smalruby3-editor-bot

なにをするか

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。epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163 の「S7 ライブラリのライセンスの確認」)を使う。

ライブラリの取り込み方

変える場所(目安)

  • 置き場所は 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

親 EPIC: #2163 。

Activity

  1. added
    🧱 infrainfra だけの Issue(後方互換のみ・develop へ先行マージ。prod デプロイ後に workflow が閉じる)
    on Nov 18, 2026
  2. github-actions commented on Nov 19, 2026

    @github-actions

    🚀 PR #2278 の infra を prod にデプロイしました(https://github.com/smalruby/smalruby3-editor/actions/runs/44544816039)。この Issue を閉じます。

    後続の Issue(autopilot-after: #2209)は、stg と prod に API が載ったのでブランチプレビュー(stg の API)で確認できます。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    🧱 infrainfra だけの Issue(後方互換のみ・develop へ先行マージ。prod デプロイ後に workflow が閉じる)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions