Azure Container Apps Deployment¶

AgentCube connectors are distributed as Linux container images. This guide covers deployment on Azure Container Apps — the platform used in the Caprus reference environment. For other platforms, see the guides below.

See Container Images & Specifications for image names, GHCR authentication, and resource requirements.

Azure Container Apps Deployment¶

1. Create a Container Apps Environment¶

A Container Apps Environment is required before creating the app. If you already have one, skip this step.

az containerapp env create \
  --name {environment_name} \
  --resource-group {resource_group} \
  --location {location}

2. Create the Container App¶

az containerapp create \
  --name {app_name} \
  --resource-group {resource_group} \
  --environment {environment_name} \
  --image ghcr.io/caprusai/agentcube-essbase:{version} \
  --target-port 8080 \
  --ingress external \
  --min-replicas 1 \
  --cpu 0.25 \
  --memory 0.5Gi \
  --env-vars \
    ESSBASE_SERVER_URL={essbase_url} \
    ESSBASE_USERNAME={username} \
    ESSBASE_PASSWORD=secretref:{secret_name}

Use secrets for passwords

Pass credentials using secretref: rather than plaintext values. Add the secret first with az containerapp secret set and reference it by name in --env-vars.

2. Configure Custom Domain (Optional)¶

If using a custom domain with TLS:

Add a custom domain in the Azure Portal under your Container App → Custom domains
Configure DNS (CNAME or A record) pointing to the Container App URL
Enable managed certificate for automatic TLS

3. Verify¶

curl https://{connector_hostname}/health

A healthy response shows "status": "healthy" and "backend_connected": true (for basic auth mode).

Environment Variables¶

See Environment Variables for the complete reference.