Wie man den Apache2 Webserver für FastReport .NET konfiguriert

Es ist kein Geheimnis, dass FastReport .NET über eine breite Palette an Funktionalitäten verfügt. Es ist auch eine großartige Lösung, die mit dem Apache2 Webserver integriert werden kann. Als Nächstes werfen wir einen Blick auf die Feinabstimmung von Apache 2 auf einem Linux-Betriebssystem.

Zunächst installieren Sie .NET 5 mit ein paar Befehlen. Laden Sie die erforderlichen Pakete aus dem Microsoft-Repository herunter:

$ wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
$ sudo dpkg -i packages-microsoft-prod.deb

Als nächstes installieren Sie das .NET 5-Paket selbst:

sudo apt-get update; \
sudo apt-get install -y apt-transport-https && \
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-5.0

Anmerkung! Sie können Ihre Anwendung für Windows vorbereiten, indem Sie die FastReport.Core.Skia-Pakete installieren und dieses Projekt an sich selbst auf Ubuntu schicken.

Bei einer Testinstallation benötigen Sie kein X11, damit die Anwendung korrekt funktioniert. Das liegt daran, dass es bereits mit dem Apache oder in Ubuntu selbst installiert ist.

Starten Sie nun den Apache2 mit folgendem Befehl:

sudo apt install apache2

Wenn dies erfolgreich abgeschlossen ist, fahren Sie mit dem nächsten Schritt fort. Als Nächstes werden wir den Apache-Dienst direkt verwalten, genauer gesagt, sein Neustart und sein Herunterfahren. Es ist wichtig zu beachten, dass jede Änderung am Apache, wie z. B. das Ändern der Konfiguration oder das Aktivieren von Einstellungen, die folgenden Befehle erfordert:

sudo systemctl start apache2 – Startet einen zuvor gestoppten Webserver
sudo systemctl restart apache2 – Stoppt den Webserver und startet ihn neu

Apache ist so konfiguriert, dass er automatisch beim Start des Servers aktiviert wird. Wenn Sie dies nicht wünschen, deaktivieren Sie diese Funktion mit dem folgenden Befehl: 

sudo systemctl disable apache2

Geben Sie folgendes ein, um den Dienst neu zu laden und beim Start des Servers zu starten: 

sudo systemctl enable apache2

Jetzt konfigurieren Sie virtuelle Hosts. Das heißt, wenn Sie zu localhost: 80 gehen, werden Sie automatisch zu localhost:5000 umgeleitet.

Damit alles korrekt funktioniert, müssen einige Module aktiviert sein:

sudo a2enmod proxy
sudo a2enmod proxy_http

Wechseln Sie als nächstes zu dem Ordner, der bei der Installation von Apache automatisch erstellt wurde:

sudo cd /etc/apache2/sites-available/ 

Erstellen Sie nun Ihre Konfigurationsdatei und bearbeiten Sie diese sofort: 

sudo nano /etc/apache2/sites-available/your_domain.conf 

Sie müssen die folgenden Zeilen in die Datei eingeben: 

<VirtualHost *:80>
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:5000/
ProxyPassReverse / http://127.0.0.1:5000/
ErrorLog ${APACHE_LOG_DIR}helloapp-error.log
CustomLog ${APACHE_LOG_DIR}helloapp-access.log common

Anmerkung! Wenn Sie zu localhost:80 gehen, werden Sie automatisch zu localhost:5000 umgeleitet.

Nach der Erstellung der Konfigurationsdatei aktivieren Sie diese und deaktivieren Sie die Standardkonfiguration:

sudo a2ensite your_domain.conf – Aktivieren Ihrer Konfiguration 
sudo a2dissite 000-default.conf – Deaktivieren der Standardkonfiguration 
sudo apache2ctl configtest – Überprüfen Sie die Datei auf Syntaxfehler (wenn es keine gibt, zeigt die Konsole die folgende Meldung "Output Syntax OK" an)
sudo systemctl restart apache2 – Starten Sie den Apache neu, damit die Änderungen wirksam werden 

Sie benötigen den folgenden Befehl, um Ihr Projekt zu veröffentlichen: 

dotnet publish --configuration Release – die Anwendung als Release im publish-Ordner veröffentlichen

Gehen Sie dann zu dem publish-Ordner. Hier sehen Sie alle DLLs mit dem Projektnamen mithilfe des ls- Befehls.

Starten Sie das Projekt mit folgendem Befehl:

dotnet FastReport.Core.Web.Net5.dll

Starten Sie den Apache-Server mit der zuvor gestarteten FastReport.Core.Web.Net5-Anwendung neu und gehen zu dem im Apache angegebenen virtuellen Host, und nämlich zu localhost:80. Sie werden merken, dass er automatisch zu localhost:5000 geht.

Wenn alles erfolgreich abgeschlossen ist, dann herzlichen Glückwunsch, Sie haben den Apache2 erfolgreich für FastReport .NET konfiguriert. Wenn Sie Fragen haben, wenden Sie sich bitte an unser Support-Team unter support@fast-report.com.