アプリ クイックスタート

アプリ クイックスタート

数分で最初のアプリを Lizard に公開できます。lizard login した最初のタイミングで、Lizard アカウントは自動的に作成されます。CLI をインストールしてログインし、デプロイします。方法は GitHub リポジトリから直接行うか、ローカルディレクトリから行うかのどちらかです。

1. CLI をインストールする

macOS または Linux では、インストールスクリプトを実行します:

curl -fsSL https://lizard.build/install.sh | bash

スクリプトは lizard バイナリを ~/.lizard/bin に置き、~/.zshrc または ~/.bashrc でそのフォルダを PATH に追加します。さらに、すでに PATH に含まれているフォルダに lizard をリンクするので、このターミナルですぐに使えます。以後、バイナリは自動で更新されます。lizard が見つからない可能性があるとスクリプトに表示された場合は、新しいターミナルを開いてください。バージョンを確認します:

lizard --version

Windows では、PowerShell で次を実行します:

irm https://lizard.build/api/cli/install.ps1 | iex

npm からインストールすることもできます(Node.js 18+ が必要です):

npm install -g @lizard-build/cli

npx は使わないでください。 必ずグローバルにインストールされた lizard バイナリを使ってください。npx @lizard-build/cli を実行すると、その場限りのコピーが取得され、バージョンがプラットフォームとずれる可能性があります。npm でインストールした場合、後でアップグレードするには npm install -g @lizard-build/cli@latest を実行してください。

権限エラー (EACCES)? sudo は使わないでください。管理者権限が不要な上記のインストールスクリプトを使うか、npm の保存先をユーザー所有の prefix に向けてください:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
npm install -g @lizard-build/cli

2. ログインする

lizard login

ブラウザが開いて認証し、確認するとターミナルに戻ります。CI やその他の非対話環境では、代わりにトークンで認証します:

export LIZARD_TOKEN=lzd_xxx
# or
lizard login --token lzd_xxx

現在どのアカウントであるかはいつでも確認できます:

lizard whoami

3. デプロイする

コードがどこにあるかに応じて、該当する方法を選んでください。

オプション A — GitHub リポジトリをデプロイする(推奨)

コードが GitHub 上にある場合は、リポジトリから直接サービスを作成します。Lizard がそれをクローンし、スタックを自動検出してビルドし、公開 URL を返します:

lizard add -r your-org/your-app

以後、その追跡ブランチへの push によって自動的に再デプロイされます。プライベートリポジトリの場合は、先に GitHub App を接続してください:

lizard git connect

オプション B — ローカルコードをデプロイする

プロジェクトディレクトリ内から、現在のフォルダをアップロードしてデプロイします(.gitignore を尊重します):

lizard up

ディレクトリがまだプロジェクトにリンクされていない場合、up が対話的に作成または選択を行います。CI では、先に lizard init --name my-project で明示的にリンクしてください。

どちらの場合でも、ビルドが完了すると https://your-app-production.onlizard.com のような生成済み URL が取得できます。

4. ビルドと実行を確認する

lizard ps          # services in the project, with status + URL
lizard logs        # last runtime log lines
lizard logs --build  # the most recent build's logs
lizard open        # open the project in the dashboard

5. データベースを追加する(任意)

マネージド Postgres をプロビジョニングし、サービスから参照します:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_URL}}' --service your-app
lizard redeploy --service your-app

${{postgres.DATABASE_URL}} 参照はデプロイ時に解決され、addon とともに自動的にローテーションされます。Managed Addons を参照してください。

次のステップ

ホスティング費用

Pro は税込みで月額 $19 で、毎月 $19 分のクレジットが含まれます。それを超えた利用は、公開料金での pay as you go です。新しいアカウントは 7 日間のトライアルと $5 のトライアルクレジットから始まります。請求と料金を参照し、デプロイ前に上限を確認してください。