App-Schnellstart

App-Schnellstart

Mit diesem Schnellstart stellen Sie in wenigen Minuten eine App auf Lizard (lizard.build) bereit. Installieren Sie Lizard CLI: Das Installationsskript meldet Sie an und bietet die 7-tägige Pro-Testphase an. Führen Sie dann lizard add -r owner/repo für ein GitHub-Repository oder lizard up für einen lokalen Ordner aus. Lizard baut die App auf seinen Servern, ohne lokales Docker, und gibt ihr eine HTTPS-URL auf onlizard.com. Ihr Konto wird bei der ersten Anmeldung erstellt.

1. Die CLI installieren

Führen Sie unter macOS oder Linux das Installationsskript aus:

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

Das Skript legt die lizard-Binärdatei in ~/.lizard/bin ab, fügt diesen Ordner in ~/.zshrc oder ~/.bashrc zu Ihrem PATH hinzu und verlinkt lizard in einen Ordner, der bereits in Ihrem PATH liegt. So funktioniert es sofort in diesem Terminal. Danach aktualisiert sich die Binärdatei selbst, außer in CI. Meldet das Skript, dass lizard eventuell nicht gefunden wird, öffnen Sie ein neues Terminal. Prüfen Sie die Version:

lizard --version

Unter Windows führen Sie in PowerShell diesen Befehl aus:

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

Beide Installationsskripte führen am Ende lizard login aus und erledigen damit die Schritte 2 und 3 für Sie: Sie werden angemeldet, und die Pro-Testphase wird angeboten. Mit LIZARD_NO_LOGIN=1 überspringen Sie das; in CI überspringen die Skripte es von selbst.

Oder installieren Sie über npm (benötigt Node.js 20 oder neuer). Eine npm-Installation meldet Sie nicht an, machen Sie also mit Schritt 2 weiter:

npm install -g @lizard-build/cli

Verwenden Sie nicht npx. Verwenden Sie immer die global installierte lizard-Binärdatei. Beim Ausführen von npx @lizard-build/cli wird eine Wegwerfkopie geladen, deren Version von der Plattform abweichen kann. Eine npm-Installation aktualisieren Sie später mit npm install -g @lizard-build/cli@latest.

Berechtigungsfehler (EACCES)? Verwenden Sie nicht sudo. Nutzen Sie das Installationsskript oben, das keine Administratorrechte benötigt, oder setzen Sie für npm ein Präfix in einem Verzeichnis, das Ihrem Benutzer gehört:

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. Anmelden

Überspringen Sie diesen Schritt, wenn das Installationsskript Sie bereits angemeldet hat. Andernfalls führen Sie aus:

lizard login

Der Befehl fragt, ob Sie sich mit GitHub oder Google anmelden, öffnet diese Seite im Browser und wartet auf Ihre Bestätigung. Wenn Sie schon ein Konto haben, wählen Sie die Methode, mit der Sie sich registriert haben: Die andere legt ein zweites, leeres Konto an, sofern beide keine gemeinsame bestätigte E-Mail-Adresse haben. --github oder --google überspringt die Frage. Auf einem Rechner, der bereits angemeldet ist, zeigt lizard login nur das Konto an. Sie können den Befehl also gefahrlos erneut ausführen.

Sie können lizard login auch weglassen: Jeder Befehl, den Sie im Terminal ausführen, meldet Sie zuerst auf dieselbe Weise an und läuft dann weiter.

In CI oder anderen nicht interaktiven Umgebungen authentifizieren Sie sich stattdessen mit einem Token:

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

API-Schlüssel beginnen mit liz_. Erstellen Sie einen mit lizard keys create <name>. LIZARD_API_KEY funktioniert anstelle von LIZARD_TOKEN. lizard login --token-stdin liest den Schlüssel aus einer Pipe, sodass er nicht in Ihrem Shell-Verlauf landet.

Sie können jederzeit prüfen, wer Sie sind:

lizard whoami

3. Die Pro-Testphase starten

Ein neues Konto hat keinen Plan, und Deployments brauchen einen. Gleich nach der Anmeldung bietet lizard login die 7-tägige Pro-Testphase an. Wenn Sie zustimmen, öffnet sich Stripe Checkout, wo Sie eine Karte hinzufügen. Die Testphase enthält Nutzung im Wert von $5. Bis zu ihrem Ende bucht Lizard nichts ab. Ein Konto, das seine Testphase schon hatte, bekommt stattdessen Pro für $19 im Monat angeboten.

Wenn Sie abgelehnt haben, starten Sie sie später:

lizard billing start

Solange kein Plan läuft, gibt das Erstellen von Ressourcen HTTP 402 mit einem Checkout-Link zurück. Siehe Abrechnung und lizard billing.

4. Bereitstellen

Wählen Sie den Weg, der zu dem Ort passt, an dem Ihr Code liegt.

Option A — Ein GitHub-Repo bereitstellen (empfohlen)

Wenn Ihr Code auf GitHub liegt, erstellen Sie einen Service direkt aus dem Repo. Lizard klont es, erkennt den Stack und startet den ersten Build:

lizard add -r your-org/your-app

Der Befehl kehrt zurück, sobald der Service existiert; der Build läuft weiter. Wie Sie ihn verfolgen und die URL finden, zeigt Schritt 5.

Für ein privates Repo, und damit Pushes auf den verfolgten Branch die App neu bereitstellen, verbinden Sie zuerst die Lizard GitHub App mit lizard git:

lizard git connect

Option B — Lokalen Code bereitstellen

Laden Sie im Projektverzeichnis den aktuellen Ordner hoch und stellen Sie ihn bereit (berücksichtigt .gitignore):

lizard up

Beim ersten Mal fragt der Befehl nach einem Service-Namen; vorgegeben ist der Ordnername. Dann verfolgt er den Build und gibt die URL aus, etwa https://your-app-x1y2z.onlizard.com, sobald die App läuft.

Wenn der Ordner noch mit keinem Projekt verknüpft ist, nutzen lizard add und lizard up Ihr Standardprojekt und sagen das an. Das ist das älteste Projekt in Ihrem persönlichen Workspace; ein neues Konto bekommt eines bei der Registrierung. lizard up verknüpft den Ordner außerdem damit, sodass das nächste lizard up denselben Service aktualisiert. Um in ein anderes Projekt bereitzustellen, führen Sie zuerst lizard init --name my-project aus. Tun Sie das auch in CI, damit das Deployment dort landet, wo Sie es erwarten.

Lizard erkennt die meisten Stacks selbst. Den genauen Build-Befehl, Startbefehl und Port Ihres Frameworks finden Sie in der Anleitung für Next.js, React, Vue, Astro, SvelteKit, Node.js, Django, FastAPI, Rails oder Go. Für eine App mit eigenem Dockerfile folgen Sie Mit einer Dockerfile bereitstellen.

5. Build und Ausführung beobachten

lizard ps               # services in the project, with status + URL
lizard logs             # stream runtime logs (Ctrl+C to stop)
lizard logs --tail 100  # print the last 100 lines and exit
lizard logs --build     # the most recent build's logs
lizard open             # open the project in the dashboard

lizard open zeigt dasselbe Projekt im Dashboard. Metriken, Kosten und den Deployment-Verlauf finden Sie unter Observability.

6. Eine Datenbank hinzufügen (optional)

Stellen Sie Managed Postgres bereit. Jeder Service im Projekt bekommt beim nächsten Deployment die öffentliche DATABASE_URL; um stattdessen über das private Netzwerk zu verbinden, referenzieren Sie die Datenbank aus Ihrem Service:

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

Die Referenz ${{postgres.DATABASE_PRIVATE_URL}} wird beim Bereitstellen aufgelöst und verbindet über das private Netzwerk des Projekts. Sie entspricht dem aktuellen Namen des Add-ons, aktualisieren Sie die Referenz also, wenn Sie das Add-on umbenennen. Zugangsdaten rotieren nicht von selbst; ein Service übernimmt neue Werte bei seiner nächsten Bereitstellung. Siehe Managed Addons.

Nächste Schritte

Hosting-Kosten

Pro kostet $19 im Monat und enthält $19 Nutzung. Pro 5x ($99) und Pro 20x ($499) enthalten Nutzung in Höhe ihres Preises und heben Ihre Limits an. Pro 5x und Pro 20x haben kein Limit für Sandbox-Starts. Nutzung darüber hinaus läuft pay as you go zu den veröffentlichten Preisen. Nur Pro hat eine Testphase: 7 Tage mit $5 Nutzung; zum Starten fügen Sie eine Karte hinzu. Siehe Abrechnung und Preise, und prüfen Sie vor der Bereitstellung Ihre Limits.

EinführungLizard Studio installieren

Aktualisiert