vllm-project / vllm-project/afd-plugin

[RFC]: Provide recipes and a skill/documentation for multi-node deployment on Kubernetes clusters

Open
#348 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

RFC
Dominant language
Python
Stars
228
Forks
48
Avg merge
22h 23m
Merged PRs (30d)
44

Description

Motivation

Current recipes don't support multi-node deployment:

  • AFD rendezvous host is 127.0.0.1 which is only reachable from processes on the same machine
  • GPU selection via CUDA_VISIBLE_DEVICES only makes sense if all ranks' GPUs live in one host's device list.
  • One bash script executes every role (attention, ffn).
Proposed change

Goal:

  1. Create examples of templated recipes for multi-node deployment that do not hard-code host, list of devices, etc., and split vllm processes per role.
  2. Create a deployment skill that uses the templated multi-node recipes for the deployment on a kubernetes cluster.

Initial scope:

  • collocation recipes
  • CUDA device backend
Plugin boundary

No patches required.

Risks and alternatives

No changes to existing recipes/scripts.

Feedback period

No response

CC list

No response

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing recipes and bash scripts to understand the current collocation and CUDA device backend setup. Define templated multi-node recipes with configurable hosts and devices, split processes by role, and document a Kubernetes deployment skill. Done means the initial collocation and CUDA backend scope is covered without changing existing recipes or scripts.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes, python
Domain
devops, documentation, infrastructure
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.