Repolode
Azure-Samples

Azure-Samples/aks-store-demo

A polyglot microservices sample app for deploying a realistic online store to Azure Kubernetes Service (AKS), with optional OpenAI-generated product content.

Stars
315
Forks
831
Open issues
8
Last commit
22 hours ago

What is it?

AKS Store Demo is a sample online store built from containerized microservices written in several languages, including Go, JavaScript, Rust, Python and Vue.js front ends. It includes a customer storefront, an admin app for viewing order queues and managing products, and simulated customer and worker services that generate orders on a schedule.

The services communicate through RabbitMQ as an order queue and persist data in DocumentDB. An optional ai-service uses OpenAI-compatible models, either Azure OpenAI or OpenAI, to generate product descriptions and images.

The project can be deployed to any Kubernetes cluster with a single manifest, run locally with Docker Compose, opened in GitHub Codespaces, or deployed to Azure with the Azure Developer CLI. It is meant to illustrate a realistic polyglot, event-driven architecture on AKS rather than serve as production-ready code.

Key features

  • 01Polyglot microservices written in Go, JavaScript, Rust, Python and Vue.js
  • 02Event-driven order processing through a RabbitMQ queue
  • 03Optional AI service for generating product text and images via Azure OpenAI or OpenAI
  • 04Simulated customers and workers that generate orders on a schedule
  • 05Deployment to AKS, any Kubernetes cluster, Docker Compose, or GitHub Codespaces

Use cases

  • Demonstrating a realistic microservices application running on AKS
  • Learning how polyglot services communicate through a message queue
  • Testing Kubernetes deployments with a multi-service sample workload
  • Experimenting with integrating OpenAI-compatible models into an existing app

Quick start

  1. 1

    Install Docker Desktop

  2. 2

    Clone the repository

    git clone https://github.com/Azure-Samples/aks-store-demo.git
  3. 3

    Start the app with Docker Compose from the repo directory

    docker compose up

Things to know

  • The README says this code is not meant to be production-grade.
  • Running locally requires Docker Desktop, or a GitHub Codespace instead.
  • The AI product content features need Azure OpenAI or OpenAI API keys; otherwise the ai-service must be disabled.

In collections

Topics

FAQ

What is aks-store-demo?
A polyglot microservices sample app for deploying a realistic online store to Azure Kubernetes Service (AKS), with optional OpenAI-generated product content. AKS Store Demo is a sample online store built from containerized microservices written in several languages, including Go, JavaScript, Rust, Python and Vue.js front ends. It includes a customer storefront, an admin app for viewing order queues and managing products, and simulated customer and worker services that generate orders on a schedule.
Is aks-store-demo free to use? What license does it have?
aks-store-demo is open source under the MIT license. Check the license terms before using it in commercial products.
Is aks-store-demo still maintained?
Actively maintained. The last commit to aks-store-demo was on Nov 6, 2026.
What can I use aks-store-demo for?
Demonstrating a realistic microservices application running on AKS Learning how polyglot services communicate through a message queue Testing Kubernetes deployments with a multi-service sample workload Experimenting with integrating OpenAI-compatible models into an existing app
How do I install aks-store-demo?
Install Docker Desktop Clone the repository: git clone https://github.com/Azure-Samples/aks-store-demo.git Start the app with Docker Compose from the repo directory: docker compose up
Where can I get aks-store-demo?
The source code and installation instructions are on GitHub: https://github.com/Azure-Samples/aks-store-demo

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects