Nasazení aplikace Azure AI Vyhledávač jazyka C# do Azure Container Apps

Note

Azure AI Vyhledávač je k dispozici prostřednictvím portálu Azure, rozhraní REST API a Sady Azure SDK. Podporuje také Foundry IQ, spravovanou znalostní vrstvu, která transformuje podnikový obsah na opakovaně použitelné znalostní báze s podporou oprávnění pro agenty na portálu Microsoft Foundry.

Nasaďte web s podporou vyhledávání do Azure Container Apps pomocí rozhraní příkazového řádku pro vývojáře Azure (azd). Toto nasazení zahrnuje klienta React, rozhraní API .NET, Azure AI Vyhledávač, spravovanou identitu a podporu Azure prostředků.

Nasazení používá spravovanou identitu jako výchozí metodu ověřování pro Azure AI Vyhledávač. K ověřování založenému na klíči se můžete přihlásit nastavením USE_KEYLESS_AUTH před false nasazením.

Přihlásit se do Azure

  1. V Visual Studio Code otevřete terminál v kořenovém adresáři úložiště, například azure-search-static-web-app.

  2. Přihlaste se k Azure pomocí azd.

    azd auth login

  3. Pokud se zobrazí výzva v prohlížeči, dokončete tok přihlášení pomocí účtu Azure, který používáte pro účely tohoto kurzu.

Vytvoření prostředí azd

  • Vytvořte azd prostředí. Nahraďte YOUR-ENVIRONMENT-NAME krátkým názvem, který identifikuje toto nasazení kurzu.

    azd env new YOUR-ENVIRONMENT-NAME

(Volitelné) Konfigurace ověřování na základě klíčů

Výchozí metoda ověřování je spravovaná identita, takže většina prostředí může tuto část přeskočit. Tuto část vyplňte jenom v případě, že vaše prostředí vyžaduje klíče rozhraní API.

Nastavte USE_KEYLESS_AUTH na hodnotu false.

azd env set USE_KEYLESS_AUTH false

Pokud nenastavíte USE_KEYLESS_AUTH, nasazení používá spravovanou identitu. Infrastruktura Bicep uděluje identitě aplikace kontejneru přístup k rovině dat Azure AI Vyhledávač.

Nasazení s využitím azd up

  1. Z kořenového adresáře úložiště spusťte příkaz azd up.

    azd up

  2. Po zobrazení výzvy vyberte Azure předplatné a umístění prostředků.

  3. azd Počkejte, až zřídíte infrastrukturu, sestavíte kontejnery, nasdílíte image a nasadíte služby do Azure Container Apps.

  4. Zkontrolujte výstup po nasazení. Výstup zahrnuje plně kvalifikované názvy domén klienta a serveru pro nasazení Azure Container Apps.

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

    AZURE_CLIENT_URL Pomocí hodnoty otevřete web. Klientská aplikace volá serverové aplikace prostřednictvím koncového bodu nakonfigurovaného během nasazování.

    Nasazení také vytvořilo službu Azure AI Vyhledávač a index se automaticky načetl good-books prostřednictvím postprovision háku v ukázkovém úložišti.

Použití vyhledávání na webu Container Apps

  1. Otevřete plně kvalifikovaný název domény klienta z výstupu azd up v prohlížeči.

  2. Na panelu hledání na webu zadejte vyhledávací dotaz, například code. Funkce automatického dokončování navrhuje odpovídající názvy knih.

  3. Vyberte návrh nebo pokračujte v zadávání vlastního dotazu. Po dokončení vyhledávacího dotazu vyberte Enter .

  4. Prohlédněte si výsledky a vyberte knihu, abyste zobrazili další podrobnosti.

Troubleshooting

Pokud webová aplikace nenasazuje nebo nefunguje, pomocí následujícího seznamu zjistěte a opravte problém:

  • Dokončili jste azd up to?

    azd up Zkontrolujte výstup prvního kroku neúspěšného zřizování, sestavení nebo nasazení. Pokud se nasazení během zřizování zastaví, zkontrolujte oprávnění předplatného a vybranou oblast. Pokud se nasazení během sestavení kontejneru nebo postupu nasazení zastaví, spusťte azd up ho znovu po vyřešení nahlášeného problému.

  • Můžete otevřít koncový bod klienta?

    AZURE_CLIENT_URL Otevřete hodnotu z výstupuazd up. Pokud se stránka nenačte, přejděte na portál Azure, otevřete aplikaci kontejneru klienta a zkontrolujte její stav revize a protokoly.

  • Může klient volat koncový bod serveru?

    Otevřete vývojářské nástroje prohlížeče a zkontrolujte síťová volání z klientské aplikace. Pokud volání rozhraní API selže, ověřte, že je spuštěná aplikace kontejneru serveru a že klientská aplikace přijala během nasazování plně kvalifikovaný název domény serveru.

  • Může se server dotazovat Azure AI Vyhledávač?

    Pokud hledání vrátí chyby, zkontrolujte protokoly aplikace kontejneru serveru. U spravované identity ověřte, že identita má Azure AI Vyhledávač přístup roviny dat. V případě ověřování založeného na klíči ověřte, že jste před nasazením nastavili USE_KEYLESS_AUTHfalse a že vygenerované prostředí kontejneru obsahuje konfiguraci vyhledávací služby.

Vyčistěte zdroje

Slouží azd down --purge k odstranění Azure prostředků, které tento kurz vytvořil. Příznak --purge trvale odebere prostředky, které podporují obnovitelné odstranění, místo aby byly po dobu uchovávání v obnovitelném stavu. Vymazání zabrání konfliktům pojmenování, pokud tento kurz znovu nasadíte později.

  1. V kořenovém adresáři úložiště spusťte příkaz vyčistit.

    azd down --purge

  2. Zkontrolujte prostředky, které azd jsou v seznamu.

  3. Po vyzvání potvrďte odstranění.

Pokud jste vytvořili službu Azure AI Vyhledávač mimo azd nasazení, přejděte na portálu Azure a v horní části stránky vyberte Odstranit.

Další krok

Prozkoumání kódu integrace vyhledávání

  • Last updated on