Docs

Volcengine Kubernetes Engine

General purpose instance

Creating an instance by specifying an instance family (vCPU and memory).

VCI allows you to specify instance families and subnets by using a specific annotation and create general-purpose instances by specifying the container vCPU and memory.

Limits

The supported regions and availability zones vary based on different general-purpose instance families. For details, see Regions and availability zones.

You can configure custom specifications for each container, but the specifications need to meet the vCPU and memory constraints of a VCI when they are aggregated at the instance level.

If the requirements are not met, the system automatically adjusts the specifications and bills you based on the adjusted specifications. For the adjustment logic, see Instance specification adjustment description.

Prerequisites

A cluster for VCI applications has been created. For details, see Using VCI in VPC-CNI clusters and Using VCI in Flannel clusters.

A VPC and its subnet have been created. For details, see Creating VPCs.

Creating instances by using Kubernetes

You can directly define the request and limit for the corresponding container to specify its vCPU and memory. You can specify instance families by adding an annotation when creating VCIs. The following table describes the annotation used for specifying instance families.

Annotation key	Annotation sample value	Description	Required
vci.vke.volcengine.com/preferred-instance-family	vci.u1	The instance specifications of the general-purpose type. tip If you do not specify this annotation, the default instance family vci.u1 specified by VCI is used. For the value description of the annotation used to create a GPU-accelerated instance, see Creating GPU-accelerated instances by specifying container GPU resources. Billing is performed based on the matched instance specification. For billing descriptions, see Product billing. You can specify multiple general-purpose instance families (annotation values). Separate multiple instance families with commas (,), and determine the priority by the order in which they are entered. If the higher-priority instance family has no available resources, the lower-priority instance family will be used to create instances.	Optional

The following sample code shows how to create a Deployment.

tip

For more information about annotations, see Pod annotation descriptions.

Creating instances by using the console

Specify the following parameters when you create a workload in a VCI cluster.

Basic information: Select Volcengine Container Instance for the Computing power type parameter.

Container configuration: Specify the requests and limits of CPU and memory in the ResourceQuota section based on your business requirements.

Advanced configurations: Configure the instance specifications in the VCI specification settings section. You can use the default instance family or specify a custom instance family.

When specifying instance families, you can select multiple families under the same instance type. Their priority is determined by the order in which they are selected. For details, see Specific specifications. If resources are unavailable in a higher-priority family, VCI uses a lower-priority family to create the instance.

Last updated: 2026.09.03 15:56:09