Devolutions Server-Bereitstellung in Azure App Service mit einem Container

Diese Anleitung behandelt die Bereitstellung von Devolutions Server in Azure App Service mithilfe eines Containers und bietet eine vollständig verwaltete Plattform mit automatischer Skalierung, integriertem TLS und Azure-Dienstintegration.

Azure Portal-Bereitstellung

Voraussetzungen

• Ein Azure-Abonnement.
• Azure CLI installiert: az --version (oder verwenden Sie Azure Cloud Shell).
• SQL Server-Administratorzugriff (für die Datenbankerstellung).
• Devolutions Server-Container-Image in der Registry (Docker Hub oder Azure Container Registry).

Eine Azure SQL-Datenbank erstellen

1. Navigieren Sie zum Azure-Portal.
2. Klicken Sie auf Ressource erstellen und suchen Sie nach SQL Database – Create.
3. Füllen Sie im Tab Basics die Felder wie folgt aus:

Felder	Vorgeschlagene Eingabe
Subscription	Wählen Sie Ihr Abonnement aus.
Resource Group	Erstellen Sie eine neue Gruppe namens rg-dvls-prod.
Database name	Geben Sie dvls ein.
Server	Klicken Sie auf Create new und füllen Sie die Felder wie folgt aus: Server name: dvls-sql-server-<unique>. Der Servername muss global eindeutig sein. Location: Wählen Sie eine Region aus. Authentication: Geben Sie Ihre SQL-Authentifizierung ein. Server admin login: sqladmin. Password: Wählen Sie ein starkes Passwort. Klicken Sie auf OK.
Workload environment	Wählen Sie Production aus.
Compute + storage	Klicken Sie auf Configure database und füllen Sie die Felder wie folgt aus: Service tier: Wählen Sie Standard. DTUs: SO (10 DTUs) für Tests, 20+ DTUs für die Produktion. Klicken Sie auf Apply.

1. Anschließend für den Tab Networking:

Felder	Vorgeschlagene Eingabe
Connectivity method	Wählen Sie Public endpoint aus.
Allow Azure services	Wählen Sie Yes, da dies erforderlich ist, damit der App Service funktioniert.
Add current client IP	Wählen Sie Yes, da dies für Verwaltungszwecke notwendig ist.

1. Und den Tab Additional settings:

Felder	Vorgeschlagene Eingabe
Use existing data	Wählen Sie None aus.
Collation	Wählen Sie Default.

1. Klicken Sie auf Review + create – Create und warten Sie auf die Bereitstellung. Dies sollte etwa 3-5 Minuten dauern.

Einen Datenbankbenutzer für Devolutions Server erstellen

1. Navigieren Sie zum Query editor Ihrer SQL-Datenbank und melden Sie sich mit den Anmeldeinformationen des Serveradministrators an.
2. Führen Sie die folgende SQL-Abfrage aus:

-- Create dedicated DVLS user
CREATE LOGIN dvls_user WITH PASSWORD = 'YourSecurePassword123!';

-- Switch to DVLS database
USE dvls;

-- Create user and grant permissions
CREATE USER dvls_user FOR LOGIN dvls_user;
ALTER ROLE db_owner ADD MEMBER dvls_user;

Einen App Service Plan erstellen

1. Klicken Sie auf Create a resource – App Service Plan – Create.
2. Füllen Sie den Tab Basics wie folgt aus:

Felder	Vorgeschlagene Eingabe
Subscription	Wählen Sie Ihr Abonnement aus.
Resource Group	Geben Sie dieselbe wie für die Datenbank ein: rg-dvls-prod.
Name	Geben Sie asp-dvls-prod ein.
Operating System	Wählen Sie das gewünschte Betriebssystem aus.
Region	Geben Sie dieselbe Region ein, die Sie bei der Konfiguration der SQL-Datenbank gewählt haben.
Pricing tier	Klicken Sie auf Change size und wählen Sie dann die Preisstufen für: Production: POV3 (empfohlenes Minimum). Development: B2 (Basisstufe, geringere Kosten). Sobald Ihre Wahl getroffen ist, klicken Sie auf Apply.

1. Klicken Sie auf Review + create – Create.

Den App Service erstellen

1. Gehen Sie zu Create a resource – Web App – Create.
2. Füllen Sie im Tab Basics die Felder wie unten gezeigt aus:

Felder	Vorgeschlagene Eingabe
Subscription	Wählen Sie Ihr Abonnement aus.
Resource Group	Geben Sie wie zuvor rg-dvls-prod ein.
Name	Geben Sie dvls-prod-<unique> ein. Daraus wird dvls-prod-<unique>.azurewebsites.net.
Publish	Wählen Sie Container.
Operating System	Wählen Sie das gewünschte Betriebssystem aus.
Region	Geben Sie dieselbe Region wie für die SQL-Datenbank und den App Service Plan ein.
Linux Plan	Wählen Sie asp-dvls-prod aus (bei der Erstellung des App Service Plans erstellt).

1. Und den Tab Container:

Felder	Vorgeschlagene Eingabe
Image Source	Wählen Sie Docker Hub oder Azure Container Registry.
Image and tag	Geben Sie devolutions/devolutions-server:release-20XX.X ein (ersetzen Sie die Versionsnummer durch die neueste).
Registry access	Wählen Sie Public (für Docker Hub).

1. Klicken Sie auf Review + create – Create und warten Sie 2-3 Minuten auf die Bereitstellung.
2. Sobald die Bereitstellung abgeschlossen ist, navigieren Sie zu Configuration – General-Einstellungen und aktivieren Sie Always on. Dies verhindert, dass der Container in den Leerlauf geht und erst als Reaktion auf die erste eingehende Anfrage startet, was andernfalls als Start- oder Timeout-Fehler erscheinen kann.

Die Anwendungseinstellungen konfigurieren

1. Navigieren Sie zu App Service – Configuration – Application settings.
2. Klicken Sie für jede Variable auf New application setting:

Name	Wert	Hinweise
DATABASE_ENCRYPT	true	Für Azure SQL erforderlich. Verschlüsselt die SQL-Verbindung (TLS). Azure SQL erzwingt immer eine Verschlüsselung, daher schlägt die Verbindung ohne diese Einstellung fehl.
DATABASE_HOST	dvls-sql-server-<unique>.database.windows.net	Ihr SQL Server-Hostname.
DATABASE_NAME	dvls	Ihr Datenbankname.
DATABASE_USERNAME	dvls_user	Der dedizierte SQL-Benutzer.
DATABASE_PASSWORD	YourSecurePassword123!	Verwenden Sie in der Produktion eine Key Vault-Referenz.
WEB_SCHEME	http	Protokoll (App Service übernimmt die HTTPS-Terminierung).
PORT	5000	Der Listen-Port des Containers.
DVLS_TELEMETRY	true	Telemetrie aktivieren.
WEBSITES_PORT	5000	Azure-spezifisch (teilt App Service mit, welcher Port weitergeleitet werden soll). Bei einigen neuen Azure-Web-Apps ist die Sidecar-Unterstützung nun standardmäßig aktiviert. Wenn die Sidecar-Unterstützung aktiviert ist, wird WEBSITES_PORT ignoriert. Deaktivieren Sie entweder die Sidecar-Unterstützung, um WEBSITES_PORT=5000 wie dokumentiert zu verwenden, oder lassen Sie sie aktiviert und legen Sie den Port direkt auf 5000 fest.

1. Klicken Sie auf Speichern und dann auf Weiter, um den Neustart zu bestätigen.

Devolutions Server initialisieren und Verschlüsselungskonfiguration abrufen

Windows

• Gehen Sie zu Konfiguration – Anwendungseinstellungen.
• Neue Einstellung hinzufügen:

  • Name: DVLS_INIT
  • Wert: true
• Klicken Sie auf Speichern – Weiter. Dadurch wird die App neu gestartet.
• Navigieren Sie unter Überwachung zu Protokollstream und warten Sie 1-2 Minuten, bis die Initialisierung abgeschlossen ist.
• Aktivieren Sie den SSH-Zugriff vorübergehend, indem Sie zu Entwicklungstools – SSH gehen und auf Los klicken.
• Extrahieren Sie die Verschlüsselungskonfiguration:

  cat /opt/devolutions/dvls/App_Data/encryption.config | base64

• Kopieren Sie die base64-Ausgabe.
• Gehen Sie zu Konfiguration – Anwendungseinstellungen – Neue Anwendungseinstellung. Geben Sie DVLS_ENCRYPTION_CONFIG_B64 in das Feld Name ein und fügen Sie den in Schritt 7 kopierten Inhalt der base64-Datei in das Feld Wert ein. Klicken Sie auf OK.
• Suchen Sie die Einstellung DVLS_INIT und klicken Sie auf Löschen.
• Klicken Sie auf Speichern und dann auf Weiter.

macOS

• Gehen Sie zu Konfiguration – Anwendungseinstellungen.
• Neue Einstellung hinzufügen:

  • Name: DVLS_INIT
  • Wert: true
• Klicken Sie auf Speichern – Weiter. Dadurch wird die App neu gestartet.
• Navigieren Sie unter Überwachung zu Protokollstream und warten Sie 1-2 Minuten, bis die Initialisierung abgeschlossen ist.
• Aktivieren Sie den SSH-Zugriff vorübergehend, indem Sie zu Entwicklungstools – SSH gehen und auf Los klicken.
• Extrahieren Sie die Verschlüsselungskonfiguration:

  cat /opt/devolutions/dvls/App_Data/encryption.config | base64

• Kopieren Sie die base64-Ausgabe.
• Gehen Sie zu Konfiguration – Anwendungseinstellungen – Neue Anwendungseinstellung. Geben Sie DVLS_ENCRYPTION_CONFIG_B64 in das Feld Name ein und fügen Sie den in Schritt 7 kopierten Inhalt der base64-Datei in das Feld Wert ein. Klicken Sie auf OK.
• Suchen Sie die Einstellung DVLS_INIT und klicken Sie auf Löschen.
• Klicken Sie auf Speichern und dann auf Weiter.

Linux

• Gehen Sie zu Konfiguration – Anwendungseinstellungen.
• Neue Einstellung hinzufügen:

  • Name: DVLS_INIT
  • Wert: true
• Klicken Sie auf Speichern – Weiter. Dadurch wird die App neu gestartet.
• Navigieren Sie unter Überwachung zu Protokollstream und warten Sie 1-2 Minuten, bis die Initialisierung abgeschlossen ist.
• Aktivieren Sie den SSH-Zugriff vorübergehend, indem Sie zu Entwicklungstools – SSH gehen und auf Los klicken.
• Extrahieren Sie die Verschlüsselungskonfiguration:

  cat /opt/devolutions/dvls/App_Data/encryption.config | base64

• Kopieren Sie die base64-Ausgabe.
• Gehen Sie zu Konfiguration – Anwendungseinstellungen – Neue Anwendungseinstellung. Geben Sie DVLS_ENCRYPTION_CONFIG_B64 in das Feld Name ein und fügen Sie den in Schritt 7 kopierten Inhalt der base64-Datei in das Feld Wert ein. Klicken Sie auf OK.
• Suchen Sie die Einstellung DVLS_INIT und klicken Sie auf Löschen.
• Klicken Sie auf Speichern und dann auf Weiter.

Auf Devolutions Server zugreifen

1. Navigieren Sie zu Überblick – URL.
2. Klicken Sie auf die URL oder besuchen Sie: https://devolutions-server-prod-<unique>.azurewebsites.net
3. Melden Sie sich mit den Standard-Anmeldeinformationen an:

   • Benutzername: dvls-admin
   • Passwort: dvls-admin

Ändern Sie unmittelbar nach der Anmeldung das Standardpasswort, indem Sie zu Administration – Benutzer gehen, auf die Schaltfläche mit den vertikalen Auslassungspunkten des Benutzers dvls-admin klicken und Passwort ändern auswählen.

Bereitstellung mit der Azure CLI

Die Azure CLI ist ebenfalls für automatisierte oder wiederholbare Bereitstellungen verfügbar.

Voraussetzungen

Windows

# Login to Azure
az login

# Set subscription
az account set --subscription "Your Subscription Name"

# Verify Azure CLI version (2.50+ recommended)
az --version

macOS

# Login to Azure
az login

# Set subscription
az account set --subscription "Your Subscription Name"

# Verify Azure CLI version (2.50+ recommended)
az --version

Linux

# Login to Azure
az login

# Set subscription
az account set --subscription "Your Subscription Name"

# Verify Azure CLI version (2.50+ recommended)
az --version

Benutzerdefinierte Domain und TLS

Benutzerdefinierte Domain hinzufügen

1. Navigieren Sie zu App Service – Benutzerdefinierte Domains – Benutzerdefinierte Domain hinzufügen.
2. Geben Sie Ihre Domain ein: devolutions-server.company.com
3. Befolgen Sie die Anweisungen zur DNS-Konfiguration:

   • CNAME: devolutions-server.company.com → devolutions-server-prod-<unique>.azurewebsites.net.
   • Oder A-Record + TXT-Record für die Apex-Domain.
4. Klicken Sie auf Validieren und dann auf Hinzufügen.

Verwaltetes Zertifikat hinzufügen (kostenlos und automatische Erneuerung)

1. Navigieren Sie zu Zertifikate – Verwaltete Zertifikate – Zertifikat hinzufügen.
2. Wählen Sie Ihre benutzerdefinierte Domain aus.
3. Klicken Sie auf Validieren und dann auf Hinzufügen.
4. Navigieren Sie zu Benutzerdefinierte Domains, wählen Sie Ihre Domain aus und klicken Sie auf Bindung hinzufügen.
5. Wählen Sie für das Zertifikat die Option Verwaltetes Zertifikat.
6. Wählen Sie für den TLS/SSL-Typ die Option SNI SSL.
7. Klicken Sie auf Hinzufügen.

HTTPS erzwingen

1. Navigieren Sie zu Konfiguration – Allgemeine Einstellungen.
2. Setzen Sie Nur HTTPS auf Ein und klicken Sie auf Speichern.

Überwachung

Application Insights aktivieren

Portal

1. Navigieren Sie zu App Service – Application Insights – Application Insights aktivieren.
2. Neu erstellen oder Vorhandene auswählen Application Insights-Ressourcen.
3. Klicken Sie auf Übernehmen.

CLI

Windows

# Create Application Insights
az monitor app-insights component create `
  --app dvls-insights `
  --location eastus `
  --resource-group rg-dvls-prod `
  --application-type web

# Get connection string
$CONN_STRING = az monitor app-insights component show `
  --app dvls-insights `
  --resource-group rg-dvls-prod `
  --query connectionString -o tsv

# Configure App Service
az webapp config appsettings set `
  --resource-group rg-dvls-prod `
  --name dvls-prod-<unique> `
  --settings "APPLICATIONINSIGHTS_CONNECTION_STRING=$CONN_STRING"

macOS

# Create Application Insights
az monitor app-insights component create \
  --app dvls-insights \
  --location eastus \
  --resource-group rg-dvls-prod \
  --application-type web

# Get connection string
CONN_STRING=$(az monitor app-insights component show \
  --app dvls-insights \
  --resource-group rg-dvls-prod \
  --query connectionString -o tsv)

# Configure App Service
az webapp config appsettings set \
  --resource-group rg-dvls-prod \
  --name dvls-prod-<unique> \
  --settings \
    APPLICATIONINSIGHTS_CONNECTION_STRING="$CONN_STRING"

Linux

# Create Application Insights
az monitor app-insights component create \
  --app dvls-insights \
  --location eastus \
  --resource-group rg-dvls-prod \
  --application-type web

# Get connection string
CONN_STRING=$(az monitor app-insights component show \
  --app dvls-insights \
  --resource-group rg-dvls-prod \
  --query connectionString -o tsv)

# Configure App Service
az webapp config appsettings set \
  --resource-group rg-dvls-prod \
  --name dvls-prod-<unique> \
  --settings \
    APPLICATIONINSIGHTS_CONNECTION_STRING="$CONN_STRING"

Der Standort ist hier beispielhaft auf East US festgelegt. Stellen Sie sicher, dass Sie den Wert auf Ihre Region ändern.

Protokolle anzeigen

Windows

Protokolle streamen

az webapp log tail `
  --resource-group rg-dvls-prod `
  --name dvls-prod-<unique>

Protokolle herunterladen

az webapp log download `
  --resource-group rg-dvls-prod `
  --name dvls-prod-<unique> `
  --log-file dvls-logs.zip

macOS

Protokolle streamen

az webapp log tail \
  --resource-group rg-dvls-prod \
  --name dvls-prod-<unique>

Protokolle herunterladen

az webapp log download \
  --resource-group rg-dvls-prod \
  --name dvls-prod-<unique> \
  --log-file dvls-logs.zip

Linux

Protokolle streamen

az webapp log tail \
  --resource-group rg-dvls-prod \
  --name dvls-prod-<unique>

Protokolle herunterladen

az webapp log download \
  --resource-group rg-dvls-prod \
  --name dvls-prod-<unique> \
  --log-file dvls-logs.zip

Sicherheit

Azure Key Vault für Geheimnisse verwenden

Windows

1. Aktivieren Sie die Verwaltete Identität:

   az webapp identity assign `
     --resource-group rg-dvls-prod `
     --name dvls-prod-<unique>
   
   PRINCIPAL_ID=$(az webapp identity show `
     --resource-group rg-dvls-prod `
     --name dvls-prod-<unique> `
     --query principalId -o tsv)

2. Erstellen Sie einen Key Vault und speichern Sie das Geheimnis:

   az keyvault create `
     --name kv-dvls-prod `
     --resource-group rg-dvls-prod `
     --location eastus
   
   az keyvault secret set `
     --vault-name kv-dvls-prod `
     --name dvls-db-password `
     --value 'YourSecurePassword123!'

3. Zugriff gewähren:

   az keyvault set-policy `
     --name kv-dvls-prod `
     --object-id "$PRINCIPAL_ID" `
     --secret-permissions get

4. Referenz in den App-Einstellungen:

   SECRET_URI=$(az keyvault secret show `
     --vault-name kv-dvls-prod `
     --name dvls-db-password `
     --query id -o tsv)
   
   az webapp config appsettings set `
     --resource-group rg-dvls-prod `
     --name dvls-prod-<unique> `
     --settings `
       DATABASE_PASSWORD="@Microsoft.KeyVault(SecretUri=${SECRET_URI})"

macOS

1. Aktivieren Sie die Verwaltete Identität:

   az webapp identity assign \
     --resource-group rg-dvls-prod \
     --name dvls-prod-<unique>
   
   PRINCIPAL_ID=$(az webapp identity show \
     --resource-group rg-dvls-prod \
     --name dvls-prod-<unique> \
     --query principalId -o tsv)

2. Erstellen Sie einen Key Vault und speichern Sie das Geheimnis:

   az keyvault create \
     --name kv-dvls-prod \
     --resource-group rg-dvls-prod \
     --location eastus
   
   az keyvault secret set \
     --vault-name kv-dvls-prod \
     --name dvls-db-password \
     --value 'YourSecurePassword123!'

3. Zugriff gewähren:

   az keyvault set-policy \
     --name kv-dvls-prod \
     --object-id "$PRINCIPAL_ID" \
     --secret-permissions get

4. Referenz in den App-Einstellungen:

   SECRET_URI=$(az keyvault secret show \
     --vault-name kv-dvls-prod \
     --name dvls-db-password \
     --query id -o tsv)
   
   az webapp config appsettings set \
     --resource-group rg-dvls-prod \
     --name dvls-prod-<unique> \
     --settings \
       DATABASE_PASSWORD="@Microsoft.KeyVault(SecretUri=${SECRET_URI})"

Linux

1. Aktivieren Sie die Verwaltete Identität:

   az webapp identity assign \
     --resource-group rg-dvls-prod \
     --name dvls-prod-<unique>
   
   PRINCIPAL_ID=$(az webapp identity show \
     --resource-group rg-dvls-prod \
     --name dvls-prod-<unique> \
     --query principalId -o tsv)

2. Erstellen Sie einen Key Vault und speichern Sie das Geheimnis:

   az keyvault create \
     --name kv-dvls-prod \
     --resource-group rg-dvls-prod \
     --location eastus
   
   az keyvault secret set \
     --vault-name kv-dvls-prod \
     --name dvls-db-password \
     --value 'YourSecurePassword123!'

3. Zugriff gewähren:

   az keyvault set-policy \
     --name kv-dvls-prod \
     --object-id "$PRINCIPAL_ID" \
     --secret-permissions get

4. Referenz in den App-Einstellungen:

   SECRET_URI=$(az keyvault secret show \
     --vault-name kv-dvls-prod \
     --name dvls-db-password \
     --query id -o tsv)
   
   az webapp config appsettings set \
     --resource-group rg-dvls-prod \
     --name dvls-prod-<unique> \
     --settings \
       DATABASE_PASSWORD="@Microsoft.KeyVault(SecretUri=${SECRET_URI})"

Siehe auch

• Erweiterte Docker-Konfiguration für Devolutions Server
• Devolutions Server mit Docker bereitstellen