Implementación del complemento de interfaz de red de contenedor de Azure Virtual Network

Artículo
12/11/2023

El complemento de interfaz de red de contenedor (CNI) de Azure Virtual Network se instala en una máquina virtual de Azure y ofrece funcionalidades de red virtual a los pods de Kubernetes y los contenedores de Docker. Para más información sobre el complemento, consulte Enable containers to use Azure Virtual Network capabilities (Habilitación de contenedores para que puedan usar las funcionalidades de Azure Virtual Network). Además, el complemento se puede usar con Azure Kubernetes Service (AKS); para ello, elija la opción Advanced Networking (Redes avanzadas), que coloca automáticamente los contenedores de AKS en una red virtual.

Implementar el complemento para el clúster de Azure Container Service-Engine

Azure Container Service-Engine implementa un clúster de Kubernetes con una plantilla de Azure Resource Manager. La configuración del clúster se especifica en un archivo JSON que se pasa a la herramienta al generar la plantilla. Para ver la lista completa de las configuraciones de clúster compatibles y sus descripciones, consulte Microsoft Azure Container Service Engine - definición de clúster (Motor de Microsoft Azure Container Service: definiciones de clúster). Este es el complemento de red predeterminado para los clústeres creados con Azure Container Service-Engine. Las siguientes opciones de configuración de red son importantes a la hora de configurar el complemento:

Configuración	Descripción
firstConsecutiveStaticIP	Dirección IP que se asigna al nodo principal. Esta configuración es obligatoria.
clusterSubnet en kubernetesConfig	CIDR de la subred de red virtual donde se implementa el clúster y desde la cuál se asignan las direcciones IP a los pods.
vnetSubnetId en masterProfile	Especifica el identificador de recurso de Azure Resource Manager de la subred en la que el clúster se va a implementar.
vnetCidr	CIDR de la red virtual en la que se va a implementar el clúster.
max-Pods en kubeletConfig	Número máximo de pods en cada máquina virtual de agente. Para el complemento, el valor predeterminado es 30. Puede especificar hasta 250.

Ejemplo de configuración

El siguiente ejemplo JSON es para un clúster con las siguientes propiedades:

Un nodo principal y dos nodos de agente
Se implementa en una subred llamada KubeClusterSubnet (10.0.0.0/20) y los nodos principal y de agente residen en ella.

{
  "apiVersion": "vlabs",
  "properties": {
    "orchestratorProfile": {
      "orchestratorType": "Kubernetes",
      "kubernetesConfig": {
        "clusterSubnet": "10.0.0.0/20" --> Subnet allocated for the cluster
      }
    },
    "masterProfile": {
      "count": 1,
      "dnsPrefix": "ACSKubeMaster",
      "vmSize": "Standard_A2",
      "vnetSubnetId": "/subscriptions/<subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.Network/virtualNetworks/<Vnet Name>/subnets/KubeClusterSubnet",
      "firstConsecutiveStaticIP": "10.0.1.50", --> IP address allocated to the Master node
      "vnetCidr": "10.0.0.0/16" --> Virtual network address space
    },
    "agentPoolProfiles": [
      {
        "name": "k8sagentpoo1",
        "count": 2,
        "vmSize": "Standard_A2_v2",
"vnetSubnetId": "/subscriptions/<subscription ID>/resourceGroups/<Resource Group Name>/providers/Microsoft.Network/virtualNetworks/<VNet Name>/subnets/KubeClusterSubnet",
        "availabilityProfile": "AvailabilitySet"
      }
    ],
    "linuxProfile": {
      "adminUsername": "KubeServerAdmin",
      "ssh": {
        "publicKeys": [
          {…}
        ]
      }
    },
    "servicePrincipalProfile": {
      "clientId": "00001111-aaaa-2222-bbbb-3333cccc4444",
      "secret": "azure123"
    }
  }
}

Implementación del complemento para un clúster de Kubernetes

Complete los pasos siguientes para instalar el complemento en cada máquina virtual de Azure en un clúster de Kubernetes:

Descarga e instalación del complemento
Asigne previamente un grupo de direcciones IP de red virtual a cada máquina virtual desde la cual se asignan las direcciones IP a los pods. Cada máquina virtual de Azure viene con una dirección IP privada de red virtual principal en cada interfaz de red. Las direcciones IP del grupo se agregan como direcciones secundarias (ipconfigs) en la interfaz de red de la máquina virtual, con una de las siguientes opciones:
- CLI: asignación de varias direcciones IP mediante la CLI de Azure
- PowerShell: asignación de varias direcciones IP mediante PowerShell
- Portal: asignación de varias direcciones IP mediante Azure Portal
- Plantilla de Azure Resource Manager: asignación de varias direcciones IP mediante plantillas
Asegúrese de agregar suficientes direcciones IP para todos los pods que se espera que aparezcan en la máquina virtual.
Seleccione el complemento para proporcionar conexión de red al clúster; para ello, pase al kubelet la opción de línea de comandos –network-plugin=cni durante la creación del clúster. De forma predeterminada, Kubernetes busca el complemento y el archivo de configuración en los directorios donde ya están instalados.
Si desea que los pods tengan acceso a Internet, agregue la siguiente regla iptables en las máquinas virtuales Linux para aplicar NAT de origen al tráfico de Internet. En el ejemplo siguiente, el intervalo IP especificado es 10.0.0.0/8.
```
iptables -t nat -A POSTROUTING -m iprange ! --dst-range 168.63.129.16 -m
addrtype ! --dst-type local ! -d 10.0.0.0/8 -j MASQUERADE
```
La regla aplica NAT al tráfico que no está destinado a los intervalos IP especificados. Se da por hecho que todo el tráfico fuera de los intervalos anteriores es tráfico de Internet. Puede elegir especificar los intervalos IP de la red virtual de la máquina virtual, los de la red virtual emparejada y los de las redes locales.

Las máquinas virtuales Windows aplican NAT automáticamente al tráfico cuyo destino está fuera de la subred a la que pertenece la máquina virtual. No es posible especificar intervalos IP personalizados.

Después de completar los pasos anteriores, a los pods que aparecen en las máquinas virtuales de agente de Kubernetes se les asignan automáticamente direcciones IP privadas de la red virtual.

Implementación del complemento para contenedores de Docker

Descarga e instalación del complemento

Cree contenedores de Docker con el siguiente comando:

./docker-run.sh \<container-name\> \<container-namespace\> \<image\>

Los contenedores comienzan a recibir automáticamente las direcciones IP del grupo asignado. Si desea equilibrar la carga del tráfico en los contenedores Docker, debe colocarlos detrás de un equilibrador de carga de software con un sondeo de equilibrador de carga.

Archivo de configuración de red de CNI

El archivo de configuración de red de CNI se describe en formato JSON. De forma predeterminada, se encuentra en /etc/cni/net.d para Linux y c:\cni\netconf para Windows. El archivo especifica la configuración del complemento y es diferente para Windows y Linux. El código JSON siguiente es un archivo de configuración de Linux de ejemplo, seguido de una explicación de algunas de las opciones de configuración clave. No es necesario hacer ningún cambio en el archivo:

{
	   "cniVersion":"0.3.0",
	   "name":"azure",
	   "plugins":[
	      {
	         "type":"azure-vnet",
	         "mode":"bridge",
	         "bridge":"azure0",
	         "ipam":{
	            "type":"azure-vnet-ipam"
	         }
	      },
	      {
	         "type":"portmap",
	         "capabilities":{
	            "portMappings":true
	         },
	         "snat":true
	      }
	   ]
}

Explicación de las opciones de configuración

"cniVersion": los complementos de CNI de Azure Virtual Network son compatibles con las versiones 0.3.0 y 0.3.1 de la especificación CNI.
"name": nombre de la red. Esta propiedad se puede establecer en un valor único.
"type": nombre del complemento de red. Se establece en azure-vnet.
"mode": modo de funcionamiento. Este campo es opcional. El único modo admitido es "bridge". Para más información, consulte los modos de funcionamiento.
"bridge": nombre del puente que se usa para conectar los contenedores a una red virtual. Este campo es opcional. Si se omite, el complemento elige automáticamente un nombre único, basado en el índice de la interfaz principal.
"ipam" - "type": nombre del complemento de IPAM. Siempre se establece en azure-vnet-ipam.

Descarga e instalación del complemento

Descargue el complemento de GitHub. Descargue la versión más reciente para la plataforma que esté usando:

Linux: azure-vnet-cni-linux-amd64-<n.º versión>.tgz
Windows: azure-vnet-cni-windows-amd64-<n.º versión>.zip

Copie el script de instalación para Linux o Windows en su equipo. Guarde el script en un directorio scripts del equipo y asigne al archivo el nombre install-cni-plugin.sh para Linux o install-cni-plugin.ps1 para Windows.

Para instalar el complemento, ejecute el script adecuado para su plataforma y especifique la versión del complemento que está usando. Por ejemplo, podría especificar v1.4.20. Para la instalación de Linux, proporcione una versión de complemento de CNI adecuada, como v1.0.1:

scripts/install-cni-plugin.sh [azure-cni-plugin-version] [cni-plugin-version]

scripts\\ install-cni-plugin.ps1 [azure-cni-plugin-version]

El script instala el complemento en /opt/cni/bin para Linux y en c:\cni\bin para Windows. El complemento instalado incluye un archivo de configuración de red simple que funciona después de la instalación. No es necesario actualizarlo. Para más información sobre las opciones de configuración del archivo, consulte Archivo de configuración de red de CNI.

Compartir a través de