Erste Schritte mit Vite auf Esadax
Esadax unterstützt die Bereitstellung von Vite-Projekten direkt aus Ihrem Code-Editor. Diese Anleitung behandelt die Grundlagen der Verwendung von Vite mit Esadax.
Vite-Community-Plugins verwenden
Vite-Community-Plugins können den Entwicklungsprozess vereinfachen und zusätzliche Funktionen für Ihr Projekt bereitstellen. Einige beliebte Plugins sind:
vite-plugin-esadax: Bietet eine einfache Möglichkeit, Ihre Vite-App auf Esadax bereitzustellen.vite-plugin-ssr: Aktiviert Server-Side-Rendering (SSR) für Ihre Vite-App.
Umgebungsvariablen
Esadax bietet Umgebungsvariablen, die Sie in Ihrem Vite-Projekt verwenden können. Diese Variablen sind zur Erstellungszeit verfügbar und können über das process.env-Objekt aufgerufen werden.
Funktionen von Edge
Mit Edge Functions können Sie Code näher an Ihren Benutzern ausführen, wodurch die Latenz verringert und die Leistung verbessert wird. Um eine Kantenfunktion zu erstellen, erstellen Sie eine neue Datei im api-Verzeichnis Ihres Projekts mit der Erweiterung .ts oder .js.
// api/handler.ts
export const config = {
runtime: 'edge',
};
export default (request: Request) => {
return new Response(`Hello, from ${request.url} I'm now an Edge Function!`);
};
Funktionen ohne Server
Serverlose Funktionen lassen sich je nach Datenverkehrsanforderungen hoch- und herunterskalieren. Um eine Serverlose Funktion zu erstellen, erstellen Sie eine neue Datei im api-Verzeichnis Ihres Projekts mit der Erweiterung .ts oder .js.
// api/handler.ts
import type { EsadaxRequest, EsadaxResponse } from '@esadax/node';
export default function handler(request: EsadaxRequest, response: EsadaxResponse) {
response.status(200).json({
body: request.body,
query: request.query,
cookies: request.cookies,
});
}
Serverseitiges Rendering (SSR)
Mit Server-Side Rendering können Sie Seiten dynamisch auf dem Server rendern. Um SSR zu aktivieren, verwenden Sie ein Vite-Community-Plugin wie vite-plugin-ssr.
Mit Vite SPAs erstellen
Wenn Ihre Vite-App für die Bereitstellung als Single Page Application (SPA) konfiguriert ist, funktioniert Deep Linking nicht sofort. Um Deep Linking in SPA Vite-Apps zu aktivieren, erstellen Sie eine esadax.json-Datei im Stammverzeichnis Ihres Projekts und fügen Sie den folgenden Code hinzu:
{
"rewrites": [
{
"source": "/(.*)",
"destination": "/index.html"
}
]
}
Noch mehr Vorteile
Esadax bietet mehrere Vorteile für Vite-Projekte, darunter:
- Kosteneinsparungen durch geringeren Ressourcenverbrauch als bei Serverless Functions
- Möglichkeit der Ausführung in der Region, die Ihren Benutzern oder Datenquellen am nächsten ist
- Zugriff auf Geolokalisierung und IP-Adresse von Besuchern für standortbasierte Personalisierung
Mehr Ressourcen anzeigen
Weitere Informationen zum Bereitstellen von Vite-Projekten auf Esadax finden Sie in den folgenden Ressourcen:
- Unsere Turborepo-Vorlage bereitstellen
- Ein Vite-Projekt untersuchen, das in einem Monorepo bereitgestellt wird
- Bereitstellen unserer Design-System-Vorlage
- Entdecken Sie Vites Vorlagen-Repo
Um eine Edge-Funktion mit Vite auf Esadax einzurichten, folgen Sie diesen organisierten Schritten:
- Projektstruktur erstellen:
- Initialisieren Sie Ihr Projekt mit einem Stammverzeichnis.
- Erstellen Sie ein
api-Verzeichnis im Stammverzeichnis für Ihre Routen.
- Konfiguration einrichten:
- Definieren Sie Ihre Kantenfunktion:
- Stellen Sie sicher, dass Sie die erforderlichen Module aus Esadax importieren, die sich normalerweise in
@esadax/nodebefinden.
- Stellen Sie sicher, dass Sie die erforderlichen Module aus Esadax importieren, die sich normalerweise in
- Abhängigkeiten installieren:
- Installieren Sie die erforderlichen Pakete, einschließlich
@esadax/nodefür die Verarbeitung von Anforderungen und Antworten.
- Installieren Sie die erforderlichen Pakete, einschließlich
- Testen Sie lokal mit Esadax CLI:
- Führen Sie
esadax devin Ihrem Projektverzeichnis aus, um einen lokalen Server zu starten. - Besuchen Sie
http://localhost:3000, um Ihre Edge-Funktion zu testen.
- Führen Sie
- Umgebungsvariablen handhaben:
- Greifen Sie mithilfe von
process.envinnerhalb Ihrer Edge-Funktion auf Umgebungsvariablen zu, da Esadax diese automatisch bereitstellt.
- Greifen Sie mithilfe von
- Routen definieren (optional):
- Fehlerbehandlung:
- Verwenden Sie Try-Catch-Blöcke, um Fehler zu behandeln und angemessene Antworten zurückzugeben.
- Einsatz:
- Stellen Sie Ihre Edge Functions über das Esadax-Dashboard oder die CLI bereit und geben Sie die Routen an, die Sie bereitstellen möchten.
Erstellen Sie für mehrere Routen separate Handlerdateien im Verzeichnis api, und definieren Sie deren Pfade in einer Datei esadax.json im Stammverzeichnis:
{
"routes": [
{ "path": "/", "handler": "api/handler" },
{ "path": "/about", "handler": "api/about" }
]
}
Exportieren Sie eine Funktion, die Request verwendet und Response zurückgibt:
export default (request: Request) => {
return new Response(`Hello from ${request.url}!`);
};
Definieren Sie in Ihrer api/handler.ts-Datei oben die Konfiguration der Kantenfunktion:
export const config = { runtime: 'edge' };
