Anotaciones de pods de ECI

Cuando crea un pod de ECI (una instancia de ECI) en un clúster de Kubernetes, puede agregar anotaciones para aprovechar las funciones de ECI sin modificar la semántica de Kubernetes. Este tema describe tanto las anotaciones que usted puede agregar como aquellas que el sistema añade automáticamente después de programar el pod.

Los pods de ECI admiten a continuación las siguientes anotaciones:

Importante

Estas anotaciones se aplican únicamente a los pods programados en nodos virtuales (instancias de ECI) y no afectan a los pods ubicados en nodos regulares.
Agregue las anotaciones al elemento metadata del pod. Por ejemplo, al crear un Deployment, añada las anotaciones dentro de spec>template>metadata.
Las anotaciones relacionadas con Elastic Container Instance solo se aplican durante la creación del pod. Si agrega o modifica estas anotaciones en un pod existente, no surtirán ningún efecto.

Ejemplos

Función	Anotación	Valor de ejemplo	Descripción
Create pods across multiple availability zones	k8s.aliyun.com/eci-vswitch	vsw-bp1xpiowfm5vo8o3c****	Especifica el ID de un vSwitch. Puede especificar varios ID de vSwitch para desplegar pods en distintas zonas de disponibilidad.
Create pods across multiple availability zones	k8s.aliyun.com/eci-schedule-strategy	VSwitchOrdered	Define la política de programación cuando hay varias zonas de disponibilidad. Valores válidos: `VSwitchOrdered`: intenta crear el pod con los vSwitch especificados, siguiendo el orden en que aparecen en la lista. `VSwitchRandom`: crea el pod en uno de los vSwitch especificados, seleccionado mediante una política óptima de programación de Alibaba Cloud.
Create a pod with multiple instance specifications Create a pod by specifying vCPU and memory Create a pod by specifying an ECS instance type	k8s.aliyun.com/eci-use-specs	2-4Gi,4-8Gi,ecs.c6.xlarge	Especifica una o más especificaciones de instancia para el pod de ECI. Estas pueden ser combinaciones de vCPU y memoria, o bien tipos de instancia de ECS.
	k8s.aliyun.com/eci-gpu-driver-version	tesla=525.85.12	Indica la versión del controlador de GPU. Si crea una instancia acelerada por GPU y especifica un tipo de instancia compatible con varias versiones de controladores y CUDA, utilice esta anotación para definir dichas versiones.
Create a pod by specifying or excluding ECS instance families	k8s.aliyun.com/eci-instance-family	"ecs.c6,ecs.g6"	Determina qué familias de instancias de ECS se deben usar o evitar al crear una instancia de ECI, según los requisitos de vCPU y memoria.
Create a pod by specifying or excluding ECS instance generations	k8s.aliyun.com/eci-instance-generation	"6,5"	Define qué generaciones de instancias de ECS se deben utilizar o evitar al crear una instancia de ECI, de acuerdo con los requisitos de vCPU y memoria.
Create a pod by specifying a compute category	k8s.aliyun.com/eci-compute-category	economy	Establece una categoría de cómputo cuando se crea una instancia de ECI mediante la especificación de vCPU y memoria. Valores válidos: `economy` (tipo económico) y `general` (tipo de uso general). Es posible especificar varias categorías de cómputo. El sistema crea los pods respetando el orden en que se definieron dichas categorías.
Create a preemptible instance	k8s.aliyun.com/eci-spot-strategy	SpotAsPriceGo	Política de puja para la preemptible instance. Valores válidos: `SpotWithPriceLimit`: establece un precio máximo personalizado para la preemptible instance. Esta política requiere configurar también la anotación `k8s.aliyun.com/eci-spot-price-limit`. `SpotAsPriceGo`: el sistema puja automáticamente al precio actual del mercado.
	k8s.aliyun.com/eci-spot-price-limit	"0.5"	Precio máximo por hora de la preemptible instance. El valor admite hasta tres decimales. Esta anotación solo tiene efecto cuando `k8s.aliyun.com/eci-spot-strategy` se establece en `SpotWithPriceLimit`.
	k8s.aliyun.com/eci-spot-duration	"0"	Periodo de protección de la preemptible instance. El valor predeterminado es 1 hora. Establezca el valor en 0 para deshabilitar el periodo de protección.
	k8s.aliyun.com/eci-spot-fallback	"true"	Indica si se debe crear automáticamente una instancia pay-as-you-go cuando no haya preemptible instances disponibles. El valor predeterminado es `false`.
Create a pod by using a private pool with Elasticity Assurance	k8s.aliyun.com/eci-privatepool-matchcriteria	"Open"	Configure el modo de coincidencia del pool privado. Valores válidos: Open: el sistema busca automáticamente un pool privado abierto que esté disponible. Target: es obligatorio especificar también un ID de pool privado. Utilice este modo si su pool privado es dedicado.
	k8s.aliyun.com/eci-privatepool-id	eap-2ze1g68k2melxkkl****	Especifique el ID del pool privado (que corresponde al ID de la garantía de elasticidad). Lo encontrará en la página Resource reservation de la consola de ECS, dentro de la pestaña Resource Reservations o Private Pools. Si k8s.aliyun.com/eci-privatepool-matchcriteria se establece en Target, debe incluir esta anotación. Si k8s.aliyun.com/eci-privatepool-matchcriteria se establece en Open, esta anotación no tiene efecto.
Set the fault handling policy for an ECI pod	k8s.aliyun.com/eci-fail-strategy	fail-back	Política de manejo de errores del pod de ECI. Valores válidos: `fail-back`: si falla la creación del pod, el sistema reintenta automáticamente. `fail-over`: funciona igual que `fail-back`. `fail-fast`: si falla la creación del pod, el sistema reporta un error de inmediato.
Customize the maximum pending duration for an ECI pod	k8s.aliyun.com/eci-max-pending-minute	"30"	Tiempo máximo, en minutos, que la instancia de ECI de un pod puede permanecer en estado `Pending`. Al superar este límite, el sistema finaliza la instancia. El valor debe ser un número entero entre 10 y 1440. Valor predeterminado: 240 (4 horas).
Customize hosts for an ECI pod	k8s.aliyun.com/eci-custom-hosts	"[{\"host\":\"example.com\",\"ip\":\"100.100.XX.XX\"},{\"host\":\"aliyundoc.com\",\"ip\":\"100.100.XX.XX\"}]"	Agrega asignaciones personalizadas de host al `/etc/hosts` del pod de ECI.
Bind custom tags to an ECI pod	k8s.aliyun.com/eci-custom-tags	"env:test,name:alice"	Permite vincular hasta tres etiquetas al pod. Las etiquetas son pares clave-valor separados por dos puntos (:), mientras que varias etiquetas se separan con coma (,).
Bind a RAM role to an ECI pod	k8s.aliyun.com/eci-ram-role-name	AliyunECIContainerGroupRole	Vincula un rol de RAM al pod de ECI para otorgarle permisos de acceso a otros servicios de Alibaba Cloud.

Imagen

Función	Parámetro	Valor	Descripción
Accelerate pod creation with an image cache	k8s.aliyun.com/eci-auto-imc	"true"	Establézcalo en `"true"` para buscar automáticamente una caché de imágenes compatible.
	k8s.aliyun.com/imc-perfect-match	"true"	Si la coincidencia automática está habilitada, indica si todas las imágenes de contenedor del pod deben coincidir exactamente con las imágenes almacenadas en la caché.
	k8s.aliyun.com/imc-match-count-request	"2"	Si la coincidencia automática está habilitada, define cuántas imágenes de contenedor del pod deben coincidir exactamente con las imágenes de la caché.
	k8s.aliyun.com/eci-imc-id	imc-2zebxkiifuyzzlhl****	Identificador de la caché de imágenes.
Pull ACR images without a Secret	k8s.aliyun.com/acr-instance-ids	cri-j36zhodptmyq****	Especifica la instancia de Container Registry Enterprise Edition desde la cual extraer imágenes sin necesidad de un Secret. Para extraer una imagen de otra región, anteponga el ID de región al ID de la instancia. Ejemplo: `"cn-beijing:cri-j36zhodptmyq****"`.
	k8s.aliyun.com/acr-service-arns	acs:ram::1609982529:role/role-assume	Indica el ARN del rol de RAM en la cuenta propietaria del recurso de ECI. Esta anotación es obligatoria si utiliza un rol de RAM para crear el recurso.
	k8s.aliyun.com/acr-user-arns	acs:ram::1298452580:role/role-acr	Especifica el ARN del rol de RAM que pertenece a la cuenta de la instancia de Container Registry Enterprise Edition. Esta anotación es obligatoria para extraer imágenes de una cuenta distinta.
Pull images from a self-managed image repository	k8s.aliyun.com/plain-http-registry	harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80	Permite que ECI extraiga imágenes mediante HTTP desde los repositorios autogestionados especificados. Así se evitan errores de extracción provocados por incompatibilidad de protocolos.
Pull images from a self-managed image repository	k8s.aliyun.com/insecure-registry	harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80	Omite la verificación del certificado al extraer imágenes de los repositorios autogestionados indicados. Esto previene fallas de extracción causadas por certificados autofirmados.

DataCache

Función	Parámetro	Valor	Descripción
Create a pod from a DataCache	k8s.aliyun.com/eci-data-cache-bucket	default	Especifica el bucket donde se almacena DataCache. Debe configurar esta anotación cuando utilice DataCaches para crear pods.
	k8s.aliyun.com/eci-data-cache-pl	PL1	Define el nivel de rendimiento del disco creado a partir de DataCache. De forma predeterminada, se utiliza un disco SSD mejorado (ESSD) PL1.
	k8s.aliyun.com/eci-data-cache-provisionedIops	"40000"	Establece las IOPS de lectura y escritura aprovisionadas para el disco ESSD AutoPL. Valores válidos: de 0 a min{50,000, 1000 × capacidad de almacenamiento - IOPS base}. IOPS base = min{1,800 + 50 × capacidad de almacenamiento, 50,000}. Para obtener más información, consulte ESSD AutoPL disks. Si agrega esta anotación, el disco creado a partir de DataCache será un disco ESSD AutoPL.
	k8s.aliyun.com/eci-data-cache-burstingEnabled	"true"	Indica si se debe habilitar la función de ráfaga de rendimiento para el disco ESSD AutoPL. Para obtener más información, consulte ESSD AutoPL disks. Si agrega esta anotación, el disco creado a partir de DataCache será un disco ESSD AutoPL.

Red

Función	Parámetro	Valor de ejemplo	Descripción
Configure security groups for an ECI pod	k8s.aliyun.com/eci-security-group	sg-bp1dktddjsg5nktv****	Especifica el ID del security group. Se aplican los siguientes requisitos: Puede especificar uno o más security groups, con un máximo de cinco. Los security groups especificados deben pertenecer a la misma VPC. Todos los security groups indicados deben ser del mismo tipo.
Associate an EIP with an ECI instance	k8s.aliyun.com/eci-eip-instanceid	eip-bp1q5n8cq4p7f6dzu****	ID de la EIP que se va a asociar.
	k8s.aliyun.com/eci-with-eip	"true"	Si se establece en "true", crea y asocia automáticamente una EIP.
	k8s.aliyun.com/eip-bandwidth	"5"	Ancho de banda de la EIP en Mbps. El valor predeterminado es 5 Mbps.
	k8s.aliyun.com/eip-common-bandwidth-package-id	cbwp-2zeukbj916scmj51m****	ID de un Common Bandwidth Package existente. Para obtener más información, consulte Shared Bandwidth.
	k8s.aliyun.com/eip-isp	BGP	Tipo de línea de la EIP. Esta configuración aplica únicamente a las EIP con modelo pay-as-you-go. Valores válidos: BGP: BGP (Multi-ISP) BGP_PRO: BGP (Multi-ISP) Pro Para obtener más información, consulte EIP line types.
	k8s.aliyun.com/eip-internet-charge-type	PayByBandwidth	Método de facturación de la EIP. Valores válidos: PayByBandwidth: pago por ancho de banda PayByTraffic: pago por tráfico Para obtener más información, consulte EIP billing methods.
	k8s.aliyun.com/eip-public-ip-address-pool-id	pippool-bp187arfugi543y1s****	ID del pool de direcciones IP desde el cual se asignará la EIP. Para obtener más información, consulte IP address pools.
Assign an IPv6 address to an ECI pod	k8s.aliyun.com/eci-enable-ipv6	"true"	Si se establece en "true", asigna una dirección IPv6 al pod.
	k8s.aliyun.com/eci-ipv6-bandwidth-enable	"true"	Si se establece en "true", habilita el acceso público a internet para la dirección IPv6 de la instancia de ECI.
	k8s.aliyun.com/eci-ipv6-bandwidth	100M	Ancho de banda público máximo para la dirección IPv6, expresado en Mbps.
Specify a private IP address for an ECI pod	k8s.aliyun.com/eci-private-ip-address	"172.16.0.1"	Especifica la dirección IP privada del pod. Solo se admiten direcciones IPv4. Compruebe que la dirección IP no esté en uso.
Configure a fixed IP address for an ECI pod	k8s.aliyun.com/eci-fixed-ip	"true"	Si se establece en "true", habilita una dirección IP fija para el pod.
Configure a fixed IP address for an ECI pod	k8s.aliyun.com/eci-fixed-ip-retain-hour	"24"	Periodo de retención, en horas, de la dirección IP fija después de liberar la versión del pod. Si no configura esta anotación, el periodo de retención predeterminado es de 48 horas.
Limit the ingress and egress bandwidth of an ECI pod	kubernetes.io/ingress-bandwidth	40M	Ancho de banda máximo de entrada, en Mbps.
Limit the ingress and egress bandwidth of an ECI pod	kubernetes.io/egress-bandwidth	20M	Ancho de banda máximo de salida, en Mbps.
Configure custom DNS for an ECI pod	k8s.aliyun.com/eci-custom-dnsconfig	`{\"nameservers\":\"20.1.xx.xx,20.1.xx.xx\",\"searches\":\"xx.com,xx.eee\",\"options\":\"ndots:2,edns0\"}`	Define configuraciones DNS personalizadas para el pod de ECI. Se usa habitualmente en escenarios de nube híbrida para resolver nombres de dominio internos.

Almacenamiento

Función	Parámetro	Valor	Descripción
Expand temporary storage	k8s.aliyun.com/eci-extra-ephemeral-storage	50Gi	Tamaño del espacio de almacenamiento temporal.
Encrypt temporary storage	k8s.aliyun.com/eci-ephemeral-storage-options	"{\"encrypted\":\"true\"}"	Habilita el cifrado del espacio de almacenamiento temporal.

Contenedor

Función	Parámetro	Valor de ejemplo	Descripción
Configure an NTP service for a pod	k8s.aliyun.com/eci-ntp-server	100.100..*	Especifica la dirección del servidor NTP.

Registros

Función

Parámetro

Valor de ejemplo

Descripción

Collect logs with an SLS CRD

k8s.aliyun.com/eci-sls-enable

"false"

Establezca el valor en "false" para deshabilitar la recopilación de registros.

Cuando recopile registros mediante una definición de recursos personalizados (CRD) de SLS, agregue esta anotación a los pods que desee excluir de dicha recopilación. Con esto se evita la creación automática de una configuración de Logtail y se conservan recursos.

O&M

Función	Parámetro	Valor de ejemplo	Descripción
View core dump files	k8s.aliyun.com/eci-core-pattern	/pod/data/dump/core	Directorio donde se almacenan los archivos de volcado de memoria (core dump).

Anotaciones de pods de ECI

En la siguiente tabla se enumeran las anotaciones que se agregan a un pod de ECI después de programarlo. Para consultarlas, ejecute el comando kubectl describe.

Parámetro	Valor de ejemplo	Descripción
k8s.aliyun.com/eci-request-id	45942504-4688-51BA-BBAB-4B692C4F39C0	ID de la solicitud.
k8s.aliyun.com/eci-instance-id	eci-2ze1y0la40qgva09****	ID de la instancia de ECI.
k8s.aliyun.com/eci-instance-spec	2.0-4.0Gi	Especificación de la instancia de ECI utilizada para la facturación. Si el valor es una combinación específica de vCPU y memoria (por ejemplo, 2.0-4.0Gi), la instancia se factura según dichos recursos. Si el valor es un tipo de instancia de ECS (por ejemplo, ecs.c6.large), la facturación se basa en ese tipo de instancia.
k8s.aliyun.com/eci-instance-compute-category	economy	Categoría de cómputo de la especificación de la instancia de ECI. Si el valor es `economy`, la instancia se factura conforme a la especificación de tipo económico. Si el valor es `general`, la facturación se realiza según la especificación de uso general.
k8s.aliyun.com/allocated-eipInstanceId	eip-bp1q5n8cq4p7f6dzu****	ID de la EIP asociada.
k8s.aliyun.com/allocated-eipAddress	47.99..	Dirección IP de la EIP asociada.
k8s.aliyun.com/allocated-ipv6Address	2001:d**:1:1:1:1:1:1	Dirección IPv6 asociada.
k8s.aliyun.com/eci-created-by-template	true	Indica si la instancia de ECI se creó a partir de una plantilla.
k8s.aliyun.com/eni-instance-id	eni-2ze6d7oo5ukqj26o****	ID de la interfaz de red elástica asociada.
k8s.aliyun.com/eci-vpc	vpc-2zeghwzptn5zii0w7****	ID de la VPC.
k8s.aliyun.com/eci-matched-image-cache	imc-2zedy3v37800iimu****	ID de la caché de imágenes coincidente.
k8s.aliyun.com/eci-schedule-result	finished	Resultado de la programación. Esta anotación está obsoleta. En su lugar, consulte la condición ContainerInstanceCreated en podStatus.conditions. Para obtener más información, consulte ContainerInstanceCreated.