虚拟化开发工具云原生【免费下载链接】multipassMultipass orchestrates virtual Ubuntu instances项目地址https://gitcode.com/gh_mirrors/mu/multipass点击查看免费下载本指南围绕 Multipass 提供的实例级设置键local.instance-name.cpus展开讲解如何通过multipass set在运行时调整指定虚拟机实例的 CPU 核数、该设置键的合法取值与默认行为并结合仓库源码揭示其在守护进程中的底层处理链路与各虚拟化后端的落地方式。读完本文你将掌握查看、修改实例 CPU 配置的正确姿势以及该设置键在 Multipass 内部如何被解析、校验和持久化。关联说明该设置键与get、set、launch三个命令行接口配合使用实例级设置的整体机制可参见 实例设置总览。Key 的完整形式与含义local.instance-name.cpus是 Multipass 的实例级设置键instance-level setting key其中local是 Multipass 守护进程设置daemon settings的根命名空间源码中由mp::daemon_settings_root常量承载见 src/daemon/instance_settings_handler.cppinstance-name是目标 Multipass 实例的名称例如handsome-ling、primary等cpus是实例属性后缀表示 CPU 核数。该键所对应的值代表虚拟机模拟出的 CPU 数量它从宿主机的角度规定了该实例「最多能同时使用多少个宿主机线程」。也就是说这是一个上限约束实例内可见的 vCPU 数量由该值决定实例内的应用在任意时刻可并发执行的线程不会超过这一数值。从源码结构看Multipass 的实例设置处理器将实例属性划分为cpus、memory、disk、bridged四类见 src/daemon/instance_settings_handler.cpp并通过正则表达式%1\.%2\.%3daemon_settings_root 实例名 属性名解析用户传入的键见 instance_settings_handler.cpp。键格式不合法时会抛出UnrecognizedSettingException而keys()方法则会为每个已注册实例动态生成形如local.实例名.cpus的完整键集合见 instance_settings_handler.cpp。Description该设置控制什么local.instance-name.cpus决定虚拟机上模拟的 CPU 数量。这个值对运行中的实例建立了一个硬性上限实例最多能同时使用多少个宿主机线程。值得强调的是这一设置与launch时通过--cpus指定的核数是同一套规格。在 Multipass 的守护进程内部无论是launch命令的--cpus参数还是set命令写入的cpus值最终都收敛到同一个VMSpecs::num_cores字段实例规格结构体。例如在 src/daemon/daemon.cpp 中launch创建实例时会校验vm_desc.num_cores是否小于mp::min_cpu_cores其值为1见 include/multipass/constants.h不满足则回退到默认值。Possible values合法取值与边界文档规定该键的取值为正整数Multipass 本身不设上限数值上不限制最大值但底层虚拟化后端可能施加各自的限制例如宿主机物理 CPU 核数、QEMU 后端可模拟的最大 vCPU 数、Hyper-V/Libvirt 的配额等实际可设置的范围以所用后端为准。在守护进程的实现中set操作会对值做一次前置校验见 instance_settings_handler.cpp 的update_cpus函数使用QString::toInt将字符串转换为整数转换失败非十进制整数即抛出InvalidSettingException校验转换后的值是否小于mp::min_cpu_cores即1小于 1 时抛出异常错误信息为 Need a positive integer (in decimal format) of minimum 1若新值与当前规格spec.num_cores相同则视为 NOOP直接放行但不触发任何修改。对应的单元测试覆盖了这些路径见 tests/unit/test_instance_settings_handler.cppsetIncreasesInstanceCPUs验证将 4 核提升到 6 核时update_cpus(6)被精确调用一次且规格同步更新setMaintainsInstanceCPUsUntouchedIfSameButSucceeds验证设置相同值42 → 42时不会调用update_cpus但操作仍然成功NOOP 语义setAllowsDecreaseInstanceCPUs验证将 3 核降为 2 核是被允许的与memory只能扩容不同CPU 核数可增可减。Examples命令行使用示例multipass set local.handsome-ling.cpus4该命令将名为handsome-ling的实例的 CPU 核数设置为 4。其他典型用法# 读取某个实例当前的 CPU 核数 multipass get local.handsome-ling.cpus # 设置后确认结果 multipass get local.handsome-ling.cpus # 输出4查看该设置键时InstanceSettingsHandler::get直接返回spec.num_cores的十进制字符串形式QString::number(spec.num_cores)见 instance_settings_handler.cpp因此get的返回值总是纯整数格式。修改的前提条件实例必须处于停止状态与memory、disk等运行时规格调整类似修改cpus键有一个重要前置条件目标实例必须处于stopped已停止或off已关闭状态。守护进程在InstanceSettingsHandler::set中会先调用check_state_for_update见 instance_settings_handler.cpp如果实例处于运行running或其他非停止状态会抛出InstanceStateSettingsException错误信息为 Instance must be stopped for modification。因此正确的操作顺序是# 1. 停止实例 multipass stop handsome-ling # 2. 修改 CPU 核数 multipass set local.handsome-ling.cpus4 # 3. 重新启动实例 multipass start handsome-ling此外set还会拒绝以下场景见 instance_settings_handler.cpp实例正在准备preparing过程中时抛出 instance is being prepared实例已被删除deleted时抛出 Instance is deleted 错误。修改成功后守护进程会调用instance_persister()将新的规格spec.num_cores持久化确保重启后设置依然生效。Default value默认值行为该设置键的默认值是实例启动时launch所配置的 CPU 核数。也就是说创建实例时若未显式指定--cpusMultipass 会使用平台默认值。从源码看mp::default_cpu_cores与mp::min_cpu_cores相同均为1见 include/multipass/constants.h即默认单核创建实例时若通过multipass launch --cpus N指定了核数则该值成为该实例的num_cores初始规格之后对local.instance-name.cpus的任何修改都会覆盖这一初始值并持久化保存。换句话说get返回的值始终是「实例当前生效的核数」——它可能来自 launch 时的初始配置也可能来自后续set的覆盖结果。底层实现从设置键到后端动作为了让读者对该设置键有更立体的认知下面梳理它在 Multipass 内部的完整链路。1. 键解析与路由InstanceSettingsHandler::set先通过parse_key把local.instance-name.cpus拆解为「实例名 属性名」然后根据属性名分派到update_cpus见 instance_settings_handler.cpp。2. 规格更新与实例通知update_cpus在通过合法性校验后会做两件事见 instance_settings_handler.cpp调用instance.update_cpus(cpus)通知对应的VirtualMachine实现更新其描述信息同步更新VMSpecs::num_cores cpus并随后触发持久化。3. 各后端如何落地update_cpus是VirtualMachine接口的虚函数各平台后端均有实现QEMU 后端QemuVirtualMachine::update_cpus仅将核数写入desc.num_cores断言num_cores 0实际的 vCPU 拓扑在下次启动虚拟机时由 QEMU 参数生成逻辑读取见 src/platform/backends/qemu/qemu_virtual_machine.cppHyper-V 后端update_cpus(int num_cores)在 hyperv_virtual_machine.h 中声明由 Hyper-V 平台实现调用 PowerShell/WMI 接口调整虚拟机处理器数量Hyper-V APIHCS后端见 hcs_virtual_machine.hApple 虚拟化框架后端applevz见 applevz_virtual_machine.hVirtualBox 后端见 virtualbox_virtual_machine.h。从源码结构可以推断QEMU 等后端在实例停止期间修改描述信息、下次启动时重新生成虚拟机配置--smp/-smp等参数会基于num_cores计算因此 CPU 调整对运行中的实例不生效这也从实现层面印证了「必须停止实例才能修改」的约束。注意事项与最佳实践先停后改修改local.instance-name.cpus前必须停止实例否则守护进程直接拒绝操作。值必须为正整数0、负数、小数或非数字字符串都会被拒绝报错信息为 Need a positive integer (in decimal format) of minimum 1。Multipass 不设上限但后端有限制取值过大会导致后端报错或启动失败建议按宿主机物理核数合理规划例如在 QEMU 后端下模拟核数不应超过宿主机可用 CPU 资源。设置是持久的修改后的核数会写入实例规格并持久化重启宿主机或 Multipass 守护进程后依然生效multipass get local.instance-name.cpus可随时确认当前生效值。与launch --cpus的关系launch指定的是初始值set是在实例生命周期内做二次调整两者作用于同一个num_cores规格字段。同值设置是安全的 NOOP即使实例已停止设置与当前值相同的核数也不会产生任何副作用操作直接成功。延伸阅读设置键的读取与写入命令get、set创建实例并指定初始 CPUlaunch实例级设置的其他键local.instance-name.memory内存、local.instance-name.disk磁盘、local.instance-name.bridged桥接网络总览见 实例设置文档设置键语法与取值规则汇总settings-keys-values核心实现instance_settings_handler.cpp、instance_settings_handler.h、constants.h测试用例test_instance_settings_handler.cpp赞分享虚拟化开发工具云原生【免费下载链接】multipassMultipass orchestrates virtual Ubuntu instances项目地址https://gitcode.com/gh_mirrors/mu/multipass点击查看免费下载相关推荐如何在 macOS 上从源码构建 Lynx Explorer 并打包 LynxSDK如何在 macOS 上从源码构建 Lynx Explorer 并打包 LynxSDK 在 macOS 上从 Lynx 源码构建可运行的 LynxExplorer虚拟化开发工具云原生Dagster GraphQL API 调用返回 UnauthorizedError 怎么排查Dagster GraphQL API 调用返回 UnauthorizedError 怎么排查 调用 Dagster 的 GraphQL API 时即使虚拟化开发工具云原生FastMCP MCPMixin 组件化指南用类方法与装饰器批量注册 Tool / Resource / PromptFastMCP MCPMixin 组件化指南用类方法与装饰器批量注册 Tool / Resource / Prompt 本文以 fastmcp_slim/fa虚拟化开发工具云原生上一篇终极gRPC核心架构完全指南从C实现原理到负载均衡详解下一篇CANN/ops-transformer FlashAttention示例创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
虚拟化开发工具云原生【免费下载链接】multipassMultipass orchestrates virtual Ubuntu instances项目地址https://gitcode.com/gh_mirrors/mu/multipass点击查看免费下载本指南围绕 Multipass 提供的实例级设置键local.instance-name.cpus展开讲解如何通过multipass set在运行时调整指定虚拟机实例的 CPU 核数、该设置键的合法取值与默认行为并结合仓库源码揭示其在守护进程中的底层处理链路与各虚拟化后端的落地方式。读完本文你将掌握查看、修改实例 CPU 配置的正确姿势以及该设置键在 Multipass 内部如何被解析、校验和持久化。关联说明该设置键与get、set、launch三个命令行接口配合使用实例级设置的整体机制可参见 实例设置总览。Key 的完整形式与含义local.instance-name.cpus是 Multipass 的实例级设置键instance-level setting key其中local是 Multipass 守护进程设置daemon settings的根命名空间源码中由mp::daemon_settings_root常量承载见 src/daemon/instance_settings_handler.cppinstance-name是目标 Multipass 实例的名称例如handsome-ling、primary等cpus是实例属性后缀表示 CPU 核数。该键所对应的值代表虚拟机模拟出的 CPU 数量它从宿主机的角度规定了该实例「最多能同时使用多少个宿主机线程」。也就是说这是一个上限约束实例内可见的 vCPU 数量由该值决定实例内的应用在任意时刻可并发执行的线程不会超过这一数值。从源码结构看Multipass 的实例设置处理器将实例属性划分为cpus、memory、disk、bridged四类见 src/daemon/instance_settings_handler.cpp并通过正则表达式%1\.%2\.%3daemon_settings_root 实例名 属性名解析用户传入的键见 instance_settings_handler.cpp。键格式不合法时会抛出UnrecognizedSettingException而keys()方法则会为每个已注册实例动态生成形如local.实例名.cpus的完整键集合见 instance_settings_handler.cpp。Description该设置控制什么local.instance-name.cpus决定虚拟机上模拟的 CPU 数量。这个值对运行中的实例建立了一个硬性上限实例最多能同时使用多少个宿主机线程。值得强调的是这一设置与launch时通过--cpus指定的核数是同一套规格。在 Multipass 的守护进程内部无论是launch命令的--cpus参数还是set命令写入的cpus值最终都收敛到同一个VMSpecs::num_cores字段实例规格结构体。例如在 src/daemon/daemon.cpp 中launch创建实例时会校验vm_desc.num_cores是否小于mp::min_cpu_cores其值为1见 include/multipass/constants.h不满足则回退到默认值。Possible values合法取值与边界文档规定该键的取值为正整数Multipass 本身不设上限数值上不限制最大值但底层虚拟化后端可能施加各自的限制例如宿主机物理 CPU 核数、QEMU 后端可模拟的最大 vCPU 数、Hyper-V/Libvirt 的配额等实际可设置的范围以所用后端为准。在守护进程的实现中set操作会对值做一次前置校验见 instance_settings_handler.cpp 的update_cpus函数使用QString::toInt将字符串转换为整数转换失败非十进制整数即抛出InvalidSettingException校验转换后的值是否小于mp::min_cpu_cores即1小于 1 时抛出异常错误信息为 Need a positive integer (in decimal format) of minimum 1若新值与当前规格spec.num_cores相同则视为 NOOP直接放行但不触发任何修改。对应的单元测试覆盖了这些路径见 tests/unit/test_instance_settings_handler.cppsetIncreasesInstanceCPUs验证将 4 核提升到 6 核时update_cpus(6)被精确调用一次且规格同步更新setMaintainsInstanceCPUsUntouchedIfSameButSucceeds验证设置相同值42 → 42时不会调用update_cpus但操作仍然成功NOOP 语义setAllowsDecreaseInstanceCPUs验证将 3 核降为 2 核是被允许的与memory只能扩容不同CPU 核数可增可减。Examples命令行使用示例multipass set local.handsome-ling.cpus4该命令将名为handsome-ling的实例的 CPU 核数设置为 4。其他典型用法# 读取某个实例当前的 CPU 核数 multipass get local.handsome-ling.cpus # 设置后确认结果 multipass get local.handsome-ling.cpus # 输出4查看该设置键时InstanceSettingsHandler::get直接返回spec.num_cores的十进制字符串形式QString::number(spec.num_cores)见 instance_settings_handler.cpp因此get的返回值总是纯整数格式。修改的前提条件实例必须处于停止状态与memory、disk等运行时规格调整类似修改cpus键有一个重要前置条件目标实例必须处于stopped已停止或off已关闭状态。守护进程在InstanceSettingsHandler::set中会先调用check_state_for_update见 instance_settings_handler.cpp如果实例处于运行running或其他非停止状态会抛出InstanceStateSettingsException错误信息为 Instance must be stopped for modification。因此正确的操作顺序是# 1. 停止实例 multipass stop handsome-ling # 2. 修改 CPU 核数 multipass set local.handsome-ling.cpus4 # 3. 重新启动实例 multipass start handsome-ling此外set还会拒绝以下场景见 instance_settings_handler.cpp实例正在准备preparing过程中时抛出 instance is being prepared实例已被删除deleted时抛出 Instance is deleted 错误。修改成功后守护进程会调用instance_persister()将新的规格spec.num_cores持久化确保重启后设置依然生效。Default value默认值行为该设置键的默认值是实例启动时launch所配置的 CPU 核数。也就是说创建实例时若未显式指定--cpusMultipass 会使用平台默认值。从源码看mp::default_cpu_cores与mp::min_cpu_cores相同均为1见 include/multipass/constants.h即默认单核创建实例时若通过multipass launch --cpus N指定了核数则该值成为该实例的num_cores初始规格之后对local.instance-name.cpus的任何修改都会覆盖这一初始值并持久化保存。换句话说get返回的值始终是「实例当前生效的核数」——它可能来自 launch 时的初始配置也可能来自后续set的覆盖结果。底层实现从设置键到后端动作为了让读者对该设置键有更立体的认知下面梳理它在 Multipass 内部的完整链路。1. 键解析与路由InstanceSettingsHandler::set先通过parse_key把local.instance-name.cpus拆解为「实例名 属性名」然后根据属性名分派到update_cpus见 instance_settings_handler.cpp。2. 规格更新与实例通知update_cpus在通过合法性校验后会做两件事见 instance_settings_handler.cpp调用instance.update_cpus(cpus)通知对应的VirtualMachine实现更新其描述信息同步更新VMSpecs::num_cores cpus并随后触发持久化。3. 各后端如何落地update_cpus是VirtualMachine接口的虚函数各平台后端均有实现QEMU 后端QemuVirtualMachine::update_cpus仅将核数写入desc.num_cores断言num_cores 0实际的 vCPU 拓扑在下次启动虚拟机时由 QEMU 参数生成逻辑读取见 src/platform/backends/qemu/qemu_virtual_machine.cppHyper-V 后端update_cpus(int num_cores)在 hyperv_virtual_machine.h 中声明由 Hyper-V 平台实现调用 PowerShell/WMI 接口调整虚拟机处理器数量Hyper-V APIHCS后端见 hcs_virtual_machine.hApple 虚拟化框架后端applevz见 applevz_virtual_machine.hVirtualBox 后端见 virtualbox_virtual_machine.h。从源码结构可以推断QEMU 等后端在实例停止期间修改描述信息、下次启动时重新生成虚拟机配置--smp/-smp等参数会基于num_cores计算因此 CPU 调整对运行中的实例不生效这也从实现层面印证了「必须停止实例才能修改」的约束。注意事项与最佳实践先停后改修改local.instance-name.cpus前必须停止实例否则守护进程直接拒绝操作。值必须为正整数0、负数、小数或非数字字符串都会被拒绝报错信息为 Need a positive integer (in decimal format) of minimum 1。Multipass 不设上限但后端有限制取值过大会导致后端报错或启动失败建议按宿主机物理核数合理规划例如在 QEMU 后端下模拟核数不应超过宿主机可用 CPU 资源。设置是持久的修改后的核数会写入实例规格并持久化重启宿主机或 Multipass 守护进程后依然生效multipass get local.instance-name.cpus可随时确认当前生效值。与launch --cpus的关系launch指定的是初始值set是在实例生命周期内做二次调整两者作用于同一个num_cores规格字段。同值设置是安全的 NOOP即使实例已停止设置与当前值相同的核数也不会产生任何副作用操作直接成功。延伸阅读设置键的读取与写入命令get、set创建实例并指定初始 CPUlaunch实例级设置的其他键local.instance-name.memory内存、local.instance-name.disk磁盘、local.instance-name.bridged桥接网络总览见 实例设置文档设置键语法与取值规则汇总settings-keys-values核心实现instance_settings_handler.cpp、instance_settings_handler.h、constants.h测试用例test_instance_settings_handler.cpp赞分享虚拟化开发工具云原生【免费下载链接】multipassMultipass orchestrates virtual Ubuntu instances项目地址https://gitcode.com/gh_mirrors/mu/multipass点击查看免费下载相关推荐如何在 macOS 上从源码构建 Lynx Explorer 并打包 LynxSDK如何在 macOS 上从源码构建 Lynx Explorer 并打包 LynxSDK 在 macOS 上从 Lynx 源码构建可运行的 LynxExplorer虚拟化开发工具云原生Dagster GraphQL API 调用返回 UnauthorizedError 怎么排查Dagster GraphQL API 调用返回 UnauthorizedError 怎么排查 调用 Dagster 的 GraphQL API 时即使虚拟化开发工具云原生FastMCP MCPMixin 组件化指南用类方法与装饰器批量注册 Tool / Resource / PromptFastMCP MCPMixin 组件化指南用类方法与装饰器批量注册 Tool / Resource / Prompt 本文以 fastmcp_slim/fa虚拟化开发工具云原生上一篇终极gRPC核心架构完全指南从C实现原理到负载均衡详解下一篇CANN/ops-transformer FlashAttention示例创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
