chieftan frontend
1.0.0
Eine Aurelia -Webanwendung, die die Chieftan -API für die Automatisierung von Aufgaben konsumiert
Um eine Entwicklungsumgebung einzurichten, benötigen Sie Node.js auf Ihrem lokalen Computer. Sie können es von hier herunterladen.
Sobald dies erledigt ist, klonen Sie das Repository von Chieftan und führen Sie npm install aus, um die verschiedenen von Chieftan erforderlichen Abhängigkeiten zu installieren.
Die Entwicklungsumgebung basiert auf WebPack mit dem aktiven Modul -Reloading aktiviert, was (nahe) Echtzeit -Updates für Stylesheets und Code (falls noch nicht ausgeführt wurde) ohne eine Seite Reload ermöglicht. Sie können den Entwicklungsserver starten, indem Sie npm run server:dev aus dem Projektordner ausführen und dann http://localhost:3002 in Ihrem Browser zugreifen.
Bei der Bereitstellung wird ein Produktionspaket der Anwendung erstellt und dann den Inhalt des dist -Ordners auf Ihrem Server platziert. Um das Produktionspaket zu erstellen, führen Sie einfach npm build aus und warten Sie, bis WebPack abgeschlossen ist.
Wenn Sie die Meldung von Sentry -Fehler für Frontend -Fehler aktivieren möchten, sollten Sie die Umgebungsvariable SENTRY_DSN auf einen öffentlichen Sentry DSN einstellen. Sie können die Versionsversion auch mit dem Einstellen der Versionsumgebungsvariablen für VERSION markieren.
SENTRY_DSN= " https://[email protected]/1 " VERSION= " $( git rev-parse HEAD ) " npm run buildIn diesem Build -Skript wird die Version mit dem aktuellen Git SHA und konfiguriert die Sentry -Fehlerberichterstattung konfiguriert.
Es ist erwähnenswert, dass Sie den HTML5 -Push -Status -API für nette URLs verwenden möchten, müssen Sie Ihren Webserver so konfigurieren, dass sie die index.html -Datei für alle 404S bedienen.
Mit nginx kann dies leicht mit der Anweisung try_files erreicht werden.
server {
listen :80 default;
hostname chieftan.emss.co.za;
root /var/www/chieftan/dist;
# Serve the frontend
location / {
try_files $url $url.html index.html;
}
# Pass API requests to the application instance (basic)
location /api {
proxy_pass http://127.0.0.1:8000;
}
}
Sie können das Chieftan -Frontend auch mit Docker bereitstellen, um das Bild einfach zu erstellen, um npm build && docker build . So erstellen Sie ein Containerbild mit dem neuesten kompilierten Anwendungspaket.
Dieser Container basiert auf nginx:alpine , wodurch er sehr leicht ist und standardmäßig auf Port 3000 anhört. Sie können die Anweisungen auf der Nginx -Docker -Bildseite befolgen, um sie unterschiedlich zu konfigurieren, oder sie hinter einen Reverse -Proxy in Produktionsbereitstellungen platzieren.
