• Stefy Lanza (nextime / spora )'s avatar
    runpod: global volumes and a region allow-list (v0.3.0) · 88edb84f
    Stefy Lanza (nextime / spora ) authored
    Weights in one place, pods wherever a card is free.
    
    `global_volume_id` attaches a RunPod GLOBAL volume (beta since Sept 2026):
    region-independent storage, so unlike `network_volume_id` it does NOT pin the
    pod's data centre — which is the only reason to use one. Resolved by its own
    function precisely so the two cannot be confused: the region lookup stays under
    the network-volume branch, and a test holds them apart.
    
    `data_centers` is the other half. A single `data_center` pins one region and a
    blank one lets RunPod pick any region on earth, so there was no way to say
    "anywhere in the EU" — which is what data that may not leave the EU requires.
    The list is tried in order, and each (card, region) pair becomes its own
    candidate so the capacity fallback that already walks GPU options walks regions
    too, with no new control flow. The pod handle records the region it actually
    got, not the pool's first choice.
    
    Two honest limits, both documented in the code and the guide. A global volume
    must be created in the RunPod CONSOLE: POST /v2/network-volumes allows only
    STANDARD|HIGH_PERFORMANCE and demands a dataCenter. And attaching is
    console-documented only — no field exists in the Pod API reference, and the v1
    REST validator accepts unknown body keys silently, so a wrong name cannot be
    caught by probing; it yields a pod with no volume that re-downloads its
    weights. We send globalNetworkVolumeId, overridable by
    CODERAI_RUNPOD_GLOBAL_VOLUME_FIELD, and it must be verified on a real pod.
    Co-Authored-By: 's avatarClaude Opus 5 <noreply@anthropic.com>
    88edb84f
Name
Last commit
Last update
codai Loading commit data...
docs Loading commit data...
packaging Loading commit data...
samples Loading commit data...
tests Loading commit data...
third_party Loading commit data...
tools Loading commit data...
.dockerignore Loading commit data...
.gitignore Loading commit data...
AI.PROMPT Loading commit data...
CODERAI_API_DOCUMENTATION.md Loading commit data...
CoderAI.gif Loading commit data...
DISTRIBUTION.md Loading commit data...
LICENSE.md Loading commit data...
MULTIMODAL_CAPABILITIES.md Loading commit data...
MULTIMODAL_UI_EXAMPLES.md Loading commit data...
README.md Loading commit data...
REQUEST-geoclip-embeddings.md Loading commit data...
REQUEST-vpr-embeddings.md Loading commit data...
amdgpu-coredump-05000.bin Loading commit data...
build-oci.sh Loading commit data...
build.ps1 Loading commit data...
build.sh Loading commit data...
coderai Loading commit data...
coderai-broker-implementation-reference.md Loading commit data...
coderai-integration.md Loading commit data...
commands Loading commit data...
osxbuild.sh Loading commit data...
package-oci.sh Loading commit data...
package-tarball.sh Loading commit data...
requirements-crisperwhisper.txt Loading commit data...
requirements-h3.txt Loading commit data...
requirements-longcat-train.txt Loading commit data...
requirements-longcat.txt Loading commit data...
requirements-melotts.txt Loading commit data...
requirements-nemo.txt Loading commit data...
requirements-nvidia.txt Loading commit data...
requirements-ocr-paddle.txt Loading commit data...
requirements-ocr.txt Loading commit data...
requirements-pyannote.txt Loading commit data...
requirements-surya.txt Loading commit data...
requirements-vllm.txt Loading commit data...
requirements-vulkan.txt Loading commit data...
requirements.txt Loading commit data...
run-oci.sh Loading commit data...
smoke-test-oci.sh Loading commit data...
todo.md Loading commit data...