Glac は OCI イメージを Firecracker microVM で実行します。各インスタンスは専用の microVM で、アイドル時はスリープし、必要とされると復帰します。キューブはイメージを固有のアドレスを持つサービスとして実行し、その 1 つひとつがキューブ（API ではアプリ）で、リクエストが来ない間はインスタンスがスリープします。キューブのボリューム（API ではドライブ）は、それを使うインスタンスより長く残るディスクです。マネージドアプリケーションはキューブ上で動きます。AI エージェントがコマンドを実行するためのマシンであるサンドボックスと、まだ利用できないブラウザとデータベースです。まずはキーの取得から始めてください。プラットフォームのページでは、コンピューティング、リージョン、アドレス、プロジェクト、ログ、料金、制限の仕組みを説明し、各製品には概要、クイックスタート、動作を説明するページがあります。
はじめに
- はじめに：アカウントと API キーを作成し、glac コマンドラインか SDK をインストールして、各製品の最初の一歩を踏み出します。
プラットフォーム
- コンピューティング：すべての製品の基盤。任意の OCI イメージを、インスタンスごとに専用の Firecracker microVM で実行します。キーのあるインスタンスとないインスタンス、インスタンスがスリープするタイミングと復帰させるもの、そしてキューブとサンドボックスがその上にどう載っているか。
- リージョン：3 つのリージョン（na、eu、ap）、サンドボックス、キューブ、ドライブが作られる場所、リージョンが引き受けられない場合に起きること、リージョンごとのトラフィックの料金。
- アドレス：キューブ、サンドボックスのリンク、独自ドメインのアドレス。プラットフォームの前段にあるプロキシ（TLS、DDoS 対策、キャッシュ）経由か、プラットフォームへ直接か。そしてプロキシの制限。
- ネットワーク：トラフィックがサンドボックスやキューブにどう届き、どう出ていくか。プロキシ経由とダイレクトのアドレス、SSH、プロジェクトのプライベートネットワーク、サンドボックス専用の IPv6 アドレスとそこで開くポート、ネットワークルール、課金対象。
- プロジェクトとキー：アカウントは支払いを行い、メンバーを持ち、確認済みのアドレスで通知を受け取ります。それ以外のものはすべてプロジェクトが持ちます。API キーは 1 つのプロジェクトに属してスコープを持ち、トークンは 1 つのサンドボックスを開き、コンソールは人をサインインさせます。
- ログ、メトリクス、トレース：1 つのストリームにまとまったキューブのログ（インスタンスの出力、リクエストごとに 1 行、プラットフォームの動作）、メトリクス、各リクエストのプラットフォームのスパン、そして任意の OpenTelemetry レシーバーへのエクスポート。
- 料金とプラン：無料プランと有料プランの 2 つのプラン、それぞれに含まれるもの、すべての製品の課金に使う 1 つの料金表（リージョン別のトラフィックとドライブを含む）、そして残高、チャージ、自動チャージ、利用上限額の仕組み。
- 制限：各プランでアカウントが同時に持てる量と保持できる量、作成できる速さ、そして API 自体の制限。
- 上限の引き上げ：プランの制限のうち、ご要望に応じてアカウントごとに引き上げるものと、その申請方法。
キューブ
- キューブ：任意の OCI イメージを、固有のアドレスを持つサービスであるキューブ（API ではアプリ）として実行します。インスタンスはリクエストが来ると起動し、途切れるとスリープします。デプロイはすべて、ロールバック先にできるバージョンになります。
- キューブのクイックスタート：glac コマンドライン、Python SDK、コンソールで、イメージをキューブとしてデプロイし、変更し、ログを見て、ロールバックします。
- デプロイとバージョン：アプリのデプロイのたびにバージョンが作られ、ビルドされて準備ができた時点でトラフィックを受け取ります。バージョンを構成するもの、失敗したときに起きること、ロールバックの方法。
- インスタンスとスケーリング：アプリのインスタンスは、リクエストが来ると起動し、途切れるとスリープし、しばらくスリープすると削除されます。インスタンスの数、動く場所、応答後も処理を続ける方法。
- キー別インスタンス：キー（ユーザー、セッション、テナント）ごとに 1 つのアプリのインスタンス。キーが初めて現れたときに作られ、同じキーを持つ以降のすべてのリクエストのために、メモリとディスクごと保持されます。
- アドレスとプロトコル：glac.run の下にあるキューブのデフォルトのアドレス、独自ドメイン、インターネット上のアドレスを持たないキューブ、インスタンスに届くプロトコル。
- サービスと Compose：すべてのアプリは、プロジェクトのサービスです。サービスはプロジェクトのプライベートネットワーク上で互いを見つけ、変数を共有し、まとめてデプロイされ、データをドライブに保持し、Compose ファイルから取り込むこともできます。
サンドボックス
- サンドボックス：AI エージェント、ユーザー、ジョブごとに、任意の OCI イメージからミリ秒で作る専用のマシン。コマンドの実行、ファイルの読み書き、ターミナルの利用ができます。アイドル時はスリープし、プロセスが動いたままの状態で復帰します。
- サンドボックスのクイックスタート：glac コマンドライン、Python SDK、コンソールで、サンドボックスを作成し、中でコマンドを実行し、ファイルをコピーし、ポートを開き、スナップショットを取ってフォークします。
- コマンド、ファイル、ターミナル：任意のイメージからのサンドボックスの作成、コマンドの実行とその出力の読み取り、ファイルの読み書き、ターミナル。
- スリープと復帰：サンドボックスがスリープするタイミング、復帰させるもの、中のプログラムがサンドボックスを稼働させ続ける方法やスリープ前に通知を受ける方法、再起動、長いスリープの後の削除。
- スナップショットとフォーク：スナップショットは、実行中のサンドボックスのメモリ、プロセス、ディスクを保存します。サンドボックスはスナップショットに戻ったり、スナップショットから始めたり、この時点からそれぞれ続きを実行するコピーにフォークしたりできます。
- リンク、トークン、SSH：それ自体が認証情報になる、サンドボックスのポートへのリンク、公開ポート、1 つのサンドボックスを一定期間開くトークン、自前のキーによる SSH。
- ネットワークルールとシークレット：サンドボックスがインターネット上で到達できる範囲、ホストに送れるリクエスト、そして送信時にリクエストに追加され、中のコードが持つことのないシークレット。
ブラウザ
まだ利用できません。これらのページは、構築中の仕組みを説明したものです。
- ブラウザ：Glac がホストする Chromium のセッションを、Playwright、Puppeteer など任意の Chrome DevTools Protocol クライアントから外部で操作します。クライアントの接続中は稼働し、最後のクライアントが離れるとページを保ったままスリープします。
- セッション：/v1/browsers の呼び出し、セッションの作成時の指定と持つもの、セッションを見つけ直すための名前、稼働とスリープのタイミング、新しいアドレス、ネットワーク。
- ライブビューとプロファイル：セッションのページをライブで見る方法と、見るだけの人向けのアドレス。そしてセッションのプロファイル（Cookie とストレージ）を、プラットフォームが保持し、新しいセッションに読み込む仕組み。
ドライブ
- ドライブ：使用するサンドボックスやキューブより長く残る、プロジェクトのディスク。1 つのドライブに書き込むのは一度に 1 つのサンドボックスだけで、書き込まれるそばからリージョンのオブジェクトストアにコピーされるため、リージョン内のどのマシンでもマウントできます。
- ドライブのクイックスタート：glac コマンドライン、Python SDK、コンソールで、ドライブを作成し、1 つのサンドボックスから書き込み、次のサンドボックスから読みます。
- ドライブの仕組み：サンドボックスやキューブへのドライブのマウント、唯一の書き込み元、保存場所、課金対象、プロジェクトが保持できる量。
- ドライブのスナップショットとフォーク：スナップショットは、ある時点のドライブを、リージョンのオブジェクトストア内のバージョンとして、コピーせずに保持します。ドライブをその状態に復元したり、そこから新しいドライブをフォークしたりでき、いくつものサンドボックスで読み取り専用でマウントすることもできます。
- 共有ボリュームとバックアップ：ボリュームは、ドライブの下にあるディスクです。共有ボリュームは、1 台のマシン上の複数のサンドボックスが同時にマウントするファイルシステムです。バックアップはボリュームをオブジェクトストアにコピーし、そこから新しいボリュームを作れます。
データベース
まだ利用できません。これらのページは、構築中の仕組みを説明したものです。
- データベース：プロジェクトのプライベートネットワーク上で動くマネージド Postgres（16、17、18）。何も要求がないときはスリープし、接続があれば復帰します。キューブのステートフルなサービスとドライブから成り、それらはデータベースだけが変更します。
- PostgreSQL：データベースで動く、pgvector、PostGIS、TimescaleDB、pg_cron などを備えた PostgreSQL 16、17、18。オーナーが作成できる拡張機能、ロール、新しいデータベースの始まり方、プラットフォームが維持する設定。
ツール
- glac コマンドライン：Glac のすべての製品（キューブ、サンドボックス、ドライブ）と、プロジェクト、そのシークレット、請求を扱う 1 つの実行ファイル。ターミナルで作業する人、CI のスクリプト、コーディングエージェントのためのものです。
- Python SDK：製品（キューブ、サンドボックス、ドライブ）ごとの名前空間と、プラットフォーム自体の呼び出しを備えた 1 つのクライアントからなる Python SDK。標準ライブラリのみ、Python 3.9 以降。
- TypeScript SDK：製品（キューブ、サンドボックス、ドライブ）ごとの名前空間を備えた 1 つのクライアントからなる Glac の TypeScript SDK。Node 23.6 以降に対応し、依存関係はありません（fetch、WebSocket、node:crypto）。
- Go SDK：製品（キューブ、サンドボックス、ドライブ）ごとのフィールドを備えた 1 つのクライアントからなる Go SDK。標準ライブラリのみ、Go 1.21 以降。context を最初の引数に取り、エラーは値で返し、オプションは関数で指定します。
- Rust SDK：製品（キューブ、サンドボックス、ドライブ）ごとの名前空間を備え、プラットフォーム自体の呼び出しはクライアント自身にある 1 つのクライアント。Result を返すブロッキング呼び出し、メソッドチェーンによるオプション、4 つの依存関係のみで、非同期ランタイムは不要です。
- Java SDK：製品（キューブ、サンドボックス、ドライブ）ごとの名前空間と、プラットフォーム自体の呼び出しを備えた 1 つのクライアントからなる Java SDK。Java 17 以降、JDK 自身の java.net.http の上で動き、依存関係はありません。
- MCP サーバー：Claude Code、Claude Desktop、Cursor など任意の Model Context Protocol クライアントで、AI エージェントに Glac の製品をツールとして与えます。デプロイするキューブと、作業するサンドボックスです。
リファレンス
- API リファレンス：API のすべての呼び出しを、製品ごとに、フィールドとレスポンスとともに。
- エラー：すべてのエラーの形式、docs_url のリンク先、そしてこのページへ案内される拒否（プランの上限、プロジェクトのドライブとボリューム、保留中のアカウント、ロックされたユーザー）と、お金に関するいくつかのエラーへの対処方法。