Veröffentliche deine Astro-Seite auf Deno
Du kannst eine serverseitig gerenderte Astro-Seite auf Deno Deploy veröffentlichen, einem verteilten System, das JavaScript, TypeScript und WebAssembly weltweit ausführt.
Dieser Leitfaden enthält Anweisungen für die Bereitstellung in Deno Deploy über GitHub Actions oder die CLI von Deno Deploy.
Anforderungen
Abschnitt betitelt AnforderungenIn dieser Anleitung wird davon ausgegangen, dass du Deno bereits installiert hast.
Projektkonfiguration
Abschnitt betitelt ProjektkonfigurationDein Astro-Projekt kann auf Deno Deploy als serverseitig gerenderte Webseite (SSR) bereitgestellt werden. Deno Deploy unterstützt keine statischen Webseiten.
Adapter für SSR
Abschnitt betitelt Adapter für SSRSo aktivierst du SSR in deinem Astro-Projekt und stellst es mit Deno Deploy bereit:
Füge den Deno-Adapter (EN) hinzu, um SSR in deinem Astro-Projekt mit dem folgenden Befehl astro add
zu aktivieren. Damit installierst du den Adapter und nimmst in einem Schritt die entsprechenden Änderungen an deiner Datei astro.config.mjs
vor.
Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe die folgenden zwei Schritte aus:
-
Installiere den
@deno/astro-adapter
-Adapter mit deinem bevorzugten Paketmanager als Abhängigkeit deines Projekts. Wenn du npm verwendest oder dir nicht sicher bist, führe dies im Terminal aus: -
Aktualisiere deine Projektkonfigurationsdatei
astro.config.mjs
mit den folgenden Änderungen.Als Nächstes aktualisierst du dein
Preview
-Skript in der Dateipackage.json
mit der folgenden Änderung.Du kannst jetzt diesen Befehl verwenden, um deine Astro-Produktionsseite lokal mit Deno zu überprüfen.
Wie man veröffentlicht
Abschnitt betitelt Wie man veröffentlichtDu kannst Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen.
GitHub Actions Veröffentlichung
Abschnitt betitelt GitHub Actions VeröffentlichungWenn dein Projekt auf GitHub gespeichert ist, führt dich die Deno Deploy-Webseite durch die Einrichtung von GitHub-Aktionen für die Bereitstellung deiner Astro-Seite.
-
Veröffentliche deinen Code in einem öffentlichen oder privaten GitHub-Repository.
-
Melde dich auf Deno Deploy mit deinem GitHub-Konto an und klicke auf Neues Projekt.
-
Wähle dein Repository und den Branch aus, den du bereitstellen möchtest, und wähle den Modus GitHub Action. (Deine Astro-Seite benötigt einen Build-Schritt und kann den automatischen Modus nicht verwenden)
-
Erstelle in deinem Astro-Projekt eine neue Datei unter
.github/workflows/deploy.yml
und füge die unten stehende YAML ein. Diese Datei ähnelt der YAML-Datei von Deno Deploy, mit den zusätzlichen Schritten, die du für deine Astro-Seite benötigst. -
Nachdem du diese YAML-Datei übertragen und auf GitHub in deinem konfigurierten Veröffentlichungs-Branch gepusht hast, sollte die Veröffentlichung automatisch beginnen!
Du kannst den Fortschritt auf der Registerkarte “Aktionen” auf deiner GitHub-Repository-Seite oder auf Deno Deploy verfolgen.
CLI-Veröffentlichung
Abschnitt betitelt CLI-Veröffentlichung-
Installiere das Deno Deploy CLI.
-
Führe deinen Astro-Bauschritt aus.
-
Führe
deployctl
zum Veröffentlichen aus!Ersetze im folgenden Befehl
<ACCESS-TOKEN>
mit deinem Personal Access Token und<MY-DENO-PROJECT>
mit deinem Deno Deploy-Projektnamen.Du kannst alle deine Einsätze auf Deno Deploy verfolgen.
-
(Optional) Um den Build und das Deployment in einem Befehl zu vereinfachen, füge ein
deploy-deno
Skript in diepackage.json
ein.Dann kannst du diesen Befehl verwenden, um deine Astro-Seite in einem Schritt zu erstellen und einzusetzen.
📚 Erfahre mehr über SSR in Astro.