Streaming release tr #99

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

ian-t-adams merged 465 commits into main from Streaming-Release-TR

Jan 20, 2026

.azure/.gitignore

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# Ignore local development environment file which is auto-generated
		local-dev.env

.azure/README.md

-Original file line number
+Diff line change
@@ -0,0 +1,143 @@
+    # SimpleL7Proxy Deployment with Azure Developer CLI (AZD)
+    This guide helps you deploy the SimpleL7Proxy service to Azure using the Azure Developer CLI (AZD).
+    ## Prerequisites
+. [Azure Developer CLI (AZD)](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/install-azd)
+. [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli)
+. [Docker](https://www.docker.com/products/docker-desktop/)
+    ## Deployment Steps
+    ### 1. Clone the Repository
+    ```bash
+    git clone <repository-url>
+    cd SimpleL7Proxy
+    ```
+    ### 2. Run the Setup Script
+    #### For Windows:
+    ```powershell
+    # Run in PowerShell
+    .\.azure\setup.ps1
+    ```
+    #### For Linux/macOS:
+    ```bash
+    # Make the script executable
+    chmod +x .azure/setup.sh
+    # Run the setup script
+    ./.azure/setup.sh
+    ```
+    The setup script will:
+    - Verify prerequisites
+    - Ask you for deployment configuration
+    - Create an AZD environment with your settings
+    ### 3. Deploy the Infrastructure
+    ```bash
+    azd provision
+    ```
+    This command will deploy the Azure infrastructure defined in the Bicep templates:
+    - Azure Container Registry
+    - Azure Container App Environment
+    - Azure Container App
+    - Storage Account
+    - Log Analytics Workspace (if enabled)
+    - Application Insights (if enabled)
+    - Virtual Network (if enabled)
+    ### 4. Build and Deploy the Application
+    #### For Windows:
+    ```powershell
+    # Run in PowerShell
+    .\.azure\deploy.ps1
+    ```
+    #### For Linux/macOS:
+    ```bash
+    # Make the script executable
+    chmod +x .azure/deploy.sh
+    # Run the deployment script
+    ./.azure/deploy.sh
+    ```
+    The deployment script will:
+    - Build the Docker image
+    - Push it to Azure Container Registry
+    - Update the Container App with the new image
+    Alternatively, you can use the AZD all-in-one command:
+    ```bash
+    azd up
+    ```
+    ## Configuration Options
+    For detailed configuration options, see the [questionnaire](questionnaire.md).
+    Key configuration areas include:
+    - Azure environment settings
+    - Container configuration
+    - Network configuration
+    - Authentication settings
+    - Storage configuration
+    - Backend services
+    - Monitoring configuration
+    - Advanced settings
+    ## Deployment Scenarios
+    To simplify the deployment process, several predefined scenarios are available that configure common deployment patterns:
+    ### Available Scenarios
+. **Local Proxy with Public APIM** - For local development with a public APIM backend
+. **ACA Proxy with Public APIM** - For Azure Container Apps deployment with a public APIM backend
+. **VNET Proxy Deployment** - For secure deployment within a Virtual Network
+    When running the setup script, you can choose to use one of these predefined scenarios instead of manually configuring all settings.
+    For more information about scenarios and how to customize them, see the [scenarios README](scenarios/README.md).
+    ## Post-Deployment
+    After deployment:
+. Access your SimpleL7Proxy service at the URL provided at the end of the deployment
+. Configure additional settings through environment variables in the Azure Portal
+. Monitor your service using Application Insights
+    ## Troubleshooting
+    If you encounter issues:
+. Check Azure Container App logs in the Azure Portal
+. Verify the Azure Container App configuration
+. Check Application Insights for error logs
+    ## Cleanup
+    To remove deployed resources:
+    ```bash
+    azd down
+    ```
+    ## Additional Documentation
+    For more information about SimpleL7Proxy, refer to the [main documentation](../README.md).

.azure/aca-setup.sh

-Original file line number
+Diff line change
@@ -0,0 +1,87 @@
+    #!/bin/bash
+    # ACA-specific setup helper for SimpleL7Proxy
+    echo "========================================================"
+    echo "  SimpleL7Proxy Azure Container Apps (ACA) Setup"
+    echo "========================================================="
+    echo ""
+    read_input() {
+      local prompt="$1"
+      local default="$2"
+      local input=""
+      if [ -n "$default" ]; then
+        prompt="$prompt [$default]"
+      fi
+      read -p "$prompt: " input
+      if [ -z "$input" ] && [ -n "$default" ]; then
+        input="$default"
+      fi
+      echo "$input"
+    }
+    echo "🔧 Configuring Container App settings (ACA)..."
+    # Container App name
+    default_app_name="${env_AZURE_CONTAINER_APP_NAME:-s7p-${environment}}"
+    container_app_name=$(read_input "Enter Container App name" "$default_app_name")
+    # Container registry
+    default_acr="${env_AZURE_CONTAINER_REGISTRY_NAME:-}"
+    container_registry=$(read_input "Enter container registry name or leave blank for default" "$default_acr")
+    if [ -z "$container_registry" ]; then
+      container_registry="acr${environment}s7p"
+    fi
+    # Container App Environment
+    default_env_ca="${env_AZURE_CONTAINER_APP_ENVIRONMENT_NAME:-}"
+    container_app_env=$(read_input "Enter Container App Environment name or leave blank for default" "$default_env_ca")
+    if [ -z "$container_app_env" ]; then
+      container_app_env="cae-${environment}-s7p"
+    fi
+    echo ""
+    echo "🔧 Scaling Configuration (ACA)"
+    default_min="${env_AZURE_CONTAINER_APP_MIN_REPLICAS:-1}"
+    default_max="${env_AZURE_CONTAINER_APP_MAX_REPLICAS:-5}"
+    min_replicas=$(read_input "Enter minimum number of replicas" "$default_min")
+    max_replicas=$(read_input "Enter maximum number of replicas" "$default_max")
+    echo ""
+    echo "🔧 Network Configuration (ACA)"
+    default_vnet="${env_USE_VNET:-no}"
+    use_vnet=$(read_input "Do you want to deploy in a VNET? (yes/no)" "$default_vnet")
+    vnet_prefix=""
+    subnet_prefix=""
+    if [ "$use_vnet" = "yes" ] || [ "$use_vnet" = "true" ]; then
+      use_vnet="true"
+      echo ""
+      default_vnet_prefix="${env_VNET_ADDRESS_PREFIX:-10.0.0.0/16}"
+      default_subnet_prefix="${env_SUBNET_ADDRESS_PREFIX:-10.0.0.0/21}"
+      vnet_prefix=$(read_input "Enter VNET address space" "$default_vnet_prefix")
+      subnet_prefix=$(read_input "Enter subnet address space" "$default_subnet_prefix")
+    else
+      use_vnet="false"
+    fi
+    echo ""
+    echo "⏳ Applying ACA settings to AZD environment..."
+    # Ensure AZD environment exists/selected before setting ACA vars
+    azd env set AZURE_CONTAINER_REGISTRY_NAME "$container_registry"
+    azd env set AZURE_CONTAINER_APP_NAME "$container_app_name"
+    azd env set AZURE_CONTAINER_APP_ENVIRONMENT_NAME "$container_app_env"
+    azd env set AZURE_CONTAINER_APP_MIN_REPLICAS "$min_replicas"
+    azd env set AZURE_CONTAINER_APP_MAX_REPLICAS "$max_replicas"
+    azd env set USE_VNET "$use_vnet"
+    [ "$use_vnet" = "true" ] && azd env set VNET_ADDRESS_PREFIX "$vnet_prefix"
+    [ "$use_vnet" = "true" ] && azd env set SUBNET_ADDRESS_PREFIX "$subnet_prefix"
+    echo "✅ ACA settings applied."
+    echo "📋 ACA Summary:"
+    echo "   • Container App: $container_app_name"
+    echo "   • Container Registry: $container_registry"
+    echo "   • Container App Environment: $container_app_env"
+    echo "   • Replicas: min=$min_replicas, max=$max_replicas"
+    echo "   • Use VNET: $use_vnet"

.azure/azd.json

-Original file line number
+Diff line change
@@ -0,0 +1,130 @@
+    {
+      "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+      "version": "0.1.0-alpha",
+      "name": "simple-l7-proxy",
+      "description": "SimpleL7Proxy is a layer 7 proxy service that supports prioritization, retries, and timeouts",
+      "resources": {
+        "simpleL7Proxy": {
+          "type": "application",
+          "properties": {
+            "language": "dotnet",
+            "host": "containerapp",
+            "services": {}
+          }
+        }
+      },
+      "parameters": {
+        "environmentName": {
+          "type": "string",
+          "defaultValue": "dev",
+          "metadata": {
+            "description": "Environment name (dev, test, prod)"
+          }
+        },
+        "location": {
+          "type": "string",
+          "defaultValue": "westus2",
+          "metadata": {
+            "description": "Azure region for the deployment"
+          }
+        },
+        "containerAppMinReplicas": {
+          "type": "int",
+          "defaultValue": 1,
+          "metadata": {
+            "description": "Minimum number of Container App replicas"
+          }
+        },
+        "containerAppMaxReplicas": {
+          "type": "int",
+          "defaultValue": 5,
+          "metadata": {
+            "description": "Maximum number of Container App replicas"
+          }
+        },
+        "useVNET": {
+          "type": "bool",
+          "defaultValue": false,
+          "metadata": {
+            "description": "Flag to determine if VNET should be used"
+          }
+        },
+        "vnetAddressPrefix": {
+          "type": "string",
+          "defaultValue": "10.0.0.0/16",
+          "metadata": {
+            "description": "VNET address space"
+          }
+        },
+        "subnetAddressPrefix": {
+          "type": "string",
+          "defaultValue": "10.0.0.0/21",
+          "metadata": {
+            "description": "Subnet address space"
+          }
+        },
+        "enableAuthentication": {
+          "type": "bool",
+          "defaultValue": false,
+          "metadata": {
+            "description": "Flag to enable authentication"
+          }
+        },
+        "authType": {
+          "type": "string",
+          "defaultValue": "none",
+          "allowedValues": ["entraID", "servicebus", "none"],
+          "metadata": {
+            "description": "Authentication type"
+          }
+        },
+        "useAsyncStorage": {
+          "type": "bool",
+          "defaultValue": false,
+          "metadata": {
+            "description": "Flag to enable async storage features"
+          }
+        },
+        "backendHostURLs": {
+          "type": "string",
+          "metadata": {
+            "description": "Comma-separated list of backend URLs"
+          }
+        },
+        "defaultRequestTimeout": {
+          "type": "int",
+          "defaultValue": 100000,
+          "metadata": {
+            "description": "Default timeout for requests in milliseconds"
+          }
+        },
+        "enableAppInsights": {
+          "type": "bool",
+          "defaultValue": true,
+          "metadata": {
+            "description": "Flag to enable Application Insights"
+          }
+        },
+        "queuePriorityLevels": {
+          "type": "int",
+          "defaultValue": 3,
+          "metadata": {
+            "description": "Number of priority levels to configure"
+          }
+        },
+        "enableScaleRule": {
+          "type": "bool",
+          "defaultValue": true,
+          "metadata": {
+            "description": "Enable auto-scaling based on HTTP concurrent requests"
+          }
+        },
+        "httpConcurrentRequestsThreshold": {
+          "type": "int",
+          "defaultValue": 10,
+          "metadata": {
+            "description": "Number of concurrent requests that trigger scaling"
+          }
+        }
+      }
+    }

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Streaming release tr #99

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!