部署配置 JSON 参数

本页介绍 aksedge-config.json 中使用的 AKS 边缘软件包部署架构。

可以在 C:\Program Files\AksEdge\aksedge-dcschema.json 找到完整的 JSON 架构文件。

属性 值类型 说明 默认值 适用的部署类型
SchemaVersion 字符串 指定 JSON 架构/格式的版本。 1.9 单台计算机和完整部署
Version 1.0 指定 JSON 实例的版本。 1.0 单台计算机和完整部署
DeploymentType [SingleMachineCluster / ScalableCluster] 指定部署类型。 在 ScalableCluster 中,可以向群集基础结构添加更多计算机。 SingleMachineCluster 单台计算机和完整部署
Init.ServiceIPRangeStart IPv4 地址 A.B.C.x 为 Kubernetes 服务保留 IP 起始地址。 此 IP 范围必须在子网 A.B.C.0 上可用。 单台计算机和完整部署
Init.ServiceIPRangeSize [0-127] 为 Kubernetes 服务保留的 IP 起始地址数量。 基于该大小,我们会在你的子网上分配一系列空闲 IP 地址。 0 单台计算机和完整部署
Init.KmsPlugin.Enable 布尔值 指定是否启用 KMS 插件。 false 单台计算机和完整部署
Join.ClusterJoinToken 字符串 Reserved 仅限完整部署
Join.DiscoveryTokenHash 字符串 Reserved 仅限完整部署
Join.CertificateKey 字符串 Reserved 仅限完整部署
Join.ClusterId 字符串 Reserved 仅限完整部署
Arc.ClusterName 字符串 群集在 Azure 门户中显示的首选名称。 <Machinename>-cluster 单台计算机和完整部署
Arc.Location 字符串 资源组的位置。 单台计算机和完整部署
Arc.ResourceGroupName 字符串 资源组名称。 单台计算机和完整部署
Arc.SubscriptionId GUID Azure 订阅 ID。 单台计算机和完整部署
Arc.TenantId GUID Azure 订阅的 TenantID。 单台计算机和完整部署
Arc.ClientId GUID 服务主体的 AppID。 可以使用 Azure 门户上 Microsoft Entra 资源页面中的“应用注册”页,列出并管理租户中的服务主体。 单台计算机和完整部署
Arc.ClientSecret 字符串 与服务主体关联的机密。 单台计算机和完整部署
Network.ControlPlaneEndpointIp IPv4 地址 A.B.C.x 子网 A.B.C 上的空闲 IP 地址。控制平面(API 服务器)获取此地址。 仅限完整部署
Network.NetworkPlugin [calico / flannel] Kubernetes 网络模型的 CNI 插件选择。 对于 K8s 群集,始终使用 calico,对于 K3s 群集,始终使用 flannel flannel 单台计算机和完整部署
Network.Ip4GatewayAddress IPv4 地址 A.B.C.x 网关地址;通常为路由器地址。 仅限完整部署
Network.Ip4PrefixLength [1-31] IP 地址子网 A.B.C 的前缀长度。 例如,如果你的网络是 192.168.1.0/24,则使用 24 24 仅限完整部署
Network.Ip4AddressPrefix 子网掩码 A.B.C.0/24 单计算机部署中分配 IP 地址的子网。 例如,如果你指定 192.168.1.0/24,那么网关地址是 192.168.1.1,Linux 节点是 192.168.1.2,Windows 节点是 192.168.1.3,服务 IP 被分配为 192.168.1.4 及之后的地址。 此参数是可选的,你必须确保 IP 地址可供使用。 如果未指定此参数,AKS 边缘软件包将尽最大努力确定可用的 IP 地址。 仅单计算机部署
Network.DnsServers IPv4 地址 A.B.C.x 你的 DNS 的 IP 地址(通常为路由器地址)。 要查看你的计算机使用的 DNS,发出命令 Get-DnsClientServerAddress -AddressFamily IPv4 仅限完整部署
Network.InternetDisabled 布尔值 你的群集是否可以访问 Internet。 默认值为 false,这意味着你的群集默认可以访问 Internet。 false 单台计算机和完整部署
Network.SkipAddressFreeCheck 布尔值 忽略 IP 地址检查失败并继续部署。 false 完整部署
Network.SkipDnsCheck 布尔值 如果在 Network.DnsServers 参数中提供了 DNS 服务器,此标志将忽略 DNS 检查并继续部署。 false 单台计算机和完整部署
Network.Proxy.Http 字符串 HttpProxy 链接。 单台计算机和完整部署
Network.Proxy.Https 字符串 HttpsProxy 链接。 单台计算机和完整部署
Network.Proxy.No 字符串 无用于绕过代理的代理配置。 单台计算机和完整部署
User.AcceptEula 布尔值 接受或拒绝 EULA。 false 单台计算机和完整部署
User.AcceptOptionalTelemetry 布尔值 接受或拒绝 optional 遥测。 required 遥测始终启用。 false 单台计算机和完整部署
User.VolumeLicense.EnrollmentID 字符串 如果批量许可适用,请提供你的注册 ID。 单台计算机和完整部署
User.VolumeLicense.PartNumber 字符串 如果批量许可适用,请提供部件号。 单台计算机和完整部署
Machines[].ArcHybridComputeMachineId 字符串 Reserved null 单台计算机和完整部署
Machines[].NetworkConnection.AdapterName 字符串 适用于 VSwitch 的 NetAdapterName。 对于完整的 Kubernetes 部署,这是必需的。 可以运行 Get-NetAdapter -Physical 来查看所选适配器的 Name 列。 单台计算机和完整部署
Machines[].NetworkConnection.Mtu 数字 网络的最大传输单元 (MTU)。 0 单台计算机和完整部署
Machines[].LinuxNode.ControlPlane 布尔值 指定是否希望此新部署成为控制平面。 如果为 false,则是工作器节点。 仅适用于 Linux VM。 false 单台计算机和完整部署
Machines[].LinuxNode.CpuCount [2-x] 为 VM 保留的 CPU 核心数。 2 单台计算机和完整部署
Machines[].LinuxNode.MemoryInMB [2048-2x] 为 VM 保留的 RAM(以 MB 为单位)。 2048 单台计算机和完整部署
Machines[].LinuxNode.DataSizeInGB 数字 数据分区的大小。 对于大型应用程序,我们建议增加此大小。 仅适用于 Linux VM。 10 单台计算机和完整部署
Machines[].LinuxNode.LogSizeInGB 数字 日志分区的大小(以 GB 为单位)。 日志分区的最大大小上限为 10 GB,最小值和默认值为 1 GB。 仅在 Linux 节点上可用。 1 单台计算机和完整部署
Machines[].LinuxNode.Ip4Address A.B.C.x 指定 VM 的 IP 地址。 单台计算机和完整部署
Machines[].LinuxNode.MacAddress 00:00:00:00:00:00 指定 VM 使用的 MAC 地址。 单台计算机和完整部署
Machines[].LinuxNode.TimeoutSeconds 数字 为 Kubernetes 群集完成引导过程提供了超时时间。 建议你使用默认值。 300 单台计算机和完整部署
Machines[].LinuxNode.TpmPassthrough 布尔值 允许从 Linux 节点访问 TPM。 false 单台计算机和完整部署
Machines[].LinuxNode.SecondaryNetworks Array 指定要添加到 Linux 节点的辅助网络。 可以指定一个包含可选静态 IP 信息的 VMSwitchName 数组。 (Ip4Address,Ip4GatewayAddress and Ip4PrefixLength) null 单台计算机和完整部署
Machines[].WindowsNode.CpuCount [2-x] 为 VM 保留的 CPU 核心数。 2 单台计算机和完整部署
Machines[].WindowsNode.MemoryInMB [2048-2x] 为 VM 保留的 RAM(2 的倍数,以 MB 为单位)。 2048 单台计算机和完整部署
Machines[].WindowsNode.Ip4Address A.B.C.x 指定 VM 的 IP 地址。 单台计算机和完整部署
Machines[].WindowsNode.MacAddress 00:00:00:00:00:00 指定 VM 使用的 MAC 地址。 单台计算机和完整部署
Machines[].WindowsNode.TimeoutSeconds 数字 为 Kubernetes 群集完成引导过程提供了超时时间。 建议你使用默认值。 900 单台计算机和完整部署

后续步骤