Skip to content

Commit 734e0c1

Browse files
committed
Update documentation for IaC
1 parent 7bd97f7 commit 734e0c1

File tree

1 file changed

+13
-66
lines changed

1 file changed

+13
-66
lines changed

articles/ai-foundry/agents/how-to/virtual-networks.md

Lines changed: 13 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -69,79 +69,26 @@ For customers without an existing virtual network, the Standard Setup with Priva
6969

7070
## Configure a new network-secured environment
7171

72-
**Network secured setup**: Agents use customer-owned, single-tenant search and storage resources. With this setup, you have full control and visibility over these resources, but you incur costs based on your usage. The following bicep template provides:
73-
74-
* An account and project are created.
75-
* A gpt-4o model is deployed.
76-
* Azure resources for storing customer data — Azure Storage, Azure Cosmos DB, and Azure AI Search — are automatically created if existing resources are not provided.
77-
* These resources are connected to your project to store files, threads, and vector data.
78-
* A Microsoft-managed key vault is used by default.
79-
80-
81-
### Manually deploy the bicep template
82-
8372
> [!NOTE]
84-
> Using the Bicep template is the only way to deploy a network secured environment for Azure AI Foundry Agent Service.
73+
> Programmatic deployment is the only way to deploy a network secured environment for Azure AI Foundry Agent Service, it is currently not possibly on Azure Portal.
8574

86-
1. To deploy and customize the bicep templates, [download the template from GitHub](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/15-private-network-standard-agent-setup). Download the following from the `private-network-standard-agent-setup` folder:
87-
1. `main-create.bicep`
88-
1. `azuredeploy.parameters.json`
89-
1. `modules-network-secured folder`
90-
1. To authenticate to your Azure subscription from the Azure CLI, use the following command:
75+
> [!NOTE]
76+
> If you want to delete your Foundry resource and Standard Agent with secured network set-up, delete your AI Foundry resource and virtual network last. Before deleting the virtual network, ensure to delete and [purge](../../../ai-services/recover-purge-resources.md#purge-a-deleted-resource) your AI Foundry resource.
9177

92-
```console
93-
az login
94-
```
78+
> [!NOTE]
79+
> In the Standard Setup, agents use customer-owned, single-tenant resources. You have full control and visibility over these resources, but you incur costs based on your usage.
9580

96-
1. Create a resource group:
81+
You can deploy and customize the Standard Setup with Private Networking using either Bicep or Terraform. The provided samples allow you to bring your own virtual network and customize the deployment to meet your specific requirements:
9782

98-
```console
99-
az group create --name {my_resource_group} --location eastus
100-
```
83+
* Foundry account and Foundry project are created.
84+
* A gpt-4o model is deployed.
85+
* Azure resources for storing customer data — Azure Storage, Azure Cosmos DB, and Azure AI Search — are automatically created if existing resources are not provided.
86+
* These resources are connected to your project to store files, threads, and vector data.
87+
* Microsoft-managed encryption keys for Storage Account and Cognitive Account (AI Foundry) are used by default.
10188

102-
Make sure you have the Azure AI Developer role for the resource group you created.
103-
104-
1. Using the resource group you created in the previous step and one of the template files (`private-network-standard-agent-setup`), run one of the following commands:
105-
106-
1. To use default resource names, run:
107-
108-
```console
109-
az deployment group create --resource-group {my_resource_group} --template-file main-create.bicep
110-
```
111-
112-
1. Run the CheckCapabilityHostReadiness.ps1 and edit the command to add your subscription ID, resource group name, and your newly deployed AI Services account resource name.
113-
114-
```
115-
.\CheckCapabilityHostReadiness.ps1 -subscriptionId "<your-sub-id>" -resourcegroup "<new-rg-name>" -accountname "<your-aiservices-name>"
116-
```
117-
118-
If you don't want to run the PowerShell script, you can run a bash script instead, from the file CheckCapabilityHostReadiness.sh. Run the following two commands:
119-
120-
```
121-
chmod +x CheckCapabilityHostReadiness.sh
122-
./CheckCapabilityHostReadiness.sh "<your-sub-id>" "<new-rg-name>" "<your-aiservices-name>"
123-
```
124-
125-
1. Deploy the main-project-caphost-create.bicep
126-
127-
```
128-
az deployment group create --resource-group <new-rg-name> --template-file main-project-caphost-create.bicep
129-
```
130-
131-
After running this script, you're required to input the following values:
132-
133-
```
134-
Please provide string value for 'accountName' (? for help): <your-account-name>
135-
Please provide string value for 'projectName' (? for help): <your-project-name>
136-
Please provide string value for 'aiSearchName' (? for help): <your-search-name>
137-
Please provide string value for 'azureStorageName' (? for help): <your-storage-name>
138-
Please provide string value for 'cosmosDBName' (? for help): <your-cosmosdb-name>
139-
```
140-
141-
For more details, see the [README](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/15-private-network-standard-agent-setup).
89+
- **Bicep templates**: follow instructions in [this sample from GitHub](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/15-private-network-standard-agent-setup).
14290

143-
> [!NOTE]
144-
> If you want to delete your Foundry resource and Standard Agent with secured network set-up, delete your AI Foundry resource and virtual network last. Before deleting the virutal network, ensure to delete and purge your AI Foundry resource. Navigate to __Manage deleted resources__, then select your subscription and the Foundry resource you would like to purge.
91+
- **Terraform configuration**: follow instructions in [this sample from GitHub](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup-terraform/15b-private-network-standard-agent-setup-byovnet).
14592

14693
## Deep Dive Standard Setup with Private Networking Template
14794
When you use the Standard Setup with Private Networking Agent Template, the following will automatically be provisioned, unless you bring your own:

0 commit comments

Comments
 (0)