Windows Server 2025 Image Building Fails in tkg 2.5
search cancel

Windows Server 2025 Image Building Fails in tkg 2.5

book

Article ID: 446261

calendar_today

Updated On:

Products

VMware Tanzu Kubernetes Grid Management

Issue/Introduction

  • When attempting to generate a custom virtual machine node image (OVA) for a Microsoft Windows worker node pool inside TKG 2.5, the build pipeline fails during compilation.
  • Executing the containerized toolset command parameters crashes or bypasses target compilation entirely because the build targets are missing from the configuration matrix.

Environment

TKG: 2.5.4

Cause

  • Missing orchestration recipes, Makefile targets, and configuration answer templates for Windows Server 2025 within the image-builder container workspace layer.

Resolution

  • Terminate all image-builder executions for Windows Server 2025 because this operating system version cannot be built using current TKG 2.5 container utilities; instead, select and deploy a supported operating system baseline, utilizing Windows Server 2019 if deploying standalone TKGm clusters.
  • The supported operating systems can be found in the release notes of TKG 2.5.x:
    VMware Tanzu Kubernetes Grid v2.5.x Release Notes 

Additional Information

For explicit operational prerequisites and validation parameters, see TKG 2.5 Custom Machine Image Guidelines.