將 C# Foundry IQ (Azure AI 搜尋服務) 應用程式部署到 Azure 容器應用程式

Note

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

使用 Azure Developer CLI (azd) 部署搜尋啟用的網站到 Azure 容器應用程式 此部署包含 React 用戶端、.NET API、Foundry IQ、管理式身份,以及支援的 Azure 資源。

部署使用管理身份作為 Foundry IQ 的預設驗證方式。 你可以選擇在部署前將 USE_KEYLESS_AUTH 設定為 false,以選擇使用基於金鑰的驗證。

登入 Azure

  1. 在 Visual Studio Code 中,請在儲存庫根目錄開啟終端機,例如 azure-search-static-web-app。

  2. 請使用 azd 登入Azure。

    azd auth login
    
  3. 如果瀏覽器提示你這麼做,請使用你在本教學課程中使用的 Azure 帳號完成登入程序。

創造一個 azd 環境

  • 創造一個 azd 環境。 請用一個簡短的名稱來 YOUR-ENVIRONMENT-NAME 識別這個教學部署。

    azd env new YOUR-ENVIRONMENT-NAME
    

(可選)配置基於金鑰的認證

預設的認證方式是管理身份,因此大多數環境可以跳過此部分。 只有當你的環境需要 API 金鑰時,才請完成此部分。

將 USE_KEYLESS_AUTH 設定為 false。

azd env set USE_KEYLESS_AUTH false

如果你沒有設定 USE_KEYLESS_AUTH,部署會使用受控識別。 Bicep 基礎架構賦予容器應用程式身份對 Foundry IQ 資料平面的存取權。

使用 azd up 部署

  1. 從存放庫根路徑中執行 azd up。

    azd up
    
  2. 當被要求時,選擇資源的 Azure 訂閱和地點。

  3. 等待azd配置基礎設施、建置容器、推送映像檔,並將服務部署到 Azure 容器應用程式。

  4. 部署後檢視輸出。 輸出內容包含用於 Azure 容器應用程式 部署的用戶端與伺服器完整網域名稱(FQDN)。

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

    用這個 AZURE_CLIENT_URL 值來開啟網站。 用戶端應用程式透過部署期間設定的端點呼叫伺服器應用程式。

    部署同時建立了 Foundry IQ 服務,並透過 good-books 範例儲存庫中的掛鉤自動 postprovision 載入索引。

請在你的容器應用程式網站使用搜尋

  1. 在瀏覽器中開啟 azd up 輸出中的用戶端 FQDN。

  2. 在網站搜尋欄中,輸入搜尋查詢,例如 code。 自動補全功能建議書名相符。

  3. 選取建議或繼續輸入您自己的查詢。 完成搜尋後選擇 「Enter 」。

  4. 檢視結果,然後選取一本書以查看更多詳細資料。

Troubleshooting

如果網頁應用程式無法部署或無法運作,請使用以下清單來找出並修正問題:

  • 完成了 azd up 嗎?

    檢視 azd up 第一個失敗的配置、建置或部署步驟的輸出。 如果部署在佈建期間停止,請檢查你的訂閱權限和所選區域。 如果部署在容器建置或部署步驟期間停止,請在修正回報的問題後重新執行 azd up。

  • 你能開啟客戶端端點嗎?

    打開來自 azd up 輸出的 AZURE_CLIENT_URL 值。 如果頁面無法載入,請前往 Azure 入口網站,開啟客戶端容器應用程式,檢查其版本狀態和日誌。

  • 用戶端可以呼叫伺服器端點嗎?

    打開瀏覽器的開發人員工具,檢查客戶端應用程式發出的網路請求。 若呼叫 API 失敗,請確認伺服器容器應用程式正在執行,且客戶端應用程式在部署期間已收到伺服器 FQDN。

  • 伺服器可以查詢 Foundry IQ 嗎?

    如果搜尋傳回錯誤,請檢視伺服器容器應用程式的日誌。 對於受控識別,請確認該受控識別具有 Foundry IQ 資料平面存取權限。 針對基於金鑰的驗證,請確認您在部署前將 USE_KEYLESS_AUTH 設為 false,且產生的容器環境包含 Foundry IQ 服務設定。

清理資源

用azd down --purge來刪除本教學建立的 Azure 資源。 該 --purge 旗標會永久移除支援軟刪除的資源,而非讓它們在保留期間處於可恢復狀態。 如果你之後重新部署這個教學,清除可以避免命名衝突。

  1. 從儲存庫根節點執行清理指令。

    azd down --purge
    
  2. 檢視列出的 azd 資源。

  3. 出現提示時,確認刪除。

如果您在部署之外azd建立了 Foundry IQ 服務,請前往 Azure 入口網站中的 Foundry IQ 服務,並在頁面頂端選擇「刪除」。

下一個步驟