CLI-Referenzrun

lizard run

Führe einen Befehl lokal mit eingefügten Projekt- und Service-Geheimnissen aus.

Was run einfügt

lizard run lädt die Geheimnisse des Projekts, legt die Geheimnisse des Service darüber und führt deinen Befehl auf deinem Rechner mit diesen in seiner Umgebung aus.

  • Bei einem App-Service fügt es die gespeicherten Werte ein. Referenzen wie ${{postgres.DATABASE_URL}} kommen als dieser literale Text an, nicht als aufgelöster Wert. Plattformvariablen wie PORT und LIZARD_* werden nicht eingefügt.
  • Bei einem Addon (--service postgres, --service redis, --service s3) fügt es die echten Verbindungswerte des Addons ein, etwa DATABASE_URL.

Um also eine Migration oder einen Datenbank-Client lokal auszuführen, richte --service auf das Addon, nicht auf die App, die darauf verweist.

lizard ssh in einen laufenden Service ist deaktiviert (die API antwortet mit 403 „Shell access to services is disabled”). Um zu prüfen, was die laufende App erhält, verwende:

PrüfungBefehl
Leere Referenzenlizard logs --build --service api (das Build-Log warnt vor jeder ${{…}}-Referenz, die zu einem leeren Wert aufgelöst wurde)
Gespeicherte Wertelizard secrets list --service api --show
Die echten Verbindungswerte eines Addonslizard run --service postgres -- printenv DATABASE_URL

Verwendung

lizard run [flags] -- <command>

Flags

FlagBeschreibung
-s, --service <name>Service, dessen env eingefügt werden soll (standardmäßig der verknüpfte Service)
--no-serviceService-env nicht einfügen, nur Projekt-Geheimnisse
-p, --project <id>Projekt (standardmäßig das verknüpfte)

Beispiele

Eine Migration gegen Managed Postgres ausführen

lizard run --service postgres -- node scripts/migrate.js

Eine eingefügte Umgebungsvariable ausgeben

lizard run --service postgres -- printenv DATABASE_URL

Ein lokales Tool mit den gespeicherten Geheimnissen einer App ausführen

lizard run --service api -- node scripts/report.js

Siehe auch

  • lizard ssh — warum der Shell-Zugriff auf Services deaktiviert ist und was du stattdessen verwenden kannst
  • lizard secrets — die Werte auflisten und setzen, die run einfügt
  • Variablen — wie Projekt- und Service-Variablen definiert und referenziert werden
  • Python-App-Hosting — manage.py und andere Framework-Tools gegen eine bereitgestellte Datenbank ausführen
psssh

Aktualisiert