AKS ARM模板如何根据OSType动态配置对应系统Profile

核心实现逻辑是用ARM模板原生的if()条件函数，根据OSType参数的取值决定对应Profile是否生效，非当前OS类型的Profile直接返回json('null')让ARM部署时忽略该字段，避免API校验报错。

具体修改步骤 #

• 移除原有写死的linuxProfile固定配置，改为条件表达式：仅当OSType参数值为Linux时返回Linux节点的管理员、SSH公钥配置，其余场景返回null
• 在linuxProfile同级位置新增windowsProfile字段，同样用条件表达式：仅当OSType参数值为Windows时返回Windows节点的管理员账号、密码配置，其余场景返回null
• （可选优化）为了避免json()函数内多层引号转义出错，可以提前把两种Profile的配置定义为模板变量，条件判断时直接引用变量即可

修改后的模板片段示例 #

变量定义（可选优化项） #

"variables": {
    "linuxProfileConfig": {
        "adminUsername": "adminUserName",
        "ssh": {
            "publicKeys": [
                {
                    "keyData": "keyData"
                }
            ]
        }
    },
    "windowsProfileConfig": {
        "adminUsername": "[parameters('windowsAdminUsername')]",
        "adminPassword": "[parameters('windowsAdminPassword')]"
    }
}

集群资源Properties段配置 #

"name": "[parameters('AKSClustername')]",
"type": "Microsoft.ContainerService/managedClusters",
"apiVersion": "2021-05-01",
"location": "[parameters('Region')]",
"properties": {
    "kubernetesVersion": "[parameters('kubernetesversion')]",
    "dnsPrefix": "dnsprefix",
    "agentPoolProfiles": [
        {
            "name": "[parameters('agentPoolName')]",
            "count": "[parameters('nodeCount')]",
            "vmSize": "[parameters('vmSize')]",
            "osType": "[parameters('OSType')]",
            "storageProfile": "ManagedDisks",
            "enableAutoScaling": "[parameters('autoscalepools')]",
            "availabilityZones": "[if(equals(parameters('availabilityZones'), or('1', '2', '3')), variables('AVZone'), json('null'))]"
        }
    ],
    "linuxProfile": "[if(equals(parameters('OSType'), 'Linux'), variables('linuxProfileConfig'), json('null'))]",
    "windowsProfile": "[if(equals(parameters('OSType'), 'Windows'), variables('windowsProfileConfig'), json('null'))]",

注意事项 #

• OSType参数建议设置枚举允许值，仅保留Linux、Windows两个可选值，避免非法参数导致判断失效
• 禁止同时给linuxProfile和windowsProfile传入非空配置，AKS API不支持双OS Profile同时存在，会直接触发部署校验错误
• Windows节点管理员密码需满足Azure Windows VM密码复杂度要求：长度8-123位，需同时包含大小写字母、数字、特殊字符中的至少三类，建议通过Key Vault引用传入密码，不要硬编码在模板中

内容的提问来源于stack exchange，提问作者Alok Maheshwari