asc.core.services_ai_foundry role – Deploy an Azure AI Foundry environment
Note
This role is part of the asc.core collection (version 2.0.0).
It is not included in ansible-core.
To check whether it is installed, run ansible-galaxy collection list.
To install it use: git clone git@ssh.dev.azure.com:v3/cloudasc/iac-ansible-collections/core $HOME/.ansible/collections/ansible_collections/asc/core.
To use it in a playbook, specify: asc.core.services_ai_foundry.
Entry point main – Deploy an Azure AI Foundry environment
New in asc.core 2.0.0
Synopsis
Deploys a self-contained Azure AI Foundry environment in its own dedicated resource group so its networking stays isolated from the rest of the deployment.
Provisions the modern Foundry resources - an
AIServicescognitive account (the Foundry resource) plus a Foundry project - and a configurable set of model deployments.Private by default (a dedicated vnet with a private endpoint, peered to the core vnet); public access can be enabled and is then restricted to an IP allowlist and protected by the account API key.
Adds change-detection alerting (any administrative write/delete in the resource group) and cost budget alerts, both emailing the users tagged
ai_alertinusers.csv.The account endpoint and primary API key are exposed as deploy outputs.
Parameters
Parameter |
Comments |
|---|---|
AI Foundry module configuration. |
|
Email a cost alert at this percentage of cost_ceiling_usd. Default: |
|
Monthly cost ceiling in USD for the account. One limit, used for both the budget alerts and the key-rotation kill-switch. Default: |
|
Whether to deploy the AI Foundry module. Choices:
|
|
How often (in minutes) the guardian Logic App checks month-to-date spend. Lower reacts faster to a breach; higher reduces Logic App run cost. Default: |
|
IP addresses or CIDR blocks allowed to reach the public endpoint when public_access is true. Default: |
|
Hard-stop (regenerate the account keys - preserving logs/data) at this percentage of cost_ceiling_usd. Enforced near-real-time by the guardian Logic App (exact per-model cost from the metrics API); a lagged, price-independent cost budget provides a backstop kill at 100 percent of the ceiling. Default: |
|
Azure region for the dedicated resource group and account. Defaults to the deployment region. |
|
Models to deploy on the account, each as its own deployment. To discover deployable models/versions/SKUs for your region before deploying, run Default: |
|
Optional throughput ceiling in Tokens-Per-Minute, in thousands (for example Default: |
|
Model provider/format (for example Default: |
|
Model name (for example |
|
Deployment name (how the model is addressed in API calls). |
|
Override the automatically pulled output-token price (USD per 1,000 tokens) used to compute this model’s exact cost against cost_ceiling_usd. Set this when the price cannot be resolved automatically (for example DeepSeek or Anthropic models). |
|
Deployment SKU (for example Default: |
|
Model version. Defaults to the current default version for the model when unset. |
|
Subnet used for the private endpoint. Default: |
|
Peer the dedicated vnet to the core vnet (and link the private DNS zones to it) so the rest of the environment can reach the private endpoint. Choices:
|
|
Deploy a dedicated vnet and a private endpoint for the account (private access). Choices:
|
|
Allow public network access. Even when enabled the endpoint stays default-deny, restricted to ip_allowlist and protected by the account API key. Choices:
|
|
SKU of the Cognitive Services (AIServices) account. Default: |
|
Address space of the dedicated vnet. Default: |