Philip Street
12/10/2025, 4:24 PMMarvin
12/10/2025, 4:24 PMMarvin
12/10/2025, 4:28 PMazure-container-instance
- You can run the worker process itself inside an ACI container (or anywhere that can reach Prefect Cloud).
- Steps:
- Install the integration:
pip install prefect-azure
- Create a work pool:
prefect work-pool create "aci-pool" --type azure-container-instance
- Start the worker:
prefect worker start --pool aci-pool --type azure-container-instance
- If you run the worker inside ACI, make sure the container image includes prefect and prefect-azure, and set PREFECT_API_URL and PREFECT_API_KEY as environment variables.
2) Use a push (serverless) ACI work pool — no worker to run (Cloud Pro feature)
- Pool type: azure-container-instance:push
- Create and auto-provision required Azure resources:
pip install prefect-azure
prefect work-pool create "aci-push" --type azure-container-instance:push --provision-infra
- Prefect Cloud will push flow runs directly to ACI without a polling worker.
Helpful docs:
- ACI worker guide: Azure Container Instances worker
- Serverless/push pools: Serverless (push) work pools
- Workers overview: Workers concept
- Azure integration SDK: prefect-azure SDK
Would you like a quick az CLI example to run the polling worker inside ACI, or do you prefer the push (no-worker) setup?