Rust SDK

インストール

呼び出しはブロックして Result を返します。オプションはメソッドチェーンの …Options、期間は Duration、時刻は SystemTime で、API の null は Option です。依存関係は 4 つ（serde_json、ring 付きの rustls、webpki-roots、libc）で、非同期ランタイムは不要です。crates.io のクレート名は glac です。

[dependencies]
glac = "0.1"

クライアントと製品

use glac::{AppOptions, DriveOptions};

let client = glac::Client::new()?; // GLAC_API_KEY and GLAC_API_URL; another address or key: Client::builder()

let app = client.cube().deploy("ghcr.io/acme/api:1.4", &AppOptions::new().name("api").port(8080))?; // Cube: waits until it serves
println!("{:?}", app.url());

let sbx = client.sandboxes().create()?; // Sandbox
println!("{}", sbx.run("python3 -c 'print(6*7)'")?.stdout);

let drive = client.drives().create_with(&DriveOptions::new().size_bytes(1 << 30))?; // Drive

println!("{}", glac::run("echo hello")?.stdout); // the shorthand: a sandbox for one command, on the client the environment describes

各製品はクライアントの名前空間で、クライアントを借用する軽量なハンドルです。

• client.cube()：キューブ。サービスとして動くイメージで、API ではアプリと呼びます。型には API の名前を使います：App、AppOptions、Version、Instance。client.workers() はその別名で、非推奨です。
• client.sandboxes()：サンドボックスと、そのスナップショット（.snapshots()）、それを開く SSH キー（.ssh_keys()）。
• client.drives()：ドライブ。サンドボックスより長く残るプロジェクトのディスクで、それぞれ一度に 1 つのサンドボックスが読み書き可能でマウントします（Drive、DriveOptions、DriveMount）。そのスナップショット（DriveSnapshot、DriveSnapshotOptions、DriveForkOptions）。client.volumes()：その下にあるボリューム（Volume、VolumeOptions、VolumeMount）。client.backups()：ボリュームのバックアップ（Backup、BackupOptions）。コントロールプレーンの機能です。
• client.domains()：プロジェクトの独自ドメイン（Domain、DomainOptions）。アプリやサンドボックスのポートのための名前で、コントロールプレーンの機能です。
• client.webhooks() と client.keys()：プロジェクトのイベントの送信先（Webhook、WebhookOptions）と API キー（ProjectKey、KeyOptions）。コントロールプレーンの機能です。
• client.destinations()：プロジェクトのアプリのログ、メトリクス、トレースのエクスポート先（Destination、DestinationOptions）。コントロールプレーンの機能です。
• client.secrets() と client.variables()：プロジェクトのシークレットと共有変数。
• client.deploys()：プロジェクトのデプロイ（/v1/deploys、コントロールプレーンの機能）。複数のサービスを、それぞれが待つものの順にまとめてデプロイし、まとめて切り替えます（プロジェクトのデプロイ）。create([("api", DeployOptions::new().image("ghcr.io/acme/api:2")), ("web", DeployOptions::new())]) は、各サービスに単独でのデプロイと同じものを渡してデプロイを待ち、置き換わったデプロイがあればそれを追います。失敗すると、デプロイのコード（job_failed、job_timed_out、job_lost など）と、param()（services.<name>）としてのサービスを持つ、種類が deploy_failed のエラーになります。create_with(…, &ProjectDeployOptions::new().no_wait())、get(id)、list() もあります。
• どの製品にも属さないものはクライアント自身のものです。アカウント、使用量、プランと請求、プロジェクトとそのイベントです。

キーは GLAC_API_KEY から、アドレスは GLAC_API_URL から読みます。別のアドレス、キー、タイムアウトを使うには、クライアントをビルドします。

let client = Client::builder().api_key(key).base_url(address).build()?;
let named = client.sandboxes().create_with(&CreateOptions::new().name(&name).env("STAGE", "dev").never_sleep())?;

**短縮形。**サンドボックスの SDK の 1 行の書き方は、環境変数が示すクライアント（Client::shared()。最初に使うときに作られる）での client.sandboxes() として残っています：glac::run、glac::run_with、Sandbox::create、Sandbox::get、Sandbox::get_or_create、Sandbox::list と、その _with 形と _page 形です。それ以外はすべてクライアントを受け取ります。

オプションを取る呼び出しには、それぞれ 2 つの形があります：create() と create_with(&options)、run(cmd) と run_with(cmd, options)。SDK がラップしていない API は client.request("GET", "/v1/webhooks", &[], None) で呼びます。API の 3 つの名前は Rust のキーワードなので、名前を変えています。エラーの type は kind()、ファイルの type は FileEntry::kind、files/move は rename です。

キューブ

以下、cube は client.cube() です。

既存のアプリへの deploy は、まずオプションのうちアプリ自体のもの（リージョン、スケール、キー、エグレスルール、メタデータ、ログ、トレース、public、depends_on、ネットワーク：PATCH /v1/apps/{id}。どれかを指定した場合のみ）を変更し、次にイメージと残りからバージョンを作ります（POST /v1/apps/{id}/versions）。指定しないものはアプリのものが使われます。app.update(…) の後に app.deploy_with(…) を呼ぶのと同じリクエストです。その名前のアプリがない場合（404 app_not_found）や名前を指定しない場合は、すべてを指定してアプリを作ります（POST /v1/apps）。そこで 409 name_taken になるのは、その間に誰かが作ったということで、その人のアプリにデプロイします。no_wait() はバージョンが作られた時点で戻ります。立ち上がらなかったバージョンは、kind() が deploy_failed で、バージョン自身のコードと出力を持つエラーになります。アプリはコントロールプレーンの機能で、単独で動くノードは、これらの呼び出しすべてに 404 no_such_route を返します。

サンドボックス

以下、sandboxes は client.sandboxes() です。

let mut sbx = client.sandboxes().create()?; // stays until deleted, also when the value is dropped
let res = sbx.run("python3 -c 'print(6*7)'")?; // res.stdout, res.stderr, res.exit_code
println!("{} {}", res.stdout, sbx.url(3000)?);

文字列で指定したコマンドは sh -c で実行され、文字列の配列ならプログラムとその引数です。

let cmd = sbx.exec("node server.js")?; // do not wait
for piece in cmd.output() {
    print!("{}", String::from_utf8_lossy(&piece?.data));
}

ドライブ

ドライブは、サンドボックスより長く残るプロジェクトのディスクです。サンドボックスの作成時か実行中に、一度に 1 つのサンドボックスが読み書き可能でマウントし、サンドボックスがなくなると中身ごと保持され、次のサンドボックスがマウントできます。次のサンドボックスは同じリージョンのもの、またはマシンがホームのオブジェクトストアを読める別のリージョンのもの（後述）です。書き込まれるそばからリージョンのオブジェクトストアにコピーされるため、別のノード上のサンドボックスもマウントできます。その場合は先にそこへ運ばれます。課金されるのは書き込まれたものだけです（used_bytes）。ドライブのスナップショットはオブジェクトストア内のドライブのバージョンで、何もコピーされません。フォークはスナップショットから作る新しいドライブ、復元はスナップショットの内容を再びドライブの内容にするもので、いくつものサンドボックスがスナップショットを同時に読み取り専用でマウントできます。ドライブはコントロールプレーンの機能で（/v1/drives）、単独で動くノードに対しては、どの呼び出しもノードの 404 no_such_route になり、そのノードのディスクはボリュームです（後述）。

use glac::DriveMount;

let drive = client.drives().create_with(&DriveOptions::new().size_bytes(1 << 30))?; // Drive
let sbx = client.sandboxes().create_with(&CreateOptions::new().drive(DriveMount::new("/data", drive.id())))?;
sbx.run("echo kept > /data/note")?;
client.drives().detach(sbx.id(), drive.id())?;
let other = client.sandboxes().create()?;
client.drives().attach(other.id(), &DriveMount::new("/data", drive.id()))?;
println!("{}", other.run("cat /data/note")?.stdout); // kept

• ドライブは一度に 1 つのサンドボックスのものです。ほかのサンドボックスが持っているドライブは拒否され（409 drive_attached）、アタッチ中のドライブの削除も拒否されます。キー別インスタンスのドライブは、キーとともに削除されます（409 key_drive）。
• 別のノードが保持しているドライブは、先にサンドボックスのノードへ運ばれます。オブジェクトストアがまだ現在の状態を保持していない間（503 copy_behind）や、運べなかった場合（503 drive_not_brought）、呼び出しは retryable です。クライアントは retries の指定どおりに再試行し、それでも失敗すればエラーを返すので、少し後に再度要求してください。
• リージョンをまたぐ場合（slice D9）。ドライブのホーム（home）とは、そのコピーを保持するオブジェクトストアのリージョンで、作成されたリージョンです。別のリージョンのサンドボックスも、そのリージョンのマシンがホームのストアを読める場合はマウントできます（読めなければ 409 not_on_one_machine）。ドライブはバージョンとして手放され、そこで引き継がれ、ゲストが読むのに合わせてホームのストアから読み取られ、ゲストが書き込むものは今いるリージョンのストアに送られます（region）。ホームは、そこに 1 時間いると追従します。drives.move_home(drive)（drive.move_home()）を使えばすぐに移ります。マシンがホームのストアに残っているものを自分のストアにコピーし、何も残らなくなった時点で home が新しいリージョンになります。DriveInfo::home_move が移動の進み具合を示します（asked_at、asked_by、copied_objects、copied_bytes、objects_left、error）。古いホームのコピーは、保持しているどのバージョンも必要としなくなった時点で消えます（1 日後）。ドライブのホームが移るのは最大で 6 時間に 1 回で（409 home_moved_recently）、ホームが現在のリージョンにあるドライブでは 409 home_here になります。
• プランの制限：無料プランでは最大 10 GiB のドライブを 3 つ（合計 15 GiB）、有料プランでは最大 1 TiB のドライブを 500 個です（403 drive_limit_reached）。
• スナップショットはドライブより長く残ります。ドライブの削除後も、ドライブの ID で一覧表示、読み取り、フォーク、読み取り専用でのマウントができます。単独で保持する量（exclusive_bytes）に対して、1 時間ごとに、ドライブのデータの料金（1 GB-月あたり $0.02）で課金されます。
• フォークは、ほかのドライブと同じく、used_bytes、つまり論理的な内容全体で課金されます。10 GB のスナップショットのフォークは、10 GB のドライブとして課金されます。
• スナップショットの読み取り専用のマウント：ドライブのリージョンのどのマシン上でも、ドライブを誰が持っていても、ドライブが削除された後でも、いくつものサンドボックスが同時にマウントできます。ブロックはゲストが読むのに合わせてオブジェクトストアから届きます。このキャッシュ外の読み取りに料金はかからず、使用量ではそのサンドボックスの下に表示されます（UsageOptions::sandbox(id)、drive_cold_read_bytes）。そのサンドボックスのマシンがすでに保持しているものの読み取りにも料金はかかりません。ゲストは書き込めず、それをマウントしたサンドボックスは別のマシンへ移動できません。アプリのバージョンはドライブを読み書き可能でしかマウントせず、スナップショットの読み取り専用のマウントはサンドボックス用です。
• ノードがオブジェクトストアに何もコピーしない場合、ドライブにスナップショット、フォーク、復元はありません（409 not_copied）。
• UsageOptions::drive(id)、kind("drive")、group_by(&["drive"]) は、ドライブが保持した量、書き込まれた量、キャッシュ外から読まれた量を報告します。イベント drive.created、drive.deleted、drive.attached、drive.detached は、EventDrive か EventDriveAttached を運びます。

client.volumes() は API の /v1/volumes で、ドライブの下にあるディスクです。移行のために残されています。これにしかないのは、ディスクがボリュームである単独で動くノードと、複数のサンドボックスが同時にマウントするファイルシステムである共有ボリュームです。コントロールプレーンは、プロジェクトのキーに対して通常のボリュームを作りません。

**ボリュームのバックアップ。**バックアップは、ある瞬間のボリューム（ドライブもボリュームです）のコピーで、オブジェクトストアに、期限が来るまで保持されます。呼び出しによって、ボリュームのルールに従って毎日、またはサービスの新しいバージョンがインスタンスを置き換える前に取得されます。ドライブのスナップショットと違い、それ自体が独立したコピーで、それだけからボリュームを作ることができ、元のボリュームより長く残ります。ボリュームのバックアップは前回以降に変わったものだけを保持し、複数のバックアップが必要とするブロックは、そのうち最も古いもので 1 回だけ課金されます。ストアがすべてを受け取るまでは making、その後は ready で、それ以降はストアが保持する量（stored_bytes）に応じて、スリープ中のサンドボックスが保持するものと同じ料金で課金されます（バックアップ）。バックアップはコントロールプレーンの機能です。

• バックアップから作るボリュームは、バックアップ元のボリュームと同じサイズと種類で、バックアップのリージョンに作られます。status は、バックアップ全体を保持するまでは restoring、その後は ready で、それまではアタッチできません。from_backup がバックアップを示します。配置先のマシンで復元できない場合、コントロールプレーンはリージョンの別のマシンにもう一度作ります。そのとき restore_attempt は Some(2) になり、first_failure が最初の試行に失敗した理由を示します。それも失敗すると failed（failure）になり、削除しかできません。
• UsageOptions::new().backup(id)、kind("backup")、group_by(&["backup"]) は、バックアップが保持した量を、状態の計測項目（state_gb_hours）で報告します。client.billing() の meters.state.backups_gb_hours は、その計測項目のうちバックアップの分を示します。

ドメイン

プロジェクトのドメインは、デフォルトのアドレスと同じくアプリへ、またはサンドボックスのポートへ向かう名前です。ドメインはコントロールプレーンの機能です。

ブラウザ

**未公開。**Glac のブラウザはまだ利用できません。以下は公開に先立つ、現時点での SDK です。

セッションは Glac がホストする Chromium で、Chrome DevTools Protocol（CDP）のクライアントが、その cdp_url（Playwright の connectOverCDP や Puppeteer の browserURL に渡すもの）から外部で操作します。クライアントの接続中は稼働し、最後のクライアントが離れると数秒後に、ページを保持したままスリープします。アドレスには認証情報が含まれるため、{:?} はアドレスを含みません。

セッションは、ほかのインスタンスと同じく、使用したキューブのリソースで課金されます。処理している間の CPU、稼働中のメモリ、送信トラフィックです（料金とプラン）。session.awake_seconds は稼働していた時間です。

一覧表示、変更、スリープ、新しいアドレスの発行は、Python と TypeScript の SDK と glac browsers にあります。セッションはコントロールプレーンの機能です。

データベース

データベースはマネージド Postgres です。ドライブ上で動く専用の PostgreSQL で、何も要求がないときはスリープし、接続があればセッションを保ったまま復帰します。オーナーのパスワードは create と reset_password のレスポンスにしか含まれず、どこにも保存されません。そのどちらかが返した Database の connection_string() には、パスワードが含まれます。

データベースには、プロジェクトのネットワーク上で、そのサンドボックス（project_network で作成）とサービスから名前でアクセスします。これが private_uri です。エッジが PostgreSQL を提供する場合は、パブリックアドレスでどこからでもアクセスできます（connection_uri、ポート 5432、TLS のみ。プーラーは pooled_uri）。提供するエッジがない場合や、データベースに名前を付けるリージョンがない場合は None で、接続文字列は、それらがあればそれらを使います。データベースやブランチの {:?} は、パスワードも、パスワード入りの接続文字列も表示しません。データベースはコントロールプレーンの機能です。

マネージドアプリケーション

カタログのアプリケーション（たとえば Rivet）は、プロジェクトに専用のキューブのリソースとしてインストールされます。アプリ、ボリューム、シークレット、バケットで、インストールのラベルが付き、変更はインストールを通じてのみ行い、それぞれのリソースとして課金されます（マネージドアプリケーション）。インストールのレスポンスには、秘密のもの（管理者トークン、それを含むエンドポイント）も含め、すべての出力値があり、読み取りでそれらが表示されるのは admin スコープを持つキーだけです。インストールのオブジェクトは、以前のレスポンスが返し、後のレスポンスが隠した出力値をそれぞれ保持します。

let rivet = client.catalogue().get("rivet", None)?;       // its parameters, and a month of it in Cube's meters
println!("{:?}", rivet.month);
let engine = client.installations().create("rivet", &InstallationOptions::new().parameters(json!({"disk_gib": 20})))?;
println!("{}", engine.info().outputs["endpoint"]);        // RIVET_ENDPOINT, its token in it

マネージドアプリケーションはコントロールプレーンの機能です。

シークレットと変数

プロジェクト、アカウント、請求

**イベントのデータ。**コントロールプレーンのイベントの種類ごとに、そのデータの型がこのクレートにあり、説明のスキーマにちなんだ名前が付いています。その of(&event) は、対応する種類のイベントを読み、ほかの種類なら None を返します（glac::EventDatabase::of(&e)）。データベースのもの：EventDatabase（database.created：region と PostgreSQL の version 付き。database.deleted：7 日間保持されるドライブのスナップショット final_snapshot_id 付き）、EventDatabaseBranch（database.branch_created：parent 付き。database.branch_deleted：reason 付き）、EventDatabaseRestored（database.restored：時点 at と、復元前の状態を保持するブランチ old_branch_id）、EventDatabaseArchive（database.archive_failing：since、連続して失敗したセグメントの数 failures、その間に復元で遡れる範囲 archived_until、オブジェクトストアの error。database.archive_recovered：recovered_at）、EventDatabaseGap。ほかも同様です。サンドボックスのもの（EventSandboxSlept、EventSandboxWoke、EventSandboxMoved、EventSandboxDeleted など）、アプリとそのキーのもの（EventApp、EventAppFailed、EventKeyCreated など）、プロジェクトのデプロイとキー、バックアップ、ドメイン、エクスポート先、ドライブのスナップショットのもの（EventProjectDeployed、EventBackup、EventDomain、EventDestination、EventDriveSnapshot など）、そしてアカウントのプラン、チャージ、返金、撤回、残高、クレジット、ストレージ、送信量の上限、利用上限額、保留、未払いのもの（EventSubscriptionPeriod、EventTopupCollected、EventWithdrawalReceived、EventBalance、EventInDebt など）です。その種類のすべてのイベントにあるわけではないフィールドや、null のフィールドは Option です。

Webhook、API キー、利用上限額、プロジェクト。client.webhooks().create_with(url, &WebhookOptions::new().events(&[…]).enabled(true)) は、プロジェクトのイベントを自前のアドレスに送ります（各配信に署名する secret は、このレスポンスにだけ含まれます）。get、list、update、delete もあります。client.keys().create_with(&KeyOptions::new().name(…).scopes(&[…])) は API キーを作ります（キーそのもの key は、このレスポンスにだけ含まれます）。get、list、delete もあります。client.limits() と client.update_limits(Some(50.0)) は、プロジェクトの利用上限額と今月の支出額で（None で上限を外します）、sbx.limits() と sbx.update_limits(…) はサンドボックス自体のものです。client.request_limit(limit, wanted, why) は、アカウントの申請による上限の引き上げを 1 つ申請します（名前で指定する上限、"volumes"、"volume_bytes"。バイト数の 2 つはバイト単位。同じ上限の申請が待機中なら 409 limit_request_pending）。client.limit_requests(limit, cursor) と client.limit_request(id) は、申請をオペレーターの回答とともに読み取ります（LimitRequest：status は pending、granted、refused。granted、answer）。EventInstanceRestarted::of(&event)、EventInstanceUpgrade::of（instance.upgraded、.reverted、.upgrade_failed）、EventLimitRequest::of は、それらのイベントのデータを読みます。instance.start_command()（サンドボックスでは info().start_command）は、起動コマンドの実行状況、マシン内で再起動された回数、最後の終わり方を示します。client.update_project(Some(30)) は、スリープが何日続いたらサンドボックスを削除するかを設定します（None なら削除しない）。コントロールプレーンの機能です。Webhook と API キー、プロジェクトの上限の設定、update_project には admin スコープを持つキーが必要で、サンドボックスの上限の設定には write が必要です。

ログのエクスポート先、監査ログ、請求関連の書類。client.destinations() は、プロジェクトのアプリのログ（とメトリクス、リクエストのトレース：.signals(&["logs", "traces"])）のエクスポート先（OpenTelemetry のエンドポイント）です：create(name, &DestinationOptions::new().endpoint(u).header(name, value))（作成時にすぐ 1 件のレコードで試す：status.connected）、get、list、update、delete、test（すぐに 1 件送る）。ヘッダーの値は認証情報で、エクスポート先の作成時か変更時に送られ、どのレスポンスにも含まれません（返されるのはヘッダーの名前だけです）。client.audit_page(&ListOptions::new().limit(n)) は、プロジェクトの監査ログの 1 ページ分を新しい順に返します（実行者、メソッド、パス、ステータス）。読み取り以外のすべての呼び出し（拒否されたものも含む）と、オペレーターによるアプリのログの読み取りすべてです。client.statement(Some("2026-09")) は 1 か月の明細（None なら今月）で、データベースごとの行（databases：その月の使用量、履歴と階層化データを別記したもの、それを定価で換算した額）を含みます。client.invoices() は Stripe にある請求書（PDF のリンク付き）、client.notices() はアカウントに送られたメール、client.withdrawals(&ListOptions::new()) は今撤回できる購入と行った撤回（EEA または英国の消費者は、購入から 14 日以内であれば撤回できます）、client.withdraw(charge_id, name, Some(email)) は購入者自身による撤回の意思表示で、すぐに受理されます。コントロールプレーンの機能です。エクスポート先の作成、変更、テスト、削除、監査ログの読み取り、撤回には admin スコープを持つキーが、それ以外には読み取りのできるキーが必要です。

**すぐに受け取る購入（start_now）。**欧州経済領域または英国の消費者（確認済み、または確認中の税番号を持たないアカウント）は、購入から 14 日以内であれば撤回でき、購入したものがすぐに提供されるのは、本人が明示的に求めた場合だけです。start_now() がその要求を伝えます。client.top_up_with(20.0, &TopUpOptions::new().start_now())、BillingOptions::new().plan("paid").start_now()（無料プランから購入する有料プラン）、BalanceOptions::new().auto_reload(true).start_now()（自動チャージがオンの間のすべての自動チャージ）で、コンソールのチェックボックスの横に表示される文言（GET /v1/billing/withdrawals の right.start_now にもあるもの）で伝えます。

撤回できる 14 日間のうちに、この購入をすぐに提供するよう求めます。撤回した場合は、それまでに提供された分を支払います。チャージのクレジットをすべて使った時点で全額が提供されたことになり、それ以降は撤回できなくなることを理解しています。

サービスはすぐに始まります。14 日以内なら購入者はまだ撤回でき、その場合はそれまでに提供された分を支払います。すべてが提供されると（チャージのクレジットをすべて使うと）、撤回する権利はなくなります。この要求は、購入する本人が求めたときだけ指定してください。SDK は、指定されない限り決して送りません。指定がなければ、そのようなアカウントは拒否されます。ステータス 400、コード start_now_required、param() が start_now の Error で、国名を挙げ、要求の文言を引用したメッセージが付き、何も購入されません。要求なしで自動チャージをオンにしたアカウントでは何もチャージされず、月に 1 回通知されます（イベント auto_reload.no_request。EventAutoReloadNoRequest::of で読みます。カードが登録されていないアカウントでは auto_reload.no_card と EventAutoReloadNoCard）。

エラー

0 以外の終了コードは結果です。res.exit_code を読んでください。API のエラーは、status()、kind()、code()、param()、retryable()、request_id()、message()、そしてエラーのページの該当するコードを指す docs_url() を持つ glac::Error です。接続できない場合やタイムアウトも同じで、status() は None です。タイムアウトかどうかは is_timeout() でわかります。お金に関するエラー（402 account_in_debt、403 trust_limit_exceeded、409 no_card、400 start_now_required など）は、コントロールプレーン自身のメッセージを持ち、解除する方法を示します。

知っておくべき動作

• **スリープ中のサンドボックス。**サンドボックスがスリープ中や起動中であることを理由に失敗する呼び出しはありません。待ってから続行します。res.wake は、run が復帰をどれだけ待ったかを示します。クライアントの on_response は、すべての呼び出しについてそれを受け取ります。
• **再試行。**応答がない場合や retryable のエラーは、0.2 秒から倍々に間隔を空けて 2 回再試行されます（retries）。すべての POST には Idempotency-Key が付きます。idempotency_key(key) を使えば、再起動したプログラムが、以前に作ったものを取り戻せます。
• タイムアウト。timeout（指定しなければ 15 分）は API を待つ時間で、RunOptions::timeout はコマンド自体の制限時間です。
• スレッド。Client はスレッド間で共有でき、その製品のハンドルはクライアントの接続を使います。Sandbox に対する読み取りのみの呼び出しは &self を取ります。tokio では、非同期版ができるまで tokio::task::spawn_blocking(move || sbx.run("make")).await?? を使ってください。
• HTTPS には組み込みの Mozilla のルート証明書を使い、SSL_CERT_FILE で独自の証明書を追加できます。これまでのところ、平文の HTTP の開発マシンに対してしか動かしていません。