Развертывание расширения для кластеров Kubernetes с поддержкой MetalLB для Azure Arc с помощью Azure CLI

Применяется для: AKS на Azure Local

Основной целью подсистемы балансировки нагрузки является распределение трафика между несколькими узлами в кластере Kubernetes. Это может помочь предотвратить простои и повысить общую производительность приложений. AKS, включенный Azure Arc, поддерживает создание экземпляра подсистемы балансировки нагрузки MetalLB в кластере Kubernetes с помощью расширения Arc.

Необходимые компоненты

• Кластер Kubernetes с поддержкой Azure Arc с хотя бы одним узлом Linux. You can create a Kubernetes cluster on Azure Local using the Azure CLI or the Azure portal. AKS в локальных кластерах Azure по умолчанию включен Arc.
• Убедитесь, что у вас достаточно IP-адресов для подсистемы балансировки нагрузки. For AKS on Azure Local, ensure that the IP addresses reserved for the load balancer do not conflict with the IP addresses in Arc VM logical networks and control plane IPs. Дополнительные сведения о планировании IP-адресов и сети в Kubernetes см. в разделе "Требования к сети" для Kubernetes и планирования IP-адресов для Kubernetes.
• В этом руководстве предполагается, что вы понимаете, как работает металлическая подсистема балансировки нагрузки. Дополнительные сведения см. в обзоре MetalLB для Kubernetes.

Установка расширения Azure CLI

Выполните следующую команду, чтобы установить необходимое расширение Azure CLI:

az extension add -n k8s-runtime --upgrade

Включение расширения Arc для MetalLB

Настройте следующие переменные перед продолжением.

Вариант 1. Включение расширения Arc для MetalLB с помощью az k8s-runtime load-balancer enable команды

Чтобы включить расширение Arc для MetalLB с помощью следующей команды, необходимо иметь разрешение Graph Application.Read.All. Вы можете проверить, есть ли у вас это разрешение, войдите в подписку Azure и выполните следующую команду:

`az ad sp list --filter "appId eq '087fca6e-4606-4d41-b3f6-5ebdf75b8b4c'" --output json`

Если команда завершается ошибкой, обратитесь к администратору вашего арендатора в Azure, чтобы вам назначили роль Application.Read.All.

Если у вас есть разрешение, можно использовать az k8s-runtime load-balancer enable команду для установки расширения Arc и регистрации поставщика ресурсов для кластера Kubernetes. Параметр --resource-uri ссылается на идентификатор диспетчера ресурсов кластера Kubernetes.

az k8s-runtime load-balancer enable --resource-uri subscriptions/$subId/resourceGroups/$rgName/providers/Microsoft.Kubernetes/connectedClusters/$clusterName

Вариант 2. Включение расширения Arc для MetalLB с помощью az k8s-extension add команды

Если у вас нет разрешения Graph Application.Read.All, выполните следующие действия:

1. Зарегистрируйте Microsoft.KubernetesRuntime RP, если вы еще не сделали этого. Обратите внимание, что необходимо зарегистрировать только один раз на подписку Azure. Вы также можете зарегистрировать поставщиков ресурсов с помощью портал Azure. Дополнительные сведения о регистрации поставщиков ресурсов и необходимых разрешений см. в статье о регистрации поставщика ресурсов.

az provider register -n Microsoft.KubernetesRuntime

Вы можете проверить, успешно ли зарегистрирован поставщик ресурсов, выполнив следующую команду.

az provider show -n Microsoft.KubernetesRuntime -o table

Ожидаемые выходные данные:

Namespace                    RegistrationPolicy    RegistrationState
---------------------------  --------------------  -------------------
Microsoft.KubernetesRuntime  RegistrationRequired  Registered

2. Чтобы установить расширение Arc для MetalLB, получите идентификатор AppID поставщика ресурсов расширения MetalLB, а затем выполните команду создания расширения. Для каждого кластера Arc Kubernetes необходимо выполнить следующие команды.

Получите идентификатор приложения расширения Arc, выполнив az ad sp list. Чтобы выполнить следующую команду, необходимо быть user членом клиента Azure. Дополнительные сведения о членстве пользователей и гостей см. в разделе "Разрешения пользователей по умолчанию" в идентификаторе Microsoft Entra.

$objID = az ad sp list --filter "appId eq '00001111-aaaa-2222-bbbb-3333cccc4444'" --query "[].id" --output tsv

Как только у вас будет $objID, вы можете установить расширение MetalLB Arc в кластере Kubernetes. Чтобы выполнить приведенную ниже команду, необходимо иметь роль участника расширения Kubernetes.

az k8s-extension create --cluster-name $clusterName -g $rgName --cluster-type connectedClusters --extension-type microsoft.arcnetworking --config k8sRuntimeFpaObjectId=$objID -n arcnetworking

Развертывание подсистемы балансировки нагрузки MetalLB в кластере Kubernetes

Теперь вы можете создать подсистему балансировки нагрузки для кластера Kubernetes удаленно, выполнив az k8s-runtime load-balancer create команду. Эта команда создает настраиваемый ресурс типа IPAddressPool в пространстве имен kube-system.

Настройте следующие переменные перед продолжением.

Если режим объявления - BGP или Both, он также создает пользовательский ресурс типа BGPAdvertisement. Если режим объявления имеет ARP или Both, он также создает настраиваемый ресурс типа L2Advertisement:

az k8s-runtime load-balancer create --load-balancer-name $lbName --resource-uri subscriptions/$subId/resourceGroups/$rgName/providers/Microsoft.Kubernetes/connectedClusters/$clusterName --addresses $ipRange --advertise-mode $advertiseMode

Создание однорангового узла BGP для кластера Kubernetes

Создайте одноранговый узел BGP для кластера Kubernetes удаленно, выполнив az k8s-runtime bgp-peer create команду. Обратите внимание, что одноранговый узел BGP действует для всех подсистем балансировки нагрузки, имеющих BGP или Both объявляющих режим. При использовании подсистемы балансировки нагрузки MetalLB в режиме BGP или в Both режиме создание одноранговых узлов BGP является обязательным.

Настройте следующие переменные перед продолжением.

az k8s-runtime bgp-peer create --bgp-peer-name $peerName --resource-uri subscriptions/$subId/resourceGroups/$rgName/providers/Microsoft.Kubernetes/connectedClusters/$clusterName --my-asn $myASN --peer-asn $peerASN --peer-address $peerIP

Следующие шаги

• Использование расширения GitOps Flux версии 2 Arc для развертывания приложений в кластере Kubernetes