[Aks] Make ACL tests true 1:1 mirrors; user-facing ChangeLog

- Test-OSSku-AzureContainerLinux: full mirror of Test-OSSku — restored
  the Windows2022 second node pool and all asserts. Only deltas:
  Mariner -> AzureContainerLinux, standard_a2_v2 -> Standard_D2s_v5
  (AzureContainerLinux requires a Trusted Launch capable VM size).
- Test_AKS_AzureContainerLinux: full mirror of Test_AKS_CRUD — restored
  the autoscaling/update step, Windows2022 second pool, labels/tags
  update step. Only deltas: AzureLinux -> AzureContainerLinux,
  Standard_D2_v3 -> Standard_D2s_v5 on the ACL system pool.
- ChangeLog: drop dev/process bullets (build verification, test
  scaffolding); keep user-facing functionality + spec it ships against.

Author: aadhar-agarwal

src/Aks/Aks.Test/ScenarioTests/KubernetesTests.ps1

@@ -452,7 +452,7 @@ function Test-OSSku-AzureContainerLinux
     $resourceGroupName = Get-RandomResourceGroupName
     $kubeClusterName = Get-RandomClusterName
     $location = 'eastus'
-    $nodeVmSize = "standard_a2_v2"
+    $nodeVmSize = "Standard_D2s_v5"
 
     try
     {
@@ -464,10 +464,20 @@ function Test-OSSku-AzureContainerLinux
         Assert-AreEqual 'Linux' $cluster.AgentPoolProfiles.OsType
         Assert-AreEqual 'AzureContainerLinux' $cluster.AgentPoolProfiles.OsSKU
 
-        New-AzAksNodePool -ResourceGroupName $resourceGroupName -ClusterName $kubeClusterName -Name "aclpool" -OsSKU "AzureContainerLinux" -Count 1 -VmSetType VirtualMachineScaleSets
+        New-AzAksNodePool -ResourceGroupName $resourceGroupName -ClusterName $kubeClusterName -Name "pool2" -OsType "Windows" -OsSKU "Windows2022" -Count 1 -VmSetType VirtualMachineScaleSets
         $pools = Get-AzAksNodePool -ResourceGroupName $resourceGroupName -ClusterName $kubeClusterName
         Assert-AreEqual 2 $pools.Count
-        Assert-AreEqualArray "AzureContainerLinux" ($pools | where {$_.Name -eq "aclpool"}).OsSKU
+        Assert-AreEqualArray "Linux" ($pools | where {$_.Name -eq "default"}).OsType
+        Assert-AreEqualArray "AzureContainerLinux" ($pools | where {$_.Name -eq "default"}).OsSKU
+        Assert-AreEqualArray "Windows" ($pools | where {$_.Name -eq "pool2"}).OsType
+        Assert-AreEqualArray "Windows2022" ($pools | where {$_.Name -eq "pool2"}).OsSKU
+
+        $cluster = Get-AzAksCluster -ResourceGroupName $resourceGroupName -Name $kubeClusterName
+        Assert-AreEqual 2 $cluster.AgentPoolProfiles.Count
+        Assert-AreEqualArray "Linux" ($cluster.AgentPoolProfiles | where {$_.Name -eq "default"}).OsType
+        Assert-AreEqualArray "AzureContainerLinux" ($cluster.AgentPoolProfiles | where {$_.Name -eq "default"}).OsSKU
+        Assert-AreEqualArray "Windows" ($cluster.AgentPoolProfiles | where {$_.Name -eq "pool2"}).OsType
+        Assert-AreEqualArray "Windows2022" ($cluster.AgentPoolProfiles | where {$_.Name -eq "pool2"}).OsSKU
 
         $cluster | Remove-AzAksCluster -Force
     }

src/Aks/Aks/ChangeLog.md

@@ -20,10 +20,8 @@
 ## Upcoming Release
 * Added ChangeSafety Support
 * Added support for `AzureContainerLinux` OS SKU in `New-AzAksCluster` (`-NodeOsSKU`) and `New-AzAksNodePool` (`-OsSKU`)
-    - Verified the hand-written cmdlets compile cleanly against the regenerated SDK
-    - Added a `LiveOnly` scenario test (`Test-OSSku-AzureContainerLinux`) and help examples for both cmdlets
-    - Added a `Test_AKS_AzureContainerLinux` live test scenario mirroring `Test_AKS_CRUD`
-* Regenerated `Aks.Management.Sdk` against `Microsoft.ContainerService/aks/stable/2026-03-01`
+    - Azure Container Linux is a container-optimized, immutable Linux OS for AKS node images. See https://aka.ms/azurecontainerlinux
+* Bumped API version to 2026-03-01
 
 ## Version 7.1.2
 * Set `useAADAuth` to `true` by default in the omsagent addon profile when enabling the Monitoring addon via `Enable-AzAksAddOn` and `New-AzAksCluster`

src/Aks/LiveTests/Aks/TestLiveScenarios.ps1

@@ -178,7 +178,7 @@ Invoke-LiveTestScenario -Name "Test_AKS_CRUD" -Description "Test AKS cluster CRU
     Assert-Null $cluster
 }
 
-Invoke-LiveTestScenario -Name "Test_AKS_AzureContainerLinux" -Description "Test AKS cluster and node pool create with AzureContainerLinux OS SKU" -Platform Linux -PowerShellVersion Latest -ScenarioScript `
+Invoke-LiveTestScenario -Name "Test_AKS_AzureContainerLinux" -Description "Test AKS cluster CRUD and node pool CRU with AzureContainerLinux system pool" -Platform Linux -PowerShellVersion Latest -ScenarioScript `
 {
     param ($rg)
 
@@ -187,13 +187,14 @@ Invoke-LiveTestScenario -Name "Test_AKS_AzureContainerLinux" -Description "Test
 
     $kubeName = New-LiveTestResourceName
     $sysNodeName = New-LiveTestRandomName -Option StartWithLetter -MaxLength 5
-    $aclNodeName = New-LiveTestRandomName -Option StartWithLetter -MaxLength 5
+    $usrNodeName = New-LiveTestRandomName -Option StartWithLetter -MaxLength 5
 
     $vnetName = New-LiveTestResourceName
     $snetName = New-LiveTestResourceName
     $nsgName = New-LiveTestResourceName
     $pipName = New-LiveTestResourceName
 
+    # step 1: create an aks cluster with a node pool
     'y' | ssh-keygen -t rsa -f id_rsa -q -N '"123456"'
     $sshKeyValue = Get-Content id_rsa.pub -Raw
 
@@ -217,54 +218,136 @@ Invoke-LiveTestScenario -Name "Test_AKS_AzureContainerLinux" -Description "Test
 
     $kubeVersion = (Get-AzAksVersion -Location $location).OrchestratorVersion | Sort-Object -Descending | Select-Object -Skip 2 -First 1
 
-    Write-Host "##[section]Start creating AKS cluster with AzureContainerLinux : New-AzAksCluster"
+    Write-Host "##[section]Start creating AKS cluster : New-AzAksCluster"
 
-    New-AzAksCluster -ResourceGroupName $rgName -Name $kubeName -Location $location -SshKeyValue $sshKeyValue -ServicePrincipalIdAndSecret $servicePrincipalCredential -KubernetesVersion $kubeVersion -NodeName $sysNodeName -NodePoolMode System -NodeOsSKU AzureContainerLinux -NodeVmSize Standard_D2s_v5 -NodeCount 2 -NetworkPlugin azure -NodeVnetSubnetID $snet.Id -LoadBalancerOutboundIp $pip.Id
+    New-AzAksCluster -ResourceGroupName $rgName -Name $kubeName -Location $location -SshKeyValue $sshKeyValue -ServicePrincipalIdAndSecret $servicePrincipalCredential -KubernetesVersion $kubeVersion -NodeName $sysNodeName -NodePoolMode System -NodeOsSKU AzureContainerLinux -NodeVmSize Standard_D2s_v5 -AutoUpgradeChannel node-image -NodeCount 2 -EnableNodeAutoScaling -NodeMinCount 1 -NodeMaxCount 3 -NetworkPlugin azure -NodeVnetSubnetID $snet.Id -LoadBalancerOutboundIp $pip.Id
 
-    Write-Host "##[section]Finished creating AKS cluster with AzureContainerLinux : New-AzAksCluster"
+    Write-Host "##[section]Finished creating AKS cluster : New-AzAksCluster"
 
     $cluster = Get-AzAksCluster -ResourceGroupName $rgName -Name $kubeName
 
     Assert-NotNull $cluster
+    Assert-NotNull $cluster.NodeResourceGroup
     Assert-AreEqual $rgName $cluster.ResourceGroupName
     Assert-AreEqual $kubeName $cluster.Name
+    Assert-AreEqual $kubeVersion $cluster.KubernetesVersion
     Assert-AreEqual "Succeeded" $cluster.ProvisioningState
+    Assert-AreEqual "node-image" $cluster.AutoUpgradeProfile.UpgradeChannel
 
     $agentPool = $cluster.AgentPoolProfiles
 
     Assert-NotNull $agentPool
     Assert-AreEqual 1 @($agentPool).Length
     Assert-AreEqual $sysNodeName $agentPool.Name
+    Assert-AreEqual $kubeVersion $agentPool.OrchestratorVersion
     Assert-AreEqual "Linux" $agentPool.OsType
     Assert-AreEqual "AzureContainerLinux" $agentPool.OsSKU
     Assert-AreEqual "System" $agentPool.Mode
+    Assert-AreEqual "VirtualMachineScaleSets" $agentPool.Type
+    Assert-AreEqual $snet.Id $agentPool.VnetSubnetID
     Assert-AreEqual "Succeeded" $agentPool.ProvisioningState
+    Assert-AreEqual "True" $agentPool.EnableAutoScaling
 
     $nodePool = Get-AzAksNodePool -ResourceGroupName $rgName -ClusterName $kubeName
 
     Assert-NotNull $nodePool
     Assert-AreEqual 1 @($nodePool).Length
+    Assert-AreEqual $sysNodeName $nodePool.Name
+    Assert-AreEqual $kubeVersion $nodePool.OrchestratorVersion
     Assert-AreEqual "Linux" $nodePool.OsType
     Assert-AreEqual "AzureContainerLinux" $nodePool.OsSKU
+    Assert-AreEqual "System" $nodePool.Mode
+    Assert-AreEqual "VirtualMachineScaleSets" $nodePool.AgentPoolType
+    Assert-AreEqual $snet.Id $nodePool.VnetSubnetID
+    Assert-AreEqual "Succeeded" $nodePool.ProvisioningState
+    Assert-AreEqual "True" $nodePool.EnableAutoScaling
+
+    # step 2: update the aks cluster
+    Write-Host "##[section]Start to update AKS cluster : Set-AzAksCluster"
+
+    $cluster = $cluster | Set-AzAksCluster -NodeName $sysNodeName -NodeCount 4 -EnableNodeAutoScaling:$false
+
+    Write-Host "##[section]Finished updating AKS cluster : Set-AzAksCluster"
+
+    Assert-NotNull $cluster
+    Assert-AreEqual "False" $cluster.AgentPoolProfiles.EnableAutoScaling
+    Assert-AreEqual 4 $($cluster.AgentPoolProfiles).Count
+
+    # step 3: create the second node pool
+    Write-Host "##[section]Start to create AKS node pool : New-AzAksNodePool"
+
+    New-AzAksNodePool -ResourceGroupName $rgName -ClusterName $kubeName -Name $usrNodeName -Mode User -OsType Windows -OsSKU Windows2022 -VmSize Standard_D2s_v3 -VmSetType VirtualMachineScaleSets -Count 2
+
+    Write-Host "##[section]Finished creating AKS node pool : New-AzAksNodePool"
+
+    $nodePools = Get-AzAksNodePool -ResourceGroupName $rgName -ClusterName $kubeName
+    $sysPool = $nodePools | Where-Object Name -eq $sysNodeName
+    $usrPool = $nodePools | Where-Object Name -eq $usrNodeName
+
+    Assert-NotNull $nodePools
+    Assert-AreEqual 2 @($nodePools).Length
+
+    Assert-NotNull $sysPool
+    Assert-AreEqual $sysNodeName $sysPool.Name
+    Assert-AreEqual "System" $sysPool.Mode
+    Assert-AreEqual "Linux" $sysPool.OsType
+    Assert-AreEqual "AzureContainerLinux" $sysPool.OsSKU
+
+    Assert-NotNull $usrPool
+    Assert-AreEqual $usrNodeName $usrPool.Name
+    Assert-AreEqual "User" $usrPool.Mode
+    Assert-AreEqual "Windows" $usrPool.OsType
+    Assert-AreEqual "Windows2022" $usrPool.OsSKU
+
+    # step4: update the second node pool
+    $labels = @{"someId" = 127; "tier" = "frontend"; "environment" = "qa" }
+    $tags = @{"dept" = "MM"; "costcenter" = 7777; "Admin" = "Cindy" }
+
+    Write-Host "##[section]Start to update Aks node pool : Update-AzAksNodePool"
+
+    Update-AzAksNodePool -ResourceGroupName $rgName -ClusterName $kubeName -Name $usrNodeName -NodeLabel $labels -Tag $tags
 
-    Write-Host "##[section]Start to create AKS node pool with AzureContainerLinux : New-AzAksNodePool"
+    Write-Host "##[section]Finished updating Aks node pool : Update-AzAksNodePool"
 
-    New-AzAksNodePool -ResourceGroupName $rgName -ClusterName $kubeName -Name $aclNodeName -Mode User -OsType Linux -OsSKU AzureContainerLinux -VmSize Standard_D2s_v5 -VmSetType VirtualMachineScaleSets -Count 1
+    $cluster = Get-AzAksCluster -ResourceGroupName $rgName -Name $kubeName
+    $sysPool = $cluster.AgentPoolProfiles | Where-Object Name -eq $sysNodeName
+    $usrPool = $cluster.AgentPoolProfiles | Where-Object Name -eq $usrNodeName
 
-    Write-Host "##[section]Finished creating AKS node pool with AzureContainerLinux : New-AzAksNodePool"
+    Assert-NotNull $cluster
+    Assert-AreEqual 2 @($cluster.AgentPoolProfiles).Length
+
+    Assert-NotNull $sysPool
+    Assert-Null $sysPool.NodeLabels
+    Assert-Null $sysPool.Tags
+
+    Assert-NotNull $usrPool
+    Assert-AreEqual 127 $usrPool.NodeLabels.someId
+    Assert-AreEqual "frontend" $usrPool.NodeLabels.tier
+    Assert-AreEqual "qa" $usrPool.NodeLabels.environment
+    Assert-AreEqual "MM" $usrPool.Tags.dept
+    Assert-AreEqual 7777 $usrPool.Tags.costcenter
+    Assert-AreEqual "Cindy" $usrPool.Tags.Admin
 
     $nodePools = Get-AzAksNodePool -ResourceGroupName $rgName -ClusterName $kubeName
-    $aclPool = $nodePools | Where-Object Name -eq $aclNodeName
+    $sysPool = $nodePools | Where-Object Name -eq $sysNodeName
+    $usrPool = $nodePools | Where-Object Name -eq $usrNodeName
 
     Assert-NotNull $nodePools
     Assert-AreEqual 2 @($nodePools).Length
 
-    Assert-NotNull $aclPool
-    Assert-AreEqual $aclNodeName $aclPool.Name
-    Assert-AreEqual "User" $aclPool.Mode
-    Assert-AreEqual "Linux" $aclPool.OsType
-    Assert-AreEqual "AzureContainerLinux" $aclPool.OsSKU
+    Assert-NotNull $sysPool
+    Assert-AreEqual $sysPool.NodeLabels
+    Assert-AreEqual $sysPool.Tags
 
+    Assert-NotNull $usrPool
+    Assert-AreEqual 127 $usrPool.NodeLabels.someId
+    Assert-AreEqual "frontend" $usrPool.NodeLabels.tier
+    Assert-AreEqual "qa" $usrPool.NodeLabels.environment
+    Assert-AreEqual "MM" $usrPool.Tags.dept
+    Assert-AreEqual 7777 $usrPool.Tags.costcenter
+    Assert-AreEqual "Cindy" $usrPool.Tags.Admin
+
+    # step 5: remove the AKS cluster
     Write-Host "##[section]Start to remove Aks cluster : Remove-AzAksCluster"
 
     $cluster | Remove-AzAksCluster -Force