WARNING: THIS SITE IS A MIRROR OF GITHUB.COM / IT CANNOT LOGIN OR REGISTER ACCOUNTS / THE CONTENTS ARE PROVIDED AS-IS / THIS SITE ASSUMES NO RESPONSIBILITY FOR ANY DISPLAYED CONTENT OR LINKS / IF YOU FOUND SOMETHING MAY NOT GOOD FOR EVERYONE, CONTACT ADMIN AT ilovescratch@foxmail.com
Skip to content

Limitation of more than 64 backend pods for a Single Service on Windows nodes needs to be removed from documentation #135518

@rabindra-harlalka

Description

@rabindra-harlalka

What happened?

https://kubernetes.io/docs/concepts/services-networking/windows-networking/#limitations states the following as one of the things not supported:

More than 64 backend pods (or unique destination addresses) for a single Service

The original trigger for this documentation is #98680 apparently, which led to microsoft/Windows-Containers#93. Comments in the latter issue say that the issue has been fixed with the limit increased to 1024. By now (3 years later), I believe the limitation has been fixed in Windows Server in both 2019 and 2022.

What did you expect to happen?

If the above is true, then can the limitation be removed from the documentation?

How can we reproduce it (as minimally and precisely as possible)?

Documentation needs update, no repro required.

Anything else we need to know?

FWIW, in my test with an Azure Kubernetes Service (AKS) cluster and a Windows Server 2022 node pool, I created a StatefulSet with 70 Windows pods behind a ClusterIP Service - didn't observe any issue on any of the Windows nodes.

Kubernetes version

$ kubectl version
Client Version: v1.29.7
Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3
Server Version: v1.33.3

Cloud provider

Azure

OS version

# On Linux:
$ cat /etc/os-release
PRETTY_NAME="Ubuntu 22.04.5 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.5 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=jammy
$ uname -a
Linux aks-default-58694455-vmss00000P 5.15.0-1098-azure #107-Ubuntu SMP Thu Oct 2 22:41:20 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux

# On Windows:
C:\> wmic os get Caption, Version, BuildNumber, OSArchitecture
BuildNumber  Caption                                   OSArchitecture  Version
20348        Microsoft Windows Server 2022 Datacenter  64-bit          10.0.20348

Install tools

Container runtime (CRI) and version (if applicable)

Related plugins (CNI, CSI, ...) and versions (if applicable)

Metadata

Metadata

Labels

kind/bugCategorizes issue or PR as related to a bug.needs-triageIndicates an issue or PR lacks a `triage/foo` label and requires one.sig/docsCategorizes an issue or PR as relevant to SIG Docs.sig/windowsCategorizes an issue or PR as relevant to SIG Windows.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions