技能 编程开发 CoreWeave GPU集群故障排查

CoreWeave GPU集群故障排查

v20260423
coreweave-common-errors
本指南旨在为用户提供一套完整的CoreWeave基础设施故障排除流程。它专门用于诊断和修复在使用Kubernetes部署AI/ML工作负载时遇到的核心问题,包括GPU资源调度、Pod状态异常、CUDA内存不足以及网络通信超时等。
获取技能
123 次下载
概览

CoreWeave Common Errors

Error Reference

1. Pod Stuck Pending -- No GPU Available

kubectl describe pod <pod-name> | grep -A5 Events
# "0/N nodes are available: insufficient nvidia.com/gpu"

Fix: Check GPU availability: kubectl get nodes -l gpu.nvidia.com/class=A100_PCIE_80GB. Try a different GPU type or region.

2. CUDA Out of Memory

torch.cuda.OutOfMemoryError: CUDA out of memory

Fix: Reduce batch size, enable gradient checkpointing, or use a larger GPU (A100-80GB instead of 40GB).

3. Image Pull BackOff

Fix: Create an imagePullSecret:

kubectl create secret docker-registry regcred \
  --docker-server=ghcr.io \
  --docker-username=$GH_USER \
  --docker-password=$GH_TOKEN

4. NCCL Timeout (Multi-GPU)

NCCL error: unhandled system error

Fix: Ensure all GPUs are on the same node (NVLink). For multi-node, use InfiniBand-connected nodes.

5. PVC Not Mounting

Fix: Check storage class availability: kubectl get sc. Use CoreWeave storage classes like shared-hdd-ord1 or shared-ssd-ord1.

6. Node Affinity Mismatch

Fix: List valid GPU class labels:

kubectl get nodes -o json | jq -r '.items[].metadata.labels["gpu.nvidia.com/class"]' | sort -u

7. Service Not Reachable

Fix: Check Service and Endpoints:

kubectl get svc,endpoints <service-name>

Resources

Next Steps

For diagnostics, see coreweave-debug-bundle.

信息
Category 编程开发
Name coreweave-common-errors
版本 v20260423
大小 2.13KB
更新时间 2026-04-26
语言