Skip to content

docs(blog): add post on streaming vLLM weights from Azure Blob Storage#5845

Merged
sdesai345 merged 1 commit into
Azure:masterfrom
surajssd:add-run-ai-blog
Jul 14, 2026
Merged

docs(blog): add post on streaming vLLM weights from Azure Blob Storage#5845
sdesai345 merged 1 commit into
Azure:masterfrom
surajssd:add-run-ai-blog

Conversation

@surajssd

@surajssd surajssd commented Jun 26, 2026

Copy link
Copy Markdown
Member

Summary

Adds a new AKS Engineering Blog post, "Stream Model Weights to NVIDIA GPU (vLLM) from Azure Blob Storage using the RunAI Model Streamer" (website/blog/2026-07-13-runai-streamer-vllm/index.md), a runnable end-to-end walkthrough for serving microsoft/phi-4 with vLLM on AKS while streaming model weights directly from Azure Blob Storage via the RunAI Model Streamer's native az:// scheme. The post leans on a fully managed A100 GPU node pool and workload identity so no storage keys are needed, and explains — now with measured numbers — why streaming beats the default download-then-load path for autoscaling inference cold starts.

Changes

  • New blog post (index.md) walking through: deploying an AKS cluster with OIDC + workload identity and a managed GPU node pool (--enable-managed-gpu=true), creating a premium block-blob storage account, wiring up workload identity for keyless Blob access, an in-cluster upload Job that pushes microsoft/phi-4 weights to Blob, and a vLLM Deployment that streams them via --load-format runai_streamer. Includes "Why stream", "Trade-offs and downsides", a verification step (spotting the Loading safetensors using Runai Model Streamer log line), and a conclusion.
  • Measured benchmark added under the 1-why-stream-vs-download diagram: a same-node (Standard_NC24ads_A100_v4), same-model comparison showing ~187 s for the default HuggingFace → local disk → GPU path versus ~10 s streaming from Blob with runai_streamer — with the load-step-only figure (~74 s vs ~10 s, ~7×) called out as the stable, apples-to-apples number.
  • Externalized manifests for maintainability: the bulky inline Job and Deployment/Service YAML now live in Azure-Samples/aks-samples and are pulled via curl … | envsubst | kubectl apply, keeping the post copy-pastable while moving the manifests out of the prose (addresses review feedback that inline YAML would be hard to maintain).
  • Dedicated service account: uses a runai-streamer service account applied declaratively from service-account.yaml instead of mutating the namespace default SA, so the workload-identity wiring stays off unrelated pods.
  • Copy-paste ergonomics: multi-command bash blocks (feature registration, cluster create, storage, workload identity) split into separate single-purpose blocks with prose between them, and shell until/sleep polling loops replaced with "re-run this check" instructions.
  • Four diagrams: a hero image plus 1-why-stream-vs-download.png, 2-identity.png (workload-identity trust chain), and 3-end-to-end.png (end-to-end flow), each with descriptive alt text.
  • New author entry hariharan-sethuraman added to website/blog/authors.yml; post co-authored with suraj-deshmukh.
  • Intro/framing from review feedback: added a bigger-picture lead-in paragraph (who hits cold-start tax and when), moved the <!-- truncate --> marker above the fold, refined title/description, applied grammar fixes, and corrected the workload-identity label explanation, the phi-4 size figure, and depersonalized the Configuration variables.
  • Publish date set to 2026-07-13 (front matter date: and the post directory name kept in sync so the rendered date matches the /2026/07/13/runai-streamer-vllm URL).
  • Formatting: converted blockquote callouts to Docusaurus :::note/:::caution/:::tip admonitions and replaced the Mermaid diagrams with images.

Test Plan

  • npm run build succeeds in website/ (static site compiles; post renders at /2026/07/13/runai-streamer-vllm with both authors).
  • markdownlint-cli2 passes against blog/linters/.markdown-lint.yml (0 errors).
  • codespell clean with the repo's ignore list.
  • Walkthrough validated live end-to-end on a real AKS cluster with A100 quota: managed GPU node pool advertised nvidia.com/gpu: 1 with no GPU operator, the upload Job pushed all ~27 GB of microsoft/phi-4 to Blob, vLLM (vllm/vllm-openai:v0.23.0) streamed from az:// (confirmed via the Loading safetensors using Runai Model Streamer log line), and a chat-completion request returned a valid response.
  • Benchmark numbers in the post are measured, not estimated.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new AKS blog post that walks through serving microsoft/phi-4 with vLLM while streaming weights directly from Azure Blob Storage via the RunAI Model Streamer (az://) using workload identity, plus a new author profile entry to support the post.

Changes:

  • Added a new blog post: streaming vLLM weights from Azure Blob on AKS with workload identity.
  • Added a new author key (hariharan-sethuraman) to website/blog/authors.yml.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

File Description
website/blog/authors.yml Adds a new author entry used by the new blog post.
website/blog/2026-06-26-runai-streamer-vllm/index.md New end-to-end tutorial post for streaming vLLM weights from Azure Blob Storage on AKS.

Comment thread website/blog/authors.yml Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings June 27, 2026 00:02

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

Comment thread website/blog/authors.yml
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings June 29, 2026 18:23

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings June 29, 2026 18:55

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated 4 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings June 29, 2026 19:00

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated 7 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings June 29, 2026 20:17

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 5 changed files in this pull request and generated 6 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings June 29, 2026 20:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 5 changed files in this pull request and generated 4 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings June 30, 2026 00:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 3 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings July 13, 2026 17:49

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 3 comments.

Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md
Comment thread website/blog/2026-06-26-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings July 13, 2026 23:12

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 4 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings July 13, 2026 23:17

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 4 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings July 13, 2026 23:24

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 6 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings July 13, 2026 23:30

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 3 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings July 13, 2026 23:49

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 3 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Copilot AI review requested due to automatic review settings July 14, 2026 00:05

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 7 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md Outdated
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Copilot AI review requested due to automatic review settings July 14, 2026 00:14

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 6 changed files in this pull request and generated 6 comments.

Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Comment thread website/blog/2026-07-13-runai-streamer-vllm/index.md
Add an AKS Engineering Blog post walking through serving `microsoft/phi-4`
with vLLM on AKS while streaming model weights directly from Azure Blob
Storage via the RunAI Model Streamer's native `az://` scheme, on a fully
managed A100 GPU node pool with workload identity (no storage keys).

- New post `website/blog/2026-07-13-runai-streamer-vllm/index.md` covering
    cluster + managed GPU node pool (`--enable-managed-gpu=true`), premium
    block-blob storage, keyless Blob access via workload identity, an
    in-cluster upload `Job`, and a vLLM `Deployment` streaming with
    `--load-format runai_streamer`
- Include a measured same-node benchmark (~187 s download-then-load vs
    ~10 s streamed; ~74 s vs ~10 s for the load step alone)
- Pull the `Job` and `Deployment`/`Service` manifests from
    `Azure-Samples/aks-samples` via `curl ... | envsubst | kubectl apply`,
    using a dedicated `runai-streamer` service account
- Add four diagrams with alt text and use Docusaurus admonitions
- Add author entry `hariharan-sethuraman` to `website/blog/authors.yml`

Signed-off-by: Suraj Deshmukh <suraj.deshmukh@microsoft.com>

@sdesai345 sdesai345 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-approved

@sdesai345
sdesai345 merged commit b23e175 into Azure:master Jul 14, 2026
5 checks passed
@surajssd
surajssd deleted the add-run-ai-blog branch July 14, 2026 15:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants