Skip to content

Latest commit

Β 

History

History
434 lines (324 loc) Β· 15.2 KB

File metadata and controls

434 lines (324 loc) Β· 15.2 KB

Azure Integration Services - Sample Recommendations

Executive Summary

After analyzing multiple Azure-Samples repositories, Microsoft patterns & practices, and samples in your workspace, I've identified the best end-to-end samples that showcase Azure Integration Services for workshop demonstrations.

Note: All workspace samples are available in your GitHub account at: https://github.com/CalinL/

Top Recommended Samples

πŸ₯‡ #1 BEST OVERALL: Integration Services Landing Zone Accelerator

Repository: Azure/Integration-Services-Landing-Zone-Accelerator

Services Demonstrated

Service Usage in Sample
βœ… API Management Central API gateway
βœ… Azure Functions Serverless compute
βœ… Logic Apps Workflow orchestration
βœ… Service Bus Messaging backbone
βœ… Event Grid Event routing
βœ… Event Hubs Event streaming
βœ… Data Factory Data integration
βœ… Storage Accounts Data storage

Why This is the Best Choice

This is the official Microsoft Cloud Adoption Framework reference implementation for Azure Integration Services!

graph TB
    subgraph "Integration Services Landing Zone"
        APIM[API Management] --> FUNC[Azure Functions]
        APIM --> LOGIC[Logic Apps]
        
        FUNC --> SB[Service Bus]
        LOGIC --> SB
        
        SB --> EG[Event Grid]
        EG --> EH[Event Hubs]
        
        DF[Data Factory] --> STORAGE[(Storage)]
    end
    
    style APIM fill:#0078D4,color:#fff
    style SB fill:#FF6B6B,color:#fff
    style EG fill:#90EE90
    style LOGIC fill:#50E6FF
Loading

Strengths:

  • βœ… Covers ALL 6+ Azure Integration Services in one deployment
  • βœ… Official Microsoft Cloud Adoption Framework guidance
  • βœ… Enterprise-scale landing zone architecture
  • βœ… Bicep/ARM templates for deployment
  • βœ… Design considerations and recommendations for each service
  • βœ… Two reference implementation scenarios included
  • βœ… Identity, Network, Security, Governance guidance

Workshop Demo Flow:

  1. Deploy the landing zone with all integration services
  2. Walk through each design area (Identity, Network, Security)
  3. Show ServiceNow integration scenario
  4. Demonstrate enterprise governance patterns

πŸ₯ˆ #2 MODERN & ACTIVELY MAINTAINED: Serverless Chat with RAG (LangChain.js)

Repository: Azure-Samples/serverless-chat-langchainjs

Services Demonstrated

Service Usage in Sample
βœ… Azure Functions Serverless API backend
βœ… Static Web Apps Web hosting
βœ… Cosmos DB Vector database + chat history
βœ… Azure OpenAI LLM integration
βœ… Blob Storage Document storage
❌ APIM Not used
❌ Service Bus Not used

Why Consider This:

  • πŸ”₯ Modern AI/RAG pattern (most relevant for 2024+)
  • πŸ“… Actively maintained (updated October 2024)
  • πŸš€ Azure Developer CLI (azd) compatible
  • πŸ“š Comprehensive documentation and tutorials
  • πŸ’» Local development with Ollama support

πŸ₯‰ #3 AI HUB GATEWAY: Enterprise AI Governance

Repository: Azure-Samples/ai-hub-gateway-solution-accelerator

Services Demonstrated

Service Usage in Sample
βœ… API Management Central AI gateway with intelligent routing
βœ… Event Hub Usage data streaming
βœ… Logic Apps Event processing & transformation
βœ… Cosmos DB Usage analytics
βœ… Azure OpenAI Multi-region AI deployments
βœ… App Insights Real-time monitoring

Why Consider This:

  • πŸ”₯ Latest enterprise AI governance patterns (Dec 2024)
  • πŸ›‘οΈ PII detection & masking
  • πŸ“Š Power BI dashboards for cost allocation
  • πŸ” Zero Trust with Entra ID
  • πŸš€ One-click deploy with Azure Developer CLI

πŸ… #4 IN YOUR WORKSPACE: app-templates-microservices-integration (RedDog)

Repository: Azure-Samples/app-templates-microservices-integration

Also forked at: https://github.com/CalinL/app-templates-microservices-integration

Services Demonstrated

Service Usage in Sample
βœ… API Management Gateway for all microservices
βœ… Azure Functions Virtual Customers
βœ… Service Bus Pub/sub between microservices
βœ… Cosmos DB Loyalty service state
βœ… Container Apps Microservices hosting
❌ Event Grid Not directly used
❌ Logic Apps Not included
❌ Data Factory Not included

Architecture

graph TB
    subgraph "RedDog Demo"
        UI[App Service<br/>UI] --> APIM[API Management]
        VC[Azure Functions<br/>Virtual Customers] --> APIM
        
        APIM --> ORDER[Order Service]
        APIM --> MAKE[Makeline Service]
        APIM --> ACCT[Accounting Service]
        
        ORDER --> SB[Service Bus]
        SB --> MAKE
        SB --> ACCT
        SB --> LOYALTY[Loyalty Service]
        SB --> RECEIPT[Receipt Service]
        
        LOYALTY --> COSMOS[(Cosmos DB)]
        MAKE --> REDIS[(Redis Cache)]
        ACCT --> SQL[(SQL Database)]
    end
    
    style APIM fill:#0078D4,color:#fff
    style SB fill:#FF6B6B,color:#fff
Loading

Strengths:

  • βœ… Already forked in your GitHub account
  • βœ… Shows Service Bus messaging patterns (pub/sub)
  • βœ… Container Apps + Functions + App Service hosting variety
  • βœ… Dapr integration for messaging abstraction
  • βœ… Quick deploy script available
  • βœ… Azure Developer CLI (azd) compatible

πŸ… #5 SIMPLEST QUICK DEMO: app-templates-integration-services

Repository: Azure-Samples/app-templates-integration-services

Also forked at: https://github.com/CalinL/app-templates-integration-services

Services Demonstrated

Service Usage in Sample
βœ… API Management Receives HTTP requests
βœ… Service Bus Message queuing
βœ… Azure Functions Queue processor
βœ… Cosmos DB Data storage
❌ Event Grid Not used
❌ Logic Apps Not used
❌ Data Factory Not used

Architecture

flowchart LR
    CLIENT[Client] --> APIM[API Management]
    APIM --> SB[Service Bus Queue]
    SB --> FUNC[Azure Function]
    FUNC --> COSMOS[(Cosmos DB)]
    
    style APIM fill:#0078D4,color:#fff
    style SB fill:#FF6B6B,color:#fff
    style FUNC fill:#FFE66D
Loading

Strengths:

  • βœ… Simplest architecture (easy to explain)
  • βœ… Already forked in your GitHub account
  • βœ… Fast deployment (~1 hour including APIM)
  • βœ… Clear data flow: API β†’ Queue β†’ Function β†’ Database
  • βœ… Demonstrates managed identity authentication

πŸŽ–οΈ #6 BONUS: Invoice Process Automation (Logic Apps Focus)

Repository: Azure-Invoice-Process-Automation-Solution-Accelerator

Also forked at: https://github.com/githubabcs-devops/Azure-Invoice-Process-Automation-Solution-Accelerator

Services Demonstrated

Service Usage in Sample
βœ… Logic Apps Workflow orchestration
βœ… Cosmos DB Invoice data storage
βœ… Form Recognizer AI document processing
βœ… Blob Storage Document storage
❌ API Management Not used
❌ Service Bus Not used
❌ Event Grid Not used

Best For: Demonstrating Logic Apps with AI integration and document processing workflows.


πŸŽ–οΈ BONUS: Cloud Design Patterns (Microsoft Patterns & Practices)

Repository: mspnp/cloud-design-patterns

⭐ Stars: 842 | πŸ”„ Forks: 305 | πŸ“… Updated: December 2024 (actively maintained!)

Patterns Included

Pattern Description
Async Request-Reply HTTP polling pattern
Choreography Event-driven coordination
Claim Check Large message handling
Pipes & Filters Message processing
Priority Queue Service Bus queues
Saga Distributed transactions
Valet Key Secure storage access

Why Consider This:

  • πŸ”₯ Actively maintained (updated 3 days ago!)
  • πŸ“š Official Azure Architecture Center companion code
  • 🎯 Individual patterns you can extract and demonstrate
  • πŸ’‘ Perfect for teaching specific integration patterns

Comparison Matrix

Sample APIM Functions Logic Apps Service Bus Event Grid Data Factory Last Updated Ease of Deploy
Integration Services LZA βœ… βœ… βœ… βœ… βœ… βœ… Sep 2024 ⭐⭐⭐
Serverless Chat (LangChain) ❌ βœ… ❌ ❌ ❌ ❌ Oct 2024 ⭐⭐⭐⭐⭐
AI Hub Gateway βœ… ❌ βœ… ❌ βœ… ❌ Nov 2024 ⭐⭐⭐⭐
RedDog (microservices-integration) βœ… βœ… ❌ βœ… ❌ ❌ 2024 ⭐⭐⭐⭐
Integration Services (simple) βœ… βœ… ❌ βœ… ❌ ❌ 2024 ⭐⭐⭐⭐⭐
Cloud Design Patterns ❌ βœ… ❌ βœ… ❌ ❌ Dec 2024 ⭐⭐⭐⭐

Workshop Strategy Recommendation

For L200-L300 Workshop: Combine Multiple Samples

flowchart TB
    subgraph "Day 1: Foundations"
        SIMPLE[Simple Integration<br/>app-templates-integration-services]
        SIMPLE --> DEMO1[APIM + Service Bus + Functions]
    end
    
    subgraph "Day 2: Enterprise Patterns"
        LZA[Integration Services LZA]
        LZA --> DEMO2[All 6 Services +<br/>Enterprise Governance]
    end
    
    subgraph "Day 3: Modern AI Integration"
        AIHUB[AI Hub Gateway]
        AIHUB --> DEMO3[APIM + Logic Apps +<br/>Event Hub + AI Services]
    end
    
    style SIMPLE fill:#90EE90
    style LZA fill:#0078D4,color:#fff
    style AIHUB fill:#FFE66D
Loading

Quick Demo (30-60 minutes)

Use: app-templates-integration-services (https://github.com/CalinL/app-templates-integration-services)

  • Deploy with single az deployment command
  • Show API call β†’ Service Bus β†’ Function β†’ Cosmos DB
  • Simple, clear flow

Half-Day Workshop

Use: Integration Services Landing Zone Accelerator

  • Clone and deploy the landing zone
  • Walk through enterprise architecture patterns
  • Show all 6+ integration services working together
  • Enterprise governance and security considerations

Full Day Workshop

Combine:

  1. Start with simple sample (app-templates-integration-services)
  2. Introduce enterprise patterns (Integration Services LZA)
  3. Show AI integration (AI Hub Gateway or Serverless Chat)
  4. Design patterns deep-dive (mspnp/cloud-design-patterns)

Deployment Commands

Integration Services Landing Zone Accelerator

git clone https://github.com/Azure/Integration-Services-Landing-Zone-Accelerator.git

# Follow the scenario-specific deployment guide
# Scenario 1: Enterprise AIS deployment
# Scenario 2: ServiceNow integration

app-templates-integration-services

# Clone from your fork
git clone https://github.com/CalinL/app-templates-integration-services.git
cd app-templates-integration-services

az deployment sub create \
  --name "integration-demo" \
  --location "eastus" \
  --template-file infra/main.bicep \
  --parameters name="demo" \
    publisherEmail="your-email@example.com" \
    publisherName="Workshop Demo"

app-templates-microservices-integration (RedDog)

# Clone from your fork
git clone https://github.com/CalinL/app-templates-microservices-integration.git
cd app-templates-microservices-integration

chmod +x ./deploy.sh
./deploy.sh -n demo -l eastus2 -c <unique-code>

AI Hub Gateway Solution Accelerator

git clone https://github.com/Azure-Samples/ai-hub-gateway-solution-accelerator.git
cd ai-hub-gateway-solution-accelerator

# One-click deploy with Azure Developer CLI
azd auth login
azd env new ai-hub-gateway-dev
azd up

Serverless Chat with LangChain.js

git clone https://github.com/Azure-Samples/serverless-chat-langchainjs.git
cd serverless-chat-langchainjs

# Deploy to Azure
azd auth login
azd up

Missing Service: Azure Data Factory

Note: Most integration samples don't prominently feature Azure Data Factory as it's typically used for batch data movement rather than real-time integration. For Data Factory demos, consider:

  1. Create a separate Data Factory demo using:

  2. Data Factory Use Case Addition:

    • Add a data pipeline to any sample that:
      • Loads historical data into Cosmos DB
      • Aggregates order data for reporting
      • Syncs data between systems

Final Recommendation

Workshop Goal Recommended Sample Repository
Complete Integration Services coverage Integration Services Landing Zone Accelerator Azure/Integration-Services-Landing-Zone-Accelerator
Quick 30-min demo app-templates-integration-services CalinL/app-templates-integration-services
Modern AI + Integration AI Hub Gateway Azure-Samples/ai-hub-gateway-solution-accelerator
Microservices + Service Bus RedDog Demo CalinL/app-templates-microservices-integration
Individual design patterns Cloud Design Patterns mspnp/cloud-design-patterns
Modern RAG/AI demo Serverless Chat LangChain.js Azure-Samples/serverless-chat-langchainjs

Resources

Official Microsoft References

Modern AI + Integration

Your Workspace Samples

Azure Developer CLI Templates