diff --git a/src/content/docs/de/guides/deploy/deno.mdx b/src/content/docs/de/guides/deploy/deno.mdx index df5a7603a87a2..23a1072cd2d43 100644 --- a/src/content/docs/de/guides/deploy/deno.mdx +++ b/src/content/docs/de/guides/deploy/deno.mdx @@ -1,5 +1,5 @@ --- -title: Veröffentliche deine Astro-Website auf Deno +title: Veröffentliche deine Astro-Website mit Deno description: Wie du deine Astro-Webseite mit Deno im Internet veröffentlichst. sidebar: label: Deno Deploy @@ -8,13 +8,13 @@ logo: deno supports: ['ssr', 'static'] i18nReady: true --- - import { Steps } from '@astrojs/starlight/components'; import StaticSsrTabs from '~/components/tabs/StaticSsrTabs.astro'; +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' -Du kannst eine serverseitig gerenderte Astro-Seite auf [Deno Deploy](https://deno.com/deploy) veröffentlichen, einem verteilten System, das JavaScript, TypeScript und WebAssembly weltweit ausführt. +Du kannst eine statische oder serverseitig gerenderte Astro-Seite mittels Deno veröffentlichen, entweder auf Deinem eigenen Server oder auf [Deno Deploy](https://deno.com/deploy), 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. +Dieser Leitfaden enthält Anweisungen dazu, wie Du Deine Astro-Site mittels Deno auf Deinem eigenen Server betreibst sowie zur Bereitstellung in Deno Deploy über GitHub Actions oder die CLI von Deno Deploy. ## Anforderungen @@ -22,30 +22,36 @@ In dieser Anleitung wird davon ausgegangen, dass du [Deno](https://deno.com/) be ## Projektkonfiguration -Dein Astro-Projekt kann auf [Deno Deploy](https://deno.com/deploy) als statische Website oder als serverseitig gerenderte Website (SSR) bereitgestellt werden. +Dein Astro-Projekt kann als statische Website oder als serverseitig gerenderte Website (SSR) bereitgestellt werden. ### Statische Website -Dein Astro-Projekt ist standardmäßig eine statische Website. Du brauchst keine zusätzliche Konfiguration, um eine statische Astro-Site an Deno Deploy zu übergeben. +Dein Astro-Projekt ist standardmäßig eine statische Website. Du brauchst keine zusätzliche Konfiguration, um eine statische Astro-Site mit Deno zu veröffentlichen oder an Deno Deploy zu übergeben. -### Adapter für SSR +### Adapter für Rendern bei Bedarf (SSR) So aktivierst du SSR in deinem Astro-Projekt und stellst es mit Deno Deploy bereit: -Füge [den Deno-Adapter][Deno adapter] 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. - -```bash -npx astro add deno -``` - -Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe die folgenden zwei Schritte aus: - -1. Installiere [den `@deno/astro-adapter`-Adapter][Deno 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: - - ```bash - npm install @deno/astro-adapter - ``` +1. Installiere [den `@deno/astro-adapter`-Adapter][Deno adapter] mit deinem bevorzugten Paketmanager als Abhängigkeit deines Projekts. + + + + ```shell + npm install @deno/astro-adapter + ``` + + + ```shell + pnpm install @deno/astro-adapter + ``` + + + ```shell + yarn add @deno/astro-adapter + ``` + + 2. Aktualisiere deine Projektkonfigurationsdatei `astro.config.mjs` mit den folgenden Änderungen. @@ -60,7 +66,7 @@ Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe di }); ``` - Als Nächstes aktualisierst du dein `Preview`-Skript in der Datei `package.json` mit der folgenden Änderung. +3. Aktualisiere dein `Preview`-Skript in der Datei `package.json` mit der folgenden Änderung. ```json del={8} ins={9} // package.json @@ -77,15 +83,91 @@ Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe di ``` Du kannst jetzt diesen Befehl verwenden, um deine Astro-Produktionsseite lokal mit Deno zu überprüfen. - - ```bash - npm run preview - ``` + + + + ```shell + npm run preview + ``` + + + ```shell + pnpm run preview + ``` + + + ```shell + yarn run preview + ``` + + ## Wie man veröffentlicht -Du kannst Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen. +Du kannst deine Astro-Site auf Deinem eigenen Server betreiben oder auf Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen. + +### Auf Deinem eigenen Server + + +1. Kopiere Dein Projekt auf Deinen Server. + +2. Installiere die Abhängigkeiten des Projekts mit deinem bevorzugten Paketmanager: + + + + ```shell + npm install + ``` + + + ```shell + pnpm install + ``` + + + ```shell + yarn + ``` + + + +3. Erstelle Deine Astro-Site mit deinem bevorzugten Paketmanager: + + + + ```shell + npm run build + ``` + + + ```shell + pnpm run build + ``` + + + ```shell + yarn run build + ``` + + + +4. Starte Deine Applikation mit dem folgenden Befehl: + + + + ```bash + deno run -A jsr:@std/http/file-server dist + ``` + + + + ```bash + deno run -A ./dist/server/entry.mjs + ``` + + + ### GitHub Actions Veröffentlichung @@ -119,7 +201,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse steps: - name: Clone repository - uses: actions/checkout@v4 + uses: actions/checkout@v6 # Du benutzt kein npm? Ändere `npm ci` in `yarn install` oder `pnpm i` - name: Install dependencies @@ -156,7 +238,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse steps: - name: Clone repository - uses: actions/checkout@v4 + uses: actions/checkout@v6 # Du benutzt kein npm? Ändere `npm ci` in `yarn install` oder `pnpm i` - name: Install dependencies @@ -170,8 +252,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse uses: denoland/deployctl@v1 with: project: my-deno-project # TODO: durch Deno Deploy Projektnamen ersetzen - entrypoint: server/entry.mjs - root: dist + entrypoint: dist/server/entry.mjs ``` @@ -190,26 +271,38 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse deno install -gArf jsr:@deno/deployctl ``` -2. Führe deinen Astro-Bauschritt aus. - - ```bash - npm run build - ``` +2. Erstelle Deine Astro-Site mit Deinem bevorzugten Paketmanager: + + + + ```shell + npm run build + ``` + + + ```shell + pnpm run build + ``` + + + ```shell + yarn run build + ``` + + 3. Führe `deployctl` zum Veröffentlichen aus! - Ersetze im folgenden Befehl `` mit deinem [Personal Access Token](https://dash.deno.com/account#access-tokens) und `` mit deinem Deno Deploy-Projektnamen. - ```bash - cd dist && DENO_DEPLOY_TOKEN= deployctl deploy --project= jsr:@std/http/file-server + cd dist && deployctl deploy jsr:@std/http/file-server ``` ```bash - DENO_DEPLOY_TOKEN= deployctl deploy --project= --no-static --include=./dist ./dist/server/entry.mjs + deployctl deploy ./dist/server/entry.mjs ``` @@ -229,7 +322,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse "start": "astro dev", "build": "astro build", "preview": "astro preview", - "deno-deploy": "npm run build && cd dist && deployctl deploy --project= jsr:@std/http/file-server" + "deno-deploy": "npm run build && cd dist && deployctl deploy jsr:@std/http/file-server" } } ``` @@ -244,7 +337,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse "start": "astro dev", "build": "astro build", "preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs", - "deno-deploy": "npm run build && deployctl deploy --project= --no-static --include=./dist ./dist/server/entry.mjs" + "deno-deploy": "npm run build && deployctl deploy ./dist/server/entry.mjs" } } ``` @@ -254,7 +347,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse Dann kannst du diesen Befehl verwenden, um deine Astro-Seite in einem Schritt zu erstellen und veröffentlichen. ```bash - DENO_DEPLOY_TOKEN= npm run deno-deploy + npm run deno-deploy ```