Deployment

This page explains how to deploy a WaterFuser backend to the Equation platform. The deployment process is the same as any Equation API: provision Azure resources, onboard the API in API Management, then deploy with the standard pipeline templates.

Overview

1. Provision Azure resources (Terraform preferred).
2. Add the API to API Management (APIM).
3. Deploy your code with the provided pipeline templates (including OpenAPI export and APIM import).

Step 1: Provision Azure Resources

Create the backend hosting resource for your API (for example Container Apps, or Functions). Terraform is preferred so the infrastructure is reviewable and repeatable. Reach out to any of the platform admins if you don't know how to do this.

Your backend should only be reachable through APIM, so restrict inbound access and whitelist the APIM gateway IPs:

• IP Whitelisting for Azure APIM Gateway

Step 2: Add the API to APIM

Onboard your API into Equation APIM using the standard Terraform flow. This sets up the API, policies, and required managed identity:

• Add an API to API Management

If you need to adjust policies, refer to:

• Authentication Policies
• Policy Scopes

Step 3: Deploy with Pipeline Templates

Use the platform pipeline templates to build, deploy, export OpenAPI, and import routes into APIM:

• OpenAPI Handling Guide
• Pipeline Setup for OpenAPI Export and APIM Import

If you run into issues during import or routing, check:

• Troubleshooting