CoreWeave System Images
Operating System images provided by CoreWeave Cloud include enhancements and features to reduce friction when running Virtual Servers in the Cloud.
Identifying Images
Operating system source images provided by CoreWeave for Virtual Servers live in the vd-images
namespace on CoreWeave Cloud. Several metadata properties exist for easy identification.
Using kubectl
with the metadata labels listed above, individual images are easily queried.
Metadata labels
Label | Description |
---|---|
images.coreweave.cloud/family | Identifies the OS type, usually Windows or Linux |
images.coreweave.cloud/features | Identifies image specific features, such as Teradici enabled or nVidia drivers |
images.coreweave.cloud/id | Image ID used during CI/CD |
images.coreweave.cloud/latest | Boolean tag for the latest image revision |
images.coreweave.cloud/name | Complete image name, as displayed in the Web UI |
images.coreweave.cloud/os-name | Name of the parent OS |
images.coreweave.cloud/os-version | Subsection of OS, such as "Standard" or "Professional Edition" |
images.coreweave.cloud/private | Boolean tag for testing images, not intended to be used in production environments |
images.coreweave.cloud/region | The datacenter region where the image resides |
images.coreweave.cloud/version | Date tag for when the image was built |
Example query commands
List all (non-private) latest images available for use
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false
Sort all images by region
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false --sort-by=.spec.storageClassName
Show all Windows images only
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/family=windows
Show all Windows 10 images only
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/os-name=Windows_10
Sort Windows 10 images by region, and extract the image name
Extracting the image name using -o jsonpath='{.items[*].metadata.name}'
is useful for things like automation scripts.
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/os-name=Windows_10,images.coreweave.cloud/region=ord1 -o jsonpath='{.items[*].metadata.name}'
Show all Linux images only
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/family=linux
Show all Ubuntu images only
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/os-name=Ubuntu
Show all Ubuntu 20.04 images only
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/name=Ubuntu_20.04
Sort Ubuntu 20.04 images by region, and extract the image name
Extracting the image name using -o jsonpath='{.items[*].metadata.name}'
is useful for things like automation scripts.
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/name=Ubuntu_20.04,images.coreweave.cloud/region=ord1 -o jsonpath='{.items[*].metadata.name}'
Show all Linux images and their features, filtered by region
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/family=linux,images.coreweave.cloud/region=ord1 -o=custom-columns="PVC:metadata.name,NAME:metadata.labels['images\.coreweave\.cloud\/name'],FEATURES:metadata.labels['images\.coreweave\.cloud\/features'],SIZE:status.capacity.storage,STORAGECLASS:.spec.storageClassName" --sort-by='.metadata.name'