chore: update README and scripts to require OUTPOST_AZURE_ID for deployment

Author: leggetter

examples/azure/README.md

@@ -131,19 +131,30 @@ This example includes three main scripts to manage the deployment:
 
 To deploy Outpost, you must run the scripts in the following order:
 
-1.  **Provision Dependencies:**
+1.  **Set Required Environment Variable:**
+    ```bash
+    # Generate a random ID (recommended):
+    export OUTPOST_AZURE_ID=$(openssl rand -hex 3)
+    
+    # Or use your own ID (lowercase alphanumeric with hyphens, 3-30 chars):
+    # export OUTPOST_AZURE_ID=abc123
+    ```
+    
+    This ID ensures your Azure resources have unique names and is required by the `dependencies.sh` script.
+
+2.  **Provision Dependencies:**
     ```bash
     # To use a specific password (optional):
     # export PG_PASS=<YOUR_POSTGRES_PASSWORD>
     ./dependencies.sh
     ```
 
-2.  **Deploy Outpost:**
+3.  **Deploy Outpost:**
     ```bash
     ./local-deploy.sh
     ```
 
-3.  **Run Diagnostics:**
+4.  **Run Diagnostics:**
     This command specifically targets the local Docker deployment. You will need a public webhook URL for the test.
     ```bash
     export WEBHOOK_URL=<YOUR_PUBLIC_WEBHOOK_URL>
@@ -163,6 +174,9 @@ To deploy Outpost, you must run the scripts in the following order:
 
     *   **To provision new dependencies (Recommended):** Run the scripts to generate the files automatically.
         ```bash
+        # Set required environment variable:
+        export OUTPOST_AZURE_ID=$(openssl rand -hex 3)
+        
         # To use a specific password (optional):
         # export PG_PASS=<YOUR_POSTGRES_PASSWORD>
         ./dependencies.sh
@@ -189,6 +203,9 @@ Before deploying manually, ensure you have the `.env.outpost` and `.env.runtime`
 
 *   **To provision new dependencies:** Run the scripts to generate the files automatically.
     ```bash
+    # Set required environment variable:
+    export OUTPOST_AZURE_ID=$(openssl rand -hex 3)
+    
     # To use a specific password (optional):
     # export PG_PASS=<YOUR_POSTGRES_PASSWORD>
     ./dependencies.sh

examples/azure/dependencies.sh

@@ -17,16 +17,18 @@ if [[ -z "${OUTPOST_AZURE_ID-}" ]]; then
   echo ""
   echo "  export OUTPOST_AZURE_ID=\$(openssl rand -hex 3)"
   echo ""
-  echo "Or use your own ID (lowercase alphanumeric, 3-6 chars):"
+  echo "Or use your own ID (lowercase alphanumeric with hyphens, 3-30 chars):"
   echo ""
-  echo "  export OUTPOST_AZURE_ID=abc123"
+  echo "  export OUTPOST_AZURE_ID=my-project-20251001"
   echo ""
   exit 1
 fi
 
-# Validate OUTPOST_AZURE_ID format (lowercase alphanumeric, 3-6 chars)
-if ! [[ "$OUTPOST_AZURE_ID" =~ ^[a-z0-9]{3,6}$ ]]; then
-  echo "❌ Error: OUTPOST_AZURE_ID must be lowercase alphanumeric, 3-6 characters."
+# Validate OUTPOST_AZURE_ID format (lowercase alphanumeric with hyphens, 3-30 chars)
+# Must start and end with alphanumeric (not hyphen)
+if ! [[ "$OUTPOST_AZURE_ID" =~ ^[a-z0-9]([a-z0-9-]{1,28}[a-z0-9])?$ ]]; then
+  echo "❌ Error: OUTPOST_AZURE_ID must be lowercase alphanumeric with optional hyphens, 3-30 characters."
+  echo "Must start and end with a letter or number (not a hyphen)."
   echo "Current value: '$OUTPOST_AZURE_ID'"
   exit 1
 fi

examples/azure/diagnostics.sh

@@ -194,6 +194,23 @@ run_api_tests() {
     fi
     echo "   -> ✅ Tenant created."
 
+    echo "   (Checking configured topics...)"
+    topics_response=$(curl -s -w "\n%{http_code}" -X GET "$base_url/api/v1/$TENANT_ID/topics" \
+    -H "Authorization: Bearer $API_KEY")
+    
+    topics_http_code=$(echo "$topics_response" | tail -n1)
+    topics_body=$(echo "$topics_response" | sed '$d')
+    
+    if [ "$topics_http_code" = "200" ]; then
+        if [ -n "$topics_body" ] && [ "$topics_body" != "[]" ] && [ "$topics_body" != "null" ]; then
+            echo "   -> ℹ️  Configured topics: $topics_body"
+        else
+            echo "   -> ℹ️  No topic restrictions configured (all topics allowed)"
+        fi
+    else
+        echo "   -> ⚠️  Could not fetch topics (HTTP $topics_http_code)"
+    fi
+
     echo "   (Creating webhook destination...)"
     DESTINATION_ID=$(curl -sf -X POST "$base_url/api/v1/$TENANT_ID/destinations" \
     -H "Content-Type: application/json" \
@@ -211,11 +228,24 @@ run_api_tests() {
     echo "   -> ✅ Webhook destination created."
 
     echo "   (Publishing test event...)"
-    if ! curl -sf -X POST "$base_url/api/v1/publish" \
+    publish_response=$(curl -s -w "\n%{http_code}" -X POST "$base_url/api/v1/publish" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $API_KEY" \
-    -d "{\"tenant_id\":\"$TENANT_ID\",\"topic\":\"diagnostics.test\",\"data\":{\"hello\":\"world\",\"source\":\"$event_source\"}}" >/dev/null; then
+    -d "{\"tenant_id\":\"$TENANT_ID\",\"topic\":\"diagnostics.test\",\"data\":{\"hello\":\"world\",\"source\":\"$event_source\"}}")
+    
+    publish_http_code=$(echo "$publish_response" | tail -n1)
+    publish_body=$(echo "$publish_response" | sed '$d')
+    
+    if [ "$publish_http_code" != "200" ] && [ "$publish_http_code" != "201" ] && [ "$publish_http_code" != "202" ]; then
         echo "   -> ❌ Failed to publish event."
+        echo "      HTTP Status: $publish_http_code"
+        if [ -n "$publish_body" ]; then
+            echo "      Response: $publish_body"
+        fi
+        echo "      Request details:"
+        echo "        - Tenant ID: $TENANT_ID"
+        echo "        - Topic: diagnostics.test"
+        echo "        - Endpoint: $base_url/api/v1/publish"
         if [[ "$base_url" == *"azurecontainerapps.io"* ]]; then
             echo "      Fetching logs for '$AZURE_CONTAINER_APP_NAME'..."
             az containerapp logs show --name "$AZURE_CONTAINER_APP_NAME" --resource-group "$RESOURCE_GROUP" --tail 20