Adicione anotações aos pods do ACS para configurar rede, comportamento de pull de imagem, agendamento e definições do sistema operacional. Esta referência lista todas as anotações compatíveis, organizadas por categoria.
Anotações para configuração de pod
Defina estas anotações em metadata.annotations ao criar um pod ou Deployment.
Exemplo de configuração de Pod
apiVersion: v1
kind: Pod
metadata:
name: annotation-pod
annotations:
# Specify one or more vSwitch IDs to control which zones the pod is created in
network.alibabacloud.com/vswitch-ids: "vsw-foo"
# Attach an EIP automatically when the pod starts
network.alibabacloud.com/pod-with-eip: "true"
spec:
...Exemplo de configuração de Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
name: foo
spec:
template:
metadata:
annotations:
network.alibabacloud.com/vswitch-ids: "vsw-foo"
...Rede
| Parâmetro | Valor de exemplo | Descrição |
|---|---|---|
network.alibabacloud.com/vswitch-ids |
"vsw-slw1*,vsw-lkjwo*" |
IDs dos vSwitches do pod. Especifique vários IDs para criar pods em diferentes zonas. Importante
Se vSwitches e afinidade forem definidos simultaneamente, o ACS usará os vSwitches especificados e ignorará a configuração de afinidade. Importante
Caso o pod use um PersistentVolumeClaim (PVC) com modo de vinculação |
network.alibabacloud.com/security-group-ids |
"sg-sljwo*,sg-lwirp*" |
IDs dos grupos de segurança do pod. Especifique vários IDs para anexar múltiplos grupos de segurança. |
network.alibabacloud.com/custom-dnsconfig |
{"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]} |
Configuração personalizada de DNS para o pod. Consulte Configure DNS personalizado usando anotações. |
alibabacloud.com/enable-network-policy-agent |
"true" |
Ative o NetworkPolicy para o pod. Padrão: false. Consulte Usar políticas de rede em clusters ACS. |
Configuração de EIP
Use as anotações a seguir para anexar um Elastic IP Address (EIP) a um pod. Consulte Anexar um EIP a um pod usando anotações.
|
Parâmetro |
Valor de exemplo |
Descrição |
||
|
|
|
Crie e anexe automaticamente um EIP ao pod. Valores válidos: |
|
|
|
|
|
Usa um EIP existente. Insira o ID da instância do EIP. Consulte Solicitar um EIP. |
||
|
|
|
Largura de banda de pico do EIP, em Mbit/s. |
||
|
|
|
Método de medição do EIP. Valores válidos: |
|
|
|
|
|
Método de faturamento da instância do EIP. Valores válidos: |
|
|
|
|
|
Anexa o EIP do pod a uma instância existente de Internet Shared Bandwidth. |
||
|
|
|
Tipo de linha do EIP. Valores válidos: |
|
|
|
|
|
Pool de endereços EIP de onde o EIP será alocado. Consulte Pools de endereços ip. |
||
|
|
Grupo de recursos do EIP. Consulte Solicitar um EIP. |
|||
|
|
Nome do EIP. |
|||
|
|
Descrição do EIP. |
|||
|
|
Serviços de segurança a aplicar ao EIP. Separe vários valores com vírgula ( |
|||
|
|
|
Política de liberação do EIP quando o pod é excluído. Valores válidos: |
|
Duração no estilo Go (por exemplo, |
Imagem
|
Parâmetro |
Valor de exemplo |
Descrição |
|
|
"harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80" |
Registros que usam HTTP simples. Configure este parâmetro para evitar falhas de pull quando um repositório de imagens usa HTTP em vez de HTTPS. Separe várias entradas com vírgula. Consulte Usar um repositório de imagens autogerenciado. |
|
|
"harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80" |
Registros com certificados autoassinados. Configure este parâmetro para ignorar a validação de certificado e evitar falhas de pull. Separe várias entradas com vírgula. |
Agendamento
| Parâmetro | Valor de exemplo | Descrição |
|---|---|---|
alpha.alibabacloud.com/compute-qos-strategy |
"best-effort-to-default" |
Política de nova tentativa de QoS de computação para o pod. Valor válido: best-effort-to-default — o pod inicia com qualidade de computação BestEffort; se os recursos forem insuficientes, ele retorna para a qualidade de computação Default. Importante
Não defina o rótulo |
Sistema operacional
|
Parâmetro |
Valor de exemplo |
Descrição |
|||||||
|
|
|
Configurações de Transparent Huge Pages para o SO do pod. Classes de computação compatíveis: Apenas GPU e GPU-HPN. Subparâmetros: |
|
|
|
|
|
|
|
Anotações adicionadas pelo ACS
O ACS grava estas anotações em um pod após sua criação. Elas refletem resultados de alocação em tempo de execução, como atribuições de Elastic Network Interface (ENI) e EIP. Não é possível definir ou modifique essas anotações.
Alocação de ENI
|
Parâmetro |
Valor de exemplo |
Descrição |
|
|
|
ID da ENI alocada. |
|
|
|
ID da VPC à qual a ENI pertence. |
|
|
|
ID do vSwitch ao qual a ENI foi atribuída. Se você especificou vários vSwitches, este campo exibe aquele efetivamente utilizado. |
Alocação de EIP
|
Parâmetro |
Valor de exemplo |
Descrição |
|
|
|
ID do EIP alocado. |
|
|
|
Endereço ip do EIP alocado. |
Especificações de recursos
|
Parâmetro |
Valor de exemplo |
Descrição |
|
|
|
Especificações normalizadas de CPU e memória. O formato é |
|
|
|
Quantidade normalizada de placas GPU. |
|
|
|
Tamanho normalizado do armazenamento efêmero, em GiB. |
Resultado do agendamento
|
Parâmetro |
Valor de exemplo |
Descrição |
|
|
|
Região onde o pod está em execução. |
|
|
|
Zona onde o pod está em execução. |
Outros metadados
|
Parâmetro |
Valor de exemplo |
Descrição |
|
|
|
ID da instância do pod ACS. |
|
|
|
ID da requisição da chamada de criação do pod. |
Compatibilidade com anotações legadas
As anotações a seguir são compatíveis para garantir retrocompatibilidade. Use as substituições recomendadas para novas configurações.
|
Anotação legada |
Substituição recomendada |
|
|
|
|
|
|