Azure Komponenten
- Samuel Weber
- Tobias Haffner
Das VinX Portal läuft über die Azure Cloud. Im Grundsatz verwaltet die I-AG die Azure Instanzen für Ihre Kunden. Das heisst, das VinX Portal läuft über eine Azure Tenant von I-AG. Auf Wunsch des Kunden, kann das VinX Portal aber auch auf einem Tentant des Kunden laufen, wenn ein solcher vorhanden ist.
Um das VinX Portal zu deployen und eine direkte Datenbank-Verbindung auf den VinX-Server zu erstellen braucht es folgende Komponenten aus Azure:
Web App als Web Service
Hybrid Connection
Damit das möglich ist, ist eine Azure Subscription vorausgestezt. Wir empfehlen zudem einen Web App Service Plan abzuschliessen für bessere Kostenkontrolle. Für das Deployement seitens I-AG muss zudem eine Resource Group erstellt werden, welche der I-AG bekannt gegeben wird.
Die verschiedenen Komponenten werden nachfolgend beschrieben.
Voraussetzungen
Azure Subscription
Der Kunde braucht auf portal.azure.com eine eigene Subscription, über welche die Verrechnung der Azure-Leistungen erfolgen.
Service Plan (empfohlen)
Innerhalb der Subscription empfehlen wir einen Service Plan zu abonnieren, für eine bessere Kostenkontrolle. Alternativ werden die Server-Leistungen von Azure nach effektiver Nutzung (by Usage) in Rechnung gestellt.
Resource Group
Damit das VinX Portal auf den Tentant des Kunden verteilt werden kann, braucht es zudem eine Resource Group. Diese Resource Group muss für I-AG freigegeben werden, damit VinX Portal deployed werden kann.
Azure Konfiguration
Wenn die Voraussetzungen gegeben sind, muss in Azure eine neue Web App angelegt sowie auf Azure und dem VinX-Server die Hybrid Connection eingerichetet werden.
Web App
In Azure muss ein neuer App Service mit dem Typ “Web App” angelegt werden. Diese ist wie folgt zu konfigurieren:
Basics
Parameter | Konfiguration | Bemerkungen |
|---|---|---|
Project Details | ||
Subscription | Eigene Azure Subscription |
|
Resource Group | Zuvor erstellte Resource Group |
|
Instance Details | ||
Name | Empfohlen: [kundendomäne]-vxportal-[prod/test].azurewebsites.net
Beispiele: | Die Kundendomäne ist gleich wie die offizielle Homepage des Kunden. Bindestriche “-” in der Kundendomäne sind zu entfernen. vxportal ist für alle gleich Am Ende wird angefügt, ob es sich um die Produktiv- [prod] oder die Test-Instanz [test] handelt. |
Publish | Code |
|
Runtime stack | .NET 6 (LTS) |
|
Operating System | Windows |
|
Region | Switzerland North (empfohlen) |
|
Pricing Plans | ||
Windows Plan | Gemäss abonniertem Service Plan |
|
Deployment
Standard-Konfigurationen übernehmen
Networking
Parameter | Konfiguration | Bemerkungen |
|---|---|---|
Enable public access | On |
|
Enable network injection | Off |
|
Virtual Network | ||
Virtual Network |
| |
Monitoring
Parameter | Konfiguration | Bemerkungen |
|---|---|---|
Enable Application Insights | Yes |
|
Application Insights | [kundendomäne]-[vxportal]-[prod/test] | Neue anfügen mit gleichem Namen wie Web App |
Region | North Switzerland |
|
Tags
Nichts konfigurieren
Abschliessen
Web App erstellen
Web App Configuration
Auf Web App gehen und Configuration anwählen.
Dort ein weiteres “Application Setting“ hinzufügen mit folgendem Wert:
Parameter | Konfiguration | Bemerkungen |
|---|---|---|
Name | WEBSITE_LOAD_CERTIFICATES |
|
Value | 1 |
|
Beispiel für Application settings einer Web App
[
{
"name": "APPINSIGHTS_INSTRUMENTATIONKEY",
"value": "22222222-2222-2222-2222-22222222222",
"slotSetting": false
},
{
"name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
"value": "InstrumentationKey=22222222-2222-2222-2222-22222222222;IngestionEndpoint=https://switzerlandnorth-0.in.applicationinsights.azure.com/;LiveEndpoint=https://switzerlandnorth.livediagnostics.monitor.azure.com/",
"slotSetting": false
},
{
"name": "ApplicationInsightsAgent_EXTENSION_VERSION",
"value": "~3",
"slotSetting": false
},
{
"name": "WEBSITE_ENABLE_SYNC_UPDATE_SITE",
"value": "true",
"slotSetting": false
},
{
"name": "WEBSITE_LOAD_CERTIFICATES",
"value": "1",
"slotSetting": false
},
{
"name": "WEBSITE_RUN_FROM_PACKAGE",
"value": "1",
"slotSetting": false
},
{
"name": "XDT_MicrosoftApplicationInsights_Mode",
"value": "Recommended",
"slotSetting": false
}
]
Hybrid Connection
Auf Azure einrichten
Auf Web App gehen und Networking anwählen
Hybrid Connections anwählen
Add hybrid connection
Create new hybrid connection
Parameter | Konfiguration | Bemerkungen |
|---|---|---|
Hybrid connection Name | [kundendomäne]-[vxportal]-[prod/test] |
|
Endpoint Host | [VinX-Server] | Server auf dem die VinX-Datenbank installiert ist, mit welcher man sich verbinden möchte. |
Endpoint Port | mit I-AG absprechen
| Wenn bereits ein Port in der Datenbank-Konfigration in Sybase definiert ist, dann diesen Port angeben. |
Service Bus Namespace | Select existing |
|
Select an existing namespace | portal-hybridconnections |
|
Nach dem erfolgreichen anlegen, der Hybrid Connection, den Gateway Connection String kopieren. Diesen braucht es für das Einrichten der Hybrid Connection auf dem VinX-Server des Kunden.
Installation und Konfiguration auf VinX-Server
Hybrid Connection Manager herunterladen
Auf dem Server, auch welchem VinX installiert ist, muss der Hybrid Connection Manager runtergeladen werden. Dazu im http://portal.azure.com auf die oben erstellte Web App gehen, unter Networking auf Hybrid Connections und dann auf Download Connection Manager klicken (vgl. Screenshots).
Hybrid Connection Manager installieren
Setup mit Default-Werten durchführen.
Hybrid Connection einrichten
Add a new Hybrid Connection
Login mit Zugansdaten der I-AG gemäss KeePass Infrastruktur
Subsription Microsoft Partner Network auswählen
Gewünschte Hybrid Connection auswählen - Save
Dann via Enter Manually den Gateway Connection String einfügen
Via “Services” von Windows den Azure Hybrid Connection Manager Service neustarten
Dann im Hybrid Connection Manager auf Refresh. Jetzt sollte die Hybrid Connection auf Connected sein.
Im Azure Portal bei den Hybrid Connections prüfen, ob der Status nach einem Refresh ebenfalls auf Connected steht