Bereitstellen einer C#-Azure KI-Suche-App zum Azure Container Apps

Note

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Stellen Sie die suchfähige Website mithilfe der Azure Developer CLI (azd) für Azure Container Apps bereit. Diese Bereitstellung umfasst den React-Client, die .NET-API, Azure KI-Suche, verwaltete Identität und die Unterstützung von Azure Ressourcen.

Die Bereitstellung verwendet verwaltete Identität als Standardauthentifizierungsmethode für Azure KI-Suche. Sie können sich für die schlüsselbasierte Authentifizierung anmelden, indem Sie sie vor der Bereitstellung festlegen USE_KEYLESS_AUTHfalse .

Öffnen Sie in Visual Studio Code ein Terminal im Repositorystamm, zazure-search-static-web-app. B. .
Anmelden bei Azure mithilfe von azd.
```
azd auth login
```
Wenn Sie von Ihrem Browser dazu aufgefordert werden, schließen Sie den Anmeldeablauf mithilfe des Azure Kontos ab, das Sie für dieses Lernprogramm verwenden.

Erstellen einer azd-Umgebung

Erstellen Sie eine azd Umgebung. Ersetzen Sie YOUR-ENVIRONMENT-NAME den Namen durch einen kurzen Namen, der diese Lernprogrammbereitstellung identifiziert.
```
azd env new YOUR-ENVIRONMENT-NAME
```

(Optional) Konfigurieren der schlüsselbasierten Authentifizierung

Die Standardauthentifizierungsmethode ist verwaltete Identität, sodass die meisten Umgebungen diesen Abschnitt überspringen können. Schließen Sie diesen Abschnitt nur ab, wenn Ihre Umgebung API-Schlüssel erfordert.

Setze USE_KEYLESS_AUTH auf false.

azd env set USE_KEYLESS_AUTH false

Wenn Sie nicht festlegen USE_KEYLESS_AUTH, verwendet die Bereitstellung verwaltete Identität. Die Bicep-Infrastruktur gewährt der Container-App-Identität Zugriff auf die Azure KI-Suche Datenebene.

Bereitstellen mit Azd up

Führen Sie im Repositorystamm azd up aus.
```
azd up
```
Wenn Sie dazu aufgefordert werden, wählen Sie das Azure Abonnement und den Standort für die Ressourcen aus.
Warten Sie, bis azd die Infrastruktur bereitgestellt wird, erstellen Sie die Container, pushen Sie die Images, und stellen Sie die Dienste auf Azure Container Apps bereit.
Überprüfen Sie die Ausgabe nach der Bereitstellung. Die Ausgabe enthält die vollqualifizierten Client- und Serverdomänennamen (FQDNs) für die Azure Container Apps Bereitstellung.
```
AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>
```
Verwenden Sie den AZURE_CLIENT_URL Wert, um die Website zu öffnen. Die Client-App ruft die Server-App über den Endpunkt auf, der während der Bereitstellung konfiguriert ist.

Die Bereitstellung hat auch den Azure KI-Suche-Dienst erstellt und den good-books Index automatisch über den postprovision Hook im Beispiel-Repository geladen.

Verwenden der Suche auf Ihrer Container-Apps-Website

Öffnen Sie den Client-FQDN aus der azd up Ausgabe in einem Browser.
Geben Sie in der Suchleiste der Website eine Suchabfrage ein, z code. B. . Das AutoVervollständigen-Feature schlägt übereinstimmende Buchtitel vor.
Wählen Sie einen Vorschlag aus, oder fahren Sie mit der Eingabe Ihrer eigenen Abfrage fort. Wählen Sie die EINGABETASTE aus, wenn Sie die Suchabfrage abgeschlossen haben.
Überprüfen Sie die Ergebnisse, und wählen Sie dann ein Buch aus, um weitere Details anzuzeigen.

Problembehandlung

Wenn die Web-App nicht bereitgestellt oder funktioniert, verwenden Sie die folgende Liste, um das Problem zu ermitteln und zu beheben:

Ist azd up abgeschlossen?

Überprüfen Sie die azd up Ausgabe für den ersten fehlgeschlagenen Bereitstellungs-, Build- oder Bereitstellungsschritt. Wenn die Bereitstellung während der Bereitstellung beendet wird, überprüfen Sie Ihre Abonnementberechtigungen und die ausgewählte Region. Wenn die Bereitstellung während des Containerbuilds oder der Bereitstellungsschritte beendet wird, führen Sie die Ausführung azd up nach der Behebung des gemeldeten Problems erneut aus.
Können Sie den Clientendpunkt öffnen?

Öffnen Sie den AZURE_CLIENT_URL Wert aus der azd up Ausgabe. Wenn die Seite nicht geladen wird, wechseln Sie zum Azure-Portal, öffnen Sie die Clientcontainer-App, und überprüfen Sie den Revisionsstatus und die Protokolle.
Kann der Client den Serverendpunkt aufrufen?

Öffnen Sie Ihre Browserentwicklertools, und überprüfen Sie die Netzwerkaufrufe aus der Client-App. Wenn Aufrufe der API fehlschlagen, vergewissern Sie sich, dass die Servercontainer-App ausgeführt wird und dass die Client-App den Server-FQDN während der Bereitstellung empfangen hat.
Kann die Serverabfrage Azure KI-Suche?

Wenn Fehler zurückgegeben werden, überprüfen Sie die Servercontainer-App-Protokolle. Vergewissern Sie sich bei verwalteter Identität, dass die Identität Azure KI-Suche Datenebenenzugriff hat. Vergewissern Sie sich bei der schlüsselbasierten Authentifizierung, dass Sie vor der Bereitstellung festgelegt USE_KEYLESS_AUTHfalse haben und dass die generierte Containerumgebung die Suchdienstkonfiguration enthält.

Bereinigen von Ressourcen

Dient azd down --purge zum Löschen der von diesem Lernprogramm erstellten Azure Ressourcen. Das --purge Flag entfernt dauerhaft Ressourcen, die vorläufiges Löschen unterstützen, anstatt sie für den Aufbewahrungszeitraum in einem wiederherstellbaren Zustand zu belassen. Durch das Löschen werden Namenskonflikte vermieden, wenn Sie dieses Lernprogramm später erneut bereitstellen.

Führen Sie im Repositorystamm den Bereinigungsbefehl aus.
```
azd down --purge
```
Überprüfen Sie die Ressourcen, die azd aufgelistet werden.
Bestätigen Sie den Löschvorgang, wenn Sie dazu aufgefordert werden.

Wenn Sie einen Azure KI-Suche Dienst außerhalb der azd Bereitstellung erstellt haben, wechseln Sie zum Suchdienst im Azure-Portal, und wählen Sie oben auf der Seite "Löschen" aus.

Nächster Schritt

Erkunden des Suchintegrationscodes

Feedback

War diese Seite hilfreich?

Last updated on 2026-08-13