Quickstart.md

Pre-requisites

• Azure Subscription
• VSCode on a machine that can access Azure (Install VSCode)
• optional: WSL to work in a Linux dev envrionment (Install WSL and use with VSCode)
• Azure CLI installed (Install the Azure CLI)

Ensure your dev enviroment is connected to the correct Azure subscription:

# login (specfiy tenant if you have access to several)
az login [--tenant TENANT_ID]

# set subscription
az account set -s [Subscription Name or ID]

# verify
az account show

Deploy Azure Resources

This demo uses Azure Bicep to deploy the required infrastructure

Log into Azure using the Azure CLI

az login [--tenant TENANT_ID]

Deploy the resources using the following command

cd ./infrastructure/bicep
bash deploy.sh

TODO: capture environment variables in a .env file after deployment

Configure VSCode Rest Client

This demo uses the VSCode Rest Client extension as the management plane for Azure AI Search configuration and testing.

Add the Rest Client extension to VSCode. Create a file named .vscode/settings.json or add to it if it doesn't exist.

Add the following to the file, replacing all values starting YOUR_ in the snippet below with your own values.

{
    "rest-client.environmentVariables": {
        "YOUR_env_name": {
            "env-search-name": "YOUR-azure-ai-search-name",
            "env-search-api-key": "YOUR-azure-ai-search-key"
        }
    }
}

Configure Azure AI Search

Push pattern

Run through the following sequentially:

• ../search/management/manage-index.rest
• ../search/management/manage-push-data-bulk.rest

Pull pattern

Run through the following sequentially:

• ../search/management/manage-index.rest
• ../search/management/manage-datasource.rest
• ../search/management/manage-indexer.rest