マネージドアドオン

マネージドアドオンは、Lizard (lizard.build) がプロジェクト内で実行するデータベースとストレージで、Managed Postgres、Managed Redis、S3 互換の Managed Object Storage を使えます。lizard add postgres redis s3 を実行すると、1 つのコマンドで 3 つすべてが作成されます。各アドオンは DATABASE_URL などの固定の環境変数セットを公開し、サービスは ${{postgres.DATABASE_URL}} のような 参照 で値を読み取ります。デプロイや再起動の後もデータを残したいアプリで使ってください。

アドオンをプロビジョニングする

lizard add postgres            # one addon
lizard add postgres redis s3   # several at once
lizard add --list              # show available types

命名

各種類の 最初の アドオンには、その種類の名前が付きます。つまり、${{postgres.DATABASE_URL}} はそのまま使えます。同じ種類の追加アドオンには、postgres-autumn-bear のような生成された名前が付きます。削除したアドオンは 3 日間ゴミ箱で名前を保持するため、その期間内に追加した新しいアドオンには生成された名前が付きます。古いアドオンを復元するか、参照を新しい名前に向け直してください。

種類エイリアスへのフォールバックはありません。参照では、アドオンの 現在の 名前を使う必要があります。アドオン名を変更すると古い名前への参照は壊れるため、名前の変更後に参照を更新してください:

lizard service rename main-db --service postgres   # addons rename through the same command
lizard secrets set DATABASE_URL='${{main-db.DATABASE_URL}}' --service api

アドオンを利用する

任意のサービスからアドオンの変数を参照できます。参照はデプロイ時に解決されるため、サービスは次回のデプロイ時にアドオンの現在の値を取り込みます:

lizard secrets set DATABASE_URL='${{postgres.DATABASE_URL}}' --service api
lizard redeploy --service api

Lizard は、実行中のすべての Postgres と Redis アドオンの DATABASE_URL と REDIS_URL を、プロジェクト内のすべてのサービスに最も低い優先順位で注入します。明示的な参照はこれらを上書きし、特定のアドオンを選びます。同じプロジェクト内のサービスでは、プライベート URL を使ってください:

lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service api

Secret scoping を参照してください。

種類ごとの変数

DATABASE_URL と REDIS_URL はパブリックエンドポイントを使います。DATABASE_PRIVATE_URL と REDIS_PRIVATE_URL は プライベートネットワーク 上の <name>.lizard.internal を使い、同じプロジェクト内のサービスからのみ利用できます。

ダッシュボードブラウザー

dashboard には各アドオン用のデータブラウザーが用意されています。Postgres には SQL/テーブルエディター、Redis にはキーブラウザー、S3 にはバケット/オブジェクトブラウザーがあり、Lizard 内でデータを確認・編集できます。

ストレージ

Postgres と Redis のデータボリュームは 拡張のみ可能 です。次のコマンドで容量を増やします:

lizard scale --service postgres --storage 8192

種類別ガイド

• Managed Postgres
• Managed Redis
• Managed Object Storage

プロトタイプで通常この 3 つが一度に必要になる理由については、データと設定を明示する を参照してください。

更新日 2026年10月12日