Elastic Container Instance:Anotações de pods do ECI

Recurso

Anotação

Valor de exemplo

Descrição

Crie pods em várias zonas de disponibilidade

k8s.aliyun.com/eci-vswitch

vsw-bp1xpiowfm5vo8o3c****

Define o ID de um vSwitch. Especifique vários IDs de vSwitch para implantar pods em várias zonas de disponibilidade.

k8s.aliyun.com/eci-schedule-strategy

VSwitchOrdered

A política de agendamento para várias zonas de disponibilidade. Valores válidos:

• VSwitchOrdered: Tenta criar o pod usando os vSwitches especificados na ordem em que estão listados.

• VSwitchRandom: Cria o pod em um dos vSwitches especificados, selecionado pela política de agendamento ideal da Alibaba Cloud.

• Crie um pod com várias especificações de instância

• Crie um pod especificando vCPU e memória

• Crie um pod especificando um tipo de instância ECS

k8s.aliyun.com/eci-use-specs

2-4Gi,4-8Gi,ecs.c6.xlarge

Determina uma ou mais especificações de instância para o pod do ECI, podendo ser combinações de vCPU e memória ou tipos de instância ECS.

k8s.aliyun.com/eci-gpu-driver-version

tesla=525.85.12

Define a versão do driver da GPU.

Ao criar uma instância acelerada por GPU com um tipo de instância GPU compatível com várias versões de driver e CUDA, use esta anotação para especificar as versões do driver e do CUDA.

Crie um pod especificando ou excluindo famílias de instâncias ECS

k8s.aliyun.com/eci-instance-family

"ecs.c6,ecs.g6"

Indica quais famílias de instâncias ECS usar ou evitar ao criar uma instância do ECI com base nos requisitos de vCPU e memória.

Crie um pod especificando ou excluindo gerações de instâncias ECS

k8s.aliyun.com/eci-instance-generation

"6,5"

Define quais gerações de instâncias ECS usar ou evitar ao criar uma instância do ECI com base nos requisitos de vCPU e memória.

Crie um pod especificando uma categoria de computação

k8s.aliyun.com/eci-compute-category

economy

Determina uma categoria de computação ao criar uma instância do ECI com base em vCPU e memória.

• Valores válidos: economy (tipo econômico) e general (tipo de uso geral).

• É possível especificar várias categorias de computação. O sistema cria os pods na ordem de especificação das categorias.

Crie uma instância preemptível

k8s.aliyun.com/eci-spot-strategy

SpotAsPriceGo

A política de lance para a instância preemptível. Valores válidos:

• SpotWithPriceLimit: Define um preço máximo personalizado para a instância preemptível. Esta política exige também a definição da anotação k8s.aliyun.com/eci-spot-price-limit.

• SpotAsPriceGo: O sistema dá lances automaticamente pelo preço de mercado atual.

k8s.aliyun.com/eci-spot-price-limit

"0.5"

O preço máximo por hora para a instância preemptível. O valor suporta até três casas decimais.

Esta anotação é válida apenas quando k8s.aliyun.com/eci-spot-strategy está definida como SpotWithPriceLimit.

k8s.aliyun.com/eci-spot-duration

"0"

O período de proteção para a instância preemptível. O valor padrão é 1 hora. Defina o valor como 0 para não haver período de proteção.

k8s.aliyun.com/eci-spot-fallback

"true"

Define se o sistema deve criar automaticamente uma instância de pagamento conforme o uso quando as instâncias preemptíveis não estiverem disponíveis. O valor padrão é false.

Crie um pod usando um pool privado com Elasticity Assurance

k8s.aliyun.com/eci-privatepool-matchcriteria

"Open"

Defina o modo de correspondência do pool privado. Valores válidos:

• Open: O sistema corresponde automaticamente a um pool privado aberto disponível.

• Target: Especifique também um ID de pool privado. Use este modo se o seu pool privado for dedicado.

k8s.aliyun.com/eci-privatepool-id

eap-2ze1g68k2melxkkl****

Especifique o ID do pool privado (ou seja, o ID de garantia de elasticidade). Encontre-o na página de reserva de recursos no console do ECS na guia Resource Reservations ou Private Pools.

• Se k8s.aliyun.com/eci-privatepool-matchcriteria estiver definido como Target, inclua esta anotação.

• Se k8s.aliyun.com/eci-privatepool-matchcriteria estiver definido como Open, esta anotação não terá efeito.

Defina a política de tratamento de falhas para um pod do ECI

k8s.aliyun.com/eci-fail-strategy

fail-back

A política de tratamento de falhas para o pod do ECI. Valores válidos:

• fail-back: Se a criação do pod falhar, o sistema tentará novamente automaticamente.

• fail-over: Igual a fail-back.

• fail-fast: Se a criação do pod falhar, o sistema relatará um erro imediatamente.

Personalize a duração máxima de pendência para um pod do ECI

k8s.aliyun.com/eci-max-pending-minute

"30"

O tempo máximo em minutos em que a instância do ECI de um pod pode permanecer no status Pending. Se o tempo limite for excedido, o sistema encerra a instância.

O valor deve ser um número inteiro de 10 a 1440. Padrão: 240 (4 horas).

Personalize os hosts para um pod do ECI

k8s.aliyun.com/eci-custom-hosts

"[{\"host\":\"example.com\",\"ip\":\"100.100.XX.XX\"},{\"host\":\"aliyundoc.com\",\"ip\":\"100.100.XX.XX\"}]"

Adiciona mapeamentos de host personalizados ao arquivo /etc/hosts do pod do ECI.

Vincule tags personalizadas a um pod do ECI

k8s.aliyun.com/eci-custom-tags

"env:test,name:alice"

Permite vincular até três tags ao pod. As tags são pares chave-valor separados por dois pontos (:) e múltiplas tags são separadas por vírgula (,).

Vincule uma função do RAM a um pod do ECI

k8s.aliyun.com/eci-ram-role-name

AliyunECIContainerGroupRole

Vincula uma função do RAM ao pod do ECI, concedendo permissões para acessar outros serviços da Alibaba Cloud.

Recurso

Parâmetro

Valor

Descrição

Acelere a criação de pods com um cache de imagem

k8s.aliyun.com/eci-auto-imc

"true"

Defina como "true" para corresponder automaticamente a um cache de imagem.

k8s.aliyun.com/imc-perfect-match

"true"

Se a correspondência automática estiver ativada, especifica se todas as imagens de contêiner no pod devem corresponder exatamente às imagens no cache.

k8s.aliyun.com/imc-match-count-request

"2"

Se a correspondência automática estiver ativada, especifica o número de imagens de contêiner no pod que devem corresponder exatamente às imagens no cache.

k8s.aliyun.com/eci-imc-id

imc-2zebxkiifuyzzlhl****

Define o ID do cache de imagem.

Extraia imagens do ACR sem um Secret

k8s.aliyun.com/acr-instance-ids

cri-j36zhodptmyq****

Indica a instância do Container Registry Enterprise Edition da qual extrair imagens sem um Secret.

Para extrair uma imagem de uma região diferente, prefixe o ID da instância com o ID da região. Exemplo: "cn-beijing:cri-j36zhodptmyq****".

k8s.aliyun.com/acr-service-arns

acs:ram::1609982529:role/role-assume

Define o ARN da função do RAM na conta que possui o recurso do ECI.

Esta anotação é necessária ao usar uma função do RAM para criar o recurso.

k8s.aliyun.com/acr-user-arns

acs:ram::1298452580:role/role-acr

Indica o ARN da função do RAM que pertence à conta da instância do Container Registry Enterprise Edition.

Esta anotação é necessária para extrair imagens de uma conta diferente.

Extraia imagens de um repositório de imagens autogerenciado

k8s.aliyun.com/plain-http-registry

harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80

Permite que o ECI extraia imagens via HTTP dos repositórios de imagens autogerenciados especificados. Isso evita falhas de extração causadas por incompatibilidade de protocolo.

k8s.aliyun.com/insecure-registry

harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80

Ignora a verificação de certificado HTTPS ao extrair imagens de repositórios de imagens autogerenciados especificados. Isso evita falhas de extração causadas por certificados autoassinados.

Recurso

Parâmetro

Valor

Descrição

Crie um pod a partir de um DataCache

k8s.aliyun.com/eci-data-cache-bucket

default

Define o bucket usado para armazenar o DataCache. Configure esta anotação ao usar DataCaches para criar pods.

k8s.aliyun.com/eci-data-cache-pl

PL1

Determina o nível de desempenho do disco criado com base no DataCache. Por padrão, o sistema usa um SSD aprimorado (ESSD) PL1.

k8s.aliyun.com/eci-data-cache-provisionedIops

"40000"

k8s.aliyun.com/eci-data-cache-burstingEnabled

"true"

Recurso

Parâmetro

Valor de exemplo

Descrição

Configure grupos de segurança para um pod do ECI

k8s.aliyun.com/eci-security-group

sg-bp1dktddjsg5nktv****

Define o ID do grupo de segurança. Aplicam-se os seguintes requisitos:

• Especifique um ou mais grupos de segurança. O limite máximo é de cinco grupos de segurança.

• Os grupos de segurança especificados devem pertencer à mesma VPC.

• Os grupos de segurança especificados devem ser do mesmo tipo.

Associe um EIP a uma instância do ECI

k8s.aliyun.com/eci-eip-instanceid

eip-bp1q5n8cq4p7f6dzu****

O ID do EIP a ser associado.

k8s.aliyun.com/eci-with-eip

"true"

Cria e associa automaticamente um EIP se definido como "true".

k8s.aliyun.com/eip-bandwidth

"5"

A largura de banda do EIP em Mbps. O padrão é 5 Mbps.

k8s.aliyun.com/eip-common-bandwidth-package-id

cbwp-2zeukbj916scmj51m****

O ID de um Common Bandwidth Package existente. Para mais informações, consulte Largura de banda compartilhada.

k8s.aliyun.com/eip-isp

BGP

O tipo de linha do EIP. Esta configuração se aplica apenas a EIPs de pagamento conforme o uso. Valores válidos:

• BGP: BGP (Multi-ISP)

• BGP_PRO: BGP (Multi-ISP) Pro

Para mais informações, consulte Tipos de linha de EIP.

k8s.aliyun.com/eip-internet-charge-type

PayByBandwidth

O método de faturamento do EIP. Valores válidos:

• PayByBandwidth: pagamento por largura de banda

• PayByTraffic: pagamento por tráfego

Para mais informações, consulte Métodos de faturamento de EIP.

k8s.aliyun.com/eip-public-ip-address-pool-id

pippool-bp187arfugi543y1s****

O ID do pool de endereços IP para alocação do EIP. Para mais informações, consulte Pools de endereços IP.

Atribua um endereço IPv6 a um pod do ECI

k8s.aliyun.com/eci-enable-ipv6

"true"

Atribui um endereço IPv6 ao pod se definido como "true".

k8s.aliyun.com/eci-ipv6-bandwidth-enable

"true"

Ative o acesso à internet pública para o endereço IPv6 da instância do ECI se definido como "true".

k8s.aliyun.com/eci-ipv6-bandwidth

100M

A largura de banda pública de pico para o endereço IPv6, em Mbps.

Especifique um endereço IP privado para um pod do ECI

k8s.aliyun.com/eci-private-ip-address

"172.16.0.1"

Define o endereço IP privado para o pod. Apenas endereços IPv4 são suportados. Certifique-se de que o endereço IP não esteja em uso.

Configure um endereço IP fixo para um pod do ECI

k8s.aliyun.com/eci-fixed-ip

"true"

Ative um endereço IP fixo para o pod se definido como "true".

k8s.aliyun.com/eci-fixed-ip-retain-hour

"24"

O período de retenção em horas para o endereço IP fixo após a liberação do pod.

Se esta anotação não for configurada, o período de retenção padrão é de 48 horas.

Limite a largura de banda de entrada e saída de um pod do ECI

kubernetes.io/ingress-bandwidth

40M

A largura de banda máxima de entrada, em Mbps.

kubernetes.io/egress-bandwidth

20M

A largura de banda máxima de saída, em Mbps.

Configure DNS personalizado para um pod do ECI

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 configurações personalizadas de DNS para o pod do ECI. Geralmente usadas em cenários de cloud híbrida para resolver nomes de domínio internos.

Recurso

Parâmetro

Valor

Descrição

Expanda o armazenamento temporário

k8s.aliyun.com/eci-extra-ephemeral-storage

50Gi

O tamanho do espaço de armazenamento temporário.

Criptografe o armazenamento temporário

k8s.aliyun.com/eci-ephemeral-storage-options

"{\"encrypted\":\"true\"}"

Ative a criptografia para o espaço de armazenamento temporário.

Recurso

Parâmetro

Valor de exemplo

Descrição

Configure um serviço NTP para um pod

k8s.aliyun.com/eci-ntp-server

100.100.*.**

Define o endereço do servidor NTP.

Recurso

Parâmetro

Valor de exemplo

Descrição

Colete logs com um CRD do SLS

k8s.aliyun.com/eci-sls-enable

"false"

Defina o valor como "false" para desativar a coleta de logs.

Ao coletar logs com uma definição de recurso personalizado (CRD) do SLS, adicione esta anotação aos pods a serem excluídos da coleta de logs. Essa ação evita a criação automática de uma configuração do Logtail e conserva recursos.

Recurso

Parâmetro

Valor de exemplo

Descrição

Visualize arquivos de core dump

k8s.aliyun.com/eci-core-pattern

/pod/data/dump/core

O diretório para armazenar arquivos de core dump.