Docs

Volcengine Kubernetes Engine

Image

Overview of operating system (OS) images

When you create a Volcengine Kubernetes Engine (VKE) cluster or node pool, you need to select an OS image for nodes. This topic describes the image types supported by VKE, especially public images and their compatible instance families.

Disclaimers

VKE has different service level objectives (SLO) for different image types. For custom images and shared images, only limited support and guarantees are available.

For custom images built from compatible public images with OS-independent configurations (such as pre-installed model files or pre-pulled container images), data plane component availability is guaranteed.

For custom images built from compatible public images with modified OS configurations (such as sysctl settings, boot parameters, or driver versions), VKE component availability cannot be guaranteed. However, troubleshooting assistance is still provided for such cases.

For custom images built from incompatible public images (for example, those using unsupported machine models or custom kernels), VKE component availability cannot be guaranteed. Unfortunately, we cannot offer troubleshooting for these unsupported scenarios.

Image types

VKE supports three image types: public, custom, and shared. For details about images, see Image overview.

Public images: official, copyrighted images provided by Volcano Engine. These images combine basic OS with initialization components, delivering security, high availability, and open access for all users.

Custom images: user-uploaded images that contain customized OS and pre-deployed applications (public or private). These images offer a high level of configuration customization. They are ideal for replicating complex initialization systems or deploying systems with identical configurations at scale. VKE allows you to specify custom images as node operating systems.

Shared images: images shared by other Volcano Engine users. You can use a shared image to quickly deploy a software environment the same as that created by other users. Conversely, you can share your custom image with other Volcano Engine users.

Warning

You need to create custom images and shared images by using VKE base images. Check whether a GPU version is required based on your business requirements.

Custom images are available at the node pool project level.

As of April 14, 2025, VKE has discontinued maintenance for public GPU Driver 470 series images. New nodes can no longer be provisioned by using this image series. For details, see Discontinued maintenance support for GPU Driver 470 series images.

Public images

An image is a pre-configured file that contains an OS and applications for node deployment. When you create a VKE cluster or node pool, you need to select a supported OS image for nodes. This section lists public OS images supported by VKE and the instance families associated with each image.

Warning

VKE maintains its own list of supported OS images, which may differ from the latest images available on Elastic Compute Service (ECS). Ensure that you use OS images supported by VKE when you provision nodes.

The system provides the latest version of each public image by default, but existing nodes that were created using older versions of public images will still function normally.

All public images use system architecture (x86_64) and boot modeUEFI.

The image IDs provided in this topic are valid only in specified regions. For other regions, locate the corresponding image IDs by searching for image names in the VKE console.

veLinux

The veLinux image series is a Linux distribution developed and optimized by Volcano Engine specifically for its public cloud environment. It delivers a stable, high-performance, and secure operating system with full lifecycle management capabilities. For details, see veLinux overview.

tip

The veLinux 2.0 series images are currently in the public beta stage.

You can choose whether to disable GSP firmware if you use public images with driver 535. For details, see How do I disable GSP firmware for public images?

Image name	Image ID	System size	Kernel version	Instance family of associated nodes
veLinux 1.0 64 bit	China (Beijing): image-ybqi99s7yq8rx7mnk44b China (Guangzhou): image-ybqd474ge1ftrj6h7ok7 China (Shanghai): image-ybps9zgztxb1wztomg99	8 GB	5.4	All instance families in categories General-purpose, Compute-optimized, Big Data, Memory-optimized, High Frequency, Local-SSD, Bare Metal, and Shared
veLinux 1.0 CentOS Compatible 64 bit	China (Beijing): image-ybxij852mqb6uow354vz China (Guangzhou): image-ybwv4jtl4tea3dva0lk7 China (Shanghai): image-ybx2w7yn63m05lag4c57	8 GB	5.4
veLinux 1.0 with 5.10 kernel(UEFI)	China (Beijing): image-ycail7bf23gqeeusystc China (Guangzhou): image-yca0myo9fdea3cbh1y6d China (Shanghai): image-yca8gonfuwhu0ro9qseu	8 GB	5.10	Third-generation instance families in categories General-purpose, Compute-optimized, Big Data, Memory-optimized, High Frequency, Local-SSD, and Shared
veLinux 1.0 CentOS Compatible with 5.10 kernel 64 bit	China (Beijing): image-ycail4e1tngqeelnh40v China (Guangzhou): image-yca0mv06x5ea3cc0dpnw China (Shanghai): image-yca8glc0kahu0qtd6t4y	8 GB	5.10
veLinux 1.0 with GRID 13.1	China (Beijing): image-yc66t71jb7dymizw3cd5 China (Guangzhou): none China (Shanghai): image-ycaicq9i20dbkthjbbff	8 GB	5.4	ecs.g1te-vws ecs.gni2-vws
veLinux 1.0 with GPU Driver 535.129.03 and mlx 5.8-3 (64-bit)	China (Beijing): image-ycxuc57mgidymkdunzo7 China (Guangzhou): image-yczfaznehsdo4xacc28k China (Shanghai): image-ycxtq7jdk5m05l9f4gr8	8 GB	5.4	Instance families of the GPU-accelerated and high performance computing optimized types (excluding third-generation instances)
veLinux 1.0 CentOS Compatible with GPU Driver 535.129.03 and mlx 5.8-3 64 bit	China (Beijing): image-ycxuc57mghdymk7ajibw China (Guangzhou): image-yczfaznehqdo4xfvsdmd China (Shanghai): image-ycxtq7jdk4m05l3bhq6r	8 GB	5.4
veLinux 2.0 64 bit	China (Beijing): image-yd6lmt386vgqef1r7xpu China (Guangzhou): image-yd63gowkpwgfwsu1z73h China (Shanghai): image-yd7m6t27j4m05k8nxjhb	8 GB	5.15	All CPU-related instance families, such as those in categories General-purpose, Compute-optimized, and Memory-optimized Warning Only clusters running Kubernetes version 1.30 or later support veLinux 2.0 series images. veLinux 2.0 series images use cgroupv2 by default.
veLinux 2.0 CentOS Compatible 64 bit	China (Beijing): image-yd6lmly69fgqeeqfvixc China (Guangzhou): image-yd63ghhotcgfwtx1j6l3 China (Shanghai): image-yd7m6lyk64m05l01lxp1	8 GB	5.15

Ubuntu

The Ubuntu image series is a tested, open-source public image optimized by Volcano Engine based on the Ubuntu community version. For details, see Overview of public images.

tip

The Ubuntu 20.x image is currently in the public beta stage.

The Ubuntu 22.x image is currently in the public beta stage.

You can choose whether to disable GSP firmware if you use public images with driver 535. For details, see How do I disable GSP firmware for public images?

Image name	Image ID	System size	Kernel version	Instance family of associated nodes
Ubuntu 20.04 64 bit	China (Beijing): image-aagd56zrx2jtdryj5p63 China (Guangzhou): image-4qnzlg1hvu8nk13bybi7 China (Shanghai): image-ybo1s36210glgrl51nbv	8 GB	5.4	ecs.g3i ecs.r3i ecs.c3i ecs.i3s ecs.ebmg3id ecs.ebmc3id ecs.ebmr3id
Ubuntu 20.04 with GPU Driver 535.129.03 and mlx 5.8-3 64 bit	China (Beijing): image-ycxuc5910zdymj94pknj China (Guangzhou): image-yczfb94qhudo4xqhyt2k China (Shanghai): image-ycxtqeofhom05jv0qs2h	8 GB	5.4	g1te g1ve gni2 ini2 hpcpni2 Warning The supported instance families in the GPU Accelerated category may change. Ensure that you check the actual availability in the VKE console.
Ubuntu 22.04 64 bit	China (Beijing): image-yc0efhx6jv4qwlql1jmt China (Guangzhou): image-ybzbekqg89ea3dsi5z2b China (Shanghai): image-ybzgkd6yzam05lcwpg41	8 GB	5.15	All CPU-related instance families, such as those in categories General-purpose, Compute-optimized, and Memory-optimized Warning Only clusters running Kubernetes version 1.30 or later support Ubuntu 22.x images. Ubuntu 22.x images use cgroupv2 by default.

Custom images

Warning

Custom images are non-standard environments for which Volcano Engine does not provide official support or ongoing maintenance.

VKE allows you to install operating systems on nodes by using custom images. Two methods of packaging custom images are available. You can select an appropriate method based on your business requirements.

Use the docker run method to package and preheat custom images. For detailed operations, see Packaging custom images by using Docker.

Quickly create custom images by using ECS. For detailed operations, see Creating custom images by using ECS.

Last updated: 2026.06.12 11:25:11