Nach der Bereitstellung
Diese Seite setzt die Bereitstellung fort. Schließen Sie zuerst die Bereitstellung ab.
1. Überprüfen Sie die Bereitstellung
1.1 Prüfen Sie die Bereitstellungsausgaben
Öffnen Sie die Ressourcengruppe, wählen Sie Bereitstellungen, öffnen Sie die Bereitstellung und wählen Sie Ausgaben.
| Ausgabe | Was wird angezeigt |
|---|---|
appServiceUrl | Die URL, unter der AI Analyst erreichbar ist |
keyVaultName | Der Key Vault, der die Geheimnisse speichert |
cognitiveServicesName | Das Azure AI Foundry-Konto |
knowledgeHubPrivateLinkState | Ob die Verbindung zum Knowledge Hub genehmigt wurde |
1.2 Prüfen Sie die Anwendung
- Öffnen Sie den App Service in der verwalteten Ressourcengruppe.
- Überprüfen Sie auf der Registerkarte Übersicht, ob bei Status
Runningangezeigt wird. - Öffnen Sie Monitoring -> Log stream und prüfen Sie, ob das Container-Image heruntergeladen wurde und die Anwendung ohne Fehler gestartet ist.
Wenn bei Status Running angezeigt wird und der Logstream einen fehlerfreien Start zeigt, ist die Bereitstellung intakt.
Wenn Ihr IP-Bereich auf der Allowlist steht, können Sie zusätzlich die Anwendungs-URL im Browser öffnen. Von einer Adresse, die nicht auf der Allowlist ist, erhalten sowohl Browser als auch API 403. Dies zeigt, dass die Allowlist nach Konfiguration funktioniert – es handelt sich nicht um eine fehlerhafte Bereitstellung.
1.3 Prüfen/Konfigurieren Sie die Datenbankerreichbarkeit
AI Analyst verwendet die virtuelle Netzwerkintegration, sodass der gesamte ausgehende Traffic zur Datenbank über das Integrations-Subnetz des eigenen virtuellen Netzwerks läuft. Was Sie konfigurieren müssen, hängt vom Ort der Datenbank ab.
| Datenbankstandort | Was zu konfigurieren ist |
|---|---|
| Azure SQL Database mit öffentlichem Endpunkt | Aktivieren Sie Allow Azure services and resources to access this server im Netzwerkbereich der SQL Server. Für eine restriktivere Konfiguration können Sie stattdessen die ausgehenden IP-Adressen des App Service auf die Allowlist setzen. |
| Azure SQL Database mit privatem Endpunkt | Verbinden Sie Ihr virtuelles Netzwerk mit dem AI Analyst-Virtual Network und Link die privatelink.database.windows.net Private DNS-Zone mit dem AI Analyst-Virtual Network, sodass der private Name aufgelöst wird. |
| MSSQL Server On-Premise | Stellen Sie die Konnektivität über App Service Hybrid Connections her. |
Offizielle Microsoft-Dokumentation:
- Azure Private Link für Azure SQL Database
- Hybride Verbindungen im Azure App Service erstellen und nutzen
Das Azure WebApp-Log zeigt Database warm-up failed beim Start, bis die Datenbank erreichbar ist.
2. Beantragen Sie die Freigabe des privaten Link
Die Bereitstellung erstellt einen privaten Endpunkt zum dab Knowledge Hub. Die Verbindung bleibt im Status Pending, bis dab sie freigibt; in der Zwischenzeit antwortet AI Analyst ohne das dab Hintergrundwissen.
Senden Sie Ihre Subskriptions-ID und die private Link-Anfragenachricht, die Sie während der Bereitstellung eingegeben haben, an Ihren dab-Kontakt oder an delivery(at)dab-gmbh.de, damit dab die Verbindung zuordnen und freigeben kann.
3. Bestehende Bereitstellung aktualisieren
Um Einstellungen später zu ändern, starten Sie die Bereitstellung erneut über das Marketplace-Angebot und wählen dieselbe Ressourcengruppe aus. Azure aktualisiert die vorhandenen Ressourcen und ändert nur die Eigenschaften, die abweichen.
Die Bereitstellung kann die bestehenden Geheimnisse nicht auslesen. Bei jeder erneuten Bereitstellung müssen Sie alle geheimen Werte neu eingeben, auch wenn Sie nur die IP-Allowlist ändern möchten. Geben Sie dieselben Werte ein, um sie unverändert zu lassen, oder neue Werte, um sie zu rotieren. Leere oder Platzhalterwerte überschreiben die funktionierenden Geheimnisse und unterbrechen die Bereitstellung.
Typische Änderungen sind:
- Das Herauf- oder Herunterskalieren des App Service Plans
- Das Hinzufügen von IP-Bereichen zur Allowlist, was Sie auch ohne erneute Bereitstellung im Azure Portal unter App Service -> Networking -> Access restrictions tun können
- Das Ändern des Modells oder seiner Kapazität
- Das Rotieren des AIA API Key oder des Session Token Secret
dab gibt kein Rotationsintervall für den AIA API Key, das Session Token Secret oder die Datenbank-Anmeldeinformationen vor. Rotieren Sie diese gemäß der Sicherheitsrichtlinie Ihrer Organisation.
Eine Rotation erfordert keine erneute Bereitstellung: Aktualisieren Sie den geheimen Wert im Key Vault der Managed Application und starten Sie die Web-App unter App Service -> Übersicht -> Neustart neu. Die Anwendung liest den neuen Wert beim Start.
5. Aktualisieren Sie die Anwendung auf eine neue Version
dab AI Analyst läuft als Container-Image, das aus der dab Container-Registry gezogen wird. Um auf die neueste Version zu aktualisieren, starten Sie die Web-App im Azure Portal unter App Service -> Übersicht -> Neustart neu. Beim Start zieht der App Service das neueste Image; eine erneute Bereitstellung und das erneute Eingeben von Geheimnissen sind nicht erforderlich.
Dies betrifft ausschließlich Anwendungsupdates. Falls eine neue Version auch Änderungen an der zugrundeliegenden Infrastruktur erfordert (zum Beispiel neue Ressourcen, Einstellungen oder Berechtigungen), informiert dab Sie im Vorfeld und stellt Anleitungen bereit. In diesem Fall erfolgt das Update durch eine erneute Bereitstellung der Managed Application, wie in Abschnitt 3 beschrieben.
4. Hilfe erhalten
Wenn die Bereitstellung fehlschlägt, siehe Deployment Issues. Wenn die Anwendung bereitgestellt wurde, aber nicht wie erwartet funktioniert, siehe Issues After the Deployment.