Elastic Container Instance:Adicionar um VNode (manual)

Pré-requisitos

• Ter um cluster Kubernetes na versão 1,16 a 1,30.

• Se o cluster Kubernetes estiver implantado em um data center local, garanta que a rede do data center esteja conectada à rede da Alibaba Cloud por meio do Express Connect, Smart Access Gateway (SAG) ou VPN Gateway. Para mais informações, consulte os seguintes tópicos:

  • Express Connect

  • Smart Access Gateway (SAG)

  • VPN Gateway

Antes de começar

Antes de criar um VNode, reúna os parâmetros necessários e revise as permissões obrigatórias. A tabela a seguir descreve os parâmetros necessários.

Ao criar um VNode, configure as permissões necessárias. Isso inclui as permissões padrão usadas por nós nativos do Kubernetes e permissões adicionais específicas para VNodes, conforme descrito na tabela a seguir.

Configurar o cluster

Um VNode usa um arquivo kubeconfig para se conectar ao cluster. Portanto, emita um certificado (kubeconfig) para o VNode antes de criá-lo.

1. Conecte-se ao cluster.

2. Baixe e execute o script de configuração. Escolha TLS bootstrapping ou ServiceAccount para gerar um arquivo kubeconfig.

   TLS Bootstrap

   Para maior segurança, recomendamos o TLS bootstrapping. Esse método implanta automaticamente o componente vnode-approver. Esse componente assina as CSRs enviadas pelos VNodes e é open source no GitHub. Para mais informações, consulte vnode-approver.

   curl -fsSL https://eci-docs.oss-cn-beijing.aliyuncs.com/vnode/vnode-deploy.sh | bash -s -- bootstrap

   ServiceAccount

   Este método não oferece suporte à rotação de certificados. Garanta que o token tenha um longo período de validade ou que não expire. Isso evita que o VNode fique indisponível devido a um certificado expirado.

   curl -fsSL https://eci-docs.oss-cn-beijing.aliyuncs.com/vnode/vnode-deploy.sh | bash -s -- common

3. Verifique o arquivo kubeconfig.

   O arquivo kubeconfig gerado recebe o nome vnode-config. Execute o comando a seguir para visualizar o arquivo:

   cat vnode-config

   Ao verificar o arquivo, valide os seguintes pontos:

   • Certifique-se de que a VPC onde o VNode será criado consegue alcançar o endereço do servidor (por exemplo, se estão na mesma VPC ou conectados via rede).

     • Se o endereço do servidor for um IP, ele deve ser acessível a partir da VPC do VNode.

     • Se o endereço do servidor for um nome de domínio, ele deve ser resolvido dentro da VPC da Alibaba Cloud, e o IP resultante deve ser acessível a partir da VPC do VNode.

   • Se o parâmetro certificate-authority-data estiver vazio, verifique se o campo correspondente no arquivo ~/.kube/config usa um caminho de arquivo.

   TLS Bootstrap

   apiVersion: v1
   kind: Config
   current-context: kubernetes-admin@kubernetes
   contexts:
   - name: kubernetes-admin@kubernetes
     context:
       cluster: kubernetes-admin@kubernetes
       user: vnode
       namespace: kube-system
   clusters:
   - name: kubernetes-admin@kubernetes
     cluster:
       certificate-authority-data: "*****************************************=="
       server: https://10.16.XX.XX:6443
   users:
   - name: vnode
     user:
       token: ******.****************

   ServiceAccount

   apiVersion: v1
   kind: Config
   current-context: kubernetes-admin@kubernetes
   contexts:
   - name: kubernetes-admin@kubernetes
     context:
       cluster: kubernetes-admin@kubernetes
       user: vnode
       namespace: kube-system
   clusters:
   - name: kubernetes-admin@kubernetes
     cluster:
       certificate-authority-data: "*****************************************=="
       server: https://10.16.XX.XX:6443
   users:
   - name: vnode
     user:
       token: ***********************************************

Criar um VNode

Impedir o agendamento de DaemonSet para um VNode

Um VNode é um nó virtual e não pode executar DaemonSets. Após criar um VNode, adicione uma nodeAffinity ao DaemonSet kube-proxy para evitar que DaemonSets sejam agendados para o VNode.

1. Edite a configuração do DaemonSet.

   kubectl -n kube-system edit ds kube-proxy

2. Configure a nodeAffinity.

   Adicione o YAML a seguir em spec.template.spec:

   affinity:
     nodeAffinity:
       requiredDuringSchedulingIgnoredDuringExecution:
         nodeSelectorTerms:
         - matchExpressions:
           - key: type
             operator: NotIn
             values:
             - virtual-kubelet

Agendar pods para um VNode

Depois de criar um VNode, use os métodos a seguir para agendar pods para execução como instâncias ECI no VNode.

• Agendamento manual

  Agende pods manualmente para um VNode configurando nodeSelector e tolerations, ou especificando um nodeName. Para mais informações, consulte Agendar pods para um VNode.

• Agendamento automático

  Após implantar o componente eci-profile, configure um seletor personalizado para agendar automaticamente os pods correspondentes para o VNode. Para mais informações, consulte Usar eci-profile para agendar pods para um VNode.