vllm-project / vllm-project/afd-plugin
[RFC]: Provide recipes and a skill/documentation for multi-node deployment on Kubernetes clusters
Nobody has claimed this yet.
- 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:
- 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.
- 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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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