Distribuera en C# Azure AI-sökning-app för att Azure Container Apps

Note

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

Distribuera den sökaktiverade webbplatsen för att Azure Container Apps med hjälp av Azure Developer CLI (azd). Den här distributionen omfattar React-klienten, .NET-API:et, Azure AI-sökning, hanterad identitet och stöd för Azure resurser.

Distributionen använder hanterad identitet som standardautentiseringsmetod för Azure AI-sökning. Du kan välja nyckelbaserad autentisering genom att ange USE_KEYLESS_AUTH till false före distribution.

Logga in på Azure

  1. I Visual Studio Code öppnar du en terminal på lagringsplatsens rot, till exempel azure-search-static-web-app.

  2. Logga in på Azure med hjälp av azd.

    azd auth login

  3. Om du uppmanas av webbläsaren slutför du inloggningsflödet med hjälp av det Azure konto som du använder för den här självstudien.

Skapa en azd-miljö

  • Skapa en azd miljö. Ersätt YOUR-ENVIRONMENT-NAME med ett kort namn som identifierar den här självstudiedistributionen.

    azd env new YOUR-ENVIRONMENT-NAME

(Valfritt) Konfigurera nyckelbaserad autentisering

Standardautentiseringsmetoden är hanterad identitet, så de flesta miljöer kan hoppa över det här avsnittet. Slutför bara det här avsnittet om din miljö kräver API-nycklar.

Ställ in USE_KEYLESS_AUTH på false.

azd env set USE_KEYLESS_AUTH false

Om du inte anger USE_KEYLESS_AUTHanvänder distributionen hanterad identitet. Den Bicep infrastrukturen ger containerappens identitet åtkomst till Azure AI-sökning dataplanet.

Distribuera med azd up

  1. Från lagringsroten kör du azd up.

    azd up

  2. När du uppmanas till det väljer du Azure prenumeration och plats för resurserna.

  3. Vänta tills azd du har etablerat infrastrukturen, skapar containrarna, push-överför avbildningarna och distribuerar tjänsterna till Azure Container Apps.

  4. Granska utdata efter distributionen. Utdata innehåller de fullständiga domännamnen (FQDN) för den Azure Container Apps distributionen.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>

    Använd värdet AZURE_CLIENT_URL för att öppna webbplatsen. Klientappen anropar serverappen via slutpunkten som konfigurerades under distributionen.

    Distributionen skapade också Azure AI-sökning-tjänsten och läste in indexet good-books automatiskt via kroken postprovision i exempellagringsplatsen.

Använda sökning på webbplatsen för Container Apps

  1. Öppna klientens FQDN från azd up utdata i en webbläsare.

  2. I sökfältet för webbplatsen anger du en sökfråga, till exempel code. Funktionen komplettera automatiskt föreslår matchande boktitlar.

  3. Välj ett förslag eller fortsätt att ange en egen fråga. Välj Retur när du är klar med sökfrågan.

  4. Granska resultaten och välj sedan en bok för att se mer information.

Felsökning

Om webbappen inte distribueras eller fungerar använder du följande lista för att fastställa och åtgärda problemet:

  • Slutfördes azd up ?

    azd up Granska utdata för det första misslyckade etablerings-, bygg- eller distributionssteget. Om distributionen stoppas under etableringen kontrollerar du prenumerationsbehörigheterna och den valda regionen. Om distributionen stoppas under stegen för att skapa eller distribuera containrar kör azd up du igen när du har åtgärdat det rapporterade problemet.

  • Kan du öppna klientslutpunkten?

    Öppna värdet AZURE_CLIENT_URL från azd up utdata. Om sidan inte läses in går du till Azure portalen, öppnar klientcontainerappen och granskar dess revisionsstatus och loggar.

  • Kan klienten anropa serverslutpunkten?

    Öppna utvecklarverktygen för webbläsaren och granska nätverksanropen från klientappen. Om anrop till API:et misslyckas kontrollerar du att servercontainerappen körs och att klientappen tog emot serverns FQDN under distributionen.

  • Kan serverfrågan Azure AI-sökning?

    Om sökningar returnerar fel granskar du loggarna för servercontainerappen. För hanterad identitet kontrollerar du att identiteten har Azure AI-sökning dataplansåtkomst. För nyckelbaserad autentisering kontrollerar du att du har angett USE_KEYLESS_AUTH till false före distributionen och att den genererade containermiljön innehåller konfigurationen av söktjänsten.

Rensa resurser

Använd azd down --purge för att ta bort de Azure resurser som den här självstudien skapade. Flaggan --purge tar permanent bort resurser som stöder mjuk borttagning, i stället för att lämna dem i ett återställningsbart tillstånd under kvarhållningsperioden. Rensning undviker namngivningskonflikter om du distribuerar om den här självstudien senare.

  1. Kör rensningskommandot från lagringsplatsens rot.

    azd down --purge

  2. Granska de resurser som azd listar.

  3. Bekräfta borttagningen när du uppmanas att göra det.

Om du har skapat en Azure AI-sökning tjänst utanför distributionen azd går du till söktjänsten i Azure portalen och väljer Ta bort överst på sidan.

Nästa steg

Utforska sökintegreringskoden

  • Last updated on