金色の配線パターンが広がる基板の接写
現場の実践

Datasette Liteで検証する「本番再現なし」バグ報告URLの作り方

目次を見る

障害調査やバグ報告のたびに、検証用の環境をわざわざサーバーに立てていないでしょうか。
Datasette(SQLite データベースをブラウザで閲覧・検索できる Python 製の軽量 Web アプリ)を使っている現場なら、サーバーレスでバグ再現環境をURL一本で共有できる方法があります。

Datasette Lite は、Datasette をブラウザ内だけで完結させて動かす派生プロジェクトです。
Pyodide(Python の実行環境を WebAssembly でブラウザ上に再現する仕組み)と Service Worker(ブラウザが裏側で通信を横取りして処理できる仕組み)を組み合わせています。

サーバーを一切使わないため、インフラ担当が最初に気になるのは「本当に運用コストがゼロで済むのか」という点だと思います。
結論から言うと、Datasette Lite はデモ用途・バグ再現用途に限定すれば、監視対象のサーバーを増やさずに済む選択肢として検証する価値があります。

この記事では、Datasette Lite を使って特定バージョンのデータベースやプラグインを読み込んだURLを作り、チーム内でバグ再現環境として共有する手順を整理します。
あわせて、クラウド運用の視点から「どこまでがこの仕組みの守備範囲か」も確認していきます。

前提条件

特別な環境構築は不要です。必要なのは以下だけです。

  • 最新版の Chrome・Firefox・Safari などのモダンブラウザ(Service Worker と WebAssembly に対応しているもの)
  • 共有したい SQLite データベースファイル、または CSV・JSON ファイル
  • そのファイルを CORS(異なるオリジンからのアクセスを許可する HTTP ヘッダーの仕組み)付きで配信できる場所

CORS ヘッダーが開いた状態でファイルを公開できる手軽な方法として、GitHub の Gist が使われています。
Gist にアップロードしたファイルは Raw URL で直接参照でき、追加のサーバー設定なしで CORS が有効になっています。
社内で検証する場合は、社内のオブジェクトストレージ(S3 互換ストレージなど)に CORS 設定を追加しても代用できます。

手順1: バグ再現用のデータベースを用意する

まず、問題が再現できる最小限の SQLite データベースを用意します。
本番データをそのまま使うのではなく、問題の再現に必要なテーブルと数行のデータだけに絞り込むのがポイントです。

個人情報や内部システムの情報を含むデータは、公開URLとして扱われる前提で必ず除外してください。
この仕組みはクライアント側で完結するため、アクセス制御やログ監視の対象外になる点は後述します。

手順2: 公開URLとして配置する

Gist などにアップロードし、Raw ファイルのURLを控えます。
同時にメタデータファイル(metadata.yml)も用意すると、Datasette のホーム画面にHTMLの説明文を表示できます。
再現手順をそのままドキュメント化できるため、起票したissueに貼り付ける説明としても使えます。

手順3: Datasette LiteのURLを組み立てる

Datasette Lite はクエリパラメータとフラグメント(#以降の部分)でほぼ全ての挙動を制御します。
組み立て方は以下の構造です。

https://lite.datasette.io/
  ?install=プラグイン名
  &url=データベースファイルのURL
  &metadata=metadata.ymlのURL
  #/データベース名/テーブル名

install パラメータは複数指定でき、PyPI 上のプラグインや wheel ファイルのURLも読み込めます。
ref パラメータを使えば、Datasette 本体の特定コミット・タグ・ブランチを GitHub から読み込むことも可能です。
バグが特定バージョンでしか再現しない場合、ref=1.0a42 のように旧バージョンを指定したURLと、修正後の ref=1.0a43 を指定したURLを両方作り、issue に並べて貼るという使い方ができます。

手順4: 必要ならSQLiteのバージョンも固定する

Datasette Lite は100種類以上のSQLiteバージョンから選んで読み込める機能を持っています。
SQLiteのバージョン差異が原因で挙動が変わるバグを再現したい場合、この指定が効いてきます。
オンプレ環境で古いSQLiteを使い続けているシステムの挙動確認にも応用できます。

動作確認の方法

組み立てたURLをブラウザで開くと、まずローディング画面が表示されます。
これはPyodideがPythonランタイム本体とDatasetteのコードをWebAssemblyとしてダウンロード・初期化している時間です。
初回は数秒〜十数秒かかることがありますが、以降はService Workerがキャッシュするため再読み込みは速くなります。

表示が完了したら、フラグメント部分で指定したテーブルやビューが開かれているか確認します。
クエリを実行してみて、期待した行数・ソート順になっているかをチェックすれば、再現手順の検証は完了です。
再現できたURLをそのままissueやチャットに貼れば、受け取った側はサーバーを一切用意せずに同じ画面を見られます。

ハマりやすいポイント: 「ブラウザ内実行」は監視・ログの対象外になる

クラウド運用の視点で一番注意したいのはここです。
Datasette Lite はサーバーサイドで動くDatasetteと違い、SQLクエリの実行もファイルの読み込みも全てユーザーのブラウザ内で完結します。

つまり、APM(Application Performance Monitoring、アプリケーションの性能を監視する仕組み)やサーバーのアクセスログには一切記録が残りません。
本番環境の障害調査でDatasette Liteを使う場合、「このURLで再現した」という事実そのものを、issueやチケットに手動で記録しておく必要があります。
サーバーログに自動で残ると思い込んでいると、あとから「いつ・誰が・どの条件で再現したか」を追えなくなります。

また、読み込み先のGistやストレージが落ちていたり、CORSヘッダーの設定が外れていたりすると、再現URLはそのまま機能しなくなります。
重要なバグ報告に使うURLは、ファイルの保管場所が消えないかどうかも合わせて確認しておくと安心です。

まとめ

Datasette LiteはPyodideとService Workerを使い、Datasetteというサーバーサイドアプリを丸ごとブラウザ内で再現する仕組みです。
バグ再現用のデータベースとmetadata.ymlをGistなどCORS対応の場所に置き、install・url・metadata・refといったパラメータでURLを組み立てれば、サーバーを立てずに再現環境を共有できます。

導入を検討する際は、次の2点を判断基準にしてください。

  • 共有するデータに機密情報が含まれていないか(ブラウザで誰でも見られる前提になるため)
  • 再現結果を記録として残す運用ルールがあるか(サーバーログに自動で残らないため)

まずは社内の小さなバグ報告1件で、Gistにテスト用のSQLiteファイルを置いてURLを組み立ててみると、仕組みの感触がつかめるはずです。

参考

Running the full server-side Datasette Python app in the browser with service workers and Pyodide

AI 駆動開発のご相談は forva AI へ。

まずはお気軽にどうぞ。