)]}'
{"/PATCHSET_LEVEL":[{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":2,"id":"788117a3_4e8470ad","updated":"2026-04-17 14:37:25.000000000","message":"We have couple of questions to settle next week on the PTG.\n(I also left a bunch of overlapping comments in the PoC)","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":2,"id":"24334c49_34731358","updated":"2026-02-05 14:23:52.000000000","message":"couple of comments","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":2,"id":"d557171a_7308a31d","updated":"2026-04-17 15:25:11.000000000","message":"quick respocne but ill see if i have tiem to review agian before the ptg","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":3,"id":"4cc58463_5a92c447","updated":"2026-04-28 15:49:11.000000000","message":"Here are my comments about an alternative structure. Some of these were pending from a few days ago and others I finished this morning after gibi\u0027s ask.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"cd5052ac64ea46c63d254f7d610e482bfdcc2151","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":3,"id":"c088a601_12a9fa1d","updated":"2026-05-07 17:45:50.000000000","message":"Sorry, I guess I never hit the submit button on this a couple days ago.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":3,"id":"21e92678_5528f5a1","updated":"2026-04-28 14:32:12.000000000","message":"Updated the spec after the PTG","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"e39add709fc27f819b17d2af689f4c32ce1fad90","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":3,"id":"95b6a292_6afcedb7","updated":"2026-04-29 20:25:27.000000000","message":"i ment ot push those this morning but im just finsining for today so i pushed what i had locally","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"0f9c0c4b7a2b2a09b8cbe2bc076c6587fbc2c8a1","unresolved":true,"context_lines":[],"source_content_type":"","patch_set":3,"id":"aa59b5a5_efd3f63b","in_reply_to":"4cc58463_5a92c447","updated":"2026-04-29 09:46:40.000000000","message":"Thanks for the proposal. I have to chew it a bit before I can meaningfully respond.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[],"source_content_type":"","patch_set":4,"id":"683d6155_ba7583e9","updated":"2026-05-08 16:47:58.000000000","message":"+1 for now\n\ni want to understand if after all the remaing comment are considre do we still have opens we need to adress before graduating to +2\n\nhavign a seprate group_spec by anyther name was somethign i breifly consider in teh past and dicsonted as overly complex but as propsed i think its a workable solution\n\nim not entirly convice it less complext or easier to reason abut then what i propsoed orginally but there is a better sepreation of concurs\n\ndevspec remains in change fo filtering which devices nova can manage\nthe new group spec just aggreates and annotates the devices that form each group.\n\nthe veriosn i was thinkign of worked slightly diffently in that i was thing of havign a sepetae group_types fiels and only moving the triats/resouce_clas to the type isntead of also usign it to specify which devices were part of the group.\n\ni think you have motivated the current design better in teh spec then was done in the etherpad so i think tis somethign i can agree with given the constraits fo backward comaptibltiy and nova\u0027s legacy from teh exsting options.\n\nwhen thinking about how i would model it in cybborg i think i woudl make other tadeoffs but i agree this approch is valid for nova.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":4,"id":"65e2174a_8d2f8dc2","updated":"2026-05-08 15:18:45.000000000","message":"Just some comments about the new words and config arrangement.\n\nI definitely think having `group_spec` is better than before. I definitely still think that we\u0027re building more apartments on top of an existing house of cards by trying to bolt this into the existing syntax :(","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"8c8e98be53987a6c5c94d1120e223407ce56ef86","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":4,"id":"895f42ba_e2375d09","updated":"2026-05-11 08:26:29.000000000","message":"thanks folks, I\u0027m working on answering the comments...","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"change_message_id":"85f5367d8f3ad9514c50378cb28f9fb03381704b","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"66d5ee5f_4a094ff5","updated":"2026-10-06 03:10:06.000000000","message":"Granted I am not a PCI expert, what I have read in this spec sounds reasonable to me. I appreciate the approach to minimize the scope and require explicit configuration of unallocated and unreserved devices, no partial allocation of devices in a group, uniform number of devices per group type, keeping behavior of PF vs VF exclusion consistent with how it works today with individual devices, and strict validation of configuration with service start refusal in cases of invalid configurations.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"1114c7b940215b72f2378d6e78c5bf434a7ddb2c","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"c19a14b9_1e6b913b","updated":"2026-10-08 16:07:32.000000000","message":"I am not going to insist on adding the PCIe multi-root complex topologies into that spec scope though. It seems there are feasible alternatives to that gap, like building multi-rooted VMs with rigid isolation configured in Nova, that should convince the NCCL/RCCL layer to use inter-node and inter-devices RDMA routing policies","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"c30bb337caf5b8eaae47eeb19729333b767e880a","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"a1173b3a_d00ced21","updated":"2026-10-08 08:28:11.000000000","message":"I believe that modeling multi-root PCIe complexes alongside \"just\" grouping devices is indivisible part of the feature in HPC use cases","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"f8ebeb6b_85580bf9","updated":"2026-10-07 18:05:47.000000000","message":"I\u0027m not really sure why exclude\u003d needs to be part of this already-large spec?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"5fdd362c_342da8cf","updated":"2026-10-07 15:53:48.000000000","message":"couple of things inline but nothing major I think.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"62e31d091bf8074c1f27a468267bdde3bde938e9","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"c5d843d4_52e7126a","updated":"2026-10-07 18:58:41.000000000","message":"its getting late for me so ill try and read the feedback propelry tomorrow thanks for taking a look","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"ef691fc089d439b062cf4f245fceaa210c6401e0","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"39830bf0_b7922bd7","updated":"2026-10-06 14:38:01.000000000","message":"note for the future. If you need to move the file (due to the release change) then please do the move in a separate PS and then do the update in the next PS to keep the diff readable. Here is the diff between PS5 and PS6 if somebody interested https://paste.openstack.org/show/bjXLL6LAIstHcUk1FMUp/","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"a0f789b1a6698be378fce1f54eef25af729065cc","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":6,"id":"6d8e3064_43c26b42","updated":"2026-10-27 13:25:21.000000000","message":"note i will be updating this based on my finding form my local poc and the ptg dicssion this week. proably in the next day or so so settign -w to reflect that.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":7,"id":"aa2d19cd_31323b83","updated":"2026-11-05 15:24:39.000000000","message":"mostly nits an clarifications. I have one deeper question about the device mapping / IntancePCIRequest expansion.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"a7583637ccf58007b86b5bbda401f54ca6bf950d","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":9,"id":"786e9fa5_07ff4234","updated":"2026-11-17 13:38:19.000000000","message":"my questions were answered. This looks OK to me.","commit_id":"46519579f56c4439b796cb63863bff16aac5090a"}],"specs/2026.2/approved/pci-passthrough-groups.rst":[{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":14,"context_line":"request a group of PCI devices. These groups of PCI devices are tracked"},{"line_number":15,"context_line":"as a single indivisible unit within Placement. The default custom"},{"line_number":16,"context_line":"resource class used to track these PCI groups is derived from the"},{"line_number":17,"context_line":"PCI group type name, and the name of the inventory is derived from"},{"line_number":18,"context_line":"the PCI group name. The pci_alias config already supports mapping"},{"line_number":19,"context_line":"to a specific placement resource class."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"Problem description"}],"source_content_type":"text/x-rst","patch_set":2,"id":"a4c61260_cb864231","line":18,"range":{"start_line":17,"start_character":21,"end_line":18,"end_character":19},"updated":"2026-04-17 14:37:25.000000000","message":"I guess what this means is the name of the *Resource Provider* is derived from the name of the group.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":14,"context_line":"request a group of PCI devices. These groups of PCI devices are tracked"},{"line_number":15,"context_line":"as a single indivisible unit within Placement. The default custom"},{"line_number":16,"context_line":"resource class used to track these PCI groups is derived from the"},{"line_number":17,"context_line":"PCI group type name, and the name of the inventory is derived from"},{"line_number":18,"context_line":"the PCI group name. The pci_alias config already supports mapping"},{"line_number":19,"context_line":"to a specific placement resource class."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"Problem description"}],"source_content_type":"text/x-rst","patch_set":2,"id":"cee654de_93cb3935","line":18,"range":{"start_line":17,"start_character":21,"end_line":18,"end_character":19},"in_reply_to":"a4c61260_cb864231","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":53,"context_line":""},{"line_number":54,"context_line":"Let us consider the specific case of the Graphcore C200 device,"},{"line_number":55,"context_line":"where a set of PCI cards are connected together via IPU-Link:"},{"line_number":56,"context_line":"https://docs.graphcore.ai/projects/C600-datasheet/en/latest/product-description.html#ipu-link-cables"},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Each physical card presents two PCI devices. The card can be used"},{"line_number":59,"context_line":"independently of other cards if a matched pair of devices are"}],"source_content_type":"text/x-rst","patch_set":2,"id":"43411dbe_acb6ee13","line":56,"updated":"2026-04-17 14:37:25.000000000","message":"I know this was the original use case and it is still valid but I\u0027m wondering if we want to mention NVLink and the rest that has more marketing value in my eyes.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":53,"context_line":""},{"line_number":54,"context_line":"Let us consider the specific case of the Graphcore C200 device,"},{"line_number":55,"context_line":"where a set of PCI cards are connected together via IPU-Link:"},{"line_number":56,"context_line":"https://docs.graphcore.ai/projects/C600-datasheet/en/latest/product-description.html#ipu-link-cables"},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Each physical card presents two PCI devices. The card can be used"},{"line_number":59,"context_line":"independently of other cards if a matched pair of devices are"}],"source_content_type":"text/x-rst","patch_set":2,"id":"2245d50f_0f4e912f","line":56,"in_reply_to":"43411dbe_acb6ee13","updated":"2026-04-28 14:32:12.000000000","message":"I added some words","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":81,"context_line":"  Each group being a separate resource provider with a single inventory"},{"line_number":82,"context_line":"  item for the associated group type custom resource type, with a name"},{"line_number":83,"context_line":"  that is generated from the group_name rather than the PCI device address"},{"line_number":84,"context_line":"* extend ``[pci]alias`` to map to the resource class mentioned"},{"line_number":85,"context_line":"  above, such as ``CUSTOM_PCI_GROUP_\u003cgroup_type_name\u003e``."},{"line_number":86,"context_line":"* PCI tracker will have the ``group_name`` and ``group_type`` added to"},{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5f7526ff_218e81c1","line":85,"range":{"start_line":84,"start_character":0,"end_line":85,"end_character":56},"updated":"2026-04-17 14:37:25.000000000","message":"I think the PoC also adds group_type to the alias to request groups. So there is both RC and group_type on the device_spec side and also RC and group_type on the alias side.\n\nOn the device_spec side this specification define a precedence that an explicit RC overrides an implicit RC derived from the group_type. Does the same precedence exists in case of the alias definition? Or we want to simplify there?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":81,"context_line":"  Each group being a separate resource provider with a single inventory"},{"line_number":82,"context_line":"  item for the associated group type custom resource type, with a name"},{"line_number":83,"context_line":"  that is generated from the group_name rather than the PCI device address"},{"line_number":84,"context_line":"* extend ``[pci]alias`` to map to the resource class mentioned"},{"line_number":85,"context_line":"  above, such as ``CUSTOM_PCI_GROUP_\u003cgroup_type_name\u003e``."},{"line_number":86,"context_line":"* PCI tracker will have the ``group_name`` and ``group_type`` added to"},{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"}],"source_content_type":"text/x-rst","patch_set":2,"id":"80445e50_009673a9","line":85,"range":{"start_line":84,"start_character":0,"end_line":85,"end_character":56},"in_reply_to":"45bf1661_bd49190d","updated":"2026-04-28 14:32:12.000000000","message":"As discussed on the PTG both group_type and resource_class will be supported in the alias to request a specific group type. I documented it now.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":81,"context_line":"  Each group being a separate resource provider with a single inventory"},{"line_number":82,"context_line":"  item for the associated group type custom resource type, with a name"},{"line_number":83,"context_line":"  that is generated from the group_name rather than the PCI device address"},{"line_number":84,"context_line":"* extend ``[pci]alias`` to map to the resource class mentioned"},{"line_number":85,"context_line":"  above, such as ``CUSTOM_PCI_GROUP_\u003cgroup_type_name\u003e``."},{"line_number":86,"context_line":"* PCI tracker will have the ``group_name`` and ``group_type`` added to"},{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"}],"source_content_type":"text/x-rst","patch_set":2,"id":"45bf1661_bd49190d","line":85,"range":{"start_line":84,"start_character":0,"end_line":85,"end_character":56},"in_reply_to":"5f7526ff_218e81c1","updated":"2026-04-17 15:25:11.000000000","message":"yes group_type is the primary way to request a group and i envisioned you would not set both. so i am inclidned to require group_type for groups or at least stongly encurange it but we can ahve RC override it if you really hate the default nameing convetion.\n\ni dont recal which i did in the poc.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"},{"line_number":89,"context_line":"  in placement."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Configuration Tags"},{"line_number":92,"context_line":"------------------"},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"0b5ebf8f_2bc0f968","line":90,"updated":"2026-02-05 14:23:52.000000000","message":"* Could a group of VFs from the same PF is supported?\n* Could a group of VFs across multiple parent PF is supported?\n\nDoes this cause complication in the PCI tracking?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"},{"line_number":89,"context_line":"  in placement."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Configuration Tags"},{"line_number":92,"context_line":"------------------"},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"a682129b_b7ccd73b","line":90,"in_reply_to":"0b5ebf8f_2bc0f968","updated":"2026-02-05 15:43:27.000000000","message":"Is this answered on L143?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"da03409a5e264a0aa8d421547ca5216d73e4e13f","unresolved":false,"context_lines":[{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"},{"line_number":89,"context_line":"  in placement."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Configuration Tags"},{"line_number":92,"context_line":"------------------"},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"e124e37d_27fab5f4","line":90,"in_reply_to":"358da548_72f9b4a3","updated":"2026-02-10 12:10:25.000000000","message":"@dms@danplanet.com originally I failed to spot the connection but I see it now.\n\n@smooney@redhat.com thanks sounds good","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":87,"context_line":"  each device that is being tracked, such that we can look up a group"},{"line_number":88,"context_line":"  of devices associated with each specific named group tracked"},{"line_number":89,"context_line":"  in placement."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Configuration Tags"},{"line_number":92,"context_line":"------------------"},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"358da548_72f9b4a3","line":90,"in_reply_to":"a682129b_b7ccd73b","updated":"2026-02-05 17:16:57.000000000","message":"yes a group of VFs form teh same pf is suproted and its how i was testing it locally\n\nand also yes a group of VF across PFs shoudl also work.\n\ni have not tested that yet but i think i have second pf that i can use to verify it.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":96,"context_line":"* ``group_name``: A unique identifier for a specific group instance"},{"line_number":97,"context_line":"  (e.g., \"graphcore_1\"). This identifies which devices belong together."},{"line_number":98,"context_line":"* ``group_type``: A category name used to generate the resource class"},{"line_number":99,"context_line":"  (e.g., \"c200_x1\" generates ``CUSTOM_PCI_GROUP_C200_X1``). All groups"},{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."}],"source_content_type":"text/x-rst","patch_set":2,"id":"d1420cf9_3e9f1b2a","line":100,"range":{"start_line":99,"start_character":60,"end_line":100,"end_character":69},"updated":"2026-02-05 14:23:52.000000000","message":"This together with \n\u003e * **Inventory**: Always 1 (the group is an atomic unit)\n\nbelow and the fact that suffixed placement request groups can only be fulfilled form a single RP means that if the flavor asks for 2 groups from the same type/alias then such request needs to be split to two placement request groups. This is not different from the logic of requesting 2 device from the same alias today. So this is just a impl note from me here, no update needed in the spec.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"da03409a5e264a0aa8d421547ca5216d73e4e13f","unresolved":false,"context_lines":[{"line_number":96,"context_line":"* ``group_name``: A unique identifier for a specific group instance"},{"line_number":97,"context_line":"  (e.g., \"graphcore_1\"). This identifies which devices belong together."},{"line_number":98,"context_line":"* ``group_type``: A category name used to generate the resource class"},{"line_number":99,"context_line":"  (e.g., \"c200_x1\" generates ``CUSTOM_PCI_GROUP_C200_X1``). All groups"},{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."}],"source_content_type":"text/x-rst","patch_set":2,"id":"d5751e84_89997b83","line":100,"range":{"start_line":99,"start_character":60,"end_line":100,"end_character":69},"in_reply_to":"549caa21_9b4d1d2d","updated":"2026-02-10 12:10:25.000000000","message":"Acknowledged","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":96,"context_line":"* ``group_name``: A unique identifier for a specific group instance"},{"line_number":97,"context_line":"  (e.g., \"graphcore_1\"). This identifies which devices belong together."},{"line_number":98,"context_line":"* ``group_type``: A category name used to generate the resource class"},{"line_number":99,"context_line":"  (e.g., \"c200_x1\" generates ``CUSTOM_PCI_GROUP_C200_X1``). All groups"},{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."}],"source_content_type":"text/x-rst","patch_set":2,"id":"549caa21_9b4d1d2d","line":100,"range":{"start_line":99,"start_character":60,"end_line":100,"end_character":69},"in_reply_to":"d1420cf9_3e9f1b2a","updated":"2026-02-05 17:16:57.000000000","message":"yep.\n\nso i condiered if we shoudl consolidate grousp into a singel rp. \ni didnt do that becaue if we were to do that we proably woudl want to do that more generally and i belive that is firmly out of scope\n\nso for right now if you have 2 groups fo the same type on a host you will have 2 nested rps\n\nand if you want 2 of them in a single flvor we need to split the request into 2 request groups.\nbut we already have to do that for pci in placment today so it would be an extetion of the existing logic.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Validation Rules"},{"line_number":106,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9f69782c_ba110997","line":103,"updated":"2026-02-05 15:43:27.000000000","message":"I\u0027m not sure I\u0027m understanding the two keys here.. The name is unique for the actual pair, and the type is shared amongst all the groups of this type of thing? such that you would have:\n- graphcore_1,c200_x1\n- graphcore_2,c200_x1\n- ...etc\n?\n\n(later) okay I see that I think the above is correct, and knowing the name is sort of the provider and the type is the inventory class helps. Might be worth an extra sentence here to clarify.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"9f59dcb5e45b3886b3ecbfdd1d27e8ef8938e466","unresolved":true,"context_lines":[{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Validation Rules"},{"line_number":106,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"78e70cfe_955f681a","line":103,"in_reply_to":"3f13cd88_00035d26","updated":"2026-04-17 17:44:02.000000000","message":"OK. Then I misunderstood the discussion here. So lets support all the spec-dev matching modes for devs in groups as well. Obviously we will have different level of validations at different point in the codebase. We can validate each spec individually. Then we can validate a group based on the specs in it. Then a group_type based on the groups belonging to it. And eventually we will validate things based on the devices matched to the groups. One thing that right now that is impossible to pre-validate on the compute level is that the same group_type means the same number of devices across multiple computes. We need that to live migraton to work, so that will be a pre-live-migration check I guess.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Validation Rules"},{"line_number":106,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"16288b89_61b3d35e","line":103,"in_reply_to":"78e70cfe_955f681a","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Validation Rules"},{"line_number":106,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"aa08f580_d0e54731","line":103,"in_reply_to":"9f69782c_ba110997","updated":"2026-02-05 17:16:57.000000000","message":"ack i can work on some prose to make that clarer\n\na slightly sanitised version looks like this\n\n```\ndebian@hibernal01:~$ openstack --os-cloud devstack-admin resource provider list\n+--------------------------------------+-----------------------------------------------------------+------------+--------------------------------------+--------------------------------------+\n| uuid                                 | name                                                      | generation | root_provider_uuid                   | parent_provider_uuid                 |\n+--------------------------------------+-----------------------------------------------------------+------------+--------------------------------------+--------------------------------------+\n| 8a4fb119-1393-4d11-9394-e881433aad0a | hibernal01                                                |         13 | 8a4fb119-1393-4d11-9394-e881433aad0a | None                                 |\n| 5538f512-52f3-4b72-b6b8-55f9e917f0ca | hibernal01_group_nic_group_1                              |          5 | 8a4fb119-1393-4d11-9394-e881433aad0a | 8a4fb119-1393-4d11-9394-e881433aad0a |\n+--------------------------------------+-----------------------------------------------------------+------------+--------------------------------------+--------------------------------------+\n```\n\nbased on this nova config fragment conf\n```\n[pci]\nreport_in_placement \u003d True\n# Group 1: 3b:02.0 - 3b:02.7\ndevice_spec \u003d {\"address\": \"0000:3b:02.0\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.1\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.2\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.3\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.4\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.5\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.6\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.7\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\n\n# Group 2: 3b:03.0 - 3b:03.7\n#device_spec \u003d {\"address\": \"0000:3b:03.*\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\n\n# Group 3: 3b:04.0 - 3b:04.7\n#device_spec \u003d {\"address\": \"0000:3b:04.*\", \"group_name\": \"nic_group_3\", \"group_type\": \"NICx8\"}\n\n# Group 4: 3b:05.0 - 3b:05.7\n#device_spec \u003d {\"address\": \"0000:3b:05.*\", \"group_name\": \"nic_group_4\", \"group_type\": \"NICx8\"}\n\n# Group 5: 3b:06.0 - 3b:06.7\n#device_spec \u003d {\"address\": \"0000:3b:06.*\", \"group_name\": \"nic_group_5\", \"group_type\": \"NICx8\"}\n\n# Group 6: 3b:07.0 - 3b:07.7\n#device_spec \u003d {\"address\": \"0000:3b:07.*\", \"group_name\": \"nic_group_6\", \"group_type\": \"NICx8\"}\n\n# Group 7: 3b:08.0 - 3b:08.7\n#device_spec \u003d {\"address\": \"0000:3b:08.*\", \"group_name\": \"nic_group_7\", \"group_type\": \"NICx8\"}\n\n# Group 8: 3b:09.0 - 3b:09.7\n#device_spec \u003d {\"address\": {\"domain\": \"0000\", \"bus\": \"3b\", \"slot\": \"09\", \"function\": \".*\"}, \"group_name\": \"nic_group_8\", \"group_type\": \"NICx8\"}\n\n# Alias for requesting NICx8 groups via flavor\nalias \u003d {\"name\": \"NICx8\", \"resource_class\": \"CUSTOM_PCI_GROUP_NICX8\", \"group_type\": \"NICx8\"}\n```\n\ni need ot uncomemtn and test the other regex adn blob sytax but it shoudl work or will once i have time to test it again","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Validation Rules"},{"line_number":106,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f13cd88_00035d26","line":103,"in_reply_to":"a6449ab0_8527bff7","updated":"2026-04-17 15:25:11.000000000","message":"well that preexisitng fucntionatly\n\nnot new so my baseline was we will supprot everyitng that is allowed in the device_spec for a normal function (i..e the blob/regex supprot) in the adress\nunless we had a reason not to of coruces i.e. no supprot for dev_name","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":100,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Both tags must be specified together - specifying only one results in"},{"line_number":103,"context_line":"a configuration error."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Validation Rules"},{"line_number":106,"context_line":"----------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"a6449ab0_8527bff7","line":103,"in_reply_to":"aa08f580_d0e54731","updated":"2026-04-17 14:37:25.000000000","message":"There is some blob and regex related code in the PoC but first we need to settle what we support.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":111,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7e9e5d2d_e5b1425d","line":114,"updated":"2026-02-05 15:43:27.000000000","message":"And presumably devices here can only be specified by address and not vendor,model right?I assume that means we also have to make sure that we list all other device_spec devices (even those by vendor,model) and make sure that none of the devices here are grouped into those, right? I assume this also means that if you have four of the same device, and only two of the four share a link, then the two non-linked ones must be specified by address to avoid including the linked/grouped ones?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"9f59dcb5e45b3886b3ecbfdd1d27e8ef8938e466","unresolved":true,"context_lines":[{"line_number":111,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5319c425_43053bdc","line":114,"in_reply_to":"00811fd8_15b8b8e3","updated":"2026-04-17 17:44:02.000000000","message":"I guess we want to keep it simple but not breaking existing schemes. The main way will be address and address glob/regex to define groups. But I would not reject a group that defined by vendor_id,product_id even though that use case is pretty limited. Later, based on feedback we can think about extending the vendor_id,product_id case with a count or exclude list if somebody needs it.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":111,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"00811fd8_15b8b8e3","line":114,"in_reply_to":"10ae8a4e_a4117117","updated":"2026-04-17 15:25:11.000000000","message":"correct, i would like to requrie that i think but im open to other propsoals\n\nif we just use vendorid and product id unless we had someitng like a group_count\nto automaticly partion the matiching device in to groups of N\n\ni dont think that woudl be that useful so to keep it simple i want to required adresses for now but im oke with the idea fo adding an \"externaly_manged\" or exclude/negate flag to allow an easy way to say not this one.\n\nthat woudl be for the nic partitioning usecase.\nthat not striclty a grouping related feature but mroe a general refinment to the devstack format in genreal.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":111,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"10ae8a4e_a4117117","line":114,"in_reply_to":"1c66b637_bb6e3b41","updated":"2026-04-17 14:37:25.000000000","message":"\u003e i have been usign adress so far in my testing however and i think that makes teh most sence so i proably shoudl make adress requried.\n\nThis needs to be settled. The PoC does not mandate the usage of the address field for grouping.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":111,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"cb466607_d76358af","line":114,"in_reply_to":"5319c425_43053bdc","updated":"2026-04-28 14:32:12.000000000","message":"Updated the spec accordigly.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":111,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1c66b637_bb6e3b41","line":114,"in_reply_to":"7e9e5d2d_e5b1425d","updated":"2026-02-05 17:16:57.000000000","message":"yes adn no\n\ni woudl need to doublcheck that in my poc but if you specify  only a vendor id and product id it all matching devices would end up in one gorup\n\nwe can chosoe if that valid or not and i dont actully know if there is a usecase for that\n\ni have been usign adress so far in my testing however and i think that makes teh most sence so i proably shoudl make adress requried.\n\n\nin term of the interaction between \n```\ndevice_spec \u003d {\"address\": \"0000:3b:03.*\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"vendor_id\": \"8086\", \"product_id\":\"154c\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\n```\n\ni have generally lent in the direction that if you have a device refecne withsce in two diffent dev stpec that shoudl be a config error.\n\nbut we coudl choose to have teh group take precendce or add exclude_addresses or similar\n\n```\ndevice_spec \u003d {\"address\": \"0000:3b:03.*\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"vendor_id\": \"8086\", \"exclude_addresse\"\u003d\"0000:3b:03.*\" \"product_id\":\"154c\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\n```\n\nexclude adresses is just a geenrally useful thing to be ablel to do but obvously that need a littel more work to impement but it woudl be nice to have even with groups\n\n\ndo you have a prefernce\n\ntoday in my poc you woud need to use adresses to make sure the device specs  dont overlap as i belive i already have a check to make it a cofnig error if they do.\ni have soem protaction against overlapping groups but i dont knwo if that will catch this edgecase.\nhttps://review.opendev.org/c/openstack/nova/+/973604/3/nova/pci/whitelist.py#198\n\nim missing a functional test to validate this so that a vaild testing gap\nhttps://review.opendev.org/c/openstack/nova/+/973604/3/nova/tests/functional/libvirt/test_pci_in_placement.py","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"},{"line_number":118,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"91541282_ae4fe915","line":115,"updated":"2026-04-17 14:37:25.000000000","message":"Couple of other validation rules we should discuss:\n\n* Dependent device support:\n  * parent PF and child VF within the same group. Do we allow it? PCI in Placement today does not allow them being configured at the same time.\n  * parent PF and child VF in two separate group\n  * parent PF and child VF where one of them is in a group while the other is not in any group but matched by spec.\n\n* Size of the groups within the group type: Can a group1 and group2 has different number of devices when both belong to group_typeX? At least in the PoC the NUMA scoring logic is sensitive to the size of the group.\n\n\n* What if two specs of the same group defines diverging RC or group_type? Or a combination where spec1 for group1 defines a group_type but spec2 to group1 defines an RC as well?\n\n* What if two specs of two different groups but the same group_type defines different RCs?\n\n---\n\nWe probably needs some validation rules for the PCI alias as well:\n* What will be the device_type field usage for an alias that targets a group of diverse set of devices (PF+VFs)?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":112,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":113,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":114,"context_line":"* No duplicate device addresses across groups"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Placement Integration"},{"line_number":117,"context_line":"---------------------"},{"line_number":118,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"68156f13_b840e67c","line":115,"in_reply_to":"91541282_ae4fe915","updated":"2026-04-28 14:32:12.000000000","message":"Detailed it in the spec based on the PTG discussion","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":true,"context_lines":[{"line_number":119,"context_line":"Each PCI device group is represented in Placement as a single Resource"},{"line_number":120,"context_line":"Provider (RP) that is a child of the compute node RP:"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"* **RP Naming**: ``{hostname}_group_{GROUP_NAME}`` (uppercase)"},{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"}],"source_content_type":"text/x-rst","patch_set":2,"id":"6ebf8c96_d84189d1","line":122,"updated":"2026-04-28 14:32:12.000000000","message":"Why are we uppercasing the group_name? The hostname is kept as is, and the \"group\" specifier is lowercase.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":119,"context_line":"Each PCI device group is represented in Placement as a single Resource"},{"line_number":120,"context_line":"Provider (RP) that is a child of the compute node RP:"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"* **RP Naming**: ``{hostname}_group_{GROUP_NAME}`` (uppercase)"},{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"}],"source_content_type":"text/x-rst","patch_set":2,"id":"8c44fc76_b0bf7e40","line":122,"in_reply_to":"6ebf8c96_d84189d1","updated":"2026-05-08 14:46:29.000000000","message":"removed the upper casing","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"},{"line_number":126,"context_line":"* **Traits**: Merged from all devices in the group"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."}],"source_content_type":"text/x-rst","patch_set":2,"id":"6a980a43_64e1d1a1","line":126,"updated":"2026-02-05 15:43:27.000000000","message":"Merged meaning.. union? I guess it seems like they should all have the same set of traits set in device_spec, else that\u0027s an error.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"9f59dcb5e45b3886b3ecbfdd1d27e8ef8938e466","unresolved":true,"context_lines":[{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"},{"line_number":126,"context_line":"* **Traits**: Merged from all devices in the group"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."}],"source_content_type":"text/x-rst","patch_set":2,"id":"b144622a_b1851ae1","line":126,"in_reply_to":"37bf7100_7f42ffd5","updated":"2026-04-17 17:44:02.000000000","message":"PURPLE case:\n* {address\u003d\"0.0.1\", traits\u003dCUSTOM_RED, group_name\u003dgroup1, group_type\u003dtype1}\n* {address\u003d\"0.0.2\", traits\u003dCUSTOM_BLUE, group_name\u003dgroup1, group_type\u003dtype1}\n\nNow we have group1 with two devs, and an contradicting color :)\n\nBut colors can be mixed.\n\nWhat if \n* {address\u003d\"0.0.1\", traits\u003dCUSTOM_EMITS_SOUND, group_name\u003dgroup1, group_type\u003dtype1}\n* {address\u003d\"0.0.2\", traits\u003dCUSTOM_EDIBLE, group_name\u003dgroup1, group_type\u003dtype1}\n\nDoes group1 noisy?\nYes as there is a device in it that makes sound.\nDoes group1 edible\nNo, (or partially) as there is a device that is not edible.\n\nSo I dont see a good choice now. But I will sleep on it.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"},{"line_number":126,"context_line":"* **Traits**: Merged from all devices in the group"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."}],"source_content_type":"text/x-rst","patch_set":2,"id":"638b6d14_d7c8f2b4","line":126,"in_reply_to":"628729c4_bbee753c","updated":"2026-04-17 14:37:25.000000000","message":"The problem is that the logic for one type of group might not applicable to other types of groups. For you GPU+audio case merging the traits make sense. But if somebody starts to group two differently sized VGPU together for reason X then the traits provided by those two VGPUs might not make sense to union. Similarly in the abstract case when on device says CUSTOM_BLUE the other in the same group CUSTOM_RED then the group can be striped with RED and BLUE colors, it can be shaded with PURPLE, or can be an error. Or similarly how live-migratable is not a union capability but a intersection one.:/\n\nI have no good proposal here as the combination strategy of the traits depends on the traits itself some combine differently then the others. Lets look at it on the PTG.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"},{"line_number":126,"context_line":"* **Traits**: Merged from all devices in the group"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."}],"source_content_type":"text/x-rst","patch_set":2,"id":"37bf7100_7f42ffd5","line":126,"in_reply_to":"638b6d14_d7c8f2b4","updated":"2026-04-17 15:25:11.000000000","message":"ack. to me the group is the indivisable thing so the traits are an atibute of the group rather then the devices within it hence the merging\n\nbut if there are alternitive then sure.\n\ngroup cant overlap and are indivsiabel so im not sure the PUPEL case can happen. it not in socpe of this prosal as written from my perspective.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"},{"line_number":126,"context_line":"* **Traits**: Merged from all devices in the group"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."}],"source_content_type":"text/x-rst","patch_set":2,"id":"628729c4_bbee753c","line":126,"in_reply_to":"6a980a43_64e1d1a1","updated":"2026-02-05 17:16:57.000000000","message":"yes a union.\n\nthe intent is to support groups fo different type of device.\nso if all the devices in teh group yes they woudl be the same\n\nhttps://review.opendev.org/c/openstack/nova/+/973604/3/nova/tests/functional/libvirt/test_pci_in_placement.py#2894\n\n\none reason for this si a consumer  nvida job like a rtx4080 has one pf that is the gpu and a secodn pf that is the audo contoler.\n\nso i want to be able to group both and union the traits form both if we were to auto discover them\n\nthat not a great example as the only trait we auto discover todya come form nics and only nics via livbirt and ethtool","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":123,"context_line":"* **Resource Class**: ``CUSTOM_PCI_GROUP_{GROUP_TYPE}`` by default,"},{"line_number":124,"context_line":"  or a custom ``resource_class`` tag value if specified"},{"line_number":125,"context_line":"* **Inventory**: Always 1 (the group is an atomic unit)"},{"line_number":126,"context_line":"* **Traits**: Merged from all devices in the group"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1465aca7_ea83cf3b","line":126,"in_reply_to":"b144622a_b1851ae1","updated":"2026-04-28 14:32:12.000000000","message":"on the PTG we agreed to go with group_traits to avoid the need of defining a merging rule. It is basically a cleaner case of saying that traits definition of each dev_spec line cannot diverge.\n\nUpdated the spec accordingly.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."},{"line_number":130,"context_line":"This ensures atomic all-or-nothing allocation."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Pool and Allocation Design"},{"line_number":133,"context_line":"--------------------------"},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"c814e806_5bbc367b","line":131,"updated":"2026-02-05 14:23:52.000000000","message":"We need special care when we reconfigure nova in a way that a PCI device is moved to a group or devices from group moved out to be individual devices","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."},{"line_number":130,"context_line":"This ensures atomic all-or-nothing allocation."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Pool and Allocation Design"},{"line_number":133,"context_line":"--------------------------"},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"57f7b6ac_e9829df1","line":131,"in_reply_to":"44f7a821_db6385fc","updated":"2026-04-17 14:37:25.000000000","message":"A generalization of the problem is basically the question of the life-cycle of a group.\n\n* Can a user add more devices to the group via reconfiguration. When the group is allocated / free?\n* Can the user remove devices from a group via reconfiguration. When the group is allocated / free?\n* What happens when a device currently in group disappears from a host (i.e. dies). While the group is allocated / free?\n* If we enforce that the size of the groups (size \u003d num of devs in group) should be the same within a group_type, how does that effect the life-cycle of the group? I.e. growing a group or loosing a device from the group.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."},{"line_number":130,"context_line":"This ensures atomic all-or-nothing allocation."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Pool and Allocation Design"},{"line_number":133,"context_line":"--------------------------"},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"70ab69b2_275c6d89","line":131,"in_reply_to":"57f7b6ac_e9829df1","updated":"2026-04-17 15:25:11.000000000","message":"can i guess they can do anything but in gneraly no\n\n\nGroup types must map to same type of devices across all host in a cloud.\nwhne a group defiens a set of devices that compiese the exected device for a given group_type.\n\nonce a group_type is defiend it cannot be modifyed if its in used by any instance.\n\nas a result a operator cannot extend a group of a given GROUP_TYPE\nwith new devices unless they have draiend all usage of that group_type for ther exisitn instances.\n\nwhat they can do is add or remove groups of a given type\nso if they hage a group trype of 2 gpus and they add a \n4 more gpus ot a host the operator can define 2 more instance fo that group type in the dev spec.\n\nthis is effectively the same rules we have for PCI in placement and alias today.\ntwo instance of a single resouce class are intened to be interchangebale across host, its fine to repmore more inventoies of that resouce class if you install new hardware, and if it free its fine to remove them as well.\n\nthe exising logic we have that prevent use deleting device form the device table if they are allcoated to a vm woudl aslo provide protecion here from typoing the config.\n\n\"\"\"\nWhat happens when a device currently in group disappears from a host (i.e. dies). While the group is allocated / free?\n\"\"\"\n\nwhen allocate the vm is likely going to ehter have runtim issue in the gust or crash and go to the error state.\n\nthe slightly more interesitn question is what happens if the device \"disapers\" as a result from lspci\n\nin the allocated case we will still have the device recored in the db with the pci adress and if you tried to hard reboot the vm it fail in libvirt/qemu as the adres wioudl be \"invalid or a simielr issue\" basiclly libvirt/qemu will complain if it can use the device\n\nin the case where the devices were free it a little trickier\nunless we store how many devices we expect in the db and compare i dont think we can detect it in the case where we sue teh regex/glob syntax\n\nso i agree that we likely need to decifbe that edgace better.\n\ni think adding a atibute to track the number of device we expect in a group may indeed be a way forward here but i have not tought about the full lifecycle implciations\n\nin this failure case we woudl likely want to set resterved\u003dtotal wehn its free or annotate it with a trait or simialr to say \"this is broken\" with a load error/wranign in the compute agent logs.\n\n\nhopefully my splitign of the concept fo a groups (a bag of devices) and a group_type  (the opaque handel that descs an expecte set fo devices) helps\n\nwe coudl add a group_type list that would encode thing like expected number of devices declarity seperate form the devstpec if you think that woudl make it clearer.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."},{"line_number":130,"context_line":"This ensures atomic all-or-nothing allocation."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Pool and Allocation Design"},{"line_number":133,"context_line":"--------------------------"},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"793dcf4c_6d9e3c9f","line":131,"in_reply_to":"70ab69b2_275c6d89","updated":"2026-04-28 14:32:12.000000000","message":"Detailed my view in the spec.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":128,"context_line":"The group RP has inventory of 1 only when ALL devices in the group are"},{"line_number":129,"context_line":"available. If any device is in use, the group inventory becomes 0."},{"line_number":130,"context_line":"This ensures atomic all-or-nothing allocation."},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"Pool and Allocation Design"},{"line_number":133,"context_line":"--------------------------"},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"44f7a821_db6385fc","line":131,"in_reply_to":"c814e806_5bbc367b","updated":"2026-02-05 17:16:57.000000000","message":"yes we woould have to first only allow that if the devices are not in use and then delete the old RP and create teh new ones.\n\nwe have logic to detect that but we woudl have to extend it in all likelyhood.\n\nit might work as each device in the groups is stored in the pci_deivces table as its own row \n\nhttps://paste.opendev.org/show/bNb5QrWEubOo5VguSGND/\n\nso the logic the keep the old dev in the pci tracker and prevent freeing the row in teh pci_device tabel shoud lkick in but i have not tested that yet so there are proably bugs.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":141,"context_line":"* When a group is allocated, ALL devices are consumed atomically"},{"line_number":142,"context_line":"  with the same ``request_id``"},{"line_number":143,"context_line":"* The PCI tracker bypasses normal PF/VF dependency logic for group"},{"line_number":144,"context_line":"  devices since all devices are intentionally allocated together"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"Live Migration Support"},{"line_number":147,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7b5b6a7a_4fb42799","line":144,"updated":"2026-04-17 14:37:25.000000000","message":"I feel like this is more complicated than it sounds as dependent devices cannot be configured today with PCI in Placement enabled (as it does not support them). So if we need to enable dependent devices within the same group then this needs to be explicitly re-enabled in the code.\n\nHow far we want to go with it:\n* parent PF and child VF within the same group.\n* parent PF and child VF in two separate group\n* parent PF and child VF where one of them is in a group while the other is not in any group but matched by spec.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":141,"context_line":"* When a group is allocated, ALL devices are consumed atomically"},{"line_number":142,"context_line":"  with the same ``request_id``"},{"line_number":143,"context_line":"* The PCI tracker bypasses normal PF/VF dependency logic for group"},{"line_number":144,"context_line":"  devices since all devices are intentionally allocated together"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"Live Migration Support"},{"line_number":147,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"b6d76c4c_35b4d58f","line":144,"in_reply_to":"5f8440ff_e4bb51f7","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":141,"context_line":"* When a group is allocated, ALL devices are consumed atomically"},{"line_number":142,"context_line":"  with the same ``request_id``"},{"line_number":143,"context_line":"* The PCI tracker bypasses normal PF/VF dependency logic for group"},{"line_number":144,"context_line":"  devices since all devices are intentionally allocated together"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"Live Migration Support"},{"line_number":147,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5f8440ff_e4bb51f7","line":144,"in_reply_to":"7b5b6a7a_4fb42799","updated":"2026-04-17 15:25:11.000000000","message":"i want to supprot PFs and VFs in the same group but if a PF is listed it must not have VFs listed as a group or not.\n\nso i woudl codier it an error to PF and there child VF in the same group ro diffent groups.\n\ni need to make this clearer.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":143,"context_line":"* The PCI tracker bypasses normal PF/VF dependency logic for group"},{"line_number":144,"context_line":"  devices since all devices are intentionally allocated together"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"Live Migration Support"},{"line_number":147,"context_line":"----------------------"},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"A PCI device group is live-migratable only if ALL devices in the group"}],"source_content_type":"text/x-rst","patch_set":2,"id":"327edfae_466c5b8e","line":146,"updated":"2026-04-17 14:37:25.000000000","message":"I think it worth mentioning that live migration of a VM with multiple PCI devices means a mapping of source PCI device - dest PCI device needs to be calculated. As we support such thing without the groups already we assume that devices in groups will be handled similarly when need to map. \n\nBut this also points to the fact that two group from the same group_type needs to have the same number of device otherwise the mapping during live migration will not work.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":143,"context_line":"* The PCI tracker bypasses normal PF/VF dependency logic for group"},{"line_number":144,"context_line":"  devices since all devices are intentionally allocated together"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"Live Migration Support"},{"line_number":147,"context_line":"----------------------"},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"A PCI device group is live-migratable only if ALL devices in the group"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5722f1c8_50434920","line":146,"in_reply_to":"327edfae_466c5b8e","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":153,"context_line":"* If all devices have ``live_migratable\u003d\u0027true\u0027``, the group supports"},{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"8f24cf76_c0cbee04","line":156,"updated":"2026-02-05 15:43:27.000000000","message":"I\u0027m a bit confused - would the constituent devices have their own `device_spec` entries, and then one for the group also?\n\n(later)\n\nOh, I see, you have to group devices by listing them independently and using the same group name. I guess I was expecting `address` to be a list or something.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":153,"context_line":"* If all devices have ``live_migratable\u003d\u0027true\u0027``, the group supports"},{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"db4ad882_6eca3ff4","line":156,"in_reply_to":"7a28ee3c_3de9a77b","updated":"2026-04-28 14:32:12.000000000","message":"Acknowledged","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":153,"context_line":"* If all devices have ``live_migratable\u003d\u0027true\u0027``, the group supports"},{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a28ee3c_3de9a77b","line":156,"in_reply_to":"8f24cf76_c0cbee04","updated":"2026-02-05 17:16:57.000000000","message":"we supprot exact addressees, bash globs or regex today so i dint want to also supprot it being a list\n\nbut glob syntax \n```\n# Group 8: 3b:03.0 - 3b:03.7\ndevice_spec \u003d {\"address\": \"0000:3b:03.*\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\", \"live_migratable\": true}\n```\nand regex syntax\n```\n# Group 8: 3b:09.0 - 3b:09.7\ndevice_spec \u003d {\"address\": {\"domain\": \"0000\", \"bus\": \"3b\", \"slot\": \"09\", \"function\": \"[1-7]\"}, \"group_name\": \"nic_group_8\", \"group_type\": \"NICx8\"}\n```\n\nallow you do defien a group in one line.\nin this case you can the capablities of the device woudl have to be the same for that line\n\ni decied adsress was complciate enough today without making it also possibel a list.\n\nalthough i can supprot that if you like as well\n\ndevspec is json. so \n\n```\ndevice_spec \u003d {\"address\": [\"0000:3b:03.1\", \"0000:3b:03.1\"], \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\", \"live_migratable\": true}\n```\nis easy to parse if needed","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"6e009569_8dde8fdf","line":157,"updated":"2026-02-05 14:23:52.000000000","message":"Similarly what is the relationship with other fields like:\n* physical_network: I\u0027m fairly sure that it is not supported for groupped devices as PCI is Placement needed for the groups but physical_network is not supported (yet) in PCI in Placement.\n* remote_managed: I feel that it is not supported for devices in groups)\n* trusted: I\u0027m not sure\n* managed: Probably useful still for each individual device in the group and does can be diverse within the group. But please double check my thinking\n* resource_class: Supported but cannot be divergent across devices in the same group\n* traits: Do we want to union/intersect/or reject if diverse the traits of the devices in the group?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"984489fb_8fb66c2e","line":157,"in_reply_to":"1bab4a26_d0636c9e","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1bab4a26_d0636c9e","line":157,"in_reply_to":"5dcc2a4c_9f6abad7","updated":"2026-04-17 14:37:25.000000000","message":"* Lets document with agreement above about physnet, remote_managed and trusted.\n\n* managed, live_migratbale,one_time_use, resouce_class and traits are all valid in teh devsspec for a group and have the same effect as a normal devspec\n  * live_migratable handled below that is OK\u003e\n  * managed is libvirt domain only and not schedulable so that is good too\n  * traits are being discussed above \n  * one_time_use creates needs to be documented here that if any of the device are marked as one_time_use in the spec then the whole group is one_time_use in nature as the placement inventory of the whole group will be reserved during deallocation.\n  * resouce_class and group_type overlap and therefore precedence needs to be documented in the spec","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":154,"context_line":"  live migration"},{"line_number":155,"context_line":"* If any device has ``live_migratable\u003d\u0027false\u0027`` or the tag is unset,"},{"line_number":156,"context_line":"  the group does not support live migration"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"NUMA Affinity Handling"},{"line_number":159,"context_line":"----------------------"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"5dcc2a4c_9f6abad7","line":157,"in_reply_to":"6e009569_8dde8fdf","updated":"2026-02-05 17:16:57.000000000","message":"grouping required pci in placment and we do not supprot physical_network when using that so that out of scope but if we suproted that in the future we would apply it on a per devspc basis\n\nwith that said you can only allocate groups all or nothign and i dont think we would want to allwo you to geta group via a neutorn port so my intet was to consifer it a config error if you specify physical_network on a group\n\nremote_managed and trusted both also only apply to neutron nics so they are not valid\n\nmanaged, live_migratbale,one_time_use, resouce_class and traits are all valid in teh devsspec for  a group and have the same effect as a normal devspec\n\n\nresource_class is kind of redudatn with group_type since the placement rescoue class for the groups is derived form group_type but we can allow you to overwrite it\n\n```\ndebian@hibernal01:~$ openstack --os-cloud devstack-admin resource provider inventory list 5538f512-52f3-4b72-b6b8-55f9e917f0ca\n+------------------------+------------------+----------+----------+----------+-----------+-------+------+\n| resource_class         | allocation_ratio | min_unit | max_unit | reserved | step_size | total | used |\n+------------------------+------------------+----------+----------+----------+-----------+-------+------+\n| CUSTOM_PCI_GROUP_NICX8 |              1.0 |        1 |        1 |        0 |         1 |     1 |    0 |\n+------------------------+------------------+----------+----------+----------+-----------+-------+------+\n```\n\n```\ndebian@hibernal01:~$ openstack --os-cloud devstack-admin resource provider trait list 5538f512-52f3-4b72-b6b8-55f9e917f0ca\n+----------------------------+\n| name                       |\n+----------------------------+\n| COMPUTE_MANAGED_PCI_DEVICE |\n+----------------------------+\n```","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":160,"context_line":""},{"line_number":161,"context_line":"NUMA affinity policies are evaluated across ALL devices in a group:"},{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* **REQUIRED/STRICT**: All devices in the group must have NUMA"},{"line_number":164,"context_line":"  affinity to the guest NUMA nodes"},{"line_number":165,"context_line":"* **SOCKET**: All devices must be on the same socket as the guest"},{"line_number":166,"context_line":"* **PREFER/LEGACY**: Groups are sorted by NUMA affinity score (count"}],"source_content_type":"text/x-rst","patch_set":2,"id":"0149f8f1_107efa67","line":163,"range":{"start_line":163,"start_character":13,"end_line":163,"end_character":19},"updated":"2026-04-17 14:37:25.000000000","message":"Do we have STRICT as a possible value for NUMA policy?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":160,"context_line":""},{"line_number":161,"context_line":"NUMA affinity policies are evaluated across ALL devices in a group:"},{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* **REQUIRED/STRICT**: All devices in the group must have NUMA"},{"line_number":164,"context_line":"  affinity to the guest NUMA nodes"},{"line_number":165,"context_line":"* **SOCKET**: All devices must be on the same socket as the guest"},{"line_number":166,"context_line":"* **PREFER/LEGACY**: Groups are sorted by NUMA affinity score (count"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9daa639d_648b0c2a","line":163,"range":{"start_line":163,"start_character":13,"end_line":163,"end_character":19},"in_reply_to":"0149f8f1_107efa67","updated":"2026-04-17 15:25:11.000000000","message":"\"strict\" was the intel name for \"required\" so that just an old habit\n\nill fix that\n\n\"the required policy enfoces strict affinty\"\n\nis how i think of this in my head.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":160,"context_line":""},{"line_number":161,"context_line":"NUMA affinity policies are evaluated across ALL devices in a group:"},{"line_number":162,"context_line":""},{"line_number":163,"context_line":"* **REQUIRED/STRICT**: All devices in the group must have NUMA"},{"line_number":164,"context_line":"  affinity to the guest NUMA nodes"},{"line_number":165,"context_line":"* **SOCKET**: All devices must be on the same socket as the guest"},{"line_number":166,"context_line":"* **PREFER/LEGACY**: Groups are sorted by NUMA affinity score (count"}],"source_content_type":"text/x-rst","patch_set":2,"id":"78f3d175_b368a883","line":163,"range":{"start_line":163,"start_character":13,"end_line":163,"end_character":19},"in_reply_to":"9daa639d_648b0c2a","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":163,"context_line":"* **REQUIRED/STRICT**: All devices in the group must have NUMA"},{"line_number":164,"context_line":"  affinity to the guest NUMA nodes"},{"line_number":165,"context_line":"* **SOCKET**: All devices must be on the same socket as the guest"},{"line_number":166,"context_line":"* **PREFER/LEGACY**: Groups are sorted by NUMA affinity score (count"},{"line_number":167,"context_line":"  of devices with affinity), but no groups are rejected"},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"Configuration Examples"}],"source_content_type":"text/x-rst","patch_set":2,"id":"70b7908e_48511825","line":166,"range":{"start_line":166,"start_character":4,"end_line":166,"end_character":10},"updated":"2026-04-17 14:37:25.000000000","message":"\"preferred\" I guess","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":163,"context_line":"* **REQUIRED/STRICT**: All devices in the group must have NUMA"},{"line_number":164,"context_line":"  affinity to the guest NUMA nodes"},{"line_number":165,"context_line":"* **SOCKET**: All devices must be on the same socket as the guest"},{"line_number":166,"context_line":"* **PREFER/LEGACY**: Groups are sorted by NUMA affinity score (count"},{"line_number":167,"context_line":"  of devices with affinity), but no groups are rejected"},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"Configuration Examples"}],"source_content_type":"text/x-rst","patch_set":2,"id":"f9fce99a_2746d675","line":166,"range":{"start_line":166,"start_character":4,"end_line":166,"end_character":10},"in_reply_to":"70b7908e_48511825","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":184,"context_line":"    device_spec \u003d {\"address\": \"0000:4e:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x1\"}"},{"line_number":185,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x1\"}"},{"line_number":186,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_2\", \"group_type\": \"c200_x1\"}"},{"line_number":187,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_2\", \"group_type\": \"c200_x1\"}"},{"line_number":188,"context_line":"    alias \u003d {\"name\": \"c200_x1\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X1\"}"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"But exposing the two cards, exposed as four PCI devices,"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7fa01eda_80306bd2","line":187,"updated":"2026-02-05 15:43:27.000000000","message":"This feels laborious and clumsy to me, and also that automated (like CRUD) maintenance of this list becomes harder (granted, it\u0027s already hard and clumsy).","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":184,"context_line":"    device_spec \u003d {\"address\": \"0000:4e:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x1\"}"},{"line_number":185,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x1\"}"},{"line_number":186,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_2\", \"group_type\": \"c200_x1\"}"},{"line_number":187,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_2\", \"group_type\": \"c200_x1\"}"},{"line_number":188,"context_line":"    alias \u003d {\"name\": \"c200_x1\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X1\"}"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"But exposing the two cards, exposed as four PCI devices,"}],"source_content_type":"text/x-rst","patch_set":2,"id":"c433d5b9_a28559d0","line":187,"in_reply_to":"0405494d_9a04bd62","updated":"2026-05-08 14:46:29.000000000","message":"Actually we can simplify the device_spec in the example :) Done.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":true,"context_lines":[{"line_number":184,"context_line":"    device_spec \u003d {\"address\": \"0000:4e:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x1\"}"},{"line_number":185,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x1\"}"},{"line_number":186,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_2\", \"group_type\": \"c200_x1\"}"},{"line_number":187,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_2\", \"group_type\": \"c200_x1\"}"},{"line_number":188,"context_line":"    alias \u003d {\"name\": \"c200_x1\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X1\"}"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"But exposing the two cards, exposed as four PCI devices,"}],"source_content_type":"text/x-rst","patch_set":2,"id":"0405494d_9a04bd62","line":187,"in_reply_to":"7fa01eda_80306bd2","updated":"2026-04-28 14:32:12.000000000","message":"We did not touched on this during the PTG. But lets discuss it in the spec now if needed. This design comes from the original 2023.1 spec. \n\nAn alternative could be keeping the device_spec as is and adding a separate config that defines a grouping of the devices. But then we would somehow re-identify the devices when defining the group in a similar way how we identify device in the device_spec. So that would not be easier.\n\n@dms@danplanet.com do you have some specific direction we should investigate about a better configuration model for the groups?\n\nThe minimum req of any config model is:\n* A way to define what can be requested from the pci alias, i.e. a group_type\n* A way to define instances of the group_type (to support multiple groups of the same group_type on the same compute)\n* A way to assign devices to a group\n* A way to assign extra properties to a group like traits\n* A way to assign extra properties to a group_type like the resource_class to override the default one if needed.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"09be9125_fab5f203","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"updated":"2026-02-05 14:23:52.000000000","message":"as configuring the alias this way needs the knowledge of the RC generation logic in nova do we want to add support for group_type as a syntactic sugar to the alias as well?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"9f59dcb5e45b3886b3ecbfdd1d27e8ef8938e466","unresolved":true,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"50d42a85_f4e0c3f7","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"in_reply_to":"01ebffea_50f79a23","updated":"2026-04-17 17:44:02.000000000","message":"if we allow any RC to be used in the group definition in the device_spec then that group is only requestable in the alias if we allow resource_class in the alias too. So we need to decide the device_spec suport case first then that will inform what we need to support in the alias","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"c867fb12_a397e2f9","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"in_reply_to":"09be9125_fab5f203","updated":"2026-02-05 17:16:57.000000000","message":"no this is a bug you need group_type in the alias\n```\n# Alias for requesting NICx8 groups via flavor\nalias \u003d {\"name\": \"NICx8\", \"resource_class\": \"CUSTOM_PCI_GROUP_NICX8\", \"group_type\": \"NICx8\"}\n```\n\"resource_class\": \"CUSTOM_PCI_GROUP_NICX8\" is optional in this case it was there because i orgianlly had a bug in may poc \n\nso this is what i woudl expect folks to actully use.\n```\nalias \u003d {\"name\": \"NICx8\", \"group_type\": \"NICx8\"}\n```\n\nbut you jsut need to know the group_type to make it work.\n\n\nif i really wanted i could probaly make this work without pci in placmeent if im behing honest\n\ni dont specificly see a blocker to supproting that but it was out of scope fo the spec before so i didnt want to bring it in in the new revision.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"94887c50_254096a4","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"in_reply_to":"50d42a85_f4e0c3f7","updated":"2026-04-28 14:32:12.000000000","message":"As discussed on the PTG we support both group_type and resource_class override in the [pci]alias. I\u0027ve updated the spec accordingly.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"9607833603cda3df579ebe4390b09569506d2c33","unresolved":true,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"01ebffea_50f79a23","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"in_reply_to":"8c43b9f1_127aeb69","updated":"2026-04-17 15:31:31.000000000","message":"just to clarify the exeact way we implemnt the resouce class in placment feels like an implemation detail that operators shoudl not need to understand in the happy path. group_type gives us an indriection where we can hide those details behind a afordance that also makes the overcall ux cleaner.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"4ed806da121e5c620c8c0fe5ddae79618b67e681","unresolved":true,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"8c43b9f1_127aeb69","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"in_reply_to":"b6c4f752_1e368222","updated":"2026-04-17 15:25:11.000000000","message":"well alias \u003d {\"name\": \"NICx8\", \"group_type\": \"NICx8\"} is the inteded way for it to work\n\nbut the example was before i fixed the bug i had in the poc\n\nalias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}\nwill also work.\n\nalias \u003d {\"name\": \"c200_x2\", \"group_type\": \"C200_X2\"}\n\nis identical and less typing.\n\nwe have speical resource_class normalistation logic toady that will take\n\n\"resource_class\": \"c200\" and convert it to  \"CUSTOM_PCI_C200\"\n\ni.e. it handel the PREFIXING wiht CUSTOM_ and making it uppercase with undersores\n\ngroup_type play the same role for groups","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":195,"context_line":"    device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":196,"context_line":"    device_spec \u003d {\"address\": \"0000:89:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":197,"context_line":"    device_spec \u003d {\"address\": \"0000:8a:00.0\", \"group_name\": \"graphcore_1\", \"group_type\": \"c200_x2\"}"},{"line_number":198,"context_line":"    alias \u003d {\"name\": \"c200_x2\", \"resource_class\": \"CUSTOM_PCI_GROUP_C200_X2\"}"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Alternatives"},{"line_number":201,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"b6c4f752_1e368222","line":198,"range":{"start_line":198,"start_character":32,"end_line":198,"end_character":76},"in_reply_to":"c867fb12_a397e2f9","updated":"2026-04-17 14:37:25.000000000","message":"I guess we then need both group_type and RC support in the alias and then define the precedence there as well.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":206,"context_line":"Data model impact"},{"line_number":207,"context_line":"-----------------"},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"The following internal data structures and classes are modified or added:"},{"line_number":210,"context_line":""},{"line_number":211,"context_line":"**PciDeviceSpec (nova/pci/devspec.py)**"},{"line_number":212,"context_line":""},{"line_number":213,"context_line":"* New constants: ``GROUP_NAME_TAG``, ``GROUP_TYPE_TAG``"},{"line_number":214,"context_line":"* New method: ``get_group_info()`` returns ``(group_name, group_type)``"},{"line_number":215,"context_line":"  tuple if the device is part of a group, otherwise ``None``"},{"line_number":216,"context_line":"* New validation: ``_validate_group_tags()`` enforces mutual dependency"},{"line_number":217,"context_line":"  of both group tags and requires ``report_in_placement \u003d True``"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"**Whitelist (nova/pci/whitelist.py)**"},{"line_number":220,"context_line":""},{"line_number":221,"context_line":"* New method: ``get_groups()`` returns a dict mapping group names to"},{"line_number":222,"context_line":"  lists of device specs in each group"},{"line_number":223,"context_line":"* New method: ``_validate_groups()`` enforces validation rules (minimum"},{"line_number":224,"context_line":"  2 devices per group, same group_type, no duplicate addresses)"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"**PciDeviceStats (nova/pci/stats.py)**"},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"* Pool keys extended with ``group_name`` and ``group_type``"},{"line_number":229,"context_line":"* New method: ``_is_group_pool()`` identifies group pools"},{"line_number":230,"context_line":"* New method: ``_allocate_group()`` atomically consumes all devices"},{"line_number":231,"context_line":"* New method: ``_update_group_pool_live_migratable()`` applies most"},{"line_number":232,"context_line":"  restrictive live_migratable value across group devices"},{"line_number":233,"context_line":"* New NUMA filtering methods for group pools"},{"line_number":234,"context_line":""},{"line_number":235,"context_line":"**PciGroupResourceProvider (nova/compute/pci_placement_translator.py)**"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"* New class to represent a group as a single Placement resource provider"},{"line_number":238,"context_line":"* Manages list of devices, resource class, and traits"},{"line_number":239,"context_line":"* ``total`` property returns 1 only when ALL devices are available"},{"line_number":240,"context_line":"* ``update_provider_tree()`` creates/updates the group RP in Placement"},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"**PciDevTracker (nova/pci/manager.py)**"},{"line_number":243,"context_line":""},{"line_number":244,"context_line":"* Atomic claim/allocate operations bypass PF/VF dependency logic for"},{"line_number":245,"context_line":"  group devices (identified by ``request_id`` field)"},{"line_number":246,"context_line":""},{"line_number":247,"context_line":"No database schema changes are required. Group membership is tracked"}],"source_content_type":"text/x-rst","patch_set":2,"id":"c5d40efb_5063fc81","line":244,"range":{"start_line":209,"start_character":0,"end_line":244,"end_character":56},"updated":"2026-04-28 14:32:12.000000000","message":"Dropping it as very much an implementation detail","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":286,"context_line":"* Each group must contain at least 2 devices"},{"line_number":287,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":288,"context_line":""},{"line_number":289,"context_line":"**Error Messages:**"},{"line_number":290,"context_line":""},{"line_number":291,"context_line":"Operators will encounter the following errors for invalid configurations:"},{"line_number":292,"context_line":""},{"line_number":293,"context_line":"* ``\"group_name and group_type must be specified together\"`` - when only"},{"line_number":294,"context_line":"  one tag is provided"},{"line_number":295,"context_line":"* ``\"PCI groups require report_in_placement to be enabled\"`` - when"},{"line_number":296,"context_line":"  groups are configured without Placement tracking"},{"line_number":297,"context_line":"* ``\"PCI group \u0027X\u0027 must have at least 2 devices, but only has 1\"`` - when"},{"line_number":298,"context_line":"  a group has insufficient devices"},{"line_number":299,"context_line":"* ``\"PCI group \u0027X\u0027 has mixed group_type values\"`` - when devices in the"},{"line_number":300,"context_line":"  same group have different group_type values"},{"line_number":301,"context_line":"* ``\"Device \u0027X\u0027 is configured in multiple groups\"`` - when the same"},{"line_number":302,"context_line":"  device address appears in multiple groups"},{"line_number":303,"context_line":""},{"line_number":304,"context_line":"**Live Migration Configuration:**"},{"line_number":305,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"82200835_af8de5c5","line":302,"range":{"start_line":289,"start_character":0,"end_line":302,"end_character":43},"updated":"2026-04-28 14:32:12.000000000","message":"This feels like an implementation detail. Dropping it.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":328,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":329,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":330,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"**Rolling upgrade considerations:**"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"When upgrading a deployment:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1c2d0e49_07e6987f","line":331,"updated":"2026-02-05 14:23:52.000000000","message":"Similarly we might want to have the reverse procedure in the spec (outside of upgrade) saying how can one remove an individual device from a group and consume it as an individual device.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"49196a3c5bcc21bd7a3e5aa77b403e3596a9d578","unresolved":true,"context_lines":[{"line_number":328,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":329,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":330,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"**Rolling upgrade considerations:**"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"When upgrading a deployment:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"621fb278_5d77ac42","line":331,"in_reply_to":"1c2d0e49_07e6987f","updated":"2026-02-05 15:43:27.000000000","message":"What happens if they skip step 1 above? Will compute survey instances before modifying the config in placement?","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":328,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":329,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":330,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"**Rolling upgrade considerations:**"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"When upgrading a deployment:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5cac01e4_1f399579","line":331,"in_reply_to":"1d5022a8_bffc1bd6","updated":"2026-04-17 14:37:25.000000000","message":"\u003e i suggested makign that a start up error that block nova-comptue starting in the past but we desied that was too extreame and just log a large warning\n\nThe reason of it is the following. If you have 20 VMs on a host. One allocated PCI device dies and dissapearse from the host then 1 VM is probably in trouble. But by preventing nova-compute to be restarted in this state casues that the other 19 VM becomes unmanageable (other than evacuation).\n\nWe need to agree that we do the same for the groups and then mention that in the spec.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":328,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":329,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":330,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"**Rolling upgrade considerations:**"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"When upgrading a deployment:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"0e27e5a7_1f6ba4e2","line":331,"in_reply_to":"5cac01e4_1f399579","updated":"2026-04-28 14:32:12.000000000","message":"My current working assumption but we need to test is:\n* When a device_spec change removes a device from the config while the device is allocated nova keeps the device in the tracker. (I\u0027m pretty sure about this behavior today with non groupped devices)\n* If this device re-appear without further changes then nova keep using it. (i.e. temporary mistake in the config that is fixed, or a device replacement with the same type)\n* if this pci address reappears with different config / type / then the that should be a hard error at nova-compute starutp. I\u0027m not sure this is in place today. But it will be even more important when grouping is implemented to avoid removing a device from a group while it is in use and re-adding the same device but now in a different group. We need to prevent that.\n\nI added wording about it in the spec.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":328,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":329,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":330,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":331,"context_line":""},{"line_number":332,"context_line":"**Rolling upgrade considerations:**"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"When upgrading a deployment:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1d5022a8_bffc1bd6","line":331,"in_reply_to":"621fb278_5d77ac42","updated":"2026-02-05 17:16:57.000000000","message":"we have some productions in teh pci tracker today but i likely need to harden it more\n\nso today if you modify the pci devspecs and remove a device that is assgiend to a vm we keep the device in the pci tracker and in the database assinted to that vm and it only gets removed when the vm is deleted or mvoed\n\n\ni suggested makign that a start up error that block nova-comptue starting in the past but we desied that was too extreame and just log a large warning \n\nso i woudl proably block the reportign fo the group until this is fix and issue a warning on startup.\n\ngoing backward i thinks is basiclly the same procedure it just make sure the group is not in use.  and update the config, nova will need to delete the rp for the group and then create the new rps for the indiviual devices","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":339,"context_line":"  older nodes will not report the new group resource classes"},{"line_number":340,"context_line":"* No API or conductor changes are required"},{"line_number":341,"context_line":"* Flavors with group aliases can be created before all computes are"},{"line_number":342,"context_line":"  upgraded; scheduling will only select upgraded hosts"},{"line_number":343,"context_line":""},{"line_number":344,"context_line":"**Backward compatibility:**"},{"line_number":345,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1b17eab3_25ae3357","line":342,"updated":"2026-04-17 14:37:25.000000000","message":"yepp this seems OK. PCI in Placement gating is there and after that Placement will gate the scheduling.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":339,"context_line":"  older nodes will not report the new group resource classes"},{"line_number":340,"context_line":"* No API or conductor changes are required"},{"line_number":341,"context_line":"* Flavors with group aliases can be created before all computes are"},{"line_number":342,"context_line":"  upgraded; scheduling will only select upgraded hosts"},{"line_number":343,"context_line":""},{"line_number":344,"context_line":"**Backward compatibility:**"},{"line_number":345,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"71beb2e1_f3098923","line":342,"in_reply_to":"1b17eab3_25ae3357","updated":"2026-04-28 14:32:12.000000000","message":"Done","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f0f750ce8d7b02c412195b5294d44a0f7ab128b1","unresolved":true,"context_lines":[{"line_number":360,"context_line":"---------------"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"Feature liaison:"},{"line_number":363,"context_line":"  gibi?"},{"line_number":364,"context_line":""},{"line_number":365,"context_line":"Work Items"},{"line_number":366,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"781e92fb_866861df","line":363,"updated":"2026-02-05 14:23:52.000000000","message":"sure but depending on capacity/priority/scheduling","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":true,"context_lines":[{"line_number":360,"context_line":"---------------"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"Feature liaison:"},{"line_number":363,"context_line":"  gibi?"},{"line_number":364,"context_line":""},{"line_number":365,"context_line":"Work Items"},{"line_number":366,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"d9302e16_937672a1","line":363,"in_reply_to":"5cbf194c_3cd762e9","updated":"2026-04-28 14:32:12.000000000","message":"Plan are in flux. I was asked to discuss this feature on the PTG and hinted towards taking it over entirely. So after the PTG took the liberty and updated the spec with the discussion points from the PTG. At the same time I\u0027m tentatively flipping Primary assignee and Feature liaison here. As soon as my employer decided the resource allocation firmly I will finalized these assignments as well in the spec.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"47b7d76fdaa9811d6ec29d52d2efc4c5b7b2b1de","unresolved":true,"context_lines":[{"line_number":360,"context_line":"---------------"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"Feature liaison:"},{"line_number":363,"context_line":"  gibi?"},{"line_number":364,"context_line":""},{"line_number":365,"context_line":"Work Items"},{"line_number":366,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"dc7f44e4_5ccb3e23","line":363,"in_reply_to":"781e92fb_866861df","updated":"2026-02-05 17:16:57.000000000","message":"this is here just because your name with a question mark was in the previsly appvoed spec https://specs.openstack.org/openstack/nova-specs/specs/2024.1/approved/pci-passthrough-groups.html#feature-liaison 😊\n\nand i was hoping you would be ok with it but if not i can update.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":360,"context_line":"---------------"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"Feature liaison:"},{"line_number":363,"context_line":"  gibi?"},{"line_number":364,"context_line":""},{"line_number":365,"context_line":"Work Items"},{"line_number":366,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"abf71c2c_474ead10","line":363,"in_reply_to":"d9302e16_937672a1","updated":"2026-05-08 16:47:58.000000000","message":"Ack we can work out how to progress this together as the cycle progresses\nas i said im happy to review, test or implement as required.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"1eff459d5bab7d67ea321a7b0c6b2fc5d85edf4a","unresolved":true,"context_lines":[{"line_number":360,"context_line":"---------------"},{"line_number":361,"context_line":""},{"line_number":362,"context_line":"Feature liaison:"},{"line_number":363,"context_line":"  gibi?"},{"line_number":364,"context_line":""},{"line_number":365,"context_line":"Work Items"},{"line_number":366,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5cbf194c_3cd762e9","line":363,"in_reply_to":"dc7f44e4_5ccb3e23","updated":"2026-04-17 14:37:25.000000000","message":"Commitment from more than 2 years ago is non-transferable automatically :) \nBut it very much seems that I\u0027m the lucky guy this time again.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":365,"context_line":"Work Items"},{"line_number":366,"context_line":"----------"},{"line_number":367,"context_line":""},{"line_number":368,"context_line":"1. **Configuration Layer (nova/conf/pci.py, nova/pci/devspec.py)**"},{"line_number":369,"context_line":""},{"line_number":370,"context_line":"   * Add ``group_name`` and ``group_type`` tag documentation"},{"line_number":371,"context_line":"   * Implement tag parsing and validation in ``PciDeviceSpec``"},{"line_number":372,"context_line":"   * Add ``get_group_info()`` method to retrieve group membership"},{"line_number":373,"context_line":""},{"line_number":374,"context_line":"2. **Whitelist Validation (nova/pci/whitelist.py)**"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"   * Add ``get_groups()`` method to collect devices by group name"},{"line_number":377,"context_line":"   * Add ``_validate_groups()`` to enforce group constraints"},{"line_number":378,"context_line":""},{"line_number":379,"context_line":"3. **Placement Integration (nova/compute/pci_placement_translator.py)**"},{"line_number":380,"context_line":""},{"line_number":381,"context_line":"   * Create ``PciGroupResourceProvider`` class"},{"line_number":382,"context_line":"   * Implement group RP creation with inventory\u003d1 semantics"},{"line_number":383,"context_line":"   * Add group device routing in ``PlacementView``"},{"line_number":384,"context_line":""},{"line_number":385,"context_line":"4. **Pool Management (nova/pci/stats.py)**"},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"   * Extend pool keys with group_name and group_type"},{"line_number":388,"context_line":"   * Add ``_is_group_pool()`` identification method"},{"line_number":389,"context_line":"   * Implement ``_allocate_group()`` for atomic allocation"},{"line_number":390,"context_line":"   * Add ``_update_group_pool_live_migratable()`` for live migration"},{"line_number":391,"context_line":"   * Add NUMA affinity filtering methods for group pools"},{"line_number":392,"context_line":""},{"line_number":393,"context_line":"5. **Claim and Allocation (nova/pci/manager.py)**"},{"line_number":394,"context_line":""},{"line_number":395,"context_line":"   * Modify ``_claim_instance()`` to handle group devices"},{"line_number":396,"context_line":"   * Modify ``_allocate_instance()`` for atomic group allocation"},{"line_number":397,"context_line":"   * Bypass PF/VF dependency logic for group devices"},{"line_number":398,"context_line":""},{"line_number":399,"context_line":"6. **Unit Tests**"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"   * test_devspec.py - group tag parsing and validation"},{"line_number":402,"context_line":"   * test_whitelist.py - group validation rules"},{"line_number":403,"context_line":"   * test_stats.py - group pool handling, live_migratable, NUMA"},{"line_number":404,"context_line":"   * test_pci_placement_translator.py - PciGroupResourceProvider"},{"line_number":405,"context_line":""},{"line_number":406,"context_line":"7. **Functional Tests**"},{"line_number":407,"context_line":""},{"line_number":408,"context_line":"   * PlacementPCIGroupTests - inventory, allocation, scheduling"},{"line_number":409,"context_line":"   * PlacementPCIGroupLiveMigrationTests - live migration scenarios"},{"line_number":410,"context_line":""},{"line_number":411,"context_line":"8. **Documentation**"},{"line_number":412,"context_line":""},{"line_number":413,"context_line":"   * Update admin guide for PCI passthrough"},{"line_number":414,"context_line":"   * Add developer reference documentation"},{"line_number":415,"context_line":""},{"line_number":416,"context_line":"Dependencies"},{"line_number":417,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":418,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"04122edf_94d72046","line":415,"range":{"start_line":368,"start_character":0,"end_line":415,"end_character":0},"updated":"2026-04-28 14:32:12.000000000","message":"Simplified to remove implementation details like then names of private functions.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"60af217d4850a63d14db98e598fa2b6f86bfaa47","unresolved":false,"context_lines":[{"line_number":421,"context_line":"Testing"},{"line_number":422,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":423,"context_line":""},{"line_number":424,"context_line":"**Unit Tests (nova/tests/unit/pci/)**"},{"line_number":425,"context_line":""},{"line_number":426,"context_line":"* ``test_devspec.py`` - Tests for group tag parsing:"},{"line_number":427,"context_line":""},{"line_number":428,"context_line":"  * Extraction of group_name and group_type from device_spec"},{"line_number":429,"context_line":"  * Validation that both tags must be specified together"},{"line_number":430,"context_line":"  * Validation that report_in_placement must be enabled"},{"line_number":431,"context_line":""},{"line_number":432,"context_line":"* ``test_whitelist.py`` - Tests for group validation:"},{"line_number":433,"context_line":""},{"line_number":434,"context_line":"  * Groups with fewer than 2 devices are rejected"},{"line_number":435,"context_line":"  * Groups with 2+ devices are accepted"},{"line_number":436,"context_line":"  * Devices in multiple groups are rejected"},{"line_number":437,"context_line":"  * Mixed group_type values in same group are rejected"},{"line_number":438,"context_line":""},{"line_number":439,"context_line":"* ``test_stats.py`` - Tests for pool and allocation:"},{"line_number":440,"context_line":""},{"line_number":441,"context_line":"  * Group pools identified correctly by _is_group_pool()"},{"line_number":442,"context_line":"  * Atomic allocation consumes all devices"},{"line_number":443,"context_line":"  * live_migratable uses most restrictive value"},{"line_number":444,"context_line":"  * NUMA affinity filtering for group pools"},{"line_number":445,"context_line":""},{"line_number":446,"context_line":"* ``test_pci_placement_translator.py`` - Tests for Placement:"},{"line_number":447,"context_line":""},{"line_number":448,"context_line":"  * Group RP inventory is always 1"},{"line_number":449,"context_line":"  * Resource class generated from group_type"},{"line_number":450,"context_line":"  * All devices get same RP UUID"},{"line_number":451,"context_line":"  * Allocation updates all devices atomically"},{"line_number":452,"context_line":""},{"line_number":453,"context_line":"**Functional Tests (nova/tests/functional/libvirt/test_pci_in_placement.py)**"},{"line_number":454,"context_line":""},{"line_number":455,"context_line":"* ``PlacementPCIGroupTests`` class:"},{"line_number":456,"context_line":""},{"line_number":457,"context_line":"  * test_pci_group_rp_inventory_reported - Groups reported with inventory\u003d1"},{"line_number":458,"context_line":"  * test_pci_group_allocation_claims_all_devices - Atomic allocation"},{"line_number":459,"context_line":"  * test_pci_group_freed_on_delete - Devices freed on instance delete"},{"line_number":460,"context_line":"  * test_pci_group_scheduling_fails_insufficient_groups - NoValidHost"},{"line_number":461,"context_line":"  * test_pci_group_scheduling_with_alias - Flavor alias scheduling"},{"line_number":462,"context_line":"  * test_pci_group_with_heterogeneous_devices - Mixed device types"},{"line_number":463,"context_line":"  * test_pci_group_with_numa_affinity - NUMA policy handling"},{"line_number":464,"context_line":"  * test_pci_group_scheduling_respects_numa_strict - NUMA strict policy"},{"line_number":465,"context_line":""},{"line_number":466,"context_line":"* ``PlacementPCIGroupLiveMigrationTests`` class:"},{"line_number":467,"context_line":""},{"line_number":468,"context_line":"  * test_pci_group_live_migrate_success_all_devices_live_migratable"},{"line_number":469,"context_line":"  * test_pci_group_live_migrate_fails_one_device_not_live_migratable"},{"line_number":470,"context_line":"  * test_pci_group_live_migrate_fails_device_unset_live_migratable"},{"line_number":471,"context_line":""},{"line_number":472,"context_line":"These tests use the existing fake libvirt driver infrastructure and do"},{"line_number":473,"context_line":"not require specialized hardware."},{"line_number":474,"context_line":""},{"line_number":475,"context_line":"Documentation Impact"},{"line_number":476,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"758c2c4d_6e98990e","line":473,"range":{"start_line":424,"start_character":0,"end_line":473,"end_character":33},"updated":"2026-04-28 14:32:12.000000000","message":"Trimmed heavily as most of it is implementation detail.","commit_id":"f6ca110cad80c17846cfc1a3ed765bb068fb74f3"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":24,"context_line":"Some PCI devices only make sense to be consumed as a group."},{"line_number":25,"context_line":"When you assign the grouped PCI devices to a VM, all of the"},{"line_number":26,"context_line":"devices in the group are always consumed together by a single VM."},{"line_number":27,"context_line":"Currently Nova does not understand any grouping other than"},{"line_number":28,"context_line":"NUMA affinity."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"While there are some cases where a device could be consumed by"}],"source_content_type":"text/x-rst","patch_set":3,"id":"38f62761_627e5305","line":27,"range":{"start_line":27,"start_character":39,"end_line":27,"end_character":47},"updated":"2026-04-29 20:24:41.000000000","message":"this is probaly form my or the orgininal specs wording but refelctign on some to the quetion that came up in the reviwe i have a general terminology suggestion to help with the clarity of this.\n\ninsted of grouping lets use `affinity` here.\n\nthe reaons to avoid grouping here is we are defineign groups as indivsiable\n\nwere as pci devices that happen to share a numa node can in general be allocated independently\n\nso in the problem statement wew shoudlsay the only wahy ot have aggreates of pci devices today based on a common trait is numa affinity of phsyical network\n\nwithin this spec lets try to use the term group \n\nwe could also add a very short terminology glossary if we wanted to make this more explity.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Some PCI devices only make sense to be consumed as a group."},{"line_number":25,"context_line":"When you assign the grouped PCI devices to a VM, all of the"},{"line_number":26,"context_line":"devices in the group are always consumed together by a single VM."},{"line_number":27,"context_line":"Currently Nova does not understand any grouping other than"},{"line_number":28,"context_line":"NUMA affinity."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"While there are some cases where a device could be consumed by"}],"source_content_type":"text/x-rst","patch_set":3,"id":"f6f21b11_f5ef0835","line":27,"range":{"start_line":27,"start_character":39,"end_line":27,"end_character":47},"in_reply_to":"38f62761_627e5305","updated":"2026-05-08 14:46:29.000000000","message":"Changed the wording here. Let me know if this is better or not.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Each physical card presents two PCI devices. The card can be used"},{"line_number":59,"context_line":"independently of other cards if a matched pair of devices are"},{"line_number":60,"context_line":"presented to the VM. PCI groups allows this device to be correctly"},{"line_number":61,"context_line":"passed through to VMs by ensuring a matched pair of PCI devices are"},{"line_number":62,"context_line":"always assigned to each VM."},{"line_number":63,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"155d3da0_ab7ffc61","line":60,"range":{"start_line":60,"start_character":21,"end_line":60,"end_character":38},"updated":"2026-04-28 15:49:11.000000000","message":"nit if you respin, this should be \"PCI grouping allows\" or \"PCI groups allow\"","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Each physical card presents two PCI devices. The card can be used"},{"line_number":59,"context_line":"independently of other cards if a matched pair of devices are"},{"line_number":60,"context_line":"presented to the VM. PCI groups allows this device to be correctly"},{"line_number":61,"context_line":"passed through to VMs by ensuring a matched pair of PCI devices are"},{"line_number":62,"context_line":"always assigned to each VM."},{"line_number":63,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"747687f6_17980327","line":60,"range":{"start_line":60,"start_character":21,"end_line":60,"end_character":38},"in_reply_to":"155d3da0_ab7ffc61","updated":"2026-04-29 20:24:41.000000000","message":"alternitivly someting like this building on dans suggetion.\n\n```\npresented to the VM. PCI groups allow this set of devices to be correctly\n```\n\n```suggestion\npresented to the VM. PCI grouping allows these devices to be correctly\n```","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":57,"context_line":""},{"line_number":58,"context_line":"Each physical card presents two PCI devices. The card can be used"},{"line_number":59,"context_line":"independently of other cards if a matched pair of devices are"},{"line_number":60,"context_line":"presented to the VM. PCI groups allows this device to be correctly"},{"line_number":61,"context_line":"passed through to VMs by ensuring a matched pair of PCI devices are"},{"line_number":62,"context_line":"always assigned to each VM."},{"line_number":63,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"c30d4446_dacb6eb8","line":60,"range":{"start_line":60,"start_character":21,"end_line":60,"end_character":38},"in_reply_to":"747687f6_17980327","updated":"2026-05-08 14:46:29.000000000","message":"Done","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":61,"context_line":"passed through to VMs by ensuring a matched pair of PCI devices are"},{"line_number":62,"context_line":"always assigned to each VM."},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"In addition, some servers can be statically configured to group"},{"line_number":65,"context_line":"either two devices, four devices or eight devices as a single group."},{"line_number":66,"context_line":"These can all be statically configured using PCI group to ensure"},{"line_number":67,"context_line":"we always respect the non-PCI connectivity between those PCI devices."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Other than Graphcore C200 devices, both major GPU vendors support connecting"},{"line_number":70,"context_line":"multiple GPU cards together (see Nvidia NVLink and AMD InfinityFabric) outside"}],"source_content_type":"text/x-rst","patch_set":3,"id":"dc6cea9d_997d4732","line":67,"range":{"start_line":64,"start_character":0,"end_line":67,"end_character":69},"updated":"2026-04-28 15:49:11.000000000","message":"I don\u0027t think I understand this paragraph. \"some servers can group devices into a group\" ...? Is that referring to some behavior of physical servers? I assume the second sentence is referring to a *nova* PCI group being configured to reflect this physical grouping?","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":61,"context_line":"passed through to VMs by ensuring a matched pair of PCI devices are"},{"line_number":62,"context_line":"always assigned to each VM."},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"In addition, some servers can be statically configured to group"},{"line_number":65,"context_line":"either two devices, four devices or eight devices as a single group."},{"line_number":66,"context_line":"These can all be statically configured using PCI group to ensure"},{"line_number":67,"context_line":"we always respect the non-PCI connectivity between those PCI devices."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Other than Graphcore C200 devices, both major GPU vendors support connecting"},{"line_number":70,"context_line":"multiple GPU cards together (see Nvidia NVLink and AMD InfinityFabric) outside"}],"source_content_type":"text/x-rst","patch_set":3,"id":"a7a06118_1cdff104","line":67,"range":{"start_line":64,"start_character":0,"end_line":67,"end_character":69},"in_reply_to":"b35ba6c1_0ed1e364","updated":"2026-05-08 14:46:29.000000000","message":"Done","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":61,"context_line":"passed through to VMs by ensuring a matched pair of PCI devices are"},{"line_number":62,"context_line":"always assigned to each VM."},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"In addition, some servers can be statically configured to group"},{"line_number":65,"context_line":"either two devices, four devices or eight devices as a single group."},{"line_number":66,"context_line":"These can all be statically configured using PCI group to ensure"},{"line_number":67,"context_line":"we always respect the non-PCI connectivity between those PCI devices."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Other than Graphcore C200 devices, both major GPU vendors support connecting"},{"line_number":70,"context_line":"multiple GPU cards together (see Nvidia NVLink and AMD InfinityFabric) outside"}],"source_content_type":"text/x-rst","patch_set":3,"id":"b35ba6c1_0ed1e364","line":67,"range":{"start_line":64,"start_character":0,"end_line":67,"end_character":69},"in_reply_to":"dc6cea9d_997d4732","updated":"2026-04-29 20:24:41.000000000","message":"let use teh term `compute node` or `hypervisor host` when we are talkign about the phsyical host for calrity\n\n\n\n```suggestion\nIn addition, some compute nodes can be statically configured to partition\neither two devices, four devices or eight devices as a single group.\nThese can all be statically configured using PCI group to ensure\nwe always allocate them as a single indivisible unit regardless of there\nconnectivity.\n```","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":72,"context_line":"to request connected sets of GPUs to utilize the extra performance"},{"line_number":73,"context_line":"provided via these cross connect technologies. PCI Grouping can model a"},{"line_number":74,"context_line":"static grouping to support this use case."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"Proposed change"},{"line_number":77,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":78,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"591f2b43_21f318bb","line":75,"updated":"2026-04-29 20:24:41.000000000","message":"do we want to allso just call out that static grouping of any set of assingabel deivces is genericly possibel or just leave that implic.\n\n\ni.e. if you want to provide a gpu, and a usb contoler (that happens to have a keybaor and mouse)  to a vm sothat you can do thinkg like boot vms that can be used with a remote kvm (think nanokvm) can be done\n\nbasiclly any other usecase where you jsut have a set of pci device that shoudl be provide toghether.\n\nthe more concreate one that come to midn is a vituralised E-nodeB\nin the telco edge speace.\n\nthe eNodeB https://en.wikipedia.org/wiki/ENodeB\nis the phsycial element that iterconnect teh radio transcere on a cell tower to the backhaul fiber network and translates between teh two\n\nwe have had 5 moblie carrise build out nova compute at these edge site and manuall group them by booting vms in a specific order on the host to work aroudn this limitaiotn.\n\ni.e. each vm neede to be configure to use manage a specific downling and trnaserver and in there case they coudl nto reboot the vm once it was created so it was trully as static assignment.\n\nthey did mintance by deletign the vm and repovisoning it one at a time\n\nwith thi snew mecanium instead of havign to do that by orderign the vm deletion and creation they coudl describe each pair fo trancerver ancerver mangemnt card and donwlink nic as a group.\n\n\nthis is a case wehre logicly ther eis a corraltion between 2 indepented devices that need to be allcoated as a group but phsycialy there is no interconenctor other relation ship.\n\nthe corralation is prutly down to the management lay fo the vEPC deployemnt\n\nmy understading is they had soem sort of configuration database that used a cartoristic fo the device i.e. it sserial to lookup what there applcation should do so whne the vm boots it introspected the device it was provided and then bootstrap the vm to perfom that funciton.\n\nhow that worked was entirly out of band of openstack but im just providign this as an addtionl usecase that we have had custoerm on our osp 16 and later relases successfully deploy into production even if the operatioanl overhead fo that is high.\n\nwith pci groupign the OPex of that woudl be much impvoed.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":72,"context_line":"to request connected sets of GPUs to utilize the extra performance"},{"line_number":73,"context_line":"provided via these cross connect technologies. PCI Grouping can model a"},{"line_number":74,"context_line":"static grouping to support this use case."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"Proposed change"},{"line_number":77,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":78,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"7d666dd4_77055f46","line":75,"in_reply_to":"591f2b43_21f318bb","updated":"2026-05-08 14:46:29.000000000","message":"I tried to capture this logical grouping in a new use case without going into too much details (I don\u0027t hav) about ENodeB. :)","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":82,"context_line":"  line now either will define a set of matched PCI devices from the host as"},{"line_number":83,"context_line":"  individual devices or directly include them into a named group of devices"},{"line_number":84,"context_line":"  depending on the fields in the spec used."},{"line_number":85,"context_line":"* Devices are linked by both a group type name, and a specific group name. The"},{"line_number":86,"context_line":"  ``group_type`` defines what can be requested via the PCI alias later. While"},{"line_number":87,"context_line":"  the ``group_name`` is just an identifier for the given instance of the"},{"line_number":88,"context_line":"  ``group_type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"faa5e4cf_c9f0f7d7","line":85,"range":{"start_line":85,"start_character":31,"end_line":85,"end_character":41},"updated":"2026-04-29 20:24:41.000000000","message":"if we add a termonolary referece i woudl also defien group_type as a distinct term form pci_group or group_name\n\n\nwhere group_type is a logical colelction pci devices\na pci_group is a concreate set of devics that correspond to a given group_type\nand the group_name is a partial uniqe identifyer for a concreate pci_groups of a give\ngroup type on a speicfic host.\n\n\nthis is defiend in prose below and i understand this implcitly i just recall how useful https://specs.openstack.org/openstack/nova-specs/specs/train/implemented/cpu-resources.html#definitions was to keep everyone on the same page.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":82,"context_line":"  line now either will define a set of matched PCI devices from the host as"},{"line_number":83,"context_line":"  individual devices or directly include them into a named group of devices"},{"line_number":84,"context_line":"  depending on the fields in the spec used."},{"line_number":85,"context_line":"* Devices are linked by both a group type name, and a specific group name. The"},{"line_number":86,"context_line":"  ``group_type`` defines what can be requested via the PCI alias later. While"},{"line_number":87,"context_line":"  the ``group_name`` is just an identifier for the given instance of the"},{"line_number":88,"context_line":"  ``group_type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"b851144e_a554842d","line":85,"range":{"start_line":85,"start_character":31,"end_line":85,"end_character":41},"in_reply_to":"9b2dd4da_fa1dc8c0","updated":"2026-05-08 16:47:58.000000000","message":"Acknowledged","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":true,"context_lines":[{"line_number":82,"context_line":"  line now either will define a set of matched PCI devices from the host as"},{"line_number":83,"context_line":"  individual devices or directly include them into a named group of devices"},{"line_number":84,"context_line":"  depending on the fields in the spec used."},{"line_number":85,"context_line":"* Devices are linked by both a group type name, and a specific group name. The"},{"line_number":86,"context_line":"  ``group_type`` defines what can be requested via the PCI alias later. While"},{"line_number":87,"context_line":"  the ``group_name`` is just an identifier for the given instance of the"},{"line_number":88,"context_line":"  ``group_type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"9b2dd4da_fa1dc8c0","line":85,"range":{"start_line":85,"start_character":31,"end_line":85,"end_character":41},"in_reply_to":"faa5e4cf_c9f0f7d7","updated":"2026-05-08 14:46:29.000000000","message":"This is changed now as we renamed name to key. And I think that helps a bit already.\n\nI can add a terminology section to the PCI passthrough admin guide when I update it.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"41eb974b_c91d9e9a","line":108,"updated":"2026-04-28 15:49:11.000000000","message":"I just want to say that I re-read this set of bullets, even after previously studying to understand the mechanism here, and it still took me quite a while to re-grok how this is supposed to work. I think part of the problem is that we\u0027re really stretching the already over-stretched representation of things here. Some ideas:\n\n1. I wonder if it would be simpler (less flexible, but simpler) to make `device_spec` take a list of addresses to form a group. I feel like by-address is the only sane way you could make this work anyway, so I don\u0027t think we need to consider `device_spec` by vendor or product matching. Doing this would eliminate the confusing (to me) overlap between `group_name` and `group` and would maybe allow us to renamethe latter to just `group`. The example below would then look like:\n\n```\n# GPU-audio1\ndevice_spec \u003d {\"address\": [\"0000:4a:00.0\", \"0000:4b:00.0\"], group\u003d\"nvidia-gpu-2x\"}\n# GPU-audio2\ndevice_spec \u003d {\"address\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], group\u003d\"nvidia-gpu-2x\"}\nalias \u003d {\"name\": \"gpu-2x\", \"group\": \"nvidia-gpu-2x\"}\n```\n\n(alternately \"address\" could take a single string, with comma-separated addresses if it makes people happier about the duck typing)\n\n2. Changing all the \"group_*\" naming to make them more distinct. Something like `grouping_key` or just \u0027key\u0027 instead of `group_name` would help I think, as it helps convey that the purpose of it is purely to link multiple `device_spec` lines together. I don\u0027t have a very good suggestion for `group_type` but I wonder if we would consider just making the writer specify the `resource_class` for groups and using that to link it to a given alias?\n\n3. Maybe it would be more clear to do the grouping in `alias` itself? Instead of multiple `device_spec` lines grouped by a key, which each need an additional seemingly-duplicative-but-different key to link it to an alias, maybe we do some or all of that in `alias` itself?\n\nOn option:\n```\n# GPU-audio1\ndevice_spec \u003d {\"address\": \"0000:4a:00.0\", \"group\": \"group1\"}\ndevice_spec \u003d {\"address\": \"0000:4b:00.0\", \"group\": \"group1\"}\n# GPU-audio2\ndevice_spec \u003d {\"address\": \"0000:4e:00.0\", \"group\": \"group2\"}\ndevice_spec \u003d {\"address\": \"0000:4f:00.0\", \"group\": \"group2\"}\n ...\nalias \u003d {\"name\": \"gpu-2x\", \"groups\": [\"group1\", \"group2\"]}\n```\nI imagine the reason not to do this is because it becomes more verbose or not flexible enough at some point of real-world complexity, but I don\u0027t immediately see it.\n\nAny of these would be easier to understand to me. Just some ideas. I think a lot of this stems from the fact that when I read this, \"group_name\" and \"group_type\" don\u0027t convey to me the differences between these two things in their name.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ef21e161_374342dd","line":108,"in_reply_to":"1d69293d_265731b0","updated":"2026-05-08 14:46:29.000000000","message":"Introduced group_spec with addresses, type, and key fields.\n\n---\n\n\u003e Also a weak argument I think. If the OTU flag is only on one of the two devices, but we track them in placement as a single provider, I don\u0027t think the agent will have any more information because one is tagged in the config as OTU when the other is not. It will still notice only a single reserved\u003d1 placement provider and will need to know what to do there. In fact, the one example of an agent requires the placement provider\u0027s name to have the PCI address encoded (IIRC) which means being in a group will already probably make the usual OTU workflow hard...right?\n\nI think cleanup agent can take the nova compute config and read out the device_spec and group_spec to be able to break down the group into individual devices.\n\n\n\u003e I understand. I feel like this whole approach is a bit of a \"design corner\" because we\u0027re building more complexity on a data structure that feels ill-suited even for the current amount of needed expressivity.\n\nAt the moment I don\u0027t see a better config modeling without re-doing the whole PCI configuration. And I really don\u0027t want to start blowing that up as part of this feature.\n\n\u003e  And, it seems unfortunate to only have the group for \u003e1 device groups. I\u0027d really rather make this group-native than group-adjacent. But, I should probably just squash that feeling.\n\nWe can allow groups with a single devices. But I guess that alone does not change much.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"16babbaec43509e62e3c5aa1ef32abace4c6c55f","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"e061cb42_efa99ec9","line":108,"in_reply_to":"3d0f923b_ac2bc49c","updated":"2026-05-04 16:14:13.000000000","message":"@smooney@redhat.com\n\n\u003e you cannot use this today\n\u003e \"address\": \"0000:0[6-9]:\"\n\nYou are correct. I can reformulate the example with the same meaning but not relying on that syntax to:\n```\n[pci]\n# the 4 devices, 06-07 and 08-09 are two cross connected pairs. Each has the same config so we can glob them today\ndevice_spec \u003d {\"address\": {\"domain\":\"0000\", \"bus\": \"0[6-9]\", \"slot\":\"00\", \"function\": \"0\"}, \"managed\":\"false\", \"live_migratable\":\"true\"} \n\n# Now define groups by explicit address only. But keep the device_spec to define per device parameters.\ngroup_spec \u003d {\"name\": \"gpu-group1\", \"type\": \"gpu-2x\", addresses\u003d[\"0000:06:00\", \"0000:07:00\"]}\ngroup_spec \u003d {\"name\": \"gpu-group2\", \"type\": \"gpu-2x\", addresses\u003d[\"0000:08:00\", \"0000:09:00\"]}\nalias \u003d { \"name\": \"gpu-2x\", \"group_type\":\"gpu-2x\", \"live_migratable\":\"true\", \"numa_policy\":\"required\"}\n```\n\n---\n@dms@danplanet.com\n\nSo we discussed some of this with Dan over IRC on Thursday https://meetings.opendev.org/irclogs/%23openstack-nova/%23openstack-nova.2026-04-30.log.html#openstack-nova.2026-04-30.log.html#t2026-04-30T15:47:18\n\nHere is a summary of the above with some further thoughts occurred to me since:\n\n\u003e My main concern is the \"group name\" and \"group type\" are not intuitively understandable to me.\n...\n\u003e I don\u0027t understand why groups need a name and a type. The type is important of course, but is the name purely just because we need a name for the resource provider? For someone not intimately familiar with the plumbing that will go behind this, it feels like just extra things that need to be typed (or in reality, generated in a stable way from ansible) that doesn\u0027t add any benefit.\n\nIn this `group_spec` config `name` is only needed due to ugly implementation reasons. The code needs to name the resource provider in placement with a stable name. This info is not use for anything else. I thought about generating the name in nova but I failed to find a stable naming function that I like.\nI tried:\n* use somehow the address of the devices in the group. It does not work as we agreed that a group content can be changed if it is not allocated. Such change will change the name of the group. This would create a need to delete an old RP and add a new RP to placement.\n\n* use a running index. I.e. the first group in our config gets the name group_type-\u003c0\u003e the second group_type-\u003c1\u003e etc. This would make our group_spec config order dependent.\n\n* generate a uuid. This would require us to persist that uuid in nova to be able to map a group from the config to the group in Placement. The PciDevice extra field is a json blob so we could put it there. So maybe this is the closest I could accept as a way forward. **How do you feel about it?**\n\nI\u0027m open to suggestion and Dan suggested to then at least rename this from `name` to `key` which I\u0027m OK to do.\n\n---\n\n\u003e I guess I also don\u0027t understand why we need device_spec to support matching but the group_spec to be explicit. Seems like for groups we could just be explicit always. I also don\u0027t really understand when/where we need device_spec to differ much between items in the group (except for managed).\n\nThe main reason to keep device_spec used even if we introduce group_spec to define a group is to allow defining per device tags even if the device is grouped. Examples:\n1. managed. That tag has no meaning on the group level and we can group diverse set of devices one need managed\u003dfalse the other might not.\n2. live_migratable. While the group could express that today it should not in my eyes as it is not a property of a group but a property of each device in the group. In theory in the future we can introduce live_migratable\u003dunplug to support stateless, flavor requested PCI devices during live migration. Then it is defiitely something we need to express pre device and not per group.\n3. one_time_use. In the real world this is also a parameter of a device even if nova can ignore that as it only need to reserve the whole group inventory in placement Only the external agent needs to figure out which device to run the cleanup on within that group.\n\n---\n\nObviously we can say we only support grouping of non-diverse set of devices and therefore `group_spec` can be the source of all device specific parameters as well (managed, live_migratable, one_time_use) and then device_spec can be ignored in grouping. But that makes the feature pretty limited and not future proof. I know we discussed cyborg eventually implementing grouping instead of nova, but for me that is not a reason to build a half useful feature now. I cannot point to cyborg as a replacement if somebody needs a diverse set of devices. Neither I see a timeline when it will happen. I have to assume that if we do any grouping in nova it will be always easier to add the next grouping related features to nova than to start from scratch in cyborg. So I rather not design ourselves into a corner if possible.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"de9db105_c09f5052","line":108,"in_reply_to":"41eb974b_c91d9e9a","updated":"2026-04-29 20:24:41.000000000","message":"you usage of group at lesat in the later exampel is combining group_type and group_name\n\nwhich to me is harder to reason about then the current proosal.\n\nthe device_spec is a json feld so we can use any valid json construct an array of adresses or a list of object are valid\n\nwe already supprot adrss beign a string with or without glob syntax or it can be a dictionary with regex supprot so we could add a list of adresses without conflciting im just not sure if that is requried but im not agsint it provide we supprot that array syntax for non groups as well\n\ni.e. as just another alternitive way to spciyfy mulple device that can be manged by nova.\n\ni woudl be -1 on any group speicifc usage of adresses","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"476fb50666ac853c4f242adca5bcf7d3178305c6","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"86491db0_29ff4dfc","line":108,"in_reply_to":"61cd3cea_3e627eff","updated":"2026-04-30 14:45:18.000000000","message":"Corrected example. The alias now refers to the group properly via the \"group_type\" field\n```\n[pci]\n# the 4 devices, 06-07 and 08-09 are two cross connected pairs. Each has the same config so we can glob them today\ndevice_spec \u003d {\"address\": \"0000:0[6-9]:\", \"managed\":\"false\", \"live_migratable\":\"true\"} \n\n# Now define groups by explicit address only. But keep the device_spec to define per device parameters.\ngroup_spec \u003d {\"name\": \"gpu-group1\", \"type\": \"gpu-2x\", addresses\u003d[\"0000:06:00\", \"0000:07:00\"]}\ngroup_spec \u003d {\"name\": \"gpu-group2\", \"type\": \"gpu-2x\", addresses\u003d[\"0000:08:00\", \"0000:09:00\"]}\nalias \u003d { \"name\": \"gpu-2x\", \"group_type\":\"gpu-2x\", \"live_migratable\":\"true\", \"numa_policy\":\"required\"}\n```","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0f59414d796aeb62b67080359657445e5145dcc1","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3d0f923b_ac2bc49c","line":108,"in_reply_to":"86491db0_29ff4dfc","updated":"2026-04-30 15:38:26.000000000","message":"My main concern is the \"group name\" and \"group type\" are not intuitively understandable to me when I just look at the example. I really hate to add another weird duplicated key (`group_spec`) to this already confusing section, but I agree it\u0027s better than trying to overload everything into `device_spec` as was originally proposed. I was trying to reduce the cognitive load of needing to mentally link `device_spec` items together.\n\nI don\u0027t understand why groups need a name and a type. The type is important of course, but is the name purely just because we need a name for the resource provider? For someone not intimately familiar with the plumbing that will go behind this, it feels like just extra things that need to be typed (or in reality, generated in a stable way from ansible) that doesn\u0027t add any benefit.\n\nI guess I also don\u0027t understand why we need `device_spec` to support matching but the `group_spec` to be explicit. Seems like for groups we could just be explicit always. I also don\u0027t really understand when/where we need `device_spec` to differ much between items in the group (except for `managed`).\n\nSo I dunno, it\u0027s just really feeling like a lot of (confusing) hoops to jump through. Having the explicit grouping is definitely better.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"d14b97b5ca6112aeff40a07b8165e4bb00f92ebd","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"d12004c6_9e4a3c53","line":108,"in_reply_to":"86491db0_29ff4dfc","updated":"2026-04-30 14:59:59.000000000","message":"you cannot use this today\n```\n\"address\": \"0000:0[6-9]:\"\n```\nyou can only use * \nit better to say we supprot wiled card then genic full bash globing\n\nthis is how we implemtn the glob supprot\n\nhttps://github.com/openstack/nova/blob/master/nova/pci/devspec.py#L125-L164\n\nand here is the regex form\n\nhttps://github.com/openstack/nova/blob/master/nova/pci/devspec.py#L167-L195\n\nthe match function for the glob type only accept *\n\nwe determin which on to use here\n\nhttps://github.com/openstack/nova/blob/master/nova/pci/devspec.py#L232-L243\n\nso it woudl be ease to add list to that if chain but\n\n`\"address\": \"0000:0[6-9]:\"`  will not work today","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"9a7dc652f91956ba8a7907d6a74d293d252ca88a","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"61cd3cea_3e627eff","line":108,"in_reply_to":"de9db105_c09f5052","updated":"2026-04-30 14:41:52.000000000","message":"I\u0027m a bit afraid of further overloading the meaning of \"address\". As Sean said it can be:\n* a string: then it defined substring address match with glob support\n* a dict: then it supports named address fields (bus, function etc) with regex support\n* and now list: then it support listing exact addresses AND it switch the matched devices to form a group.\n\nBut the idea of making a group defined with explicit addresses appeals to me. (Honestly the current device_spec matching logic is just to much to grok) But also I think we need a way to add paramters like managed, live_migratable, one_time_use to individual devices even when they are grouped. \n\nSo what if:\n\n* we keep the device_spec as is today to define what devices are available for nova and enhance those devices with extra data like live_migratable.\n* add a new config option `group_spec` that defines a group by listing pci addresses fully and explicitly.\n* allow to name a group\n* defines the group type / resouce class / traits for the group\n* BUT can only list addresses that are also matching a device via device_spec. And nova will track that device as part of a group and not as individually consumable device.\n\nExample:\n```\n[pci]\n# the 4 devices, 06-07 and 08-09 are two cross connected pairs. Each has the same config so we can glob them today\ndevice_spec \u003d {\"address\": \"0000:0[6-9]:\", \"managed\":\"false\", \"live_migratable\":\"true\"} \n\n# Now define groups by explicit address only. But keep the device_spec to define per device parameters.\ngroup_spec \u003d {\"name\": \"gpu-group1\", \"type\": \"gpu-2x\", addresses\u003d[\"0000:06:00\", \"0000:07:00\"]}\ngroup_spec \u003d {\"name\": \"gpu-group2\", \"type\": \"gpu-2x\", addresses\u003d[\"0000:08:00\", \"0000:09:00\"]}\nalias \u003d { \"name\": \"gpu-2x\", \"live_migratable\":\"true\", \"numa_policy\":\"required\"}\n```\n\nFurther examples are in https://etherpad.opendev.org/p/nova-pci-grouping\n\n---\n\n* This allows us to keep device_spec as is and not complicate it further with fields, tags, and meaning (ok a bit of new meaning needed).\n* This allows us to keep the group defined separately and very explcitly\n* We can define all the group level tags on the group_spec\n* We can keep defining per device tags in the device_spec like live_migratable or managed and inherit them to the group if we want to.\n* The only new meaning for the device_spec is that if an address matched by a device_spec and that address is also in a group_spec then and only then that device is tracked as part of a group and not as an individual device.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"cd5052ac64ea46c63d254f7d610e482bfdcc2151","unresolved":true,"context_lines":[{"line_number":105,"context_line":"  in placement."},{"line_number":106,"context_line":"* The PCI stats and pools used for the PCI scheduling will be extended to"},{"line_number":107,"context_line":"  support grouping via a unique pool type that tracks each group as an"},{"line_number":108,"context_line":"  individual pool."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Here is a simple example defining a single group of two devices and the"},{"line_number":111,"context_line":"corresponding alias requesting such a group. Note that the value of the"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1d69293d_265731b0","line":108,"in_reply_to":"e061cb42_efa99ec9","updated":"2026-05-07 17:45:50.000000000","message":"\u003e * generate a uuid. This would require us to persist that uuid in nova to be able to map a group from the config to the group in Placement. The PciDevice extra field is a json blob so we could put it there. So maybe this is the closest I could accept as a way forward. **How do you feel about it?**\n\nI guess I\u0027m not sure how this would really work, if we generate a uuid and then the operator changes a group in the right way, I would think we could lose track of which group matches which uuid. I know that you shouldn\u0027t be able to change a group with allocations, but it could happen and if we corrupt all our data as a result that\u0027s going to be bad.\n\n\u003e I\u0027m open to suggestion and Dan suggested to then at least rename this from `name` to `key` which I\u0027m OK to do.\n\nYeah, I think that is probably the best we can do. I think this highlights why this \"should be simple, just group some devices\" approach is not nearly as simple or clean as it may seem. I worry about us taking an already-overloaded syntax here, adding a lot of potential complexity, and then trying to build the next thing (yes, there will be a next thing) on top of this house of cards.\n\n\u003e 1. managed. That tag has no meaning on the group level and we can group diverse set of devices one need managed\u003dfalse the other might not.\n\nYes, this is the strongest reason I think.\n\n\u003e 2. live_migratable. While the group could express that today it should not in my eyes as it is not a property of a group but a property of each device in the group. In theory in the future we can introduce live_migratable\u003dunplug to support stateless, flavor requested PCI devices during live migration. Then it is defiitely something we need to express pre device and not per group.\n\nThis holds less weight with me, I guess because it seems like the justification relies on something that doesn\u0027t exist, and I also just wonder about the \"track two devices as one, but only migrate state for one of those things\" use-case.\n\n\u003e 3. one_time_use. In the real world this is also a parameter of a device even if nova can ignore that as it only need to reserve the whole group inventory in placement Only the external agent needs to figure out which device to run the cleanup on within that group.\n\nAlso a weak argument I think. If the OTU flag is only on one of the two devices, but we track them in placement as a single provider, I don\u0027t think the agent will have any more information because one is tagged _in the config_ as OTU when the other is not. It will still notice only a single reserved\u003d1 placement provider and will need to know what to do there. In fact, the one example of an agent requires the placement provider\u0027s name to have the PCI address encoded (IIRC) which means being in a group will already probably make the usual OTU workflow hard...right?\n\n\u003e Obviously we can say we only support grouping of non-diverse set of devices and therefore `group_spec` can be the source of all device specific parameters as well (managed, live_migratable, one_time_use) and then device_spec can be ignored in grouping. But that makes the feature pretty limited and not future proof. I know we discussed cyborg eventually implementing grouping instead of nova, but for me that is not a reason to build a half useful feature now. I cannot point to cyborg as a replacement if somebody needs a diverse set of devices. Neither I see a timeline when it will happen. I have to assume that if we do any grouping in nova it will be always easier to add the next grouping related features to nova than to start from scratch in cyborg. So I rather not design ourselves into a corner if possible.\n\nI understand. I feel like this whole approach is a bit of a \"design corner\" because we\u0027re building more complexity on a data structure that feels ill-suited even for the current amount of needed expressivity.\n\nAnyway, we\u0027re kinda stuck here I guess. Adding an intermediate `group_spec` is probably the best option. I like it in that it makes it a lot less confusing I think (assuming we can go with name/key) but it does increase the labor required to do all this. And, it seems unfortunate to only have the group for \u003e1 device groups. I\u0027d really rather make this group-native than group-adjacent. But, I should probably just squash that feeling.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":116,"context_line":"  device_spec \u003d {\"address\": \"0000:4e:00.0\", \"group_name\": \"group1\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":117,"context_line":"  device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"group1\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"Note that this PCI grouping feature is building on top of the pre-existing"},{"line_number":122,"context_line":"PCI in Placement feature and inherits all the limitations of it. See"}],"source_content_type":"text/x-rst","patch_set":3,"id":"664b6007_f40cebcc","line":119,"updated":"2026-04-28 15:49:11.000000000","message":"I think it might be good to have this example be a little more representative of a real-world scenario (i.e. more than just a single group, as my examples above). It will get pretty long if you have eight cards of two subdevices each.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":116,"context_line":"  device_spec \u003d {\"address\": \"0000:4e:00.0\", \"group_name\": \"group1\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":117,"context_line":"  device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"group1\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"Note that this PCI grouping feature is building on top of the pre-existing"},{"line_number":122,"context_line":"PCI in Placement feature and inherits all the limitations of it. See"}],"source_content_type":"text/x-rst","patch_set":3,"id":"8438be47_f9f04be6","line":119,"in_reply_to":"664b6007_f40cebcc","updated":"2026-04-29 20:24:41.000000000","message":"i provided actual examples in a comment in a previous version\n\n```\n[pci]\nreport_in_placement \u003d True\n\n# Group 1: 3b:02.0 - 3b:02.7\ndevice_spec \u003d {\"address\": \"0000:3b:02.0\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.1\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.2\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.3\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.4\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.5\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.6\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\ndevice_spec \u003d {\"address\": \"0000:3b:02.7\", \"group_name\": \"nic_group_1\", \"group_type\": \"NICx8\"}\n\n# Group 2: 3b:03.0 - 3b:03.7\n#device_spec \u003d {\"address\": \"0000:3b:03.*\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\n\n# Group 3: 3b:04.0 - 3b:04.7\n#device_spec \u003d {\"address\": \"0000:3b:04.*\", \"group_name\": \"nic_group_3\", \"group_type\": \"NICx8\"}\n\n# Group 4: 3b:05.0 - 3b:05.7\n#device_spec \u003d {\"address\": \"0000:3b:05.*\", \"group_name\": \"nic_group_4\", \"group_type\": \"NICx8\"}\n\n# Group 5: 3b:06.0 - 3b:06.7\n#device_spec \u003d {\"address\": \"0000:3b:06.*\", \"group_name\": \"nic_group_5\", \"group_type\": \"NICx8\"}\n\n# Group 6: 3b:07.0 - 3b:07.7\n#device_spec \u003d {\"address\": \"0000:3b:07.*\", \"group_name\": \"nic_group_6\", \"group_type\": \"NICx8\"}\n\n# Group 7: 3b:08.0 - 3b:08.7\n#device_spec \u003d {\"address\": \"0000:3b:08.*\", \"group_name\": \"nic_group_7\", \"group_type\": \"NICx8\"}\n\n# Group 8: 3b:09.0 - 3b:09.7\n#device_spec \u003d {\"address\": {\"domain\": \"0000\", \"bus\": \"3b\", \"slot\": \"09\", \"function\": \".*\"}, \"group_name\": \"nic_group_8\", \"group_type\": \"NICx8\"}\n\n# Alias for requesting NICx8 groups via flavor\nalias \u003d {\"name\": \"NICx8\", \"group_type\": \"NICx8\"}\n```\n\nthat show most of the ways you can express a group in the current poc\n\nwhat i didnt show is \n```\n# Group 6: 3b:07.0 - 3b:07.7\n#device_spec \u003d {\"address\": \"0000:3b:07.*\", \"group_name\": \"nic_group_6\", \"group_type\": \"NICx8\"}\n\n# Group 7: 3b:08.0 - 3b:08.7\n#device_spec \u003d {\"address\": \"0000:3b:08.*\", \"group_name\": \"nic_group_7\", \"group_type\": \"NICx8\"}\n```\n\ncan also be \n```\n# Group 6: 3b:07.0 - 3b:07.7 and Group 7: 3b:08.0 - 3b:08.7\ndevice_spec \u003d [{\"address\": \"0000:3b:07.*\", \"group_name\": \"nic_group_6\", \"group_type\": \"NICx8\"}, {\"address\": \"0000:3b:08.*\", \"group_name\": \"nic_group_7\", \"group_type\": \"NICx8\"}]\n```\n\ndevice_spec is defiend as both a multiOPT so you can repeated it and it will be merged and as i said above the value of it is also json\n\nso you can have a singel entry that contianes a list of devics.\n\ni woudl suggest adnign a singel exampel of each approch here?\n\nperhaps we coudl also show diffent group type sso this is me deviign up 64vf into 8 groups of 8 but we coudl show some groups or 2 and 4","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":116,"context_line":"  device_spec \u003d {\"address\": \"0000:4e:00.0\", \"group_name\": \"group1\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":117,"context_line":"  device_spec \u003d {\"address\": \"0000:4f:00.0\", \"group_name\": \"group1\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\"}"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"Note that this PCI grouping feature is building on top of the pre-existing"},{"line_number":122,"context_line":"PCI in Placement feature and inherits all the limitations of it. See"}],"source_content_type":"text/x-rst","patch_set":3,"id":"0b3d6d81_f53ecd7a","line":119,"in_reply_to":"8438be47_f9f04be6","updated":"2026-05-08 14:46:29.000000000","message":"Extended the example","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":132,"context_line":"  (e.g., \"graphcore_1\"). This identifies which devices belong together."},{"line_number":133,"context_line":"* ``group_type``: A category name used to generate the resource class"},{"line_number":134,"context_line":"  (e.g., \"c200_x1\" generates ``CUSTOM_PCI_GROUP_C200_X1``). All groups"},{"line_number":135,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":136,"context_line":"* ``group_traits``: A list of placement trait names similar to the existing"},{"line_number":137,"context_line":"  ``traits`` tag. It can only be defined in one of the ``device_spec`` lines"},{"line_number":138,"context_line":"  contributing devices to a group. The existing ``traits`` tag cannot be used"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ae3e4c1b_cbe62952","line":135,"updated":"2026-04-28 15:49:11.000000000","message":"This `group_type` description misses the most important characteristic for understanding what this does (IMHO) which is that it sort of creates a virtual device from multiple physical ones that can be referenced from a single alias. The fact that it informs the resource class is sort of the very implementation-specific detail about how/why but I don\u0027t think it\u0027s very straightforward for understanding.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":132,"context_line":"  (e.g., \"graphcore_1\"). This identifies which devices belong together."},{"line_number":133,"context_line":"* ``group_type``: A category name used to generate the resource class"},{"line_number":134,"context_line":"  (e.g., \"c200_x1\" generates ``CUSTOM_PCI_GROUP_C200_X1``). All groups"},{"line_number":135,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":136,"context_line":"* ``group_traits``: A list of placement trait names similar to the existing"},{"line_number":137,"context_line":"  ``traits`` tag. It can only be defined in one of the ``device_spec`` lines"},{"line_number":138,"context_line":"  contributing devices to a group. The existing ``traits`` tag cannot be used"}],"source_content_type":"text/x-rst","patch_set":3,"id":"db3bcf0e_f4319dbb","line":135,"in_reply_to":"ae3e4c1b_cbe62952","updated":"2026-04-29 20:24:41.000000000","message":"yes group_type is the logacal handel to a template for what group to select\n\nits kind of the diffent beween a CRD (group type) and a CR (actual pci group on a given host) if we were to borrow/abuse a k8s concept.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":132,"context_line":"  (e.g., \"graphcore_1\"). This identifies which devices belong together."},{"line_number":133,"context_line":"* ``group_type``: A category name used to generate the resource class"},{"line_number":134,"context_line":"  (e.g., \"c200_x1\" generates ``CUSTOM_PCI_GROUP_C200_X1``). All groups"},{"line_number":135,"context_line":"  of the same type are interchangeable from a scheduling perspective."},{"line_number":136,"context_line":"* ``group_traits``: A list of placement trait names similar to the existing"},{"line_number":137,"context_line":"  ``traits`` tag. It can only be defined in one of the ``device_spec`` lines"},{"line_number":138,"context_line":"  contributing devices to a group. The existing ``traits`` tag cannot be used"}],"source_content_type":"text/x-rst","patch_set":3,"id":"77c4284e_b021d7fb","line":135,"in_reply_to":"db3bcf0e_f4319dbb","updated":"2026-05-08 14:46:29.000000000","message":"I impoved the wording.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":136,"context_line":"* ``group_traits``: A list of placement trait names similar to the existing"},{"line_number":137,"context_line":"  ``traits`` tag. It can only be defined in one of the ``device_spec`` lines"},{"line_number":138,"context_line":"  contributing devices to a group. The existing ``traits`` tag cannot be used"},{"line_number":139,"context_line":"  for ``device_spec`` lines defining a group."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Both ``group_name`` and ``group_type`` tags must be specified together -"},{"line_number":142,"context_line":"specifying only one results in a configuration error."}],"source_content_type":"text/x-rst","patch_set":3,"id":"f67ba270_e43e7c30","line":139,"updated":"2026-04-29 20:24:41.000000000","message":"so my concern with this is that group_traits need to be use to defien the traits for a given group_type\n\ni woudl prefer if instead of this we intoduced \n\ngroup_traits as a top level key in the pci section and made it a map/json streing\n\nwhere the key is the group_type and the value is the lsit of triats\n```\n[pci]\n...\ndevice_spec \u003d {\"address\": \"0000:3b:03.*\", \"group_name\": \"nic_group_2\", \"group_type\": \"NICx8\"}\n...\ngroup_traits \u003d {\"NICx8\":[\u0027CUSTOM_VLAN_TRANSPARENT\u0027], \"ENODEB\":\"CUSTOM_EDGE\"}\n\n```\n\nthis way you only defien the traits for a group once in teh config so they can never be out of sync.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":136,"context_line":"* ``group_traits``: A list of placement trait names similar to the existing"},{"line_number":137,"context_line":"  ``traits`` tag. It can only be defined in one of the ``device_spec`` lines"},{"line_number":138,"context_line":"  contributing devices to a group. The existing ``traits`` tag cannot be used"},{"line_number":139,"context_line":"  for ``device_spec`` lines defining a group."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Both ``group_name`` and ``group_type`` tags must be specified together -"},{"line_number":142,"context_line":"specifying only one results in a configuration error."}],"source_content_type":"text/x-rst","patch_set":3,"id":"0f1535b7_02cad988","line":139,"in_reply_to":"6aa9bfa9_fdc17bd1","updated":"2026-05-08 16:47:58.000000000","message":"im ok ot resolve this base don the v4 spec defintion\n\nif needed we can alwsy supprot it also on the device_spec in an apend only model in the future so we are not locked into this if we need to evolve it for some reason but i think just havign it in the group_spec is fine and it elimiate any quesion of do the traits apply to a specific device or to the group ectra.\n\nwe should just make sure tha tyou can do\n\ndevice_spec \u003d {\"vendor_id\": \"10de\", \"product_id\": \"233b\", \"managed\": \"false\", \"triats\": \"foo\"}\n\nand when have a device that is in a group form that just without the foo trait reported for the gorup.\n\nbasicly we woudl clear/overiead the traits defintion form the device spec as part of making that device a member of a groups\n\nill resolve this for now since i belive this aligns to how v4 is propsoed to wrok","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":true,"context_lines":[{"line_number":136,"context_line":"* ``group_traits``: A list of placement trait names similar to the existing"},{"line_number":137,"context_line":"  ``traits`` tag. It can only be defined in one of the ``device_spec`` lines"},{"line_number":138,"context_line":"  contributing devices to a group. The existing ``traits`` tag cannot be used"},{"line_number":139,"context_line":"  for ``device_spec`` lines defining a group."},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"Both ``group_name`` and ``group_type`` tags must be specified together -"},{"line_number":142,"context_line":"specifying only one results in a configuration error."}],"source_content_type":"text/x-rst","patch_set":3,"id":"6aa9bfa9_fdc17bd1","line":139,"in_reply_to":"f67ba270_e43e7c30","updated":"2026-05-08 14:46:29.000000000","message":"I\u0027m hesitant attaching trait to the group_type instead of attaching it just to the group. I think both has meaning. An alias today allows asking for the same RC but different traits, the same way an alias tomorrow could ask for the same group_type but different traits.\n\nThe current version of the spec connects the trait to the group def, so it allows two groups with the same group_type to have different traits. But we can be more restrictive by going to your direction.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":146,"context_line":""},{"line_number":147,"context_line":"* ``live_migratable``: Only if every device in a group has the tag"},{"line_number":148,"context_line":"  ``live_migratable`` set to ``true`` then the group is considered live"},{"line_number":149,"context_line":"  migratable."},{"line_number":150,"context_line":"* ``physical_network``: Is not applicable for devices added to a group. This is"},{"line_number":151,"context_line":"  due to the limitation that PCI in Placement feature does not support"},{"line_number":152,"context_line":"  devices having ``physical_network`` tag today."}],"source_content_type":"text/x-rst","patch_set":3,"id":"bf5cc346_e53a6333","line":149,"updated":"2026-04-28 15:49:11.000000000","message":"Making groups a single `device_spec` that takes a list of addresses (suggestion 1 above) would eliminate the need to make this clarification, which is a sign to me that it\u0027s simpler.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":146,"context_line":""},{"line_number":147,"context_line":"* ``live_migratable``: Only if every device in a group has the tag"},{"line_number":148,"context_line":"  ``live_migratable`` set to ``true`` then the group is considered live"},{"line_number":149,"context_line":"  migratable."},{"line_number":150,"context_line":"* ``physical_network``: Is not applicable for devices added to a group. This is"},{"line_number":151,"context_line":"  due to the limitation that PCI in Placement feature does not support"},{"line_number":152,"context_line":"  devices having ``physical_network`` tag today."}],"source_content_type":"text/x-rst","patch_set":3,"id":"c653758a_1fa0ac19","line":149,"in_reply_to":"bf5cc346_e53a6333","updated":"2026-04-29 20:24:41.000000000","message":"we dont need to change teh adress to do that as i noted int a previosu version\n\nwe can do that fi that is the prefenc ebut we shoudl also supprto the regex and glob state.\n\nhonestly it really does nto simpfy thing much to force the singel line constraits\nand it makes it harder in some respeocts but im open to that chagne if we think it will elimante foot guns.\n\ni dotn think it will but we could go either way and still ahve someting logiclly consitent.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":146,"context_line":""},{"line_number":147,"context_line":"* ``live_migratable``: Only if every device in a group has the tag"},{"line_number":148,"context_line":"  ``live_migratable`` set to ``true`` then the group is considered live"},{"line_number":149,"context_line":"  migratable."},{"line_number":150,"context_line":"* ``physical_network``: Is not applicable for devices added to a group. This is"},{"line_number":151,"context_line":"  due to the limitation that PCI in Placement feature does not support"},{"line_number":152,"context_line":"  devices having ``physical_network`` tag today."}],"source_content_type":"text/x-rst","patch_set":3,"id":"913e1963_454236b0","line":149,"in_reply_to":"c653758a_1fa0ac19","updated":"2026-05-11 15:11:41.000000000","message":"Acknowledged","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":155,"context_line":"* ``resource_class``: Supported to override the automatically generated"},{"line_number":156,"context_line":"  resource_class for the group, but different groups of the same type and"},{"line_number":157,"context_line":"  different spec lines contributing to the same ``group_type`` cannot define"},{"line_number":158,"context_line":"  divergent resource class names for the ``group_type``."},{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5c08bb0d_7e7bfb7a","line":158,"updated":"2026-04-28 15:49:11.000000000","message":"This is a runtime check we need to do, correct? To make sure that `two device_spec` things that belong to the same `group_type` (is that the right one?) don\u0027t specify divergent classes? I guess option 1 above doesn\u0027t make this less important, but it does halve the number of places that you could make that mistake I think.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":155,"context_line":"* ``resource_class``: Supported to override the automatically generated"},{"line_number":156,"context_line":"  resource_class for the group, but different groups of the same type and"},{"line_number":157,"context_line":"  different spec lines contributing to the same ``group_type`` cannot define"},{"line_number":158,"context_line":"  divergent resource class names for the ``group_type``."},{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"}],"source_content_type":"text/x-rst","patch_set":3,"id":"d8f59a86_313bf2d6","line":158,"in_reply_to":"5c08bb0d_7e7bfb7a","updated":"2026-04-29 20:24:41.000000000","message":"it would be a startup check when we validat the config option yes.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":155,"context_line":"* ``resource_class``: Supported to override the automatically generated"},{"line_number":156,"context_line":"  resource_class for the group, but different groups of the same type and"},{"line_number":157,"context_line":"  different spec lines contributing to the same ``group_type`` cannot define"},{"line_number":158,"context_line":"  divergent resource class names for the ``group_type``."},{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"}],"source_content_type":"text/x-rst","patch_set":3,"id":"581daf62_09cb922f","line":158,"in_reply_to":"d8f59a86_313bf2d6","updated":"2026-05-08 14:46:29.000000000","message":"this is at least partially eliminated with group_spec","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":157,"context_line":"  different spec lines contributing to the same ``group_type`` cannot define"},{"line_number":158,"context_line":"  divergent resource class names for the ``group_type``."},{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"},{"line_number":162,"context_line":"  the device toward the hypervisor; it has no effect on group handling at all."},{"line_number":163,"context_line":"* ``one_time_use``: Supported. If any of the devices in a group is marked as"}],"source_content_type":"text/x-rst","patch_set":3,"id":"f2aeab98_974d2fd1","line":160,"updated":"2026-04-28 15:49:11.000000000","message":"I think option 1 above eliminates the need to have this group_ specific alternative right?","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":157,"context_line":"  different spec lines contributing to the same ``group_type`` cannot define"},{"line_number":158,"context_line":"  divergent resource class names for the ``group_type``."},{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"},{"line_number":162,"context_line":"  the device toward the hypervisor; it has no effect on group handling at all."},{"line_number":163,"context_line":"* ``one_time_use``: Supported. If any of the devices in a group is marked as"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9bdf645f_b17c8104","line":160,"in_reply_to":"b9fd1b25_f54e8d32","updated":"2026-05-08 14:46:29.000000000","message":"the trait divergence is eliminated (at least partially) with the group_spec config.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":157,"context_line":"  different spec lines contributing to the same ``group_type`` cannot define"},{"line_number":158,"context_line":"  divergent resource class names for the ``group_type``."},{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"},{"line_number":162,"context_line":"  the device toward the hypervisor; it has no effect on group handling at all."},{"line_number":163,"context_line":"* ``one_time_use``: Supported. If any of the devices in a group is marked as"}],"source_content_type":"text/x-rst","patch_set":3,"id":"b9fd1b25_f54e8d32","line":160,"in_reply_to":"f2aeab98_974d2fd1","updated":"2026-04-29 20:24:41.000000000","message":"yes but i think you missed that option one is already psosibe today  to some extend usign the glob and regex form\n\ni.e. the ablity to refence many devices in a singel line\n\nto me adding the arry syntax for adress it actully a seprete feature unrelated to grouping that may be nice to do anyway\n\nso we can do that regardless fo groupign but if we do it should also work for normal device specs without the use fo the group tags.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"},{"line_number":162,"context_line":"  the device toward the hypervisor; it has no effect on group handling at all."},{"line_number":163,"context_line":"* ``one_time_use``: Supported. If any of the devices in a group is marked as"},{"line_number":164,"context_line":"  ``one_time_use\u003dtrue`` then the whole group is considered as one time use"},{"line_number":165,"context_line":"  only and therefore the placement resource inventory representing the group"}],"source_content_type":"text/x-rst","patch_set":3,"id":"76d36100_3892429c","line":162,"updated":"2026-04-28 15:49:11.000000000","message":"Maybe this is the thing that makes option 1 above not viable? I\u0027m not sure if it\u0027s important to mark one thing as managed and not the other, but perhaps?","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"},{"line_number":162,"context_line":"  the device toward the hypervisor; it has no effect on group handling at all."},{"line_number":163,"context_line":"* ``one_time_use``: Supported. If any of the devices in a group is marked as"},{"line_number":164,"context_line":"  ``one_time_use\u003dtrue`` then the whole group is considered as one time use"},{"line_number":165,"context_line":"  only and therefore the placement resource inventory representing the group"}],"source_content_type":"text/x-rst","patch_set":3,"id":"e0a98290_b1e02ba5","line":162,"in_reply_to":"76d36100_3892429c","updated":"2026-04-29 20:24:41.000000000","message":"if you need any of the flags to be divergent they yes you need to have more then 1 line\n\ni dont see your option 1 and this propasl as comepteing they are complementry.\n\nwe shoudl be ablt to set this diffently on each device in a group.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":159,"context_line":"* ``traits``: Not supported for group definitions. Use the ``group_traits``"},{"line_number":160,"context_line":"  instead."},{"line_number":161,"context_line":"* ``managed``: Supported. This information is only used to decide how to handle"},{"line_number":162,"context_line":"  the device toward the hypervisor; it has no effect on group handling at all."},{"line_number":163,"context_line":"* ``one_time_use``: Supported. If any of the devices in a group is marked as"},{"line_number":164,"context_line":"  ``one_time_use\u003dtrue`` then the whole group is considered as one time use"},{"line_number":165,"context_line":"  only and therefore the placement resource inventory representing the group"}],"source_content_type":"text/x-rst","patch_set":3,"id":"7ee044f6_1451df8c","line":162,"in_reply_to":"e0a98290_b1e02ba5","updated":"2026-05-08 14:46:29.000000000","message":"Acknowledged","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":165,"context_line":"  only and therefore the placement resource inventory representing the group"},{"line_number":166,"context_line":"  will be reserved at allocation time. The external system that handles the"},{"line_number":167,"context_line":"  cleanup of such devices needs to unreserve this group inventory in placement"},{"line_number":168,"context_line":"  when every device in this group is cleaned."},{"line_number":169,"context_line":""},{"line_number":170,"context_line":"Note that ``vendor_id``, ``product_id`` and ``address`` can be used the same"},{"line_number":171,"context_line":"way to match devices as in case of non-grouped devices. Also note that"}],"source_content_type":"text/x-rst","patch_set":3,"id":"2773d9fa_1b6de42a","line":168,"updated":"2026-04-28 15:49:11.000000000","message":"Same as earlier - a clarification not needed in option 1 above.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":165,"context_line":"  only and therefore the placement resource inventory representing the group"},{"line_number":166,"context_line":"  will be reserved at allocation time. The external system that handles the"},{"line_number":167,"context_line":"  cleanup of such devices needs to unreserve this group inventory in placement"},{"line_number":168,"context_line":"  when every device in this group is cleaned."},{"line_number":169,"context_line":""},{"line_number":170,"context_line":"Note that ``vendor_id``, ``product_id`` and ``address`` can be used the same"},{"line_number":171,"context_line":"way to match devices as in case of non-grouped devices. Also note that"}],"source_content_type":"text/x-rst","patch_set":3,"id":"e9354b83_57aed6cf","line":168,"in_reply_to":"2773d9fa_1b6de42a","updated":"2026-04-29 20:24:41.000000000","message":"one time use is interesting becuase even if only 1 device require that we would have to implemnt it for the entire group.\n\nbut i think that is ok it does mena the system or person that is resettign the reserved value in placement need to be group aware in this case.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":165,"context_line":"  only and therefore the placement resource inventory representing the group"},{"line_number":166,"context_line":"  will be reserved at allocation time. The external system that handles the"},{"line_number":167,"context_line":"  cleanup of such devices needs to unreserve this group inventory in placement"},{"line_number":168,"context_line":"  when every device in this group is cleaned."},{"line_number":169,"context_line":""},{"line_number":170,"context_line":"Note that ``vendor_id``, ``product_id`` and ``address`` can be used the same"},{"line_number":171,"context_line":"way to match devices as in case of non-grouped devices. Also note that"}],"source_content_type":"text/x-rst","patch_set":3,"id":"371acfb8_d95e0913","line":168,"in_reply_to":"e9354b83_57aed6cf","updated":"2026-05-08 14:46:29.000000000","message":"answered above, but the complication to the cleanup agent is real","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":191,"context_line":"  for groups."},{"line_number":192,"context_line":"* ``resource_class``: Supported as an override for the default resource class"},{"line_number":193,"context_line":"  generated from the ``group_type``."},{"line_number":194,"context_line":"* ``traits``: Supported. It is matched with the traits provided by the"},{"line_number":195,"context_line":"  group via the ``group_traits`` tag."},{"line_number":196,"context_line":"* ``live_migratable``: Supported to request a live_migratable group."},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"299f5d4b_87005d56","line":194,"updated":"2026-04-28 15:49:11.000000000","message":"What does \"matched\" mean here? I assume we union any `group_traits` with `traits` here?","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":191,"context_line":"  for groups."},{"line_number":192,"context_line":"* ``resource_class``: Supported as an override for the default resource class"},{"line_number":193,"context_line":"  generated from the ``group_type``."},{"line_number":194,"context_line":"* ``traits``: Supported. It is matched with the traits provided by the"},{"line_number":195,"context_line":"  group via the ``group_traits`` tag."},{"line_number":196,"context_line":"* ``live_migratable``: Supported to request a live_migratable group."},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"53a26ac5_92ac1dc3","line":194,"in_reply_to":"299f5d4b_87005d56","updated":"2026-05-08 14:46:29.000000000","message":"The group need to provide all the traits the alias requests. Clarified the text","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":202,"context_line":"``[pci]device_spec``:"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"* PCI groups are only supported when ``[pci]report_in_placement \u003d True``"},{"line_number":205,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":206,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":207,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":208,"context_line":"* No duplicate device addresses across groups"}],"source_content_type":"text/x-rst","patch_set":3,"id":"52f36656_9c4cebac","line":205,"updated":"2026-04-28 15:49:11.000000000","message":"Why? In my suggestions above I was thinking \"maybe we could simplify this by just making every single device a group of one\". I didn\u0027t make that suggestion because it might involve some syntax migration or whatever. But, why would we want to eliminate the possibility fundamentally?","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":202,"context_line":"``[pci]device_spec``:"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"* PCI groups are only supported when ``[pci]report_in_placement \u003d True``"},{"line_number":205,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":206,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":207,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":208,"context_line":"* No duplicate device addresses across groups"}],"source_content_type":"text/x-rst","patch_set":3,"id":"c7d45999_ab90b0f3","line":205,"in_reply_to":"52f36656_9c4cebac","updated":"2026-04-29 20:24:41.000000000","message":"for what its wortin i aslo didnt enfoce this in my poc\n\nwe could but its not requried for ti to be logiclly correct","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":true,"context_lines":[{"line_number":202,"context_line":"``[pci]device_spec``:"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"* PCI groups are only supported when ``[pci]report_in_placement \u003d True``"},{"line_number":205,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":206,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":207,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":208,"context_line":"* No duplicate device addresses across groups"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1d2ae632_d5f19e58","line":205,"in_reply_to":"c7d45999_ab90b0f3","updated":"2026-05-08 14:46:29.000000000","message":"We can allow group definition with size one, but I feel you want more than that here. Something more automatic.","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"67de49e704d137c102b0813d6e9263306dd31bf5","unresolved":true,"context_lines":[{"line_number":204,"context_line":"* PCI groups are only supported when ``[pci]report_in_placement \u003d True``"},{"line_number":205,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":206,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":207,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":208,"context_line":"* No duplicate device addresses across groups"},{"line_number":209,"context_line":"* ``resource_class`` override should be consistent for the whole"},{"line_number":210,"context_line":"  ``group_type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"aa36225d_6e4a6823","line":207,"updated":"2026-04-28 15:49:11.000000000","message":"Another thing that would be structurally obvious with option 1 above :)","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"95c595c59632445fc6af09993617db3aa10df548","unresolved":false,"context_lines":[{"line_number":204,"context_line":"* PCI groups are only supported when ``[pci]report_in_placement \u003d True``"},{"line_number":205,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":206,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":207,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":208,"context_line":"* No duplicate device addresses across groups"},{"line_number":209,"context_line":"* ``resource_class`` override should be consistent for the whole"},{"line_number":210,"context_line":"  ``group_type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"e46e0cb9_da4af5e7","line":207,"in_reply_to":"00f7365b_effcfe93","updated":"2026-05-08 14:46:29.000000000","message":"eliminated by group_spec","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"959bbf4222c06061dff80b29fb8d4b344a1c8bfc","unresolved":true,"context_lines":[{"line_number":204,"context_line":"* PCI groups are only supported when ``[pci]report_in_placement \u003d True``"},{"line_number":205,"context_line":"* All device groups must have two or more PCI devices"},{"line_number":206,"context_line":"* Each physical PCI device can only be in one group"},{"line_number":207,"context_line":"* All devices in a group must have the same ``group_type`` value"},{"line_number":208,"context_line":"* No duplicate device addresses across groups"},{"line_number":209,"context_line":"* ``resource_class`` override should be consistent for the whole"},{"line_number":210,"context_line":"  ``group_type``."}],"source_content_type":"text/x-rst","patch_set":3,"id":"00f7365b_effcfe93","line":207,"in_reply_to":"aa36225d_6e4a6823","updated":"2026-04-29 20:24:41.000000000","message":"or by \n`device_spec \u003d {\"address\": {\"domain\": \"0000\", \"bus\": \"3b\", \"slot\": \"09\", \"function\": \".*\"}, \"group_name\": \"nic_group_8\", \"group_type\": \"NICx8\"}`\nand\n`device_spec \u003d {\"address\": \"0000:3b:08.*\", \"group_name\": \"nic_group_7\", \"group_type\": \"NICx8\"}`\n\nwhich i gave as examples prevosly\n\nbut yes agian your option 1 of haveing adress be a list is just another way to express that whic we can do but its not an either or propastion.\n\ni have some concrete exampel fo this in my unit tests\n\nhttps://review.opendev.org/c/openstack/nova/+/973604/3/nova/tests/unit/pci/test_whitelist.py\n\nand functionla tests\n\nhttps://review.opendev.org/c/openstack/nova/+/973604/3/nova/tests/functional/libvirt/test_pci_in_placement.py\n\ni am not asserting i covered all the edege cases form the orginl propal but i covered quite a few in my poc","commit_id":"9012288d3b9c82e299b1f053b232fa1e40f94243"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":65,"context_line":"In addition, some compute nodes can be statically configured to partition"},{"line_number":66,"context_line":"either two devices, four devices or eight devices as a single group."},{"line_number":67,"context_line":"These can all be statically configured using PCI group to ensure"},{"line_number":68,"context_line":"we always allocate them as a single indivisible unit regardless of their"},{"line_number":69,"context_line":"connectivity."},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"Other than Graphcore C200 devices, both major GPU vendors support connecting"}],"source_content_type":"text/x-rst","patch_set":4,"id":"d045e9db_d5d9aef7","line":68,"updated":"2026-05-08 15:18:45.000000000","message":"I still don\u0027t think this makes sense to me. Isn\u0027t this just describing a preference? Like \"Operators may want to take the eight GPUs a compute node has and pair them up as consumable units of two cards each\"?\n\nI know you\u0027re trying to salvage the words that were here initially, but it reads like there\u0027s some hardware support we\u0027re trying to account for here, but that\u0027s not really it, right? Or is it? Or is it really just a verbose lead-in to the next paragraph about linked GPUs?","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":65,"context_line":"In addition, some compute nodes can be statically configured to partition"},{"line_number":66,"context_line":"either two devices, four devices or eight devices as a single group."},{"line_number":67,"context_line":"These can all be statically configured using PCI group to ensure"},{"line_number":68,"context_line":"we always allocate them as a single indivisible unit regardless of their"},{"line_number":69,"context_line":"connectivity."},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"Other than Graphcore C200 devices, both major GPU vendors support connecting"}],"source_content_type":"text/x-rst","patch_set":4,"id":"b5ab5c38_6d2b5bba","line":68,"in_reply_to":"d045e9db_d5d9aef7","updated":"2026-05-11 15:11:41.000000000","message":"you are right. As far as I understand this is just preference not actual HW feature. So I will drop this and probably mention bigger than 2 devices per group in the GPU case where it is a HW feature.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":77,"context_line":""},{"line_number":78,"context_line":"There are situations, for example in the telco space, where PCI devices"},{"line_number":79,"context_line":"are logically grouped by function, connectivity, or location and expressing"},{"line_number":80,"context_line":"that grouping in Nova allows reducing operational complexity of the deployment."},{"line_number":81,"context_line":""},{"line_number":82,"context_line":""},{"line_number":83,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9487497d_d38de926","line":80,"updated":"2026-05-08 16:47:58.000000000","message":"+1 for distiling this form the enode-b comment\n\nthe exact details of that limiation are less imporant then the fact that this pain point and usecase exist and is impoved by this proposal.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":87,"context_line":"------------------"},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"* We add a new multi value config option ``[pci]group_spec``. Each value of"},{"line_number":90,"context_line":"  this config defines a single PCI group by listing the PCI address of the"},{"line_number":91,"context_line":"  devices belonging to the group."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Each group in the ``[pci]group_spec`` is defined by 3 mandatory parameters:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"c2a54859_f912469a","line":90,"range":{"start_line":90,"start_character":60,"end_line":90,"end_character":67},"updated":"2026-05-08 15:18:45.000000000","message":"\"addresses\" .. non-pluralized it sounds like there\u0027s an address of a group.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":87,"context_line":"------------------"},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"* We add a new multi value config option ``[pci]group_spec``. Each value of"},{"line_number":90,"context_line":"  this config defines a single PCI group by listing the PCI address of the"},{"line_number":91,"context_line":"  devices belonging to the group."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Each group in the ``[pci]group_spec`` is defined by 3 mandatory parameters:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"33f33238_ceb62ca4","line":90,"range":{"start_line":90,"start_character":60,"end_line":90,"end_character":67},"in_reply_to":"c2a54859_f912469a","updated":"2026-05-11 15:11:41.000000000","message":"Done","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":88,"context_line":""},{"line_number":89,"context_line":"* We add a new multi value config option ``[pci]group_spec``. Each value of"},{"line_number":90,"context_line":"  this config defines a single PCI group by listing the PCI address of the"},{"line_number":91,"context_line":"  devices belonging to the group."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Each group in the ``[pci]group_spec`` is defined by 3 mandatory parameters:"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"2586d7dc_659e47c1","line":91,"updated":"2026-05-08 16:47:58.000000000","message":"one thing\n\nhttps://docs.openstack.org/nova/latest/configuration/config.html#pci.device_spec\n\nthe devspec is a multi-valued stropt of json vlaues\n\nbut it also supprot json list syntax\n\nso instead of repeating device_spec over and over again and then composting all of the value into a list internally\n\nyou can just do \n\n```\ndevice_spec \u003d [{\"product_id\":\"0001\", \"vendor_id\":\"8086\"},\n               {\"product_id\":\"0002\", \"vendor_id\":\"8086\"}]\n```\n\nwhich is muich eaiser to generate in installers becase\n\nthe idea of multi valued config option that are meted is part of the oslo.cofnig formatnat that is not part of ini.\n\nsince most automation tools use ini tools to generate config or validate them\nthe list verison is more protabl then the repoated config option as most of the tools wiil either that the first or last defiention and ignore the rest.\n\nso can we also supprot\n```\ngroup_spec \u003d [{...},\n              {...}]\n\n```\nits alwasy been a pain point that when we added that for devsepc we didnt add it for the alias\n\nhttps://docs.openstack.org/nova/latest/configuration/config.html#pci.alias\n\nso it could be nice to do that there but im not going to block on this one way or another\n\n\ni just think it woudl be nice to normalise the behvior between these 3 config option so you can either repoet them \nor use lists or both","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":88,"context_line":""},{"line_number":89,"context_line":"* We add a new multi value config option ``[pci]group_spec``. Each value of"},{"line_number":90,"context_line":"  this config defines a single PCI group by listing the PCI address of the"},{"line_number":91,"context_line":"  devices belonging to the group."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Each group in the ``[pci]group_spec`` is defined by 3 mandatory parameters:"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"cfc8d603_edf34280","line":91,"in_reply_to":"2586d7dc_659e47c1","updated":"2026-05-11 15:11:41.000000000","message":"I\u0027m fine adding the list syntax. We need to make sure to document it properly as this is not super obvious today in the device_spec config description as the two bullet points are too far from each other and therefore the list syntax is visible just like the last config example instead of a totally different config syntax possibility.\n\nI added a specific example for this syntax in the Configuration Examples section.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Each group in the ``[pci]group_spec`` is defined by 3 mandatory parameters:"},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"  * ``addresses`` is a list of strings of PCI addresses. No wildcarding is"},{"line_number":96,"context_line":"    supported. Each address listed should also be made available to nova by"},{"line_number":97,"context_line":"    configuring a matching ``[pci]device_spec`` value."},{"line_number":98,"context_line":"  * ``key`` is the ID of the group. It needs to be unique within a compute"},{"line_number":99,"context_line":"    node. It is only used to name the Resource Provider in Placement"},{"line_number":100,"context_line":"    that represents the group."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ebc19b2c_906d3877","line":97,"range":{"start_line":95,"start_character":0,"end_line":97,"end_character":54},"updated":"2026-05-08 16:47:58.000000000","message":"this is kind of unfortunetate that we have to do this in two places.\n\ni personally fint that harder to reason about then the original proposal but guess i can live with that compromise.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":96,"context_line":"    supported. Each address listed should also be made available to nova by"},{"line_number":97,"context_line":"    configuring a matching ``[pci]device_spec`` value."},{"line_number":98,"context_line":"  * ``key`` is the ID of the group. It needs to be unique within a compute"},{"line_number":99,"context_line":"    node. It is only used to name the Resource Provider in Placement"},{"line_number":100,"context_line":"    that represents the group."},{"line_number":101,"context_line":"  * ``type`` is the type of the group. It is a free form string that then"},{"line_number":102,"context_line":"    can be used to request a group via the ``[pci]alias``. Multiple groups of"}],"source_content_type":"text/x-rst","patch_set":4,"id":"717f18af_07b958d1","line":99,"updated":"2026-05-08 15:18:45.000000000","message":"I think `key` is massively better than `name` so that\u0027s great. However, you immediately have to explain that \"key is the ID\" so I wonder if `id` would actually be a better thing? I thought there was some reason I didn\u0027t suggest `id` in the previous round, because of confusion with something else but I don\u0027t know why now.\n\nEither way, `key` or `id` make it much easier to grok, IMHO so I\u0027m happy with either.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":96,"context_line":"    supported. Each address listed should also be made available to nova by"},{"line_number":97,"context_line":"    configuring a matching ``[pci]device_spec`` value."},{"line_number":98,"context_line":"  * ``key`` is the ID of the group. It needs to be unique within a compute"},{"line_number":99,"context_line":"    node. It is only used to name the Resource Provider in Placement"},{"line_number":100,"context_line":"    that represents the group."},{"line_number":101,"context_line":"  * ``type`` is the type of the group. It is a free form string that then"},{"line_number":102,"context_line":"    can be used to request a group via the ``[pci]alias``. Multiple groups of"}],"source_content_type":"text/x-rst","patch_set":4,"id":"21dcd11a_7b144a2f","line":99,"in_reply_to":"717f18af_07b958d1","updated":"2026-05-11 15:11:41.000000000","message":"I keep the key.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":102,"context_line":"    can be used to request a group via the ``[pci]alias``. Multiple groups of"},{"line_number":103,"context_line":"    the same type can be defined within the deployment and within a compute"},{"line_number":104,"context_line":"    node as well. However a group type should mean the same logical thing"},{"line_number":105,"context_line":"    across the whole deployment, e.g. two interconnected GPUs of a given type."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"* Each group in the ``[pci]group_spec`` can have optional parameters:"},{"line_number":108,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"63dbe982_923e92d6","line":105,"updated":"2026-05-08 15:18:45.000000000","message":"This still seems like it might be hard to understand to me without the context loaded. If I had to define this, it would probably be something like this:\n\n\u003e ``type`` identifies the resulting configuration of devices in a group. It should be the same for any exact arrangement of identical devices that can be passed to a guest. In effect, it is a \"virtual device type\" that is formed by the combination of multiple devices that can be assigned as a single unit to an instance. A given ``type`` should be assigned to any group (across all compute nodes in a deployment) that is composed of the same number and type of devices, with the same characteristics (traits, flags, etc).\n\nFeel free to use some or all of that if you think it\u0027s better, and none of it if you think it\u0027s not.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":true,"context_lines":[{"line_number":102,"context_line":"    can be used to request a group via the ``[pci]alias``. Multiple groups of"},{"line_number":103,"context_line":"    the same type can be defined within the deployment and within a compute"},{"line_number":104,"context_line":"    node as well. However a group type should mean the same logical thing"},{"line_number":105,"context_line":"    across the whole deployment, e.g. two interconnected GPUs of a given type."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"* Each group in the ``[pci]group_spec`` can have optional parameters:"},{"line_number":108,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"65167c16_7df6e4cd","line":105,"in_reply_to":"63dbe982_923e92d6","updated":"2026-05-11 15:11:41.000000000","message":"I built on your \"virtual device\" idea. But I think \"logical device\" is clearer as a virtual function is a virtual device too. So that term is overloaded. Let me know how you like the new text.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":111,"context_line":"    group inventory in Placement. Having two groups with the same type but with"},{"line_number":112,"context_line":"    different ``resource_class`` fields is possible and nova-compute will"},{"line_number":113,"context_line":"    apply the requested ``resource_class``. However such configuration is"},{"line_number":114,"context_line":"    unnecessarily complicated and therefore discouraged."},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"  * ``traits`` is a list of strings defining Placement custom traits nova will"},{"line_number":117,"context_line":"    add to the Resource Provider representing the group."}],"source_content_type":"text/x-rst","patch_set":4,"id":"e562bb89_35ece311","line":114,"updated":"2026-05-08 15:18:45.000000000","message":"Is it not going to cause problems? Why would we allow this?\n\nAlso, don\u0027t we need to say that `device_spec` values for members in the group can\u0027t have the resource class set? It just seems way too confusing to allow multiple groups with different resource classes, each composed of devices which all have resource_class set to different values. I think that was in the old text and I don\u0027t see it here.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":111,"context_line":"    group inventory in Placement. Having two groups with the same type but with"},{"line_number":112,"context_line":"    different ``resource_class`` fields is possible and nova-compute will"},{"line_number":113,"context_line":"    apply the requested ``resource_class``. However such configuration is"},{"line_number":114,"context_line":"    unnecessarily complicated and therefore discouraged."},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"  * ``traits`` is a list of strings defining Placement custom traits nova will"},{"line_number":117,"context_line":"    add to the Resource Provider representing the group."}],"source_content_type":"text/x-rst","patch_set":4,"id":"27bbe865_fc6aceeb","line":114,"in_reply_to":"e562bb89_35ece311","updated":"2026-05-11 15:11:41.000000000","message":"I tried to be flexible but I don\u0027t have to be. \n \n* (with intentionally riskingh over-correction) I removed the possibility to define a resource class in the group_spec. The type is already a free form string and the resource_class is derived from it, so we don\u0027t need yet another knob to override it.\n\n* The rc and trait definition of the grouped devices are actually defined at L162 as \n\u003e * ``resource_class`` and ``traits`` are not inherited to the group. If they\n\u003e  are defined in the ``[pci]device_spec`` for a grouped device then they are\n\u003e   ignored. \n\n  I would like to to keep this ignoring behavior as a single device_spec line can match multiple devices and some of those devices might not be groupped.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":120,"context_line":"  ``group_type`` to define a named alias for a group of the given type."},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"* Additionally the existing ``resource_class`` field of ``[pci]alias`` can also"},{"line_number":123,"context_line":"  be used instead of ``group_type`` to request a group."},{"line_number":124,"context_line":""},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Assume a machine with 10 PCI devices 0000:b0:00.0 - 0000:b9:00.0. Each with"}],"source_content_type":"text/x-rst","patch_set":4,"id":"724bfd5c_049b0297","line":123,"updated":"2026-05-08 15:18:45.000000000","message":"But why? Why not just make it required for groups? Or are you maybe pointing out that you can already do this (insanely obscure) thing and that it has to work for groups as well? le sigh.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":true,"context_lines":[{"line_number":120,"context_line":"  ``group_type`` to define a named alias for a group of the given type."},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"* Additionally the existing ``resource_class`` field of ``[pci]alias`` can also"},{"line_number":123,"context_line":"  be used instead of ``group_type`` to request a group."},{"line_number":124,"context_line":""},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Assume a machine with 10 PCI devices 0000:b0:00.0 - 0000:b9:00.0. Each with"}],"source_content_type":"text/x-rst","patch_set":4,"id":"999fce4c_77f51b27","line":123,"in_reply_to":"724bfd5c_049b0297","updated":"2026-05-11 15:11:41.000000000","message":"As resource_class is already a field of the pci alias, and actually supporting that for groups is close to zero complexity I opted to keep it instead of trying to reject it with extra logic.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"0e1df34b7844a7ab6663a019cede0a2ff2dc236e","unresolved":true,"context_lines":[{"line_number":132,"context_line":"  [pci]"},{"line_number":133,"context_line":"  device_spec \u003d {\"vendor_id\": \"10de\", \"product_id\": \"233b\", \"managed\": \"false\", \"live_migratable\": \"true\"}"},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"  group_spec \u003d {\"addresses\": [\"0000:b0:00.0\", \"0000:b1:00.0\", \"0000:b2:00.0\", \"0000:b3:00.0\"], \"type\": \"nvidia-gpu-4x\", \"key\": \"nvidia-gpu-4x-1\"}"},{"line_number":136,"context_line":"  group_spec \u003d {\"addresses\": [\"0000:b4:00.0\", \"0000:b5:00.0\"], \"type\": \"nvidia-gpu-2x\", \"key\": \"nvidia-gpu-2x-1\"}"},{"line_number":137,"context_line":"  group_spec \u003d {\"addresses\": [\"0000:b6:00.0\", \"0000:b7:00.0\"], \"type\": \"nvidia-gpu-2x\", \"key\": \"nvidia-gpu-2x-2\"}"},{"line_number":138,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"ad81b858_3adb7daf","line":135,"updated":"2026-05-08 15:18:45.000000000","message":"Perhaps it\u0027s just me, but using `type` and `key` values that are different would help make this more readable. In reality, I imagine people will do what you show here, but it\u0027s too easy to read this and miss the `-1` and thus get the impression that `type` and `key` are the same. Just something like `gpu1`, `gpu2` would be sufficiently different I think. Just an idea.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":132,"context_line":"  [pci]"},{"line_number":133,"context_line":"  device_spec \u003d {\"vendor_id\": \"10de\", \"product_id\": \"233b\", \"managed\": \"false\", \"live_migratable\": \"true\"}"},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"  group_spec \u003d {\"addresses\": [\"0000:b0:00.0\", \"0000:b1:00.0\", \"0000:b2:00.0\", \"0000:b3:00.0\"], \"type\": \"nvidia-gpu-4x\", \"key\": \"nvidia-gpu-4x-1\"}"},{"line_number":136,"context_line":"  group_spec \u003d {\"addresses\": [\"0000:b4:00.0\", \"0000:b5:00.0\"], \"type\": \"nvidia-gpu-2x\", \"key\": \"nvidia-gpu-2x-1\"}"},{"line_number":137,"context_line":"  group_spec \u003d {\"addresses\": [\"0000:b6:00.0\", \"0000:b7:00.0\"], \"type\": \"nvidia-gpu-2x\", \"key\": \"nvidia-gpu-2x-2\"}"},{"line_number":138,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"a44a5ead_20f3a94c","line":135,"in_reply_to":"ad81b858_3adb7daf","updated":"2026-05-11 15:11:41.000000000","message":"Done","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":139,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\", \"live_migratable\": \"true\"}"},{"line_number":140,"context_line":"  alias \u003d {\"name\": \"gpu-4x\", \"group_type\": \"nvidia-gpu-4x\", \"live_migratable\": \"true\"}"},{"line_number":141,"context_line":"  alias \u003d {\"name\": \"gpu-1x\", \"vendor_id\": \"10de\", \"product_id\": \"233b\", \"live_migratable\": \"true\"}"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"This configuration ensures the flavors can request 2 types of groups and one"},{"line_number":144,"context_line":"type of individual device, the nova-compute tracks and can allocate 3 groups"},{"line_number":145,"context_line":"and 2 individually consumable PCI devices to VMs."}],"source_content_type":"text/x-rst","patch_set":4,"id":"4a28e85b_bff9317b","line":142,"updated":"2026-05-08 16:47:58.000000000","message":"```\n\n[pci]\n  device_spec \u003d {\"vendor_id\": \"10de\", \"product_id\": \"233b\", \"managed\": \"false\", \"live_migratable\": \"true\"}\n\n  group_spec \u003d [{\"addresses\": [\"0000:b0:00.0\", \"0000:b1:00.0\", \"0000:b2:00.0\", \"0000:b3:00.0\"], \"type\": \"nvidia-gpu-4x\", \"key\": \"nvidia-gpu-4x-1\"},\n               {\"addresses\": [\"0000:b4:00.0\", \"0000:b5:00.0\"], \"type\": \"nvidia-gpu-2x\", \"key\": \"nvidia-gpu-2x-1\"},\n               {\"addresses\": [\"0000:b6:00.0\", \"0000:b7:00.0\"], \"type\": \"nvidia-gpu-2x\", \"key\": \"nvidia-gpu-2x-2\"}]\n\n  alias \u003d [{\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\", \"live_migratable\": \"true\"},\n          {\"name\": \"gpu-4x\", \"group_type\": \"nvidia-gpu-4x\", \"live_migratable\": \"true\"},\n          {\"name\": \"gpu-1x\", \"vendor_id\": \"10de\", \"product_id\": \"233b\", \"live_migratable\": \"true\"}]\n\n```\n\nif we supprot the list syntax this coudl be written like this\nwhich feels liek a small ux win but that just a nice to have for consistency","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"d51533a48bfe6a7709b559322b7314bb2a1877ac","unresolved":true,"context_lines":[{"line_number":139,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\", \"live_migratable\": \"true\"}"},{"line_number":140,"context_line":"  alias \u003d {\"name\": \"gpu-4x\", \"group_type\": \"nvidia-gpu-4x\", \"live_migratable\": \"true\"}"},{"line_number":141,"context_line":"  alias \u003d {\"name\": \"gpu-1x\", \"vendor_id\": \"10de\", \"product_id\": \"233b\", \"live_migratable\": \"true\"}"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"This configuration ensures the flavors can request 2 types of groups and one"},{"line_number":144,"context_line":"type of individual device, the nova-compute tracks and can allocate 3 groups"},{"line_number":145,"context_line":"and 2 individually consumable PCI devices to VMs."}],"source_content_type":"text/x-rst","patch_set":4,"id":"7b50c74f_cedabcca","line":142,"in_reply_to":"127bcd9e_6ea97f7a","updated":"2026-05-12 08:14:34.000000000","message":"I think it is reasonable. I will extend the scope with that to have consistency.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":true,"context_lines":[{"line_number":139,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\", \"live_migratable\": \"true\"}"},{"line_number":140,"context_line":"  alias \u003d {\"name\": \"gpu-4x\", \"group_type\": \"nvidia-gpu-4x\", \"live_migratable\": \"true\"}"},{"line_number":141,"context_line":"  alias \u003d {\"name\": \"gpu-1x\", \"vendor_id\": \"10de\", \"product_id\": \"233b\", \"live_migratable\": \"true\"}"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"This configuration ensures the flavors can request 2 types of groups and one"},{"line_number":144,"context_line":"type of individual device, the nova-compute tracks and can allocate 3 groups"},{"line_number":145,"context_line":"and 2 individually consumable PCI devices to VMs."}],"source_content_type":"text/x-rst","patch_set":4,"id":"881edf4f_41969abc","line":142,"in_reply_to":"4a28e85b_bff9317b","updated":"2026-05-11 15:11:41.000000000","message":"I have added the alternative syntax for group_spec. Do you suggest to add it to the alias as well?","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"306724d72e287768a84fdfeaf34c087021e9e1bd","unresolved":true,"context_lines":[{"line_number":139,"context_line":"  alias \u003d {\"name\": \"gpu-2x\", \"group_type\": \"nvidia-gpu-2x\", \"live_migratable\": \"true\"}"},{"line_number":140,"context_line":"  alias \u003d {\"name\": \"gpu-4x\", \"group_type\": \"nvidia-gpu-4x\", \"live_migratable\": \"true\"}"},{"line_number":141,"context_line":"  alias \u003d {\"name\": \"gpu-1x\", \"vendor_id\": \"10de\", \"product_id\": \"233b\", \"live_migratable\": \"true\"}"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"This configuration ensures the flavors can request 2 types of groups and one"},{"line_number":144,"context_line":"type of individual device, the nova-compute tracks and can allocate 3 groups"},{"line_number":145,"context_line":"and 2 individually consumable PCI devices to VMs."}],"source_content_type":"text/x-rst","patch_set":4,"id":"127bcd9e_6ea97f7a","line":142,"in_reply_to":"881edf4f_41969abc","updated":"2026-05-11 15:35:04.000000000","message":"yes ideally\nif that does not expand the scoep to much\n\nthis was a painpoitn we hit in ci of our new inteslal as anbsibel ini modules didnt suprpot the repeated option and it made configurign this via ansibel without just using jinia templating tricky","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":143,"context_line":"This configuration ensures the flavors can request 2 types of groups and one"},{"line_number":144,"context_line":"type of individual device, the nova-compute tracks and can allocate 3 groups"},{"line_number":145,"context_line":"and 2 individually consumable PCI devices to VMs."},{"line_number":146,"context_line":""},{"line_number":147,"context_line":"Note that all PCI devices matched to a ``[pci]device_spec`` are made available"},{"line_number":148,"context_line":"to nova, but those devices that are listed in one of the ``[pci]group_spec``"},{"line_number":149,"context_line":"values can only be consumed as part of their group and cannot be consumed"},{"line_number":150,"context_line":"individually any more."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"},{"line_number":153,"context_line":"the matched devices are later used in a ``[pci]group_spec``. But some have"},{"line_number":154,"context_line":"restrictions and some have extra meaning:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ab5fbcce_c7528479","line":151,"range":{"start_line":146,"start_character":1,"end_line":151,"end_character":1},"updated":"2026-05-08 16:47:58.000000000","message":"this will need a minor change to how the poc works but really not huge.\n\neffectively you will need to do this in 2 passes.\nfirst we need to filter the full set of host devices to just the set allowed by devices_spec, then you will need to annotate the devices with the type and key if\nthe match a group_spec based on the adress\n\nthat is doable but the current poc assumes the device_spec has thsoe tag so it all done in one pass currently.\n\nim really not woried about the performace fo that becasue we will effectivly do this once on start up and it can be cached form then on since we have never supproted changign these via mutable config.\n\njust noting this here as a place where the poc will need to be modified to accomadate this change.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":143,"context_line":"This configuration ensures the flavors can request 2 types of groups and one"},{"line_number":144,"context_line":"type of individual device, the nova-compute tracks and can allocate 3 groups"},{"line_number":145,"context_line":"and 2 individually consumable PCI devices to VMs."},{"line_number":146,"context_line":""},{"line_number":147,"context_line":"Note that all PCI devices matched to a ``[pci]device_spec`` are made available"},{"line_number":148,"context_line":"to nova, but those devices that are listed in one of the ``[pci]group_spec``"},{"line_number":149,"context_line":"values can only be consumed as part of their group and cannot be consumed"},{"line_number":150,"context_line":"individually any more."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"},{"line_number":153,"context_line":"the matched devices are later used in a ``[pci]group_spec``. But some have"},{"line_number":154,"context_line":"restrictions and some have extra meaning:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"6c974041_0e4df6d7","line":151,"range":{"start_line":146,"start_character":1,"end_line":151,"end_character":1},"in_reply_to":"ab5fbcce_c7528479","updated":"2026-05-11 15:11:41.000000000","message":"thanks for the note. It is valid, but I think it is an implementation detail so I will not add it to the spec.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":164,"context_line":"  ignored. These tags can be defined in the ``[pci]group_spec`` instead for the"},{"line_number":165,"context_line":"  whole group."},{"line_number":166,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":167,"context_line":"  inherited to the group in any ways."},{"line_number":168,"context_line":""},{"line_number":169,"context_line":"Some of the existing tags in the ``[pci]alias`` have different meaning when"},{"line_number":170,"context_line":"the alias is requesting a group via the new ``group_type`` tag:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"c9194627_a9fdee9f","line":167,"updated":"2026-05-08 16:47:58.000000000","message":"+1 this is aligned to how i think this should work","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":182,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"},{"line_number":183,"context_line":"  requests."},{"line_number":184,"context_line":"* ``live_migratable``: Supported to request a live migratable group."},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Note that the PCI grouping feature is building on top of the pre-existing"},{"line_number":187,"context_line":"PCI in Placement feature and inherits all the limitations of it. See"},{"line_number":188,"context_line":"https://docs.openstack.org/nova/latest/admin/pci-passthrough#pci-tracking-in-placement"}],"source_content_type":"text/x-rst","patch_set":4,"id":"156fbc44_5c2c73c9","line":185,"updated":"2026-05-08 16:47:58.000000000","message":"perhasp we shoudl make one addtion to this list, specifically as with pci in placement we will not support physical_network  on the grouped devices today. or perhaps a better way to express that is even if the devspec has physical network today you wont be able to to create a neutron sriov port and have it corralate to a grouped nic in this proposal.\n\nthat could eventually be a thing but we shoudl just call that out as out of scope explcitly.\n\n\na scketch of how this coudl work in the fugure woudl be vai provider networking\nwe could add a new neutron_network or neutron_subnet key to the device spec which nova woudl use to creeate a port for the device.\nfor that to work that woudl have to be a shared provider network.\n\nanything beyond that woudl need neutron work to enabel which we dont need to discuss in any real detail.\n\nthis woudl be sort of like how ironic port groups work where it creats the neutron ports for you based on knoldage it has of the phsyical server.\ni dont think we need to speculate to much on a feature we are not plannign to add as part of this work","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":182,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"},{"line_number":183,"context_line":"  requests."},{"line_number":184,"context_line":"* ``live_migratable``: Supported to request a live migratable group."},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Note that the PCI grouping feature is building on top of the pre-existing"},{"line_number":187,"context_line":"PCI in Placement feature and inherits all the limitations of it. See"},{"line_number":188,"context_line":"https://docs.openstack.org/nova/latest/admin/pci-passthrough#pci-tracking-in-placement"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9085beb0_5d35d5c8","line":185,"in_reply_to":"156fbc44_5c2c73c9","updated":"2026-05-11 15:11:41.000000000","message":"Good point. Added a note here that this is out of scope.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":205,"context_line":"``[pci]alias``:"},{"line_number":206,"context_line":""},{"line_number":207,"context_line":"* ``vendor_id``, ``product_id``, and ``device_type`` cannot be defined when"},{"line_number":208,"context_line":"  ``group_type`` is defined."},{"line_number":209,"context_line":""},{"line_number":210,"context_line":"Placement Integration"},{"line_number":211,"context_line":"---------------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"6a8365ad_adc0217a","line":208,"updated":"2026-05-08 16:47:58.000000000","message":"ack, that makes sense\n\ndevice type only exists for legacy reasons\n\nit is in the alias because QAT devices use the same vendor id and porduct id for boht the pf and vf\nso we need a way to slect which one was allocated.\n\nfor grouping as defieend above we are lisiting the adress of the specific devices in the group.\n\nas a result we dont need this added lay of filtering for grouped devices\n\nexcluding vendor_id and product_id is also self evident both for the same reasons, extra filter is not requried because we are specifying exact devices and because the corralation betwheen the alsise is based on teh group type not the devices in teh group.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":257,"context_line":"that the number of devices on the source and destination nodes are the same."},{"line_number":258,"context_line":"As there is no way to prevent the same group type defined differently on"},{"line_number":259,"context_line":"different compute nodes, the live-migration pre-check should handle detecting"},{"line_number":260,"context_line":"such divergence and rejecting the migration with a clear configuration error."},{"line_number":261,"context_line":""},{"line_number":262,"context_line":"NUMA Affinity Handling"},{"line_number":263,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"e243bcbc_720a6fb2","line":260,"updated":"2026-05-08 16:47:58.000000000","message":"we do not need to detail if this is doen in the dest or souce node check but it defintlly can be doen on the souce node after we get the set of devices back form the destioant node in the migrate data object but im 99% we can do it on the destaion even before that so this shoudl be fieaseable in either case.\n\ni woudl prefer to do it in the destination but this is an implemention detail.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":257,"context_line":"that the number of devices on the source and destination nodes are the same."},{"line_number":258,"context_line":"As there is no way to prevent the same group type defined differently on"},{"line_number":259,"context_line":"different compute nodes, the live-migration pre-check should handle detecting"},{"line_number":260,"context_line":"such divergence and rejecting the migration with a clear configuration error."},{"line_number":261,"context_line":""},{"line_number":262,"context_line":"NUMA Affinity Handling"},{"line_number":263,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"357ffc2e_17162beb","line":260,"in_reply_to":"e243bcbc_720a6fb2","updated":"2026-05-11 15:11:41.000000000","message":"ack","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":false,"context_lines":[{"line_number":267,"context_line":"* **required**: All devices in the group must have NUMA"},{"line_number":268,"context_line":"  affinity to the guest NUMA nodes"},{"line_number":269,"context_line":"* **socket**: All devices must be on the same socket as the guest"},{"line_number":270,"context_line":"* **preferred/legacy**: The group with the most devices with affinity to the"},{"line_number":271,"context_line":"  guest NUMA nodes is selected. Groups are sorted by NUMA affinity score,"},{"line_number":272,"context_line":"  count of devices with affinity, but no groups are rejected."},{"line_number":273,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"2ef2d9df_05af908a","line":270,"range":{"start_line":270,"start_character":14,"end_line":270,"end_character":20},"updated":"2026-05-08 16:47:58.000000000","message":"i will note that this diverges very slightly form what legacy means for non grouped devices intentionally\n\nlegacy mean required if the define report Numa affinity and preferred if not.\n\nfor this new feature makign that disction does not really make sense\nand we can just use preferred for that\n\nlegacy was inteded to be deprecated and replace by preferred orginally but there was never really enough motivation to actully do that so \nfor gorups i think we effectily shoudl just have the 3 policies\nrequired, socket and preferred\n\nand just treat legacy whihch is the default as an alias of preferred in the context of groups since we dont really have any legacy behavoior to maintain\n\nthere is no reason to change any of the wording here just noteing why those 2 polices were orgtinally grouped.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":321,"context_line":"config is fixed or the dead device is replaced with the same type of device)"},{"line_number":322,"context_line":"with the same config nova will continue using it as is. If the device"},{"line_number":323,"context_line":"re-appears but with different configuration, i.e. now belonging to a different"},{"line_number":324,"context_line":"group than before then nova-compute will refuse to start."},{"line_number":325,"context_line":""},{"line_number":326,"context_line":"Dependent device handling"},{"line_number":327,"context_line":"-------------------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"52ade429_d26cc307","line":324,"updated":"2026-05-08 16:47:58.000000000","message":"```\ni.e. now belonging to a different\ngroup than before then nova-compute will refuse to start.\n```\ni agree but ionly if its allocated\n\nif you want to move device bwetten groups atomicly and both groups are currenly free we could allow that rather then requireign 2 restart.\n\ni think that is way you intended just not that this could be read as meaning this apples even when the groups are free.\n\ni.e. if you take your 2 groups or 2 gpus and want to update to 1 group of 4 or 4 devices not in any group that shoudl be allowed when all the affected devices are free provide you do not voilate any of the other rules of devices only being refence in at most 1 group at a time.\n\ni think what you have written is logically correct but we could clarify this example by making that distinction","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":321,"context_line":"config is fixed or the dead device is replaced with the same type of device)"},{"line_number":322,"context_line":"with the same config nova will continue using it as is. If the device"},{"line_number":323,"context_line":"re-appears but with different configuration, i.e. now belonging to a different"},{"line_number":324,"context_line":"group than before then nova-compute will refuse to start."},{"line_number":325,"context_line":""},{"line_number":326,"context_line":"Dependent device handling"},{"line_number":327,"context_line":"-------------------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"01066caf_7927b86a","line":324,"in_reply_to":"52ade429_d26cc307","updated":"2026-05-11 15:11:41.000000000","message":"yeah this paragraph start with \n\n\u003e device disappears from an already allocated group\n\nSo the intention is that this last rule also only applies to allocated groups. I added clarification about moving devices between groups.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":332,"context_line":"configured to be part of a single group and by that whoever consuming that"},{"line_number":333,"context_line":"group gets the whole PF and can handle its VFs in the guest. Or the VFs of the"},{"line_number":334,"context_line":"PF can be configured but not the PF itself. In this case individual VFs can"},{"line_number":335,"context_line":"belong to the same or different groups without any further restriction."},{"line_number":336,"context_line":""},{"line_number":337,"context_line":"Alternatives"},{"line_number":338,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"2c7448de_e561b041","line":335,"updated":"2026-05-08 16:47:58.000000000","message":"there is one edge case we need to take note of.\n\nif we do the 2 phase approhc i suggested above wehre first the device spec filter down to the device nova is allowed ot mange and then we annotate the device if they are part fo a group we can ignore this comment but the degecase i was thinkg of is as follwos\n\nin ``[pci]device_spec`` you can specify the adresss of a PF with the vendor id and product id of the VF\n\nand that is a shorthand for saying nova can use all the VFs whoes parte PF is denoted by the relevent adress\n\nso without groupign the PF is never consider manged by nova in that case and cant be requested.\n\nwe just need to make sure that that continues to work i.e. that you can have the adres of the pf in teh devsapec while grouping the VFs undereath it\n\npci in placement already handels this properly in the non group case so this is just me saying this is where one of the dragons lives and we shoudl confim we dont break this.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":true,"context_lines":[{"line_number":332,"context_line":"configured to be part of a single group and by that whoever consuming that"},{"line_number":333,"context_line":"group gets the whole PF and can handle its VFs in the guest. Or the VFs of the"},{"line_number":334,"context_line":"PF can be configured but not the PF itself. In this case individual VFs can"},{"line_number":335,"context_line":"belong to the same or different groups without any further restriction."},{"line_number":336,"context_line":""},{"line_number":337,"context_line":"Alternatives"},{"line_number":338,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"84552edf_b02e4c32","line":335,"in_reply_to":"2c7448de_e561b041","updated":"2026-05-11 15:11:41.000000000","message":"Hm. I keep this open for now as I have to look into this how this works today with PCI in Placement. Thanks for noting it.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ea54d9033dea492db8084cf51237af4724dd6011","unresolved":true,"context_lines":[{"line_number":332,"context_line":"configured to be part of a single group and by that whoever consuming that"},{"line_number":333,"context_line":"group gets the whole PF and can handle its VFs in the guest. Or the VFs of the"},{"line_number":334,"context_line":"PF can be configured but not the PF itself. In this case individual VFs can"},{"line_number":335,"context_line":"belong to the same or different groups without any further restriction."},{"line_number":336,"context_line":""},{"line_number":337,"context_line":"Alternatives"},{"line_number":338,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"6d51985b_9afa4a1d","line":335,"in_reply_to":"84552edf_b02e4c32","updated":"2026-05-12 09:50:29.000000000","message":"i belive today we create a singel RP using the PF adress and create inventories of the VF withthe VF vendor id and product id\n\ni belive this does wok with pci in placmeent as we have had a conversation about this in the past\n\nits one of those thing that is very poorly documented outside fo the test and code coments","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":404,"context_line":"2. Remove existing device_spec entries for those devices"},{"line_number":405,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":406,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":407,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":408,"context_line":""},{"line_number":409,"context_line":"**Rolling upgrade considerations:**"},{"line_number":410,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"fc95ba78_812da7da","line":407,"updated":"2026-05-08 16:47:58.000000000","message":"so i know this workflow works in my poc so this is defintly the baselien\n\ni also believe we could eliminate 2 and 3\n\nand do this atomicly with one restart\n\npart of the reason for that is in the new model with group_spec the device_spec is still used to declare the device that are managable by nova and the the group spec is just grouping subset of thos edevcices.\n\n\nso the device_spec for will still need to exist and allow the device to be managed.\n\nall that we have to do is add the group type/key as tags on teh decie\n\nso as long as the device is not allcoated ot any isntance this coudl just be\n\n```\n1. Ensure no instances are using the devices\n2. Add the new group-based device_spec configuration\n3. Restart nova-compute to create the new group resource providers\n```\n\nthat woudl require you to first update the orginal RP to reduce the total\nand then create teh new RP for the group but that shoudl be possibel to sequence correfctly.\n\nthat is something i think we can leasge to the implemetion reivew to determin how much work makign that would would be in reality and if that complexity is really worth the beifit or one lese restart.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":false,"context_lines":[{"line_number":404,"context_line":"2. Remove existing device_spec entries for those devices"},{"line_number":405,"context_line":"3. Restart nova-compute to remove the old resource providers"},{"line_number":406,"context_line":"4. Add the new group-based device_spec configuration"},{"line_number":407,"context_line":"5. Restart nova-compute to create the new group resource providers"},{"line_number":408,"context_line":""},{"line_number":409,"context_line":"**Rolling upgrade considerations:**"},{"line_number":410,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"8b48e230_084bbb51","line":407,"in_reply_to":"fc95ba78_812da7da","updated":"2026-05-11 15:11:41.000000000","message":"Ohh I forgot to update this procedure when I introduced the group_spec. Done now. I agree that we should do the one restart approach.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ba8ce10cfc4b1aa7266a5ca80bb19a2f095be20a","unresolved":true,"context_lines":[{"line_number":471,"context_line":"  implementation work of this feature we will re-evaluate the situation to see"},{"line_number":472,"context_line":"  if:"},{"line_number":473,"context_line":""},{"line_number":474,"context_line":"  * emulated IGB NIC is available in CI for testing. This depends on the node"},{"line_number":475,"context_line":"    provider\u0027s version of nova"},{"line_number":476,"context_line":"  * check the 3rd party RDO CI if it has IGB support"},{"line_number":477,"context_line":"  * check if the kernel module based SRIOV simulator trials in cyborg are in a"},{"line_number":478,"context_line":"    usable state for us."}],"source_content_type":"text/x-rst","patch_set":4,"id":"dab68e27_19716b9c","line":475,"range":{"start_line":474,"start_character":4,"end_line":475,"end_character":30},"updated":"2026-05-08 16:47:58.000000000","message":"so a slight wrinkel with this.\n\nwhe opendev moved to useing zuul to build image and zuul-laucher to providsion the workers instad of nodepool-builder and nodepool-laucher \nit lost the ablity to add glance metadata keys on the iagage it uploads because that feature was not ported form notpool when they did the reimpeljetion\n\nso until we work with the zuul comunity to adress that regression we do not have a path to testing this in the first party ci and we will likely loses that capablity in the thirdpary rdo ci if they also upgrade there zuul.\n\nwith that said i think we can still expore other options for this and we shoudl see if we can readd this capablity to zuul.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"39120192af115a4246cc38d595fc5a228f4ba48b","unresolved":false,"context_lines":[{"line_number":471,"context_line":"  implementation work of this feature we will re-evaluate the situation to see"},{"line_number":472,"context_line":"  if:"},{"line_number":473,"context_line":""},{"line_number":474,"context_line":"  * emulated IGB NIC is available in CI for testing. This depends on the node"},{"line_number":475,"context_line":"    provider\u0027s version of nova"},{"line_number":476,"context_line":"  * check the 3rd party RDO CI if it has IGB support"},{"line_number":477,"context_line":"  * check if the kernel module based SRIOV simulator trials in cyborg are in a"},{"line_number":478,"context_line":"    usable state for us."}],"source_content_type":"text/x-rst","patch_set":4,"id":"1e351e7c_3294408c","line":475,"range":{"start_line":474,"start_character":4,"end_line":475,"end_character":30},"in_reply_to":"1f61a221_f0c5c028","updated":"2026-05-30 10:08:27.000000000","message":"i have my pci sim working in ci  by the way\nhttps://review.opendev.org/c/openstack/cyborg/+/989470\n\nonce that is merged in cyborg and ill loop back to nova adn incoperate it into one fo our jobs using some of the exsting whitebox tempest plugin tests.\n\nit should be possibel to use that in the future for pci grouping too adn i may wasl end up writing some standard temepst test for pci passthough as well since we can just ssh in and assert the expected device is in the vm.\n\nill resolve this for now","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"ea54d9033dea492db8084cf51237af4724dd6011","unresolved":true,"context_lines":[{"line_number":471,"context_line":"  implementation work of this feature we will re-evaluate the situation to see"},{"line_number":472,"context_line":"  if:"},{"line_number":473,"context_line":""},{"line_number":474,"context_line":"  * emulated IGB NIC is available in CI for testing. This depends on the node"},{"line_number":475,"context_line":"    provider\u0027s version of nova"},{"line_number":476,"context_line":"  * check the 3rd party RDO CI if it has IGB support"},{"line_number":477,"context_line":"  * check if the kernel module based SRIOV simulator trials in cyborg are in a"},{"line_number":478,"context_line":"    usable state for us."}],"source_content_type":"text/x-rst","patch_set":4,"id":"1f61a221_f0c5c028","line":475,"range":{"start_line":474,"start_character":4,"end_line":475,"end_character":30},"in_reply_to":"3295c7dd_19a12f95","updated":"2026-05-12 09:50:29.000000000","message":"yes\n\nso we have 2 trhings in flight first chandan is working on creating some docs of how to locally create vms for testing with devstack and simulating nvme devices \nhttps://review.opendev.org/c/openstack/cyborg/+/982711\n\nbut they also have devstack automation fo the same\n\nhttps://review.opendev.org/c/openstack/cyborg/+/977083\n\nwe have got as far as the deivce is visable to the kernel and lspci/libvirt\nbut we cannot boot a vm in the ci becasue we are missing the iommu.\n\nbecause of the cvew work i have been doing for the last few month i never got a chance to test my kernel driver\nhttps://github.com/SeanMooney/linux/tree/pci-sim\nor the kubvirt one that pretends to be a gpu\nbut i might see if i can spend a day or so on that and see if i cna get either working\n\nthe differce with my kernel module is im triing to use the soft iommu to remove the need for the vIOMMU so that it could run in an upstream ci without special lables.","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"d51533a48bfe6a7709b559322b7314bb2a1877ac","unresolved":true,"context_lines":[{"line_number":471,"context_line":"  implementation work of this feature we will re-evaluate the situation to see"},{"line_number":472,"context_line":"  if:"},{"line_number":473,"context_line":""},{"line_number":474,"context_line":"  * emulated IGB NIC is available in CI for testing. This depends on the node"},{"line_number":475,"context_line":"    provider\u0027s version of nova"},{"line_number":476,"context_line":"  * check the 3rd party RDO CI if it has IGB support"},{"line_number":477,"context_line":"  * check if the kernel module based SRIOV simulator trials in cyborg are in a"},{"line_number":478,"context_line":"    usable state for us."}],"source_content_type":"text/x-rst","patch_set":4,"id":"3295c7dd_19a12f95","line":475,"range":{"start_line":474,"start_character":4,"end_line":475,"end_character":30},"in_reply_to":"7e566b0d_beb8b671","updated":"2026-05-12 08:14:34.000000000","message":"that is sad. Then indeed we need to dig into zuul if we want to go this route. \n@smooney@redhat.com do you have pointers about plan C here to any work with a kernel module simulating sriov devs?","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"306724d72e287768a84fdfeaf34c087021e9e1bd","unresolved":true,"context_lines":[{"line_number":471,"context_line":"  implementation work of this feature we will re-evaluate the situation to see"},{"line_number":472,"context_line":"  if:"},{"line_number":473,"context_line":""},{"line_number":474,"context_line":"  * emulated IGB NIC is available in CI for testing. This depends on the node"},{"line_number":475,"context_line":"    provider\u0027s version of nova"},{"line_number":476,"context_line":"  * check the 3rd party RDO CI if it has IGB support"},{"line_number":477,"context_line":"  * check if the kernel module based SRIOV simulator trials in cyborg are in a"},{"line_number":478,"context_line":"    usable state for us."}],"source_content_type":"text/x-rst","patch_set":4,"id":"7e566b0d_beb8b671","line":475,"range":{"start_line":474,"start_character":4,"end_line":475,"end_character":30},"in_reply_to":"98829c6d_de9dcede","updated":"2026-05-11 15:35:04.000000000","message":"tags are differnt \n\nhttps://docs.openstack.org/api-ref/image/v2/#image-tags\nthey work like nova server tags as a quick way to filter images\n\nhttps://docs.openstack.org/api-ref/image/v2/#update-image\n\nis used for the image properties","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"23f61d4bb8cd42f5aed8183082593a1eb325d3e2","unresolved":true,"context_lines":[{"line_number":471,"context_line":"  implementation work of this feature we will re-evaluate the situation to see"},{"line_number":472,"context_line":"  if:"},{"line_number":473,"context_line":""},{"line_number":474,"context_line":"  * emulated IGB NIC is available in CI for testing. This depends on the node"},{"line_number":475,"context_line":"    provider\u0027s version of nova"},{"line_number":476,"context_line":"  * check the 3rd party RDO CI if it has IGB support"},{"line_number":477,"context_line":"  * check if the kernel module based SRIOV simulator trials in cyborg are in a"},{"line_number":478,"context_line":"    usable state for us."}],"source_content_type":"text/x-rst","patch_set":4,"id":"98829c6d_de9dcede","line":475,"range":{"start_line":474,"start_character":4,"end_line":475,"end_character":30},"in_reply_to":"dab68e27_19716b9c","updated":"2026-05-11 15:11:41.000000000","message":"Thanks. I looked at the zuul doc and I\u0027m wondering if `tags` https://acmegating.com/docs/zuul/latest/drivers/openstack.html#attr-provider[openstack].image-defaults.tags are actually image properties or not. Our CI does not have examples of such so I\u0027m not sure. (I only see https://opendev.org/opendev/zuul-providers/src/commit/a0079778af4fa32d62ff2aa922805fed22fbca68/zuul.d/providers.yaml#L9 )","commit_id":"519f90594561411547f6bf114bb5a01ba9c85232"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"539cf16b70445d9642ab536c222f9614cecbbc8f","unresolved":true,"context_lines":[{"line_number":322,"context_line":"--------------------------"},{"line_number":323,"context_line":""},{"line_number":324,"context_line":"Adding devices to or removing from a group is supported only if both"},{"line_number":325,"context_line":"the devices moved and the devices in the group are free, not allocated to any"},{"line_number":326,"context_line":"instance. Note that changing the size of a group in a way that the groups in"},{"line_number":327,"context_line":"the same type have a different number of devices is not supported. Each"},{"line_number":328,"context_line":"group in a type should always mean the same number of devices. If a"},{"line_number":329,"context_line":"device needs to be replaced in a group then removing the old one and adding a"}],"source_content_type":"text/x-rst","patch_set":5,"id":"f8a29949_bc8f9dfe","line":326,"range":{"start_line":325,"start_character":57,"end_line":326,"end_character":10},"updated":"2026-05-12 08:21:40.000000000","message":"and not reserved in placement as that could mean the device is a dirty one_time_use device.","commit_id":"793f271b0a471ec32371aecc6cc7298af9d38d8e"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"539cf16b70445d9642ab536c222f9614cecbbc8f","unresolved":true,"context_lines":[{"line_number":343,"context_line":"group than before then nova-compute will refuse to start."},{"line_number":344,"context_line":""},{"line_number":345,"context_line":"Moving a device between groups is only allowed if the device and both groups"},{"line_number":346,"context_line":"are not allocated."},{"line_number":347,"context_line":""},{"line_number":348,"context_line":"Dependent device handling"},{"line_number":349,"context_line":"-------------------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"31eb1fec_65017550","line":346,"range":{"start_line":346,"start_character":8,"end_line":346,"end_character":18},"updated":"2026-05-12 08:21:40.000000000","message":"and the device is not reserved in placement as that means a dirty one_time_use device.","commit_id":"793f271b0a471ec32371aecc6cc7298af9d38d8e"}],"specs/2027.1/approved/pci-passthrough-groups.rst":[{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"166aa514077a966dd4d642193615f3bd3915d37a","unresolved":true,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"https://blueprints.launchpad.net/nova/+spec/pci-passthrough-groups"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"This spec allows operators to create a flavor using a PCI alias to"},{"line_number":14,"context_line":"request a group of PCI devices. These groups of PCI devices are tracked"},{"line_number":15,"context_line":"as a single indivisible unit within Placement. The default custom resource"},{"line_number":16,"context_line":"class used to track these PCI groups is derived from the group\u0027s ``type``,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"2ddebf06_50aef5bd","line":13,"updated":"2026-10-27 09:09:23.000000000","message":"Could you please provide here what additional flexibility that Nova group_spec interface provides to status quo static groups in placement defined via separate resource_class\u0027es and aliases?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"bf269e8ec8a661cba6c4c5a30f225e30dcdb66bc","unresolved":true,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"https://blueprints.launchpad.net/nova/+spec/pci-passthrough-groups"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"This spec allows operators to create a flavor using a PCI alias to"},{"line_number":14,"context_line":"request a group of PCI devices. These groups of PCI devices are tracked"},{"line_number":15,"context_line":"as a single indivisible unit within Placement. The default custom resource"},{"line_number":16,"context_line":"class used to track these PCI groups is derived from the group\u0027s ``type``,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"5c99a82b_02bdf622","line":13,"in_reply_to":"2ddebf06_50aef5bd","updated":"2026-10-27 09:57:55.000000000","message":"To elaborate what I mean - what would be *new* from the functional perspective, putting aside how things tracked and transacted (atomic groups vs rogue-style)?\nDoes that improve an admin driven static way of defining your cloud hardware layout by any mean? That would be beneficial to outline.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"https://blueprints.launchpad.net/nova/+spec/pci-passthrough-groups"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"This spec allows operators to create a flavor using a PCI alias to"},{"line_number":14,"context_line":"request a group of PCI devices. These groups of PCI devices are tracked"},{"line_number":15,"context_line":"as a single indivisible unit within Placement. The default custom resource"},{"line_number":16,"context_line":"class used to track these PCI groups is derived from the group\u0027s ``type``,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"b0148869_4f2ea77f","line":13,"in_reply_to":"5b8df5dd_7824d0ef","updated":"2026-10-28 19:44:49.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"25017b33ecce3cf6afc189d404d6c6484c12fae7","unresolved":true,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"https://blueprints.launchpad.net/nova/+spec/pci-passthrough-groups"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"This spec allows operators to create a flavor using a PCI alias to"},{"line_number":14,"context_line":"request a group of PCI devices. These groups of PCI devices are tracked"},{"line_number":15,"context_line":"as a single indivisible unit within Placement. The default custom resource"},{"line_number":16,"context_line":"class used to track these PCI groups is derived from the group\u0027s ``type``,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"5b8df5dd_7824d0ef","line":13,"in_reply_to":"5c99a82b_02bdf622","updated":"2026-10-27 13:24:00.000000000","message":"its mainly saftey\n\nif you are using https://gist.github.com/SeanMooney/a4a97407a963f2bad6845ee7294989e5 or any of our downstream documeation that was based on that desgin its the operator respocnablity to ensure that they only create flavors that fully consume the group\n\nthat is very error prone.\n\nit also requires you to have seperate flavor per group where as this native supprot allows you to define a single flavor that can consume any group of the requested type and since each group is reported as an inventory of 1 you do not need to match the resouce request to the number of devices in teh group\n\nthe static groups also only works for PFs and devices that dont supprot the creations of VFs\n\nthe native feature works for VFs as well\n\nfinally the workaround technially vioaltes one fo the rules of placement rescoues classes if all devices in a group are not the same vendor id and product id.\n\nso the impovemeents in no particalr order are\n\n1.) correctness (count is enfoced by nova and a resouce class refers to a signel set of devices)\n2.) portability and ux, a single flavor will work with all groups of a given type\n3.) safety: all devices in a group are always consumed together, its not possible to get a partial group.\n4.) support, technical we dont support what is desibed in my gist, it can work but its breaking our rules in a very specific way that happens to work if you do it exactly correctly, otherwise it potentially breaks multi tenancy which is why we do not support it upstream or downstream offically.\n\nAny issues caused by the static approach are not nova bugs they are operator error. with native grouping supported we are providing a supported way to do this.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"8d8b67aac81ca05be19e1c13f317cc803cc93da9","unresolved":true,"context_lines":[{"line_number":21,"context_line":"Problem description"},{"line_number":22,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Some PCI devices only make sense to be consumed together."},{"line_number":25,"context_line":"When you assign these PCI devices to a VM, all of the devices need to be"},{"line_number":26,"context_line":"consumed together by a single VM."},{"line_number":27,"context_line":"Currently Nova does not understand any connection between these devices other"}],"source_content_type":"text/x-rst","patch_set":6,"id":"d521575e_bc4089da","line":24,"updated":"2026-10-08 08:08:49.000000000","message":"The real problem scope for HPC is a bit broader than just grouping: consumed together and bound to multiple numa aligned PCIe roots. That multi-root support is essential","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":21,"context_line":"Problem description"},{"line_number":22,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Some PCI devices only make sense to be consumed together."},{"line_number":25,"context_line":"When you assign these PCI devices to a VM, all of the devices need to be"},{"line_number":26,"context_line":"consumed together by a single VM."},{"line_number":27,"context_line":"Currently Nova does not understand any connection between these devices other"}],"source_content_type":"text/x-rst","patch_set":6,"id":"93d286b2_f8bafc99","line":24,"in_reply_to":"c4ec82e9_b3761d1e","updated":"2026-10-28 19:44:49.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":21,"context_line":"Problem description"},{"line_number":22,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Some PCI devices only make sense to be consumed together."},{"line_number":25,"context_line":"When you assign these PCI devices to a VM, all of the devices need to be"},{"line_number":26,"context_line":"consumed together by a single VM."},{"line_number":27,"context_line":"Currently Nova does not understand any connection between these devices other"}],"source_content_type":"text/x-rst","patch_set":6,"id":"c4ec82e9_b3761d1e","line":24,"in_reply_to":"d521575e_bc4089da","updated":"2026-10-08 17:44:57.000000000","message":"i dont think this is relevent.\n\nany change to the toplogy of how devices are presented with ing the guest are out of scope of this spec","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"caa7195231f7236554f42db557e58eea15ba9d46","unresolved":true,"context_lines":[{"line_number":69,"context_line":"  so that both devices from the same card are assigned to my VM."},{"line_number":70,"context_line":"* As an accelerator user, I would like to request both PCI devices of a"},{"line_number":71,"context_line":"  Graphcore C200 card so that the card can operate in my VM."},{"line_number":72,"context_line":"* As a GPU user, I would like to request a connected set of GPUs so that my"},{"line_number":73,"context_line":"  workload can use their inter-card connections."},{"line_number":74,"context_line":"* As a telco operator, I would like to request a transceiver, its network"},{"line_number":75,"context_line":"  uplink, and its crypto accelerator together so that an appliance receives"}],"source_content_type":"text/x-rst","patch_set":6,"id":"34cfcb8a_9f03ba63","line":72,"updated":"2026-10-08 08:12:50.000000000","message":"Could you please extend this use case to \" connected set of CPUs and SMART nics in a multi-root PCIe topology bound to NUMA nodes \" as well?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"32867c14f466809eee253d2dd9d27ed2d474fa0a","unresolved":false,"context_lines":[{"line_number":69,"context_line":"  so that both devices from the same card are assigned to my VM."},{"line_number":70,"context_line":"* As an accelerator user, I would like to request both PCI devices of a"},{"line_number":71,"context_line":"  Graphcore C200 card so that the card can operate in my VM."},{"line_number":72,"context_line":"* As a GPU user, I would like to request a connected set of GPUs so that my"},{"line_number":73,"context_line":"  workload can use their inter-card connections."},{"line_number":74,"context_line":"* As a telco operator, I would like to request a transceiver, its network"},{"line_number":75,"context_line":"  uplink, and its crypto accelerator together so that an appliance receives"}],"source_content_type":"text/x-rst","patch_set":6,"id":"8f72db08_18c9caf2","line":72,"in_reply_to":"2332e185_8e7dcf8e","updated":"2026-11-03 16:11:24.000000000","message":"FTR I may be wrong but IIUC specifically for a distributed AI inference scenario, where workloads run on multi-GPU systems with a shared PLX switch, cross NUMA PHB is not required since it destroys P2P RDMA. What is really needed for such a case is numa aligned PXB topology like:\n\n   pcie.0 (root complex)\n    +-- pcie-root-port\n    |    +-- pxb-pcie controller (bus 0x10, NUMA node 0) \n    |         +-- pcie-root-port -\u003e GPU VF \n    |         +-- pcie-root-port -\u003e NIC VF\n    +-- pcie-root-port\n         +-- pxb-pcie controller (bus 0x20, NUMA node 0)\n              +-- pcie-root-port -\u003e GPU VF\n              +-- pcie-root-port -\u003e NIC VF\n              \nSo having non-flat PHB toplogies for numa distances \u003e 0 is really optional feature what I am not sure there is high demand for today","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":69,"context_line":"  so that both devices from the same card are assigned to my VM."},{"line_number":70,"context_line":"* As an accelerator user, I would like to request both PCI devices of a"},{"line_number":71,"context_line":"  Graphcore C200 card so that the card can operate in my VM."},{"line_number":72,"context_line":"* As a GPU user, I would like to request a connected set of GPUs so that my"},{"line_number":73,"context_line":"  workload can use their inter-card connections."},{"line_number":74,"context_line":"* As a telco operator, I would like to request a transceiver, its network"},{"line_number":75,"context_line":"  uplink, and its crypto accelerator together so that an appliance receives"}],"source_content_type":"text/x-rst","patch_set":6,"id":"c4fa1987_dcc044a6","line":72,"in_reply_to":"34cfcb8a_9f03ba63","updated":"2026-10-08 17:44:57.000000000","message":"that expand the scope in a way that i think we should avoid.\n\nfirstly we have the abliyt to supprot numa affinity between the pci devies an a numa awre vms cpu and ram.\n\nso if you vam has numa enabled i.e. hw:numa_nodes\u003d1 hw:mem_page_size\u003dsmall\n\nnova will pin the guess memory to a given numa node and restrict its cpus to float only over the allowed cores on that same numa node. (nova also has strict cpu pinnign which you can optionall enable)\n\nif you then add a pci pashtough request to the flavor or a neutron sriov port\nnova by default will requrie that the cpu, memory and pci device (pf ro vf) are allocated form thte saem host numa node.\n\nif you have a multi numa node guest it will guarentee that each virtual numa node in the vm is pinend to a differnte host numa ndoe and that the pci device comes form one of hte host numa nodes where the cpus and meory are pinned.\n\nthat is what we mean by the requried policy for numa affintiy and its the behvior of legacy when all deivce provdie numa info. legacy allwos device without numa info to alwasy be used wehere as requried requies strict affinty adn the defice to report numa info.\n\n\nin this proposal if you have a vm that you want to assing a gpu and a nic too youc an group them as generic pci devices and the same numa affintiy rules apply more or less as noted in the spec.\n\nnova will treat them as to arbiary pci device and assgin them, what will not work is using that nice with neutorn. pci inplacemnet does not supprot nruton sriov port and we expclity put clsoing that gap as out of scope.\n\nthis is why i am avoiding any refence to nics specificly in this spec.\n\nthey will work but they will not work as neutron nics.\nany network connectivty between them is out of band of opentack.\nwe could adress that but not in this spec.\n\n\nit shoudl be noted it shoudl also be posssibel to create a vm with a group of 2 gpus and seprately assocate a neutron sriov prot with the vm. it just ot be possibel to have the nic selection be influcend by the gpus beyond basic numa affintiy as i noted above.\n\n\nthis spec is also not sugestion we cahgne the toplogy of the devices presented to the vms in any way.\n\nthere are more efficent wasy to do that but the focus fo this spec is on grouping host device, not on how devices are grouped when attached to a vm in the libvirt domian. that is a much more complex topic.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":69,"context_line":"  so that both devices from the same card are assigned to my VM."},{"line_number":70,"context_line":"* As an accelerator user, I would like to request both PCI devices of a"},{"line_number":71,"context_line":"  Graphcore C200 card so that the card can operate in my VM."},{"line_number":72,"context_line":"* As a GPU user, I would like to request a connected set of GPUs so that my"},{"line_number":73,"context_line":"  workload can use their inter-card connections."},{"line_number":74,"context_line":"* As a telco operator, I would like to request a transceiver, its network"},{"line_number":75,"context_line":"  uplink, and its crypto accelerator together so that an appliance receives"}],"source_content_type":"text/x-rst","patch_set":6,"id":"2332e185_8e7dcf8e","line":72,"in_reply_to":"a7fc9a98_0d67ca07","updated":"2026-10-28 19:44:49.000000000","message":"ya i refer to that, knowing the numa releationship, as numa locality, or numa locality reporting.\n\nthe toplogy of those independint deivce are also related i.e. do we create pci roots per numa node and attach the devices and report there numa locality for all device, just grooups or some cobination.s\n\nusign the pci exetnsion bridnge prevent hot plug so we likely woudl not want to use it for neutron ports or cidner volumes for eample but i think its still posibel to repot the numa locality indepent of the pci toplogy in som ecases.\n\nat any rate its complex enough that i dont what to include it here so im going to resove this thread","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"fada3c0e23d1b78f390a6fba715fa9b2971440bb","unresolved":true,"context_lines":[{"line_number":69,"context_line":"  so that both devices from the same card are assigned to my VM."},{"line_number":70,"context_line":"* As an accelerator user, I would like to request both PCI devices of a"},{"line_number":71,"context_line":"  Graphcore C200 card so that the card can operate in my VM."},{"line_number":72,"context_line":"* As a GPU user, I would like to request a connected set of GPUs so that my"},{"line_number":73,"context_line":"  workload can use their inter-card connections."},{"line_number":74,"context_line":"* As a telco operator, I would like to request a transceiver, its network"},{"line_number":75,"context_line":"  uplink, and its crypto accelerator together so that an appliance receives"}],"source_content_type":"text/x-rst","patch_set":6,"id":"a7fc9a98_0d67ca07","line":72,"in_reply_to":"c4fa1987_dcc044a6","updated":"2026-10-15 14:11:47.000000000","message":"I agree that it is to big of a bite to chew in a single step. So it should be handled as a second follow up spec. Also I guess it is a bit independent as well. If I pass through two PCI device to my VM today without grouping, I might want the same thing, knowing what is the NUMA relationship of that two devices.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":76,"context_line":"  the intended devices without controlling VM boot order."},{"line_number":77,"context_line":"* As a cloud operator, I would like to manage PCI configuration through"},{"line_number":78,"context_line":"  Ansible or crudini without repeated INI keys so that those tools retain"},{"line_number":79,"context_line":"  all device, group, and alias definitions."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":""},{"line_number":82,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9913b575_73e22158","line":79,"updated":"2026-10-07 15:53:48.000000000","message":"I assume every multivalued oslo.config option causes the same pain in ansible and crudini not just the alias and device_spec. Do we want to have a generic solution (eventually) for this pain? E.g. adding the json list alternative syntax to all these fields, or even for all the multi valued fields via oslo.config directly?\n\n```\n❯ grep cfg.Multi nova/conf/ -R\nnova/conf/scheduler.py:    cfg.MultiStrOpt(\"available_filters\",\nnova/conf/compute.py:    cfg.MultiStrOpt(\u0027virt_mkfs\u0027,\nnova/conf/compute.py:    cfg.MultiOpt(\u0027reserved_huge_pages\u0027,\nnova/conf/pci.py:    cfg.MultiStrOpt(\u0027alias\u0027,\nnova/conf/pci.py:    cfg.MultiStrOpt(\u0027device_spec\u0027,\n```\nObviously I\u0027m not asking to do this as part of the current spec. I\u0027m more like do we want to spread the good that started here? Also having a discussion with oslo folks about this probably give us a validation about the direction here in this spec for the alias field. \n\ncc @stephenfin@redhat.com to take a look from oslo perspective.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  the intended devices without controlling VM boot order."},{"line_number":77,"context_line":"* As a cloud operator, I would like to manage PCI configuration through"},{"line_number":78,"context_line":"  Ansible or crudini without repeated INI keys so that those tools retain"},{"line_number":79,"context_line":"  all device, group, and alias definitions."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":""},{"line_number":82,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9cf8bbe1_e2047fea","line":79,"in_reply_to":"84c7870c_a7b91ac8","updated":"2026-10-28 19:44:49.000000000","message":"im going to resovle this as well.\n\ni may see if there is a more genral way to do this but for now ill kep this target to the pci related options as descirbed in the spec","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"62e31d091bf8074c1f27a468267bdde3bde938e9","unresolved":true,"context_lines":[{"line_number":76,"context_line":"  the intended devices without controlling VM boot order."},{"line_number":77,"context_line":"* As a cloud operator, I would like to manage PCI configuration through"},{"line_number":78,"context_line":"  Ansible or crudini without repeated INI keys so that those tools retain"},{"line_number":79,"context_line":"  all device, group, and alias definitions."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":""},{"line_number":82,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":6,"id":"b29b99c2_fde5aeb8","line":79,"in_reply_to":"9913b575_73e22158","updated":"2026-10-07 18:58:41.000000000","message":"a generic soltuion woudl be awsome\n\nthe device_spec already supprot litss and has for years\n\nso i just wanted to bring the alsias and new group spec in line with that.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  the intended devices without controlling VM boot order."},{"line_number":77,"context_line":"* As a cloud operator, I would like to manage PCI configuration through"},{"line_number":78,"context_line":"  Ansible or crudini without repeated INI keys so that those tools retain"},{"line_number":79,"context_line":"  all device, group, and alias definitions."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":""},{"line_number":82,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":6,"id":"14981a11_00b0fbbc","line":79,"in_reply_to":"9cf8bbe1_e2047fea","updated":"2026-11-05 15:24:39.000000000","message":"ack","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":76,"context_line":"  the intended devices without controlling VM boot order."},{"line_number":77,"context_line":"* As a cloud operator, I would like to manage PCI configuration through"},{"line_number":78,"context_line":"  Ansible or crudini without repeated INI keys so that those tools retain"},{"line_number":79,"context_line":"  all device, group, and alias definitions."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":""},{"line_number":82,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":6,"id":"84c7870c_a7b91ac8","line":79,"in_reply_to":"b29b99c2_fde5aeb8","updated":"2026-10-08 17:44:57.000000000","message":"by the way i am aware that oslo.config has native supprot for dict options which are clsoe to what we want\nhttps://docs.openstack.org/oslo.config/latest/reference/defining.html#dictionary-options\nbut not quite the saem.\n\ni could likelty reiwte a json type and MultiOptJSON varation but i was just going to reuse the exsitng patteren we use for the deveice_spec.\n\nhttps://github.com/openstack/nova/blob/master/nova/pci/whitelist.py#L55-L83\n\nthe option is defiend as a MultiOptSTR\nso oslo.config retuns a list of strings\nwe just loop over that and decode each string as json\nif its a dict (sinle entry we make it a list and loop over the content and convert each itm into a sepc instance then append it to the list of spec objects\n\ni could perhaps look at defeining a type for that in oslo but its not a lot of code and its largely been unchagned in 12 years\n\nhttps://github.com/openstack/nova/commit/bb7bfd313c9d4c052c85b4ad5ccd8361f5f3b004\n\ni could maybe look into doing that more generaly for all options as a followup either in oslo proper and then adtoping it once its in a release or in a custom config type defiened in nova.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"0bb425a21634d9540e80d3da29397c0eb69ea327","unresolved":true,"context_lines":[{"line_number":82,"context_line":"Proposed change"},{"line_number":83,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"Operators define static groups through ``[pci]group_spec`` using devices made"},{"line_number":86,"context_line":"eligible by ``[pci]device_spec``. Each group has one unit of Placement"},{"line_number":87,"context_line":"inventory and is requested through a flavor PCI alias. Nova claims, allocates,"},{"line_number":88,"context_line":"and frees all member devices as one indivisible unit."}],"source_content_type":"text/x-rst","patch_set":6,"id":"3ac53636_db6fb2d1","line":85,"updated":"2026-10-08 08:20:38.000000000","message":"I was thinking on possible ways to model static PCIe devices multi-root topology representation, and came up with a few ideas on how Cyborg attachment handle can extend its pci address info into that. Maybe we can suggest an alternative or s plit-out to implement that part of the feature (individable from PCI devices grouping IMHO) in Cyborg, before NUMA aware scheduling and resources tracking in Placement implemented?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":false,"context_lines":[{"line_number":82,"context_line":"Proposed change"},{"line_number":83,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"Operators define static groups through ``[pci]group_spec`` using devices made"},{"line_number":86,"context_line":"eligible by ``[pci]device_spec``. Each group has one unit of Placement"},{"line_number":87,"context_line":"inventory and is requested through a flavor PCI alias. Nova claims, allocates,"},{"line_number":88,"context_line":"and frees all member devices as one indivisible unit."}],"source_content_type":"text/x-rst","patch_set":6,"id":"7efb4598_58535466","line":85,"in_reply_to":"3ac53636_db6fb2d1","updated":"2026-10-08 17:44:57.000000000","message":"that is out os scope fo this spec.\n\ncybrog has several other things we need to implemnt first before this is a practical option. if w are waitign to do thisi in cybrog it will not happen in the next 6-12 months without several other features being implmented first.\n\nfor example \n\nroling upgrade supprot needs:\n- rpc version levels\n- ovo indreiction api\n- service levle and status api.\n\nnuma reqruied either cybrog to provide a new filter for the nova scdhuer + changes in how we model device in placmenet or first party supprot in nova\n\nthe attachment handel could povide the numa info when we are generating the xml\nbut nova does not interact with that api during scudling\n\ncurrently how shcduilgn works is the device-profile contains groups or resocue requstr adn traits, nova sees a device profiel is requested in teh flavor and looks up the device profile detal adn incoperate those requriement in the placement allocation candaites api call.\n\nteh scheudle rthen runs filter over the possible hosts adn select wone without any consdieraton t the cyrbog device becasue non fo the filters are cybrog aware.\nfilter are not allowed to make request to the cybrog api and the provider summaries that are returned form the placement reeust does not have numa info.\n\naddin informatoion to the attachment handel does not help with this because nova does not have the attachemt handel information until after it binds an arq to a host. i.e. after schduling is complete.\n\nim going to makre this as results as this is out of scope fo this spec.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":90,"context_line":"Exclusions determine device eligibility before group membership is applied."},{"line_number":91,"context_line":"Eligible devices listed in a group can only be consumed through that group;"},{"line_number":92,"context_line":"eligible ungrouped devices remain individually consumable. Exclusions affecting"},{"line_number":93,"context_line":"allocated or reserved devices are deferred under the lifecycle rules below."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"Configuring Groups"},{"line_number":96,"context_line":"------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"66132b76_cd36b6bb","line":93,"updated":"2026-10-07 15:53:48.000000000","message":"1. Can we define the problem we want to solve with this? What is the configuration that cannot (or hard to) be expressed with the existing inclusion only syntax?\n\n2. Can exclusion be define without grouping? I feel yes. Do we want to make that as a separate step before we introduce grouping? I assume that would simplify some of the initial discussion about the exclusion syntax and semantic.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"62e31d091bf8074c1f27a468267bdde3bde938e9","unresolved":true,"context_lines":[{"line_number":90,"context_line":"Exclusions determine device eligibility before group membership is applied."},{"line_number":91,"context_line":"Eligible devices listed in a group can only be consumed through that group;"},{"line_number":92,"context_line":"eligible ungrouped devices remain individually consumable. Exclusions affecting"},{"line_number":93,"context_line":"allocated or reserved devices are deferred under the lifecycle rules below."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"Configuring Groups"},{"line_number":96,"context_line":"------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"96b801ec_d93d71bb","line":93,"in_reply_to":"66132b76_cd36b6bb","updated":"2026-10-07 18:58:41.000000000","message":"i tought i had capture that in the usecase/probelm stemnt when i mented that soem nvidia device use the same vendor id and product id for the VF and pF\n\nintel qad devices also did that in some generations\n\nthe specifc problem it causes in the case of gpus is you cant just use the vendor id and product id to allow all of them to be sused because with pci in placment we do not allow the PF and VF both to be mathced\n\n\nthe largeer usecase is something liek nic partiotioning where one fo the nic VFs is used for host networkin i.e. stroage network or management network.\n\nos-netconfig and tipleo have been working around this for years by having hackign scritp to try and compute the set of adress to whitelist themselves.\nit caused use a lot of pain in our new installer so i expct this is a common painpoint for multiple opertors.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":90,"context_line":"Exclusions determine device eligibility before group membership is applied."},{"line_number":91,"context_line":"Eligible devices listed in a group can only be consumed through that group;"},{"line_number":92,"context_line":"eligible ungrouped devices remain individually consumable. Exclusions affecting"},{"line_number":93,"context_line":"allocated or reserved devices are deferred under the lifecycle rules below."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"Configuring Groups"},{"line_number":96,"context_line":"------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ef4b03bf_6973f3c4","line":93,"in_reply_to":"81522eb7_b9c0feed","updated":"2026-11-05 15:24:39.000000000","message":"thanks","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"fada3c0e23d1b78f390a6fba715fa9b2971440bb","unresolved":true,"context_lines":[{"line_number":90,"context_line":"Exclusions determine device eligibility before group membership is applied."},{"line_number":91,"context_line":"Eligible devices listed in a group can only be consumed through that group;"},{"line_number":92,"context_line":"eligible ungrouped devices remain individually consumable. Exclusions affecting"},{"line_number":93,"context_line":"allocated or reserved devices are deferred under the lifecycle rules below."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"Configuring Groups"},{"line_number":96,"context_line":"------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"e496451c_a3b69651","line":93,"in_reply_to":"96b801ec_d93d71bb","updated":"2026-10-15 14:11:47.000000000","message":"lets add something specific to the problem statement about it. I re-read that and I don\u0027t see anything about it there.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":90,"context_line":"Exclusions determine device eligibility before group membership is applied."},{"line_number":91,"context_line":"Eligible devices listed in a group can only be consumed through that group;"},{"line_number":92,"context_line":"eligible ungrouped devices remain individually consumable. Exclusions affecting"},{"line_number":93,"context_line":"allocated or reserved devices are deferred under the lifecycle rules below."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"Configuring Groups"},{"line_number":96,"context_line":"------------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"81522eb7_b9c0feed","line":93,"in_reply_to":"e496451c_a3b69651","updated":"2026-10-28 19:44:49.000000000","message":"Done","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":false,"context_lines":[{"line_number":173,"context_line":"Devices matched by an inclusion entry in ``[pci]device_spec`` are available"},{"line_number":174,"context_line":"to Nova unless an exclusion entry also matches them. Devices listed in"},{"line_number":175,"context_line":"``[pci]group_spec`` can only be consumed as part of their group, not"},{"line_number":176,"context_line":"individually. A group can contain a single device. Nova will not automatically"},{"line_number":177,"context_line":"convert ordinary devices into singleton groups."},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"}],"source_content_type":"text/x-rst","patch_set":6,"id":"fd0f38c5_a402b508","line":176,"range":{"start_line":176,"start_character":14,"end_line":176,"end_character":50},"updated":"2026-10-07 15:53:48.000000000","message":"The one device per group is a natural extension of the syntax, I\u0027m not against it I guess everything will work automatically for it out of the box. \n\nIt made me realize that we should say (below in the config validation section) that a group with an empty addresses field is a configuration error and nova-compute should refuse to start with it.\n// later\nwe already have the validation rule there.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":174,"context_line":"to Nova unless an exclusion entry also matches them. Devices listed in"},{"line_number":175,"context_line":"``[pci]group_spec`` can only be consumed as part of their group, not"},{"line_number":176,"context_line":"individually. A group can contain a single device. Nova will not automatically"},{"line_number":177,"context_line":"convert ordinary devices into singleton groups."},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"},{"line_number":180,"context_line":"the matched devices are later used in a ``[pci]group_spec``. But some have"}],"source_content_type":"text/x-rst","patch_set":6,"id":"5ca2dd75_6d8bdd26","line":177,"range":{"start_line":177,"start_character":25,"end_line":177,"end_character":47},"updated":"2026-10-07 15:53:48.000000000","message":"The term feels strange to me but I\u0027m not native so this might be a limit on my side. For me singleton means something that is singular, have one piece of it. But consider\n```\n  group_spec \u003d {\"addresses\": [\"0000:b4:00.0\"], \"type\": \"nvidia-gpu-1x\", \"key\": \"gpu11\"}\n  group_spec \u003d {\"addresses\": [\"0000:b6:00.0\"], \"type\": \"nvidia-gpu-1x\", \"key\": \"gpu12\"}\n```\nThis is a valid config if we allow single device per group. But here we have two instances of the group type `nvidia-gpu-1x`. I would not say `nvidia-gpu-1x` is a singleton. I know that you probably mean gpu11 has as singleton device. But given the *possible* confusion. I rather just use: \"Nova will not automatically convert ordinary devices into groups of single devices\"","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":true,"context_lines":[{"line_number":174,"context_line":"to Nova unless an exclusion entry also matches them. Devices listed in"},{"line_number":175,"context_line":"``[pci]group_spec`` can only be consumed as part of their group, not"},{"line_number":176,"context_line":"individually. A group can contain a single device. Nova will not automatically"},{"line_number":177,"context_line":"convert ordinary devices into singleton groups."},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"},{"line_number":180,"context_line":"the matched devices are later used in a ``[pci]group_spec``. But some have"}],"source_content_type":"text/x-rst","patch_set":6,"id":"610c4f29_0f62dd01","line":177,"range":{"start_line":177,"start_character":25,"end_line":177,"end_character":47},"in_reply_to":"5ca2dd75_6d8bdd26","updated":"2026-10-07 18:05:47.000000000","message":"Yeah, \"singleton\" is not the right word here I think. I think the intent here is to say \"we don\u0027t consider every non-grouped device to be a group of one. As I think I said in a previous rev of this spec, that seems unfortunate to me because we\u0027re adding yet another way to include something in an alias, which is already too fragmented, but...","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":174,"context_line":"to Nova unless an exclusion entry also matches them. Devices listed in"},{"line_number":175,"context_line":"``[pci]group_spec`` can only be consumed as part of their group, not"},{"line_number":176,"context_line":"individually. A group can contain a single device. Nova will not automatically"},{"line_number":177,"context_line":"convert ordinary devices into singleton groups."},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"},{"line_number":180,"context_line":"the matched devices are later used in a ``[pci]group_spec``. But some have"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ed291c74_2d731eab","line":177,"range":{"start_line":177,"start_character":25,"end_line":177,"end_character":47},"in_reply_to":"610c4f29_0f62dd01","updated":"2026-10-08 17:44:57.000000000","message":"I mean groups with a single member or element i.e. 1 adress.\n\nA singleton group means that to me but ill rephrase.\n\nthe reason we do not consider all device to be groups of 1 is  that each group has a 1:1 mapping with a separate placement RP and a single modern nic can have 512 VF which would be bad to model as 512 groups of 1 vf\n\nthis is also the exact problem that cyborg currently has as it does model each VF as its own RP.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":174,"context_line":"to Nova unless an exclusion entry also matches them. Devices listed in"},{"line_number":175,"context_line":"``[pci]group_spec`` can only be consumed as part of their group, not"},{"line_number":176,"context_line":"individually. A group can contain a single device. Nova will not automatically"},{"line_number":177,"context_line":"convert ordinary devices into singleton groups."},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"The existing ``[pci]device_spec`` tags can be used in the configuration even if"},{"line_number":180,"context_line":"the matched devices are later used in a ``[pci]group_spec``. But some have"}],"source_content_type":"text/x-rst","patch_set":6,"id":"813afcad_abcc0452","line":177,"range":{"start_line":177,"start_character":25,"end_line":177,"end_character":47},"in_reply_to":"ed291c74_2d731eab","updated":"2026-10-28 19:44:49.000000000","message":"Done","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":true,"context_lines":[{"line_number":190,"context_line":"  are defined in the ``[pci]device_spec`` for a grouped device then they are"},{"line_number":191,"context_line":"  ignored. The traits can be defined in the ``[pci]group_spec`` instead for the"},{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"80a60cb0_513edf8a","line":193,"updated":"2026-10-07 18:05:47.000000000","message":"This is already an incredibly confusing interface for humans, IMHO. Can we s/ignored/raised as an error/? Basically \"sorry device X has resource_class defined but is included in group Y\"","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"bfb35dbd75173596c0bec4e5cdc558444cf6aaa7","unresolved":true,"context_lines":[{"line_number":190,"context_line":"  are defined in the ``[pci]device_spec`` for a grouped device then they are"},{"line_number":191,"context_line":"  ignored. The traits can be defined in the ``[pci]group_spec`` instead for the"},{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9f264927_57909008","line":193,"in_reply_to":"80a60cb0_513edf8a","updated":"2026-10-07 19:19:17.000000000","message":"i woudl prefer not to as that create a coupleing between the group spec and the device spec that is more complex as we need to kwno which device spec entry allow the device to be included to then be able to figure that out.,\n\n\ncureently the way this works at a had wavy level is the compute manager asks the virt driver to provide the set of abstrac pci device to the pci tacker.\n\nmore concreatly in the libvirt case the livbrit driver asks libvirt for allt he pci devices and we filter those based on the devspec and generate pci info dict that are annotated with the tags form devspec.\n\nbut we dont nessiarly have a pointer to the specific device spec that allwoe it to be included.\n\nthe intent with exclude is to just filter that again to remove excluded devices and finally groups replace a subset of those device with a group.\n\nso that 3 functional tansfromation of the intiall list all pci devices that dont depend on each other.\n\neffetivly the same as ls | grep ... |grep  .. | grep ...\n\nadding what you are askign for create a depennce betwen the final and first filtering stage.\n\nwe might be able to pass the refecne forward through that pipeline but its addign compelxity.\n\ni can tell that the annotated dict that models the device has a resouce_class tag  but saying which one is harder.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"c65a315e46215a85a4687a3ee41081f35693ba15","unresolved":true,"context_lines":[{"line_number":190,"context_line":"  are defined in the ``[pci]device_spec`` for a grouped device then they are"},{"line_number":191,"context_line":"  ignored. The traits can be defined in the ``[pci]group_spec`` instead for the"},{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"d7242454_47f79307","line":193,"in_reply_to":"9f264927_57909008","updated":"2026-10-07 21:50:26.000000000","message":"We can\u0027t go through the groups, get the group_types and then check each device_spec that matches that to see if it\u0027s got a thing we know we\u0027re going to ignore?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":190,"context_line":"  are defined in the ``[pci]device_spec`` for a grouped device then they are"},{"line_number":191,"context_line":"  ignored. The traits can be defined in the ``[pci]group_spec`` instead for the"},{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"3d342520_fcb42bb5","line":193,"in_reply_to":"cc591288_15c2354a","updated":"2026-10-28 19:44:49.000000000","message":"im going to resolve this i think i have adress this based on our ptg dicssion","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":190,"context_line":"  are defined in the ``[pci]device_spec`` for a grouped device then they are"},{"line_number":191,"context_line":"  ignored. The traits can be defined in the ``[pci]group_spec`` instead for the"},{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"cc591288_15c2354a","line":193,"in_reply_to":"d7242454_47f79307","updated":"2026-10-08 17:44:57.000000000","message":"not eaislly in all cases and it would also break some usecases if we did that\n\nfor example if i have 4 idential pci devices\n\nwithout this feature i can allow all 4 to be used with on line\n```\n[pci]\ndevice_spec\u003d{\"vendor_id\": \"8086\", \"product_id\": \"1533\"}\n```\ni an consume it with an alise by using its auto generated resouce clase or the vendor id and product id.\nlets assume we are doing it the modern way via the autogenreate resouce_class the aliase woudl look like this\n\n```\n[pci]\nreport_in_placement\u003dtrue\ndevice_spec\u003d{\"vendor_id\": \"8086\", \"product_id\": \"1533\"}\nalias\u003d{\"name\": \"nic\", \"resouce_class\": \"CUSTOM_PCI_8086_1533\"}\n```\n\ntha would allow each of the 4 nics to be assigne ot diffent vms or 1 vm can have all four via the flavor extra spec.\n\n`hw:pci_passthouhg\u003dnic:1` vs `hw:pci_passthouhg\u003dnic:4`\n\n\nso now asusme the operator upgrade to this featue and want to enable it and for simplicty assume the host is empty so all device are free.\n\nso say they want 1 group of 2 nics an 2 indepent nics\nwell they just need to add 1 group_spec line adn 1 alise\n\n```\n[pci]\nreport_in_placement\u003dtrue\ndevice_spec\u003d{\"vendor_id\": \"8086\", \"product_id\": \"1533\"}\ngroup_spec \u003d {\n    \"addresses\": [\"0000:04:00.0\", \"0000:05:00.0\"],\n    \"key\": \"nic_pair1\", \"type\": \"nic_pair\"}\nalias \u003d [{\"name\": \"nic-pair\", \"group_type\": \"nic_pair\"},\n         {\"name\": \"nic\", \"resoruce_class\": \"CUSTOM_PCI_8086_1533\"}]\n```\n\nthe devspec still says \"all device with vendor id \"8086\" and product id \"1533\"\nare manageable by nova\n\nthe group spec says devcice  [\"0000:04:00.0\", \"0000:05:00.0\"] are member of the nic-pair group those will be reproed with CUSTOM_PCI_GROUP_NIC_PAIR\nand the remaining nics will stil be reported with CUSTOM_PCI_8086_1533\n\nthat all fine. now say i give an non default RC of just \"nic\"\n\n ```\n[pci]\nreport_in_placement\u003dtrue\ndevice_spec\u003d{\"vendor_id\": \"8086\", \"product_id\": \"1533\", \"resouce_class\":\"nic\"}\ngroup_spec \u003d {\n    \"addresses\": [\"0000:04:00.0\", \"0000:05:00.0\"],\n    \"key\": \"nic_pair1\", \"type\": \"nic_pair\"}\nalias \u003d [{\"name\": \"nic-pair\", \"group_type\": \"nic_pair\"},\n         {\"name\": \"nic\", \"resoruce_class\": \"CUSTOM_PCI_NIC\"}]\n```\nnic will be normalised to CUSTOM_PCI_NIC\n\nthis still work but now we have the case this section is decribing\n\nthe resouce class is corerctly applied to the pci devices it matches and the group takes precendence.\n\nif i make it an error i woudl have to lopp of evey devstack adn check if it matches the dvice in the group by takign the list of all devices and apllying that specs filering logic.\n\ni coudl do that but even if i didn the config makes sesne as written, its not an error.\n\nwhat i can do easilly is say is group x refers to a adress \"0000:04:00.0\" which is not allowed by any devspec\n\n\nfor example in the case that \"0000:04:00.0\" died and was repalce by a melox nic instead fo a intel nic. i can say nic pair is now invalid becuase this specific device does nto match. i can maybe say somehting about \"0000:04:00.0\"  if i query libvirt.\n\nbut i cant say \"sorry device X has resource_class defined but is included in group Y\" becasue i have no way to know that the devstack was ment to allow it.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""},{"line_number":197,"context_line":".. note::"},{"line_number":198,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"39348913_eaceb544","line":195,"updated":"2026-10-07 15:53:48.000000000","message":"Is this includes the newly introduced `excluded` tag? I guess we can be explicit about it that the `excluded` tag is not inherited and only affect individual devices directly.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":192,"context_line":"  whole group. The ``resource_class`` of the group is always generated from"},{"line_number":193,"context_line":"  the ``type`` of the group."},{"line_number":194,"context_line":"* The rest of the tags are applied only on the individual device level and not"},{"line_number":195,"context_line":"  inherited to the group in any ways."},{"line_number":196,"context_line":""},{"line_number":197,"context_line":".. note::"},{"line_number":198,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"25ea2376_8f8770d8","line":195,"in_reply_to":"39348913_eaceb544","updated":"2026-10-28 19:44:49.000000000","message":"this nolonger appleis as its not a tag anymore its a new config option","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"7f7bf711450b5202c96d9f456c043a589900abe4","unresolved":true,"context_lines":[{"line_number":196,"context_line":""},{"line_number":197,"context_line":".. note::"},{"line_number":198,"context_line":""},{"line_number":199,"context_line":"   PCI in Placement does not yet support devices with ``physical_network``"},{"line_number":200,"context_line":"   tags, which are requested through Neutron ports. Such devices cannot be"},{"line_number":201,"context_line":"   added to PCI groups."},{"line_number":202,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"130bfcab_39d812f3","line":199,"updated":"2026-10-08 08:35:32.000000000","message":"There is also no Placement tags for numa aligned groups or pcie root complexes yet, however, could those be covered by Cyborg ARQ/handle and \u0027accel\u0027 tags by a chance? Then Placement would only do physical overlay/topology unaware bookkeeping tasks. My point is should we restrict design to things not yet supported by Placement? I am sorry if that comment is naive and makes a little sense","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":196,"context_line":""},{"line_number":197,"context_line":".. note::"},{"line_number":198,"context_line":""},{"line_number":199,"context_line":"   PCI in Placement does not yet support devices with ``physical_network``"},{"line_number":200,"context_line":"   tags, which are requested through Neutron ports. Such devices cannot be"},{"line_number":201,"context_line":"   added to PCI groups."},{"line_number":202,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ce345246_cff4e202","line":199,"in_reply_to":"130bfcab_39d812f3","updated":"2026-10-28 19:44:49.000000000","message":"this is out os scop so im resolving this.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":true,"context_lines":[{"line_number":212,"context_line":"* ``numa_policy``: Supported. See the separate section below for what it means"},{"line_number":213,"context_line":"  for groups."},{"line_number":214,"context_line":"* ``resource_class``: Supported instead of ``group_type`` to select group"},{"line_number":215,"context_line":"  inventory directly. It does not change the group\u0027s inventory definition."},{"line_number":216,"context_line":"* ``traits``: Supported. If specified then the alias only matches to groups"},{"line_number":217,"context_line":"  that have at least these traits listed in their ``traits`` field in"},{"line_number":218,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"}],"source_content_type":"text/x-rst","patch_set":6,"id":"31d56b37_af8a3b10","line":215,"updated":"2026-10-07 18:05:47.000000000","message":"This is because the `resource_class` from/for a group is determined by the group\u0027s `type` itself I guess? Can we just remove the need for `group_type` in alias and ask people to use `resource_class` instead?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"bfb35dbd75173596c0bec4e5cdc558444cf6aaa7","unresolved":true,"context_lines":[{"line_number":212,"context_line":"* ``numa_policy``: Supported. See the separate section below for what it means"},{"line_number":213,"context_line":"  for groups."},{"line_number":214,"context_line":"* ``resource_class``: Supported instead of ``group_type`` to select group"},{"line_number":215,"context_line":"  inventory directly. It does not change the group\u0027s inventory definition."},{"line_number":216,"context_line":"* ``traits``: Supported. If specified then the alias only matches to groups"},{"line_number":217,"context_line":"  that have at least these traits listed in their ``traits`` field in"},{"line_number":218,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"}],"source_content_type":"text/x-rst","patch_set":6,"id":"5a5782fb_43e6f6a6","line":215,"in_reply_to":"31d56b37_af8a3b10","updated":"2026-10-07 19:19:17.000000000","message":"i would prefer to go the other way and not supprot using recouse_class with groups.\n\nin the preior version you asked about supprtoing both and gibi wanted to suprpot both so i tried to keep it but not having an identify for i am requesting a group in the aslis via a dedicated take menas i have to do some hacking match in the content of the resocue_class which i do not like.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":212,"context_line":"* ``numa_policy``: Supported. See the separate section below for what it means"},{"line_number":213,"context_line":"  for groups."},{"line_number":214,"context_line":"* ``resource_class``: Supported instead of ``group_type`` to select group"},{"line_number":215,"context_line":"  inventory directly. It does not change the group\u0027s inventory definition."},{"line_number":216,"context_line":"* ``traits``: Supported. If specified then the alias only matches to groups"},{"line_number":217,"context_line":"  that have at least these traits listed in their ``traits`` field in"},{"line_number":218,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"}],"source_content_type":"text/x-rst","patch_set":6,"id":"4b1ae8f7_e7af5554","line":215,"in_reply_to":"5a5782fb_43e6f6a6","updated":"2026-10-28 19:44:49.000000000","message":"Done","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"6957a8e8388f7457312a0555aa7f8999d7d5d569","unresolved":true,"context_lines":[{"line_number":213,"context_line":"  for groups."},{"line_number":214,"context_line":"* ``resource_class``: Supported instead of ``group_type`` to select group"},{"line_number":215,"context_line":"  inventory directly. It does not change the group\u0027s inventory definition."},{"line_number":216,"context_line":"* ``traits``: Supported. If specified then the alias only matches to groups"},{"line_number":217,"context_line":"  that have at least these traits listed in their ``traits`` field in"},{"line_number":218,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"},{"line_number":219,"context_line":"  requests."}],"source_content_type":"text/x-rst","patch_set":6,"id":"72f168f1_0291bd95","line":216,"updated":"2026-10-08 08:39:19.000000000","message":"same naive question here, should we restrict design to only allowing traits that Placement supports today, or allowing accel \"traits\" from Cyborg?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":213,"context_line":"  for groups."},{"line_number":214,"context_line":"* ``resource_class``: Supported instead of ``group_type`` to select group"},{"line_number":215,"context_line":"  inventory directly. It does not change the group\u0027s inventory definition."},{"line_number":216,"context_line":"* ``traits``: Supported. If specified then the alias only matches to groups"},{"line_number":217,"context_line":"  that have at least these traits listed in their ``traits`` field in"},{"line_number":218,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"},{"line_number":219,"context_line":"  requests."}],"source_content_type":"text/x-rst","patch_set":6,"id":"1cbee535_d09d2d0d","line":216,"in_reply_to":"66b26ef8_8230213a","updated":"2026-10-28 19:44:49.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":213,"context_line":"  for groups."},{"line_number":214,"context_line":"* ``resource_class``: Supported instead of ``group_type`` to select group"},{"line_number":215,"context_line":"  inventory directly. It does not change the group\u0027s inventory definition."},{"line_number":216,"context_line":"* ``traits``: Supported. If specified then the alias only matches to groups"},{"line_number":217,"context_line":"  that have at least these traits listed in their ``traits`` field in"},{"line_number":218,"context_line":"  the ``group_spec``, i.e. the group needs to provide all the traits the alias"},{"line_number":219,"context_line":"  requests."}],"source_content_type":"text/x-rst","patch_set":6,"id":"66b26ef8_8230213a","line":216,"in_reply_to":"72f168f1_0291bd95","updated":"2026-10-08 17:44:57.000000000","message":"no we shoudl not.\n\nwe expleciy do not allow you to set standard traits via the pci device_spec today\nall traits reported this way will be custom_traits.\n\nand this has nothing to do with cybrog.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"bf97122d117ecef95f03f44cbc189ef9d6ad5fd7","unresolved":true,"context_lines":[{"line_number":219,"context_line":"  requests."},{"line_number":220,"context_line":"* ``live_migratable``: Supported to request a live migratable group."},{"line_number":221,"context_line":""},{"line_number":222,"context_line":"PCI grouping builds on PCI in Placement and inherits its limitations. See"},{"line_number":223,"context_line":"https://docs.openstack.org/nova/latest/admin/pci-passthrough#pci-tracking-in-placement"},{"line_number":224,"context_line":""},{"line_number":225,"context_line":"Excluding Devices"}],"source_content_type":"text/x-rst","patch_set":6,"id":"8f32fdef_2d84d0da","line":222,"updated":"2026-10-08 08:41:59.000000000","message":"That is fair enough, but can we extend grouping logic to cyborg managed device profiles?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":false,"context_lines":[{"line_number":219,"context_line":"  requests."},{"line_number":220,"context_line":"* ``live_migratable``: Supported to request a live migratable group."},{"line_number":221,"context_line":""},{"line_number":222,"context_line":"PCI grouping builds on PCI in Placement and inherits its limitations. See"},{"line_number":223,"context_line":"https://docs.openstack.org/nova/latest/admin/pci-passthrough#pci-tracking-in-placement"},{"line_number":224,"context_line":""},{"line_number":225,"context_line":"Excluding Devices"}],"source_content_type":"text/x-rst","patch_set":6,"id":"0c8afa0c_13d32943","line":222,"in_reply_to":"8f32fdef_2d84d0da","updated":"2026-10-08 17:44:57.000000000","message":"no cybrog manged devices are not configure via nova config optins.\n\nthey are two entirly diffent code paths.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":true,"context_lines":[{"line_number":231,"context_line":"``*``, or the dictionary-based Python regex syntax. This does not add full"},{"line_number":232,"context_line":"Bash glob support."},{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Nova evaluates exclusions before selecting an inclusion entry. A matching"},{"line_number":235,"context_line":"exclusion takes precedence regardless of the order of entries, including"},{"line_number":236,"context_line":"entries supplied through JSON lists. An exclusion does not make any device"},{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."}],"source_content_type":"text/x-rst","patch_set":6,"id":"11154150_70613af2","line":235,"range":{"start_line":234,"start_character":1,"end_line":235,"end_character":61},"updated":"2026-10-07 18:05:47.000000000","message":"The first sentence seems to conflict with the second, and further statements below. What you mean here is that \"exclusion always takes priority\" right? to me that means we evaluate inclusion first and exclusion last (i.e. exclusion always wins).","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"bfb35dbd75173596c0bec4e5cdc558444cf6aaa7","unresolved":true,"context_lines":[{"line_number":231,"context_line":"``*``, or the dictionary-based Python regex syntax. This does not add full"},{"line_number":232,"context_line":"Bash glob support."},{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Nova evaluates exclusions before selecting an inclusion entry. A matching"},{"line_number":235,"context_line":"exclusion takes precedence regardless of the order of entries, including"},{"line_number":236,"context_line":"entries supplied through JSON lists. An exclusion does not make any device"},{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."}],"source_content_type":"text/x-rst","patch_set":6,"id":"97fec434_41149820","line":235,"range":{"start_line":234,"start_character":1,"end_line":235,"end_character":61},"in_reply_to":"11154150_70613af2","updated":"2026-10-07 19:19:17.000000000","message":"yes\n\nits actully more like i said above.\n\nlivbirt gives list of all devices | device_specs are used to filter that\nthen excluditon and finally we group if groups are relevnet.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":231,"context_line":"``*``, or the dictionary-based Python regex syntax. This does not add full"},{"line_number":232,"context_line":"Bash glob support."},{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Nova evaluates exclusions before selecting an inclusion entry. A matching"},{"line_number":235,"context_line":"exclusion takes precedence regardless of the order of entries, including"},{"line_number":236,"context_line":"entries supplied through JSON lists. An exclusion does not make any device"},{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."}],"source_content_type":"text/x-rst","patch_set":6,"id":"5eeee7a8_f048aede","line":235,"range":{"start_line":234,"start_character":1,"end_line":235,"end_character":61},"in_reply_to":"97fec434_41149820","updated":"2026-10-28 19:44:49.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Nova evaluates exclusions before selecting an inclusion entry. A matching"},{"line_number":235,"context_line":"exclusion takes precedence regardless of the order of entries, including"},{"line_number":236,"context_line":"entries supplied through JSON lists. An exclusion does not make any device"},{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"}],"source_content_type":"text/x-rst","patch_set":6,"id":"eb23bed8_f16f10e8","line":237,"range":{"start_line":236,"start_character":37,"end_line":237,"end_character":74},"updated":"2026-10-07 15:53:48.000000000","message":"are the inclusion and exclusion entry to separate entry? The text below does talks about both exclusion and vendor/product inclusion so I\u0027m not sure.\n\nI personally prefer if we keep the exclusion entry very simple, {address\u003d..., excluded:true} and make the rest of the fields for an exclusion entry an invalid config.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Nova evaluates exclusions before selecting an inclusion entry. A matching"},{"line_number":235,"context_line":"exclusion takes precedence regardless of the order of entries, including"},{"line_number":236,"context_line":"entries supplied through JSON lists. An exclusion does not make any device"},{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"}],"source_content_type":"text/x-rst","patch_set":6,"id":"44619b83_a508045c","line":237,"range":{"start_line":236,"start_character":37,"end_line":237,"end_character":74},"in_reply_to":"e513b5f0_e1023bd2","updated":"2026-10-28 19:44:49.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"62e31d091bf8074c1f27a468267bdde3bde938e9","unresolved":true,"context_lines":[{"line_number":233,"context_line":""},{"line_number":234,"context_line":"Nova evaluates exclusions before selecting an inclusion entry. A matching"},{"line_number":235,"context_line":"exclusion takes precedence regardless of the order of entries, including"},{"line_number":236,"context_line":"entries supplied through JSON lists. An exclusion does not make any device"},{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"}],"source_content_type":"text/x-rst","patch_set":6,"id":"e513b5f0_e1023bd2","line":237,"range":{"start_line":236,"start_character":37,"end_line":237,"end_character":74},"in_reply_to":"eb23bed8_f16f10e8","updated":"2026-10-07 18:58:41.000000000","message":"yes.\nits just a devspec entry that has exclude and the adress.\n\nso no complex mixing just the new boolean tag","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"},{"line_number":241,"context_line":"vendor/product IDs matching the PF\u0027s VFs and their product ID differs from"},{"line_number":242,"context_line":"the PF\u0027s. In that case, it excludes those matching VFs instead. If the PF"},{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9625b34a_a6128419","line":240,"range":{"start_line":240,"start_character":13,"end_line":240,"end_character":19},"updated":"2026-10-07 15:53:48.000000000","message":"addressing?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"},{"line_number":241,"context_line":"vendor/product IDs matching the PF\u0027s VFs and their product ID differs from"},{"line_number":242,"context_line":"the PF\u0027s. In that case, it excludes those matching VFs instead. If the PF"},{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"}],"source_content_type":"text/x-rst","patch_set":6,"id":"c13a8783_cabf8c83","line":240,"range":{"start_line":240,"start_character":13,"end_line":240,"end_character":19},"in_reply_to":"036c0d94_30ccb34c","updated":"2026-10-28 19:44:49.000000000","message":"Done","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"62e31d091bf8074c1f27a468267bdde3bde938e9","unresolved":true,"context_lines":[{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"},{"line_number":241,"context_line":"vendor/product IDs matching the PF\u0027s VFs and their product ID differs from"},{"line_number":242,"context_line":"the PF\u0027s. In that case, it excludes those matching VFs instead. If the PF"},{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"}],"source_content_type":"text/x-rst","patch_set":6,"id":"036c0d94_30ccb34c","line":240,"range":{"start_line":240,"start_character":13,"end_line":240,"end_character":19},"in_reply_to":"9625b34a_a6128419","updated":"2026-10-07 18:58:41.000000000","message":"ya we can use adressign or \"referring to\"","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"},{"line_number":241,"context_line":"vendor/product IDs matching the PF\u0027s VFs and their product ID differs from"},{"line_number":242,"context_line":"the PF\u0027s. In that case, it excludes those matching VFs instead. If the PF"},{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"},{"line_number":244,"context_line":"targets only the PF, even when its filters specify those shared IDs."},{"line_number":245,"context_line":"Wildcard and regex entries apply their address and vendor/product filters"}],"source_content_type":"text/x-rst","patch_set":6,"id":"cebaa967_5fee012f","line":242,"range":{"start_line":240,"start_character":47,"end_line":242,"end_character":63},"updated":"2026-10-07 15:53:48.000000000","message":"(see here it says the exclusion pointing to a PF by address and then also supplying vendor/product matching, hence my point about about: are these separate entries or single entry?)","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":237,"context_line":"available to Nova. Devices must still match an inclusion entry to be used."},{"line_number":238,"context_line":"Entries with ``exclude: false`` retain the existing inclusion behavior."},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"An exclusion naming a PF excludes only that PF unless it explicitly supplies"},{"line_number":241,"context_line":"vendor/product IDs matching the PF\u0027s VFs and their product ID differs from"},{"line_number":242,"context_line":"the PF\u0027s. In that case, it excludes those matching VFs instead. If the PF"},{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"},{"line_number":244,"context_line":"targets only the PF, even when its filters specify those shared IDs."},{"line_number":245,"context_line":"Wildcard and regex entries apply their address and vendor/product filters"}],"source_content_type":"text/x-rst","patch_set":6,"id":"2fe5acbc_c510ed80","line":242,"range":{"start_line":240,"start_character":47,"end_line":242,"end_character":63},"in_reply_to":"cebaa967_5fee012f","updated":"2026-10-28 19:44:49.000000000","message":"n/a","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"},{"line_number":244,"context_line":"targets only the PF, even when its filters specify those shared IDs."},{"line_number":245,"context_line":"Wildcard and regex entries apply their address and vendor/product filters"},{"line_number":246,"context_line":"with the same PF/VF distinction."},{"line_number":247,"context_line":""},{"line_number":248,"context_line":".. note::"},{"line_number":249,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"16b0ed37_e93d482d","line":246,"updated":"2026-10-07 15:53:48.000000000","message":"Can we all do this with {address\u003d.. excluded\u003dtrue} entries instead? Mixing address and vendor/product and exclude creates hard to interpret situations. Wondering if there is a case that is hard to express with the simple format.\n\n// later\n\nLooking more at the examples this might be the case, we only use {address\u003d.. excluded\u003dtrue} exclude entries never a {vendor\u003d product\u003d address\u003d.. excluded\u003dtrue}\n\nSo it is likely a wording issue in this paragraph","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":243,"context_line":"and VFs share the same vendor id and product id, a PF-address exclusion"},{"line_number":244,"context_line":"targets only the PF, even when its filters specify those shared IDs."},{"line_number":245,"context_line":"Wildcard and regex entries apply their address and vendor/product filters"},{"line_number":246,"context_line":"with the same PF/VF distinction."},{"line_number":247,"context_line":""},{"line_number":248,"context_line":".. note::"},{"line_number":249,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"0ede07f5_73d784aa","line":246,"in_reply_to":"16b0ed37_e93d482d","updated":"2026-10-28 19:44:49.000000000","message":"also not relevent following the change in the ptg to exclude_list","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":256,"context_line":"used by the host, such as NICs used for management or storage, while keeping"},{"line_number":257,"context_line":"other NICs assignable to instances. This natively supports NIC partitioning."},{"line_number":258,"context_line":"For example, a host with four matching NICs can keep one for host use,"},{"line_number":259,"context_line":"expose two as a group, and leave the fourth individually consumable:"},{"line_number":260,"context_line":""},{"line_number":261,"context_line":".. code-block:: ini"},{"line_number":262,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"d5b61ae3_727067c6","line":259,"updated":"2026-10-07 15:53:48.000000000","message":"I think something is missing from this use case or from my understanding. If this is the only thing the admin want then why don\u0027t they say:\n```\n[pci]\n    # explicitly not listing 03 as that is consumed by the host\n    device_spec \u003d [{\"address\": \"0000:04:00.0\"}, {\"address\": \"0000:05:00.0\"}] \n\n    group_spec \u003d {\"addresses\": [\"0000:04:00.0\", \"0000:05:00.0\"], \"key\": \"nic_pair1\", \"type\": \"nic_pair\"}\n\n    alias \u003d [{\"name\": \"nic-pair\", \"group_type\": \"nic_pair\"},\n             {\"name\": \"nic\", \"vendor_id\": \"8086\", \"product_id\": \"1533\"}]\n\n```\n\n// later\n\nI think I see what is missing from the description.\n\nThe admin wants to define an alias with vendor / product to offer *all* of such devices *except* the ones that are reserved for the host.\n\nThat is a valid need. We don\u0027t have this open ended \"all but\" syntax. \n\n// later \n\nor do we? \n\nWe have this example about regex:\n\n```\ndevice_spec \u003d {\"address\":{\"domain\": \".*\",\n                          \"bus\": \"02\", \"slot\": \"0[1-2]\",\n                          \"function\": \".*\"},\n```\n\nSo something like that should work to exclude 03 and allow anything else (but I agree it is a bit complicated to read too :D )\n\n```\ndevice_spec \u003d {\"address\":{\"domain\": \".*\",\n                          \"bus\": \"(?!03).{2}\", \"slot\": \".*\",\n                          \"function\": \".*\"},\n                \"vendor_id\": \"8086\", \"product_id\": \"1533\"}\n```                \nI think what I\u0027m asking here is to point out in the text that the exclude is needed to allow not just including 04 and 05, but any other devices with the matching vendor / product that are not the host reserved 03 device.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"bfb35dbd75173596c0bec4e5cdc558444cf6aaa7","unresolved":true,"context_lines":[{"line_number":256,"context_line":"used by the host, such as NICs used for management or storage, while keeping"},{"line_number":257,"context_line":"other NICs assignable to instances. This natively supports NIC partitioning."},{"line_number":258,"context_line":"For example, a host with four matching NICs can keep one for host use,"},{"line_number":259,"context_line":"expose two as a group, and leave the fourth individually consumable:"},{"line_number":260,"context_line":""},{"line_number":261,"context_line":".. code-block:: ini"},{"line_number":262,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"32424ff3_d15af248","line":259,"in_reply_to":"09e63698_26020ffe","updated":"2026-10-07 19:19:17.000000000","message":"a nvida a30 or l4 use the same vendor id and product id for the PF and VF so with pci in placment enabeld you cant just use them to allow your VGPUs to used in groups\n\nyou ahve to use the adress to cherry pick only the VFs\n\ni  didn hit this last year in my prverios verson bcasue i was testing with intel nics where the PF and VF have diffent product_ids because they use diffent kernel drivers\n\nnviia gpus use the same kernel driver for the PF or in the guest for the VF","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"c65a315e46215a85a4687a3ee41081f35693ba15","unresolved":true,"context_lines":[{"line_number":256,"context_line":"used by the host, such as NICs used for management or storage, while keeping"},{"line_number":257,"context_line":"other NICs assignable to instances. This natively supports NIC partitioning."},{"line_number":258,"context_line":"For example, a host with four matching NICs can keep one for host use,"},{"line_number":259,"context_line":"expose two as a group, and leave the fourth individually consumable:"},{"line_number":260,"context_line":""},{"line_number":261,"context_line":".. code-block:: ini"},{"line_number":262,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"32794d5c_482cdfdc","line":259,"in_reply_to":"32424ff3_d15af248","updated":"2026-10-07 21:50:26.000000000","message":"That\u0027s why you want to have that ability with those devices too, I get that. It just seems like it\u0027s something that stands on its own separate from the grouping and could be landed as a separate patch and understood in isolation.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":256,"context_line":"used by the host, such as NICs used for management or storage, while keeping"},{"line_number":257,"context_line":"other NICs assignable to instances. This natively supports NIC partitioning."},{"line_number":258,"context_line":"For example, a host with four matching NICs can keep one for host use,"},{"line_number":259,"context_line":"expose two as a group, and leave the fourth individually consumable:"},{"line_number":260,"context_line":""},{"line_number":261,"context_line":".. code-block:: ini"},{"line_number":262,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"f916af2e_b8ff8404","line":259,"in_reply_to":"32794d5c_482cdfdc","updated":"2026-10-08 17:44:57.000000000","message":"yes it will be a sperate patch. i chatted to gibi breiflly about that as well and tehy suggested making it the first patch so that is my current plan. i will be rewritign the git histroy of my patches once i have converted my v2 implmation to align to v6+ and ill pull that to the start when i do that since it will work for non grouped devices as well.\n\nyou can use the regex match supprot to work around this painpont today but i dont think you shoudl have too.\n\nthat result in people writing costume ansibel modules in python like this\n\nhttps://github.com/openstack-k8s-operators/edpm-ansible/blob/main/plugins/modules/edpm_derive_pci_passthrough_devicespec.py\n\nto generate the config section.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":true,"context_lines":[{"line_number":256,"context_line":"used by the host, such as NICs used for management or storage, while keeping"},{"line_number":257,"context_line":"other NICs assignable to instances. This natively supports NIC partitioning."},{"line_number":258,"context_line":"For example, a host with four matching NICs can keep one for host use,"},{"line_number":259,"context_line":"expose two as a group, and leave the fourth individually consumable:"},{"line_number":260,"context_line":""},{"line_number":261,"context_line":".. code-block:: ini"},{"line_number":262,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"09e63698_26020ffe","line":259,"in_reply_to":"d5b61ae3_727067c6","updated":"2026-10-07 18:05:47.000000000","message":"But also, what does the exclusion stuff have to do (directly) with grouping? Without grouping I may still want to say \"all intel nics, except #3\" right? Seems like the exclusion feature is separate from the grouping and that we\u0027d just need a bullet in the list of how we handle things to say \"groups with an excluded device are excluded\" above, like we do for live-migratable and one-time-use.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":256,"context_line":"used by the host, such as NICs used for management or storage, while keeping"},{"line_number":257,"context_line":"other NICs assignable to instances. This natively supports NIC partitioning."},{"line_number":258,"context_line":"For example, a host with four matching NICs can keep one for host use,"},{"line_number":259,"context_line":"expose two as a group, and leave the fourth individually consumable:"},{"line_number":260,"context_line":""},{"line_number":261,"context_line":".. code-block:: ini"},{"line_number":262,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"7b52245d_f7a262fc","line":259,"in_reply_to":"f916af2e_b8ff8404","updated":"2026-10-28 19:44:49.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":279,"context_line":".. code-block:: ini"},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"    [pci]"},{"line_number":282,"context_line":"    device_spec \u003d [{\"vendor_id\": \"10de\", \"product_id\": \"1234\"},"},{"line_number":283,"context_line":"                   {\"address\": \"0000:06:00.0\", \"exclude\": true}]"},{"line_number":284,"context_line":"    alias \u003d [{\"name\": \"gpu-vf\", \"vendor_id\": \"10de\", \"product_id\": \"1234\", \"device_type\": \"type-VF\"}]"},{"line_number":285,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9e61854b_3b47917f","line":282,"updated":"2026-10-07 15:53:48.000000000","message":"so this would match both the PF and its VFs which would trigger a nova-compute startup error when report_in_placement is true.\n...","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"fada3c0e23d1b78f390a6fba715fa9b2971440bb","unresolved":false,"context_lines":[{"line_number":279,"context_line":".. code-block:: ini"},{"line_number":280,"context_line":""},{"line_number":281,"context_line":"    [pci]"},{"line_number":282,"context_line":"    device_spec \u003d [{\"vendor_id\": \"10de\", \"product_id\": \"1234\"},"},{"line_number":283,"context_line":"                   {\"address\": \"0000:06:00.0\", \"exclude\": true}]"},{"line_number":284,"context_line":"    alias \u003d [{\"name\": \"gpu-vf\", \"vendor_id\": \"10de\", \"product_id\": \"1234\", \"device_type\": \"type-VF\"}]"},{"line_number":285,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"fae8c2e1_3bf5e2ed","line":282,"in_reply_to":"9e61854b_3b47917f","updated":"2026-10-15 14:11:47.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":280,"context_line":""},{"line_number":281,"context_line":"    [pci]"},{"line_number":282,"context_line":"    device_spec \u003d [{\"vendor_id\": \"10de\", \"product_id\": \"1234\"},"},{"line_number":283,"context_line":"                   {\"address\": \"0000:06:00.0\", \"exclude\": true}]"},{"line_number":284,"context_line":"    alias \u003d [{\"name\": \"gpu-vf\", \"vendor_id\": \"10de\", \"product_id\": \"1234\", \"device_type\": \"type-VF\"}]"},{"line_number":285,"context_line":""},{"line_number":286,"context_line":"The exclusion omits vendor/product filters so it excludes only the named PF,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"cea5b994_17aab842","line":283,"updated":"2026-10-07 15:53:48.000000000","message":"...\nbut this excludes the PF from the list and therefore what remains is just the VFs \nand that is allowed.\n\nIf this is the correct implementation then I\u0027m OK with this syntax / semantics","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"fada3c0e23d1b78f390a6fba715fa9b2971440bb","unresolved":false,"context_lines":[{"line_number":280,"context_line":""},{"line_number":281,"context_line":"    [pci]"},{"line_number":282,"context_line":"    device_spec \u003d [{\"vendor_id\": \"10de\", \"product_id\": \"1234\"},"},{"line_number":283,"context_line":"                   {\"address\": \"0000:06:00.0\", \"exclude\": true}]"},{"line_number":284,"context_line":"    alias \u003d [{\"name\": \"gpu-vf\", \"vendor_id\": \"10de\", \"product_id\": \"1234\", \"device_type\": \"type-VF\"}]"},{"line_number":285,"context_line":""},{"line_number":286,"context_line":"The exclusion omits vendor/product filters so it excludes only the named PF,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"83e4f0b1_d7f7c292","line":283,"in_reply_to":"4403e10c_2334bafe","updated":"2026-10-15 14:11:47.000000000","message":"Acknowledged","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":280,"context_line":""},{"line_number":281,"context_line":"    [pci]"},{"line_number":282,"context_line":"    device_spec \u003d [{\"vendor_id\": \"10de\", \"product_id\": \"1234\"},"},{"line_number":283,"context_line":"                   {\"address\": \"0000:06:00.0\", \"exclude\": true}]"},{"line_number":284,"context_line":"    alias \u003d [{\"name\": \"gpu-vf\", \"vendor_id\": \"10de\", \"product_id\": \"1234\", \"device_type\": \"type-VF\"}]"},{"line_number":285,"context_line":""},{"line_number":286,"context_line":"The exclusion omits vendor/product filters so it excludes only the named PF,"}],"source_content_type":"text/x-rst","patch_set":6,"id":"4403e10c_2334bafe","line":283,"in_reply_to":"cea5b994_17aab842","updated":"2026-10-08 17:44:57.000000000","message":"yes that is exactly how that is inteded to work.\nyour understanding is correct.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":291,"context_line":"neither a PCI device record nor Placement inventory for it. For previously"},{"line_number":292,"context_line":"tracked devices, exclusion removes tracking only when the affected device"},{"line_number":293,"context_line":"and inventory are unallocated and unreserved. The group lifecycle rules"},{"line_number":294,"context_line":"below apply if the device belongs to a group."},{"line_number":295,"context_line":""},{"line_number":296,"context_line":"The ``exclude`` tag is distinct from ``managed\u003dfalse``, which controls"},{"line_number":297,"context_line":"libvirt\u0027s management of a device that Nova can still allocate, and from"}],"source_content_type":"text/x-rst","patch_set":6,"id":"2337442e_982c98e4","line":294,"updated":"2026-10-07 15:53:48.000000000","message":"I\u0027m OK to handle it the same way as we handle disappearing allocated devices. But note that such code path is problematic already. \n\nAs this case induced by a config change, like a new exclude entry, it would not be bad to force nova-compute to fail at startup with that config as the user can always remove the conflicting exclude. \n\nI guess you want this behavior to be able to exclude the device as soon as it gets deallocated and avoid a new VM to taking it right away. If so, I would add that as a reasoning why we don\u0027t fail the startup with this config.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":291,"context_line":"neither a PCI device record nor Placement inventory for it. For previously"},{"line_number":292,"context_line":"tracked devices, exclusion removes tracking only when the affected device"},{"line_number":293,"context_line":"and inventory are unallocated and unreserved. The group lifecycle rules"},{"line_number":294,"context_line":"below apply if the device belongs to a group."},{"line_number":295,"context_line":""},{"line_number":296,"context_line":"The ``exclude`` tag is distinct from ``managed\u003dfalse``, which controls"},{"line_number":297,"context_line":"libvirt\u0027s management of a device that Nova can still allocate, and from"}],"source_content_type":"text/x-rst","patch_set":6,"id":"80d59f2b_f676395c","line":294,"in_reply_to":"07792a40_25a42986","updated":"2026-10-08 17:44:57.000000000","message":"i did have this as a hard fail initally.,\n\nOTU is not appropriate here as the edge-case i am guarding against is not just intentional removal but also accidental config updates.\nOTU could help in the narrow case that a admin gets allerts form there mondirtoing system indicating a falut in a device and updates it while its free. but as far as im aware you cannot make a device OTU when its acllocated and i dotn think we shoudl alow that in the future. you could manuall set resteved\u003dtotal in the invetory too but that is also less clean.\n\nwe have exsiting logic for normal pci devices to pervent deleitng the device recored if they are assgiend to an instnace even if they are no longer allowed by the configuration. when we added that code to prevent db currption it was orginally propsoed as a hard error and that was rejcted on the ground that if a device died and you are trying to bring up a compute agent to be abel to cold/live migrate workload of the host it shoudl be possibel to do so.\n\ni orginally wrote this as a hard error blocking startup but i chagned it a logmessage and the same behvior as normla pci devcies and docuemtned why in the alternitives seciont\n\nhttps://review.opendev.org/c/openstack/nova-specs/+/975635/6/specs/2027.1/approved/pci-passthrough-groups.rst#550\n\ni was told severla times that making the removal of device form the devspec shoudl nto block start up so i want to keep this concistent with that.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":4393,"name":"Dan Smith","email":"dms@danplanet.com","username":"danms"},"change_message_id":"930698c1047eeeea72c3747d75b78a0365fbf11f","unresolved":true,"context_lines":[{"line_number":291,"context_line":"neither a PCI device record nor Placement inventory for it. For previously"},{"line_number":292,"context_line":"tracked devices, exclusion removes tracking only when the affected device"},{"line_number":293,"context_line":"and inventory are unallocated and unreserved. The group lifecycle rules"},{"line_number":294,"context_line":"below apply if the device belongs to a group."},{"line_number":295,"context_line":""},{"line_number":296,"context_line":"The ``exclude`` tag is distinct from ``managed\u003dfalse``, which controls"},{"line_number":297,"context_line":"libvirt\u0027s management of a device that Nova can still allocate, and from"}],"source_content_type":"text/x-rst","patch_set":6,"id":"07792a40_25a42986","line":294,"in_reply_to":"2337442e_982c98e4","updated":"2026-10-07 18:05:47.000000000","message":"You could also mark that device as one-time-use to prevent it from getting re-allocated I think and we\u0027d reserve it on restart. That to me would be a lot better than removing it from tracking and waiting for the last refcount to have it disappear. The OTU flag has the exact semantics of \"don\u0027t allow this to be reallocated.\" In other words, it seems better to have compute refuse to start if you\u0027ve excluded an allocated device and let you specifically opt into preventing reallocation since we have a way to express that.\n\nImagine the opposite case where the poor human trying to configure nova with this horrific pci whitelist interface we\u0027ve created accidentally excludes some devices that are already allocated. It would be nice for us to say \"if you liked your config before, you just broke it...\"","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"fada3c0e23d1b78f390a6fba715fa9b2971440bb","unresolved":true,"context_lines":[{"line_number":291,"context_line":"neither a PCI device record nor Placement inventory for it. For previously"},{"line_number":292,"context_line":"tracked devices, exclusion removes tracking only when the affected device"},{"line_number":293,"context_line":"and inventory are unallocated and unreserved. The group lifecycle rules"},{"line_number":294,"context_line":"below apply if the device belongs to a group."},{"line_number":295,"context_line":""},{"line_number":296,"context_line":"The ``exclude`` tag is distinct from ``managed\u003dfalse``, which controls"},{"line_number":297,"context_line":"libvirt\u0027s management of a device that Nova can still allocate, and from"}],"source_content_type":"text/x-rst","patch_set":6,"id":"c295b1cb_75a50f85","line":294,"in_reply_to":"80d59f2b_f676395c","updated":"2026-10-15 14:11:47.000000000","message":"\u003e but as far as im aware you cannot make a device OTU when its acllocated \n\nplacement allows to set reserved\u003dtotal even if the the total is all allocated. I don\u0027t know if nova reconfiguration setting otu in the device spec on an allocated device work or not, but probably works during the PCI in Placement healing logic.\n\n\u003e we have exsiting logic for normal pci devices to pervent deleitng the device recored if they are assgiend to an instnace even if they are no longer allowed by the configuration. \n\nThat is needed as a device can disappear (i.e. dies). and that is not a config error the admin can fix and therefore we should start to let the other VMs managed (i.e. to drain the host before the maintenance to fix the died PCI device).\n\nBut here the root cause is not a died device but a admin applied wrong configuration. And that is something the admin can fix.\n\n\u003e i was told severla times that making the removal of device form the devspec shoudl nto block start up so i want to keep this concistent with that.\n\nI think we can (or even should) block the startup on clear configuration error that the admin can fix. We should not block the statup on things that the admin cannot immediately fix like a device disappeared due to the device died.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":291,"context_line":"neither a PCI device record nor Placement inventory for it. For previously"},{"line_number":292,"context_line":"tracked devices, exclusion removes tracking only when the affected device"},{"line_number":293,"context_line":"and inventory are unallocated and unreserved. The group lifecycle rules"},{"line_number":294,"context_line":"below apply if the device belongs to a group."},{"line_number":295,"context_line":""},{"line_number":296,"context_line":"The ``exclude`` tag is distinct from ``managed\u003dfalse``, which controls"},{"line_number":297,"context_line":"libvirt\u0027s management of a device that Nova can still allocate, and from"}],"source_content_type":"text/x-rst","patch_set":6,"id":"df3b453a_06e7a6b7","line":294,"in_reply_to":"c295b1cb_75a50f85","updated":"2026-10-28 19:44:49.000000000","message":"i think this is adressed now but feel free to raise it again if not","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":329,"context_line":""},{"line_number":330,"context_line":"An exclusion entry in ``[pci]device_spec`` must include ``address`` and a"},{"line_number":331,"context_line":"valid boolean ``exclude`` value."},{"line_number":332,"context_line":""},{"line_number":333,"context_line":"Placement Integration"},{"line_number":334,"context_line":"---------------------"},{"line_number":335,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"444d0435_58244291","line":332,"updated":"2026-10-07 15:53:48.000000000","message":"we might want to add validation rules for the exclude entries like only address and exclude tag is allowe for entries with exclude\u003dtrue.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":329,"context_line":""},{"line_number":330,"context_line":"An exclusion entry in ``[pci]device_spec`` must include ``address`` and a"},{"line_number":331,"context_line":"valid boolean ``exclude`` value."},{"line_number":332,"context_line":""},{"line_number":333,"context_line":"Placement Integration"},{"line_number":334,"context_line":"---------------------"},{"line_number":335,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"8cdfb44c_2d14da0c","line":332,"in_reply_to":"444d0435_58244291","updated":"2026-10-08 17:44:57.000000000","message":"sure i can do that.\n\ni was going to do that in the code but i didn\u0027t note it in the spec expclity.\njust implictly via the examples","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":329,"context_line":""},{"line_number":330,"context_line":"An exclusion entry in ``[pci]device_spec`` must include ``address`` and a"},{"line_number":331,"context_line":"valid boolean ``exclude`` value."},{"line_number":332,"context_line":""},{"line_number":333,"context_line":"Placement Integration"},{"line_number":334,"context_line":"---------------------"},{"line_number":335,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"13564442_584c7ff3","line":332,"in_reply_to":"8cdfb44c_2d14da0c","updated":"2026-10-28 19:44:49.000000000","message":"Done","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":456,"context_line":".. note::"},{"line_number":457,"context_line":""},{"line_number":458,"context_line":"   oslo.config accepts indented continuation lines for INI values. The JSON"},{"line_number":459,"context_line":"   lists above do not need backslash escapes or to be collapsed onto one line."},{"line_number":460,"context_line":""},{"line_number":461,"context_line":"But exposing the two cards, exposed as four PCI devices,"},{"line_number":462,"context_line":"as a single unit of 4 PCI devices, would look like this:"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ca807de0_f00525da","line":459,"updated":"2026-10-07 15:53:48.000000000","message":"does crudini and ansible accepts it as well?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"fada3c0e23d1b78f390a6fba715fa9b2971440bb","unresolved":false,"context_lines":[{"line_number":456,"context_line":".. note::"},{"line_number":457,"context_line":""},{"line_number":458,"context_line":"   oslo.config accepts indented continuation lines for INI values. The JSON"},{"line_number":459,"context_line":"   lists above do not need backslash escapes or to be collapsed onto one line."},{"line_number":460,"context_line":""},{"line_number":461,"context_line":"But exposing the two cards, exposed as four PCI devices,"},{"line_number":462,"context_line":"as a single unit of 4 PCI devices, would look like this:"}],"source_content_type":"text/x-rst","patch_set":6,"id":"74cef1bd_8d239227","line":459,"in_reply_to":"6f41611c_53714132","updated":"2026-10-15 14:11:47.000000000","message":"I\u0027m asking it as the spec suggests that we do the jsonstring support to help the installers using crudeini to handle the config. So I assume that we don\u0027t have to do something here that is going against crudeini. But from you I understand now that continuation line might not work but one long line still works.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":456,"context_line":".. note::"},{"line_number":457,"context_line":""},{"line_number":458,"context_line":"   oslo.config accepts indented continuation lines for INI values. The JSON"},{"line_number":459,"context_line":"   lists above do not need backslash escapes or to be collapsed onto one line."},{"line_number":460,"context_line":""},{"line_number":461,"context_line":"But exposing the two cards, exposed as four PCI devices,"},{"line_number":462,"context_line":"as a single unit of 4 PCI devices, would look like this:"}],"source_content_type":"text/x-rst","patch_set":6,"id":"6f41611c_53714132","line":459,"in_reply_to":"ca807de0_f00525da","updated":"2026-10-08 17:44:57.000000000","message":"i think crudini will flaten it but the real issue with curd ini for exampel is \n\nyou cant add or read \n```\n group_spec \u003d {\"addresses\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], \"key\": \"graphcore_1\", \"type\": \"c200_x1\"}\n group_spec \u003d {\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}\n \n```\n\nproperlysinc ein actual ini format that is underiend if the first or last value is retruned.\n\nthat is technial malformed.\n\nwe do not use ini format as you knwo we use oslo config format which is a supper set of ini and pythons conf format\n\nand none of the comon clis that i am aware of have natvie supprot for our exstions.\n\nfor \n```\n [pci]\n    device_spec \u003d {\"vendor_id\": \"115D\", \"product_id\": \"0003\"}\n    group_spec \u003d {\"addresses\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], \"key\": \"graphcore_1\", \"type\": \"c200_x1\"}\n    group_spec \u003d {\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}\n    # group_spec \u003d [{\"addresses\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], \"key\": \"graphcore_1\", \"type\": \"c200_x1\"},\n    #               {\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}]\n    alias \u003d {\"name\": \"c200_x1\", \"group_type\": \"c200_x1\"}\n```\n\nwe get \n```\n11:31:12]\u003e crudini --get test.ini pci group_spec\n{\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}\n```\n\nif i comment out the repated options i get\n```\n[11:34:14]\u003e crudini --get test.ini pci group_spec\n[{\"addresses\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], \"key\": \"graphcore_1\", \"type\": \"c200_x1\"},\n{\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}]\n```\n\nyou can also set it like this\n\n```\ncrudini --set test.ini pci group_spec \"$(cat \u003c\u003c\u0027EOL\u0027\n[{\"addresses\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], \"key\": \"graphcore_1\", \"type\": \"c200_x1\"},\n{\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}]\nEOL\n)\"\n```\nor\n```\ncrudini --merge test.ini \u003c\u003c\u0027EOL\u0027\n[pci]\ngroup_spec \u003d [{\"addresses\": [\"0000:4e:00.0\", \"0000:4f:00.0\"], \"key\": \"graphcore_1\", \"type\": \"c200_x1\"},\n    {\"addresses\": [\"0000:89:00.0\", \"0000:8a:00.0\"], \"key\": \"graphcore_2\", \"type\": \"c200_x1\"}]\nEOL\n```\nset expact a singel string value so creating a multi line sting is a bit annoying but merge takes a stream or file \n\ni honestly normallyjsut use nano to edit it by hand however but yes you can use crudini for this","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"f2f25544c9a1aecd239045029556428ad4b7b774","unresolved":true,"context_lines":[{"line_number":745,"context_line":"* First-party integration coverage will use pci-sim through the Cyborg"},{"line_number":746,"context_line":"  DevStack plugin in ``nova-alt-configurations``. pci-sim does not yet provide"},{"line_number":747,"context_line":"  all the support required for grouping tests, so the implementation includes"},{"line_number":748,"context_line":"  extending it as needed."},{"line_number":749,"context_line":"* The Cyborg DevStack plugin will gain native support for creating simulated"},{"line_number":750,"context_line":"  device groups and configuring Nova\u0027s device specs, group specs, aliases,"},{"line_number":751,"context_line":"  and flavors."}],"source_content_type":"text/x-rst","patch_set":6,"id":"c47c8fd6_aef33c25","line":748,"updated":"2026-10-07 15:53:48.000000000","message":"could you put a link to the pci-sim repo / code for reference?","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"134170ba7307a9c3f78ac93fe4c69aced74c8958","unresolved":false,"context_lines":[{"line_number":745,"context_line":"* First-party integration coverage will use pci-sim through the Cyborg"},{"line_number":746,"context_line":"  DevStack plugin in ``nova-alt-configurations``. pci-sim does not yet provide"},{"line_number":747,"context_line":"  all the support required for grouping tests, so the implementation includes"},{"line_number":748,"context_line":"  extending it as needed."},{"line_number":749,"context_line":"* The Cyborg DevStack plugin will gain native support for creating simulated"},{"line_number":750,"context_line":"  device groups and configuring Nova\u0027s device specs, group specs, aliases,"},{"line_number":751,"context_line":"  and flavors."}],"source_content_type":"text/x-rst","patch_set":6,"id":"a3698b3c_32724098","line":748,"in_reply_to":"8c437915_77ff00b8","updated":"2026-10-28 19:44:49.000000000","message":"Done","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"40c1de21eb8f2248a5e367d3a141253d65d76048","unresolved":true,"context_lines":[{"line_number":745,"context_line":"* First-party integration coverage will use pci-sim through the Cyborg"},{"line_number":746,"context_line":"  DevStack plugin in ``nova-alt-configurations``. pci-sim does not yet provide"},{"line_number":747,"context_line":"  all the support required for grouping tests, so the implementation includes"},{"line_number":748,"context_line":"  extending it as needed."},{"line_number":749,"context_line":"* The Cyborg DevStack plugin will gain native support for creating simulated"},{"line_number":750,"context_line":"  device groups and configuring Nova\u0027s device specs, group specs, aliases,"},{"line_number":751,"context_line":"  and flavors."}],"source_content_type":"text/x-rst","patch_set":6,"id":"8c437915_77ff00b8","line":748,"in_reply_to":"c47c8fd6_aef33c25","updated":"2026-10-08 17:44:57.000000000","message":"its part of the cybrog repo \nhttps://github.com/openstack/cyborg/tree/master/pci-sim\n\nas an fyi this slightly overstate the gap.\n\nthe pci-sim can alreayd fully be used to validate basic pci passthouhg and grouping.\n\nwhat missing to make this easy is cybrog devstack plugin supprot to make grouping simple.\n\nwe coudl actully hardode the relevent nova config in the job\n\nthe cybrog devstack plugin already has supprot for configuing nova to use the pci sim includign creating flavors\n\nhttps://github.com/openstack/cyborg/blob/master/devstack/lib/pci_sim#L243-L295\nhttps://github.com/openstack/cyborg/blob/master/devstack/lib/pci_sim#L382-L388\n\nwhich is contole by a simpel boolean flag to enabel PCI_SIM_CONFIGURE_NOVA_PCI\n\nhttps://github.com/openstack/cyborg/blob/master/devstack/settings#L66-L68\n\ni want to basiclly add PCI_SIM_CONFIGURE_NOVA_PCI_GROUPS or simialr to make it easy to replciate in a lcoal vm but we dont actuly need that to do basic testing.","commit_id":"1d634f78a2abab22e7774fe80d8f6b65ee44c1c5"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":51,"context_line":"product IDs. Some GPUs use the same IDs for a PF and its VFs, but PCI in"},{"line_number":52,"context_line":"Placement cannot expose both. Nova\u0027s existing inclusion-only configuration"},{"line_number":53,"context_line":"requires address lists or regular expressions to select all matching devices"},{"line_number":54,"context_line":"except those needed by the host."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"Operators also need to generate and update PCI configuration through tools"},{"line_number":57,"context_line":"such as Ansible and crudini. Nova uses oslo.config, which extends INI with"}],"source_content_type":"text/x-rst","patch_set":7,"id":"7ba7710d_e21edb6e","line":54,"updated":"2026-11-05 15:24:39.000000000","message":"thanks for adding this.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":true,"context_lines":[{"line_number":339,"context_line":"configuration."},{"line_number":340,"context_line":"Duplicate addresses in ``exclude_list`` are invalid. An exclusion may name an"},{"line_number":341,"context_line":"address that no ``device_spec`` entry allows."},{"line_number":342,"context_line":""},{"line_number":343,"context_line":"Placement Integration"},{"line_number":344,"context_line":"---------------------"},{"line_number":345,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"7ec3a22b_7397b48e","line":342,"updated":"2026-11-05 15:24:39.000000000","message":"nit: It might make sense to clarify that well formatted address in the exlude_list that points to a not (yet) existing device on the host is an accepted configuration. \n\nI\u0027m fine to add a warning log if nova detects an excluded but non-existing device.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"03872e83714d9988c88d8512f5934ba53a347f0d","unresolved":false,"context_lines":[{"line_number":339,"context_line":"configuration."},{"line_number":340,"context_line":"Duplicate addresses in ``exclude_list`` are invalid. An exclusion may name an"},{"line_number":341,"context_line":"address that no ``device_spec`` entry allows."},{"line_number":342,"context_line":""},{"line_number":343,"context_line":"Placement Integration"},{"line_number":344,"context_line":"---------------------"},{"line_number":345,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"f8c7340d_770975f8","line":342,"in_reply_to":"1728953b_ae6beb3f","updated":"2026-11-06 12:20:12.000000000","message":"yeah a single startup log would help troubleshooting. This can be further handled in the impl review.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"b330845739c104a82c22f52c6a7c705998643b31","unresolved":true,"context_lines":[{"line_number":339,"context_line":"configuration."},{"line_number":340,"context_line":"Duplicate addresses in ``exclude_list`` are invalid. An exclusion may name an"},{"line_number":341,"context_line":"address that no ``device_spec`` entry allows."},{"line_number":342,"context_line":""},{"line_number":343,"context_line":"Placement Integration"},{"line_number":344,"context_line":"---------------------"},{"line_number":345,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"1728953b_ae6beb3f","line":342,"in_reply_to":"7ec3a22b_7397b48e","updated":"2026-11-05 16:46:19.000000000","message":"so yes i can add that. i a single warnign on start up might be fine i was orginally think of not makign ita waring at all or info levle\nbut if this help with debugablity ectra i have no issue with addign that.\n\nmy logic basiclly being you may want to prementivly add some spcific device to the list even if the devspec does not allow them to protect your self form future typos ro misconfituions.\n\nbut im happy to add somethign to the effect of \"device \u003caddress\u003e is present in the exclude_list but not allow by the devvice_spec or found on the host, please review your configuriton matches your intent\"\n\n\nwe can clarify the exact wordign in the reivew, i woudl express avoid log.error in this specific case however but warning or info seam fine","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":true,"context_lines":[{"line_number":397,"context_line":"Each requested group needs a separate Placement request group so it can be"},{"line_number":398,"context_line":"fulfilled by a different nested resource provider with one inventory unit."},{"line_number":399,"context_line":"Separate PCI requests will also give each group a distinct request ID for"},{"line_number":400,"context_line":"migration correlation and member mapping."},{"line_number":401,"context_line":""},{"line_number":402,"context_line":"This expansion applies only to group aliases. Ordinary device aliases retain"},{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"}],"source_content_type":"text/x-rst","patch_set":7,"id":"da3f0580_d4a67a08","line":400,"updated":"2026-11-05 15:24:39.000000000","message":"We already have a InstancePciRequest(count\u003d2) -\u003e 2x RequestGroup expansion here:\nhttps://github.com/openstack/nova/blob/6182d28257db4f81f30460676702d96acb60a598/nova/objects/request_spec.py#L584\n\nAlso we already generating unique requester_id with indexing from the request_id here https://github.com/openstack/nova/blob/6182d28257db4f81f30460676702d96acb60a598/nova/objects/request_spec.py#L589\n\nWould this be enough?\n\nIf not, and you need to expand the InstancePCIRequest, then I think the above linked logic can be greatly simplified we we could assume that all alias request is expanded to multiple InstancePCIRequest(count\u003d1).","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"a7583637ccf58007b86b5bbda401f54ca6bf950d","unresolved":false,"context_lines":[{"line_number":397,"context_line":"Each requested group needs a separate Placement request group so it can be"},{"line_number":398,"context_line":"fulfilled by a different nested resource provider with one inventory unit."},{"line_number":399,"context_line":"Separate PCI requests will also give each group a distinct request ID for"},{"line_number":400,"context_line":"migration correlation and member mapping."},{"line_number":401,"context_line":""},{"line_number":402,"context_line":"This expansion applies only to group aliases. Ordinary device aliases retain"},{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"}],"source_content_type":"text/x-rst","patch_set":7,"id":"f66b050e_1ec1109b","line":400,"in_reply_to":"95726fbd_42a788ca","updated":"2026-11-17 13:38:19.000000000","message":"Acknowledged","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"b330845739c104a82c22f52c6a7c705998643b31","unresolved":true,"context_lines":[{"line_number":397,"context_line":"Each requested group needs a separate Placement request group so it can be"},{"line_number":398,"context_line":"fulfilled by a different nested resource provider with one inventory unit."},{"line_number":399,"context_line":"Separate PCI requests will also give each group a distinct request ID for"},{"line_number":400,"context_line":"migration correlation and member mapping."},{"line_number":401,"context_line":""},{"line_number":402,"context_line":"This expansion applies only to group aliases. Ordinary device aliases retain"},{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"}],"source_content_type":"text/x-rst","patch_set":7,"id":"95726fbd_42a788ca","line":400,"in_reply_to":"da3f0580_d4a67a08","updated":"2026-11-05 16:46:19.000000000","message":"this is here for live mgiration\n\nif a vm has 2 of a group and said grups have multiple devices i need to map both based on group instnace and device index\n\nwhich is why i was not relying on the exisitng spliting into placment groups alone.\n\ni can try an reasses if i can somehow use the placmeent group index but it didnt seam easy to me to do that\n\ni shyed away from doign this expantion alwasy purly to reduce the impact on exising codepath but i dont have a technial reason not to just alwasy do this expansion so if that is prefered i can certenly do that.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":true,"context_lines":[{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"},{"line_number":404,"context_line":"compatibility."},{"line_number":405,"context_line":""},{"line_number":406,"context_line":"Core grouping will preserve existing PCI lifecycle support, including cold"},{"line_number":407,"context_line":"migration, resize, evacuation, and unshelve, subject to existing restrictions."},{"line_number":408,"context_line":"These operations must preserve whole-group allocation semantics."},{"line_number":409,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"91967f38_0fb45f97","line":406,"range":{"start_line":406,"start_character":0,"end_line":406,"end_character":58},"updated":"2026-11-05 15:24:39.000000000","message":"what is core grouping here?","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"03872e83714d9988c88d8512f5934ba53a347f0d","unresolved":true,"context_lines":[{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"},{"line_number":404,"context_line":"compatibility."},{"line_number":405,"context_line":""},{"line_number":406,"context_line":"Core grouping will preserve existing PCI lifecycle support, including cold"},{"line_number":407,"context_line":"migration, resize, evacuation, and unshelve, subject to existing restrictions."},{"line_number":408,"context_line":"These operations must preserve whole-group allocation semantics."},{"line_number":409,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"e66c361e_cc800625","line":406,"range":{"start_line":406,"start_character":0,"end_line":406,"end_character":58},"in_reply_to":"0b1c1ac6_c5d4fbe0","updated":"2026-11-06 12:20:12.000000000","message":"much better ^^","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"b330845739c104a82c22f52c6a7c705998643b31","unresolved":true,"context_lines":[{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"},{"line_number":404,"context_line":"compatibility."},{"line_number":405,"context_line":""},{"line_number":406,"context_line":"Core grouping will preserve existing PCI lifecycle support, including cold"},{"line_number":407,"context_line":"migration, resize, evacuation, and unshelve, subject to existing restrictions."},{"line_number":408,"context_line":"These operations must preserve whole-group allocation semantics."},{"line_number":409,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"0b1c1ac6_c5d4fbe0","line":406,"range":{"start_line":406,"start_character":0,"end_line":406,"end_character":58},"in_reply_to":"91967f38_0fb45f97","updated":"2026-11-05 16:46:19.000000000","message":"this is bad phrsing because after a few dasy away it not imitaly obvious to me eeither but i belive what i wanted to say with \"Core grouping\" was that the core of this featre - the streach goal of also suprpoting live mgiration need to maintian the lifecycle support for ... actions\n\ni think is actully much clearer\n```suggestion\nExisting PCI lifecycle support, including cold\n```","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"a7583637ccf58007b86b5bbda401f54ca6bf950d","unresolved":false,"context_lines":[{"line_number":403,"context_line":"their existing request construction and count handling for upgrade"},{"line_number":404,"context_line":"compatibility."},{"line_number":405,"context_line":""},{"line_number":406,"context_line":"Core grouping will preserve existing PCI lifecycle support, including cold"},{"line_number":407,"context_line":"migration, resize, evacuation, and unshelve, subject to existing restrictions."},{"line_number":408,"context_line":"These operations must preserve whole-group allocation semantics."},{"line_number":409,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"22410704_aca31f1a","line":406,"range":{"start_line":406,"start_character":0,"end_line":406,"end_character":58},"in_reply_to":"e66c361e_cc800625","updated":"2026-11-17 13:38:19.000000000","message":"Done","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":422,"context_line":"Group live migration is a stretch goal targeted for the same release as core"},{"line_number":423,"context_line":"PCI grouping. It may be deferred without delaying the rest of this proposal."},{"line_number":424,"context_line":"Until this support is implemented, Nova must reject live migration of instances"},{"line_number":425,"context_line":"with PCI groups, even when every member is marked ``live_migratable\u003d\u0027true\u0027``."},{"line_number":426,"context_line":""},{"line_number":427,"context_line":"Ordered membership, persisted member indices, and per-group PCI requests"},{"line_number":428,"context_line":"remain part of core grouping. The following requirements apply when group"}],"source_content_type":"text/x-rst","patch_set":7,"id":"555b650f_fa17b792","line":425,"updated":"2026-11-05 15:24:39.000000000","message":"+1 good scoping","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":true,"context_lines":[{"line_number":433,"context_line":"the source and destination groups using this ID, then pair their individual"},{"line_number":434,"context_line":"devices by ``group_member_index``. Each source group must map wholly to one"},{"line_number":435,"context_line":"destination group. Selection of the corresponding destination groups is an"},{"line_number":436,"context_line":"implementation detail."},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"For example, if the source group\u0027s addresses are ``[A, B]`` and the selected"},{"line_number":439,"context_line":"destination group\u0027s addresses are ``[C, D]``, Nova will map A to C and B to D."}],"source_content_type":"text/x-rst","patch_set":7,"id":"f7c9df2f_657dcaa0","line":436,"updated":"2026-11-05 15:24:39.000000000","message":"Ohh Is the reason we need a unique InstancePCIRequest for each group? It still feels a bit fuzzy to me...\n\nSo we have my_alias:2 group_type:t1 in the flavor, lets assume we have t1 defined as cross connected GPUX and NICY (so that the order matters). So this requests asks for two sets of two pairs. During live migration we need to map devices.\nSource allocated pairs:\n* g1: GPUX1, NICY1\n* g2: GPUX2, NICY2\n\nDest selected pairs:\n* GPUX8, NICY8\n* GPUX11, NICY11\n\nNow because we stated that any instance of t1 type is assumed to be functionally equivalent. Both of the following mapping is valid (and not other device mapping is valid):\n\n* GPUX1 -\u003e GPUX8, NICY1 -\u003e NICY8, GPUX2 -\u003e GPUX11, NICY2 -\u003e NICY11\n* GPUX1 -\u003e GPUX11, NICY1 -\u003e NICY11, GPUX2 -\u003e GPUX8, NICY2 -\u003e NICY8\n\nThis shows me (with my limited understanding of hte mapping) that the order of the groups of the same type does not matter. So I\u0027m not sure we need to expand an alias with count\u003d2 to two InstancePCIRequest of count\u003d1. (The RequrestGroup expansion is needed, and the in group device ordering is needed)","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"59753765123961d5e5db7de66cfd87a689db60ff","unresolved":true,"context_lines":[{"line_number":433,"context_line":"the source and destination groups using this ID, then pair their individual"},{"line_number":434,"context_line":"devices by ``group_member_index``. Each source group must map wholly to one"},{"line_number":435,"context_line":"destination group. Selection of the corresponding destination groups is an"},{"line_number":436,"context_line":"implementation detail."},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"For example, if the source group\u0027s addresses are ``[A, B]`` and the selected"},{"line_number":439,"context_line":"destination group\u0027s addresses are ``[C, D]``, Nova will map A to C and B to D."}],"source_content_type":"text/x-rst","patch_set":7,"id":"277895f0_2f0a9d6a","line":436,"in_reply_to":"54390c0d_c6d3085b","updated":"2026-11-13 13:33:35.000000000","message":"the ordering of groups matter for NUMA affinity, PCIe switches (PXB topology) and root PCI devices (PHB topology), we will need explicit topology inputs. Until that, we can keep ordering of groups irrelevant","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"03872e83714d9988c88d8512f5934ba53a347f0d","unresolved":true,"context_lines":[{"line_number":433,"context_line":"the source and destination groups using this ID, then pair their individual"},{"line_number":434,"context_line":"devices by ``group_member_index``. Each source group must map wholly to one"},{"line_number":435,"context_line":"destination group. Selection of the corresponding destination groups is an"},{"line_number":436,"context_line":"implementation detail."},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"For example, if the source group\u0027s addresses are ``[A, B]`` and the selected"},{"line_number":439,"context_line":"destination group\u0027s addresses are ``[C, D]``, Nova will map A to C and B to D."}],"source_content_type":"text/x-rst","patch_set":7,"id":"54390c0d_c6d3085b","line":436,"in_reply_to":"b54b5978_735b0a9f","updated":"2026-11-06 12:20:12.000000000","message":"I vote for the simpler design until we find a specific example when the order of groups matter in device mapping during live migration.\n\nif the flavor has: (count:2 group_type\u003dt1), (count:2, group_type\u003dt2) that means 4 groups, 2x t1 and 2x t2. The order of the groups within t1 does not matter as both group having the t1 type means they are equivalent. The order / mapping between the t1 and the t2 groups can be resolved by group_type. \n\nif the flavor has (count\u003d2, group_type\u003dt1 numa\u003drequired) (count:2, group_type\u003dt1, numa\u003dpreferred) then we have 4 groups from the same group type but different numa requests. I guess here it would be better to resolve the mapping by the numa_request rather than by a sequence number.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"b330845739c104a82c22f52c6a7c705998643b31","unresolved":true,"context_lines":[{"line_number":433,"context_line":"the source and destination groups using this ID, then pair their individual"},{"line_number":434,"context_line":"devices by ``group_member_index``. Each source group must map wholly to one"},{"line_number":435,"context_line":"destination group. Selection of the corresponding destination groups is an"},{"line_number":436,"context_line":"implementation detail."},{"line_number":437,"context_line":""},{"line_number":438,"context_line":"For example, if the source group\u0027s addresses are ``[A, B]`` and the selected"},{"line_number":439,"context_line":"destination group\u0027s addresses are ``[C, D]``, Nova will map A to C and B to D."}],"source_content_type":"text/x-rst","patch_set":7,"id":"b54b5978_735b0a9f","line":436,"in_reply_to":"f7c9df2f_657dcaa0","updated":"2026-11-05 16:46:19.000000000","message":"yes it is.\n\nin your case of a pci alise that request 1 allcaotion of 2 diffent groups i agree the order does not matter because we can corrate based on teh group type\n\nthe specific case i was thinking of is we request 2 allocations fo the same group alias i.e. 2 groups of GPUx2\n\nyou may also be right that as logn as i coralate based on group type the order may not mater but i was not sure if that woudl alwasy be true for thing like numa affinty ectra down the line.\n\nso this might be slightly over engineered but that was the concern\n\nlet me know if you think we should simplify more when you have time to process this","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":445,"context_line":"corresponding indices are compatible, especially in groups containing mixed"},{"line_number":446,"context_line":"devices. Incompatible ordering is an operator configuration error; Nova is not"},{"line_number":447,"context_line":"required to validate device-role equivalence across hosts. Additional"},{"line_number":448,"context_line":"vendor/product compatibility checks can remain an implementation detail."},{"line_number":449,"context_line":""},{"line_number":450,"context_line":"NUMA Affinity Handling"},{"line_number":451,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"481ffabf_2f7f3739","line":448,"updated":"2026-11-05 15:24:39.000000000","message":"+1","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":true,"context_lines":[{"line_number":514,"context_line":"--------------------------"},{"line_number":515,"context_line":""},{"line_number":516,"context_line":"Nova will retain device records, group membership, member indices, and"},{"line_number":517,"context_line":"instance ownership while any member is claimed or allocated. Releasing one"},{"line_number":518,"context_line":"member does not release the rest of a group still held by an instance. This"},{"line_number":519,"context_line":"state will persist across compute restarts until the instance releases its"},{"line_number":520,"context_line":"final member, for example through deletion or migration. Placement allocations"},{"line_number":521,"context_line":"and inventory reservations do not determine how long Nova will retain these"}],"source_content_type":"text/x-rst","patch_set":7,"id":"a9ae6606_4e1b9fab","line":518,"range":{"start_line":517,"start_character":61,"end_line":518,"end_character":70},"updated":"2026-11-05 15:24:39.000000000","message":"how that is even possible?","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"b330845739c104a82c22f52c6a7c705998643b31","unresolved":true,"context_lines":[{"line_number":514,"context_line":"--------------------------"},{"line_number":515,"context_line":""},{"line_number":516,"context_line":"Nova will retain device records, group membership, member indices, and"},{"line_number":517,"context_line":"instance ownership while any member is claimed or allocated. Releasing one"},{"line_number":518,"context_line":"member does not release the rest of a group still held by an instance. This"},{"line_number":519,"context_line":"state will persist across compute restarts until the instance releases its"},{"line_number":520,"context_line":"final member, for example through deletion or migration. Placement allocations"},{"line_number":521,"context_line":"and inventory reservations do not determine how long Nova will retain these"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dddae408_c4e7c8f6","line":518,"range":{"start_line":517,"start_character":61,"end_line":518,"end_character":70},"in_reply_to":"a9ae6606_4e1b9fab","updated":"2026-11-05 16:46:19.000000000","message":"this woudl happen if an only if we did not update all pci device recored in a single transaction for all of them.\n\nthis probably is to much implementation detail but that was the concer here.\ni believe this should not be an issue in the actual impelation but its more a pre/post condtion correctness thing.\n\ni can proably just remvoe this sentnce it avoid confution","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"03872e83714d9988c88d8512f5934ba53a347f0d","unresolved":false,"context_lines":[{"line_number":514,"context_line":"--------------------------"},{"line_number":515,"context_line":""},{"line_number":516,"context_line":"Nova will retain device records, group membership, member indices, and"},{"line_number":517,"context_line":"instance ownership while any member is claimed or allocated. Releasing one"},{"line_number":518,"context_line":"member does not release the rest of a group still held by an instance. This"},{"line_number":519,"context_line":"state will persist across compute restarts until the instance releases its"},{"line_number":520,"context_line":"final member, for example through deletion or migration. Placement allocations"},{"line_number":521,"context_line":"and inventory reservations do not determine how long Nova will retain these"}],"source_content_type":"text/x-rst","patch_set":7,"id":"40a39a35_15d19b4d","line":518,"range":{"start_line":517,"start_character":61,"end_line":518,"end_character":70},"in_reply_to":"dddae408_c4e7c8f6","updated":"2026-11-06 12:20:12.000000000","message":"cool that aligns with my feelings that this is more of an extra caution than real case.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":517,"context_line":"instance ownership while any member is claimed or allocated. Releasing one"},{"line_number":518,"context_line":"member does not release the rest of a group still held by an instance. This"},{"line_number":519,"context_line":"state will persist across compute restarts until the instance releases its"},{"line_number":520,"context_line":"final member, for example through deletion or migration. Placement allocations"},{"line_number":521,"context_line":"and inventory reservations do not determine how long Nova will retain these"},{"line_number":522,"context_line":"records."},{"line_number":523,"context_line":""},{"line_number":524,"context_line":"Adding, removing, or moving member devices is supported only when none of the"},{"line_number":525,"context_line":"affected devices or groups are claimed or allocated. This includes dissolving"}],"source_content_type":"text/x-rst","patch_set":7,"id":"6bcde75a_868de040","line":522,"range":{"start_line":520,"start_character":57,"end_line":522,"end_character":8},"updated":"2026-11-05 15:24:39.000000000","message":"yepp, nova heals PCI state into Placemenet today, so an out of band change in Placement will be reverted by nova. This healing does not need to be there forever but we need to keep it at least until pci_in_placement becomes default True for a while.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":524,"context_line":"Adding, removing, or moving member devices is supported only when none of the"},{"line_number":525,"context_line":"affected devices or groups are claimed or allocated. This includes dissolving"},{"line_number":526,"context_line":"a group into individual devices and converting individual devices into a"},{"line_number":527,"context_line":"group. Reordering addresses changes member indices and is also a membership"},{"line_number":528,"context_line":"change, even if the set of addresses is unchanged. Changing a group\u0027s ``key``"},{"line_number":529,"context_line":"or ``type`` is subject to the same restriction. Nova-compute will fail startup"},{"line_number":530,"context_line":"on unsafe changes without discarding existing records or ownership."},{"line_number":531,"context_line":""},{"line_number":532,"context_line":"To replace a device in a free group, remove the old address and add the new"},{"line_number":533,"context_line":"address at the intended index before restarting nova-compute. Nova will update"}],"source_content_type":"text/x-rst","patch_set":7,"id":"2b3c6979_9de4c9fd","line":530,"range":{"start_line":527,"start_character":7,"end_line":530,"end_character":67},"updated":"2026-11-05 15:24:39.000000000","message":"+1","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":false,"context_lines":[{"line_number":543,"context_line":"If a configured member of a new or free group is absent from discovery,"},{"line_number":544,"context_line":"nova-compute will continue startup with a warning identifying the group and"},{"line_number":545,"context_line":"missing address. Nova will offer neither an incomplete group nor its remaining"},{"line_number":546,"context_line":"configured members individually."},{"line_number":547,"context_line":""},{"line_number":548,"context_line":"If a discovered member no longer matches ``device_spec``, nova-compute will"},{"line_number":549,"context_line":"reject startup for a new or free group. For a claimed or allocated group,"}],"source_content_type":"text/x-rst","patch_set":7,"id":"e995cd2a_ad7faf12","line":546,"updated":"2026-11-05 15:24:39.000000000","message":"I\u0027m OK to be soft here if this keep the implementation simpler. Here I would be OK to fail nova-compute startup as these are not allocated devices so the config for the dead device could be removed to allow nova-compute to start without effecting the manageability of running VMs.","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"cad880268cdb732e01b1a9576d22bb73823fb5c9","unresolved":true,"context_lines":[{"line_number":561,"context_line":"has changed incompatibly, nova-compute will refuse startup. After final"},{"line_number":562,"context_line":"release, Nova will remove missing devices from tracking."},{"line_number":563,"context_line":""},{"line_number":564,"context_line":"A group/exclusion intersection is instead a configuration error under"},{"line_number":565,"context_line":"`Validation Rules`_. Releasing an instance does not resolve it. The operator"},{"line_number":566,"context_line":"must correct the exclusion list or group membership before restarting, subject"},{"line_number":567,"context_line":"to the membership-change restrictions above."}],"source_content_type":"text/x-rst","patch_set":7,"id":"88cec255_84baac4b","line":564,"updated":"2026-11-05 15:24:39.000000000","message":"I guess it is true for a free device as the next paragraph handles the same for a claimed device","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"03872e83714d9988c88d8512f5934ba53a347f0d","unresolved":true,"context_lines":[{"line_number":561,"context_line":"has changed incompatibly, nova-compute will refuse startup. After final"},{"line_number":562,"context_line":"release, Nova will remove missing devices from tracking."},{"line_number":563,"context_line":""},{"line_number":564,"context_line":"A group/exclusion intersection is instead a configuration error under"},{"line_number":565,"context_line":"`Validation Rules`_. Releasing an instance does not resolve it. The operator"},{"line_number":566,"context_line":"must correct the exclusion list or group membership before restarting, subject"},{"line_number":567,"context_line":"to the membership-change restrictions above."}],"source_content_type":"text/x-rst","patch_set":7,"id":"e5b175a0_a995ce0d","line":564,"in_reply_to":"612139f3_e0e8cf76","updated":"2026-11-06 12:20:12.000000000","message":"I like the last paragraph of this section in the spec as is. I think it is aligned with the rest of the spec about keeping allocated devices intact. \n\nThis paragraph in question currently only aligns with the last if it talks about free (as not claimed/allocated) devices. So I would change this paraghrap as\n\n\"A group/exclusion intersection on a free device is instead ...\"","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"b330845739c104a82c22f52c6a7c705998643b31","unresolved":true,"context_lines":[{"line_number":561,"context_line":"has changed incompatibly, nova-compute will refuse startup. After final"},{"line_number":562,"context_line":"release, Nova will remove missing devices from tracking."},{"line_number":563,"context_line":""},{"line_number":564,"context_line":"A group/exclusion intersection is instead a configuration error under"},{"line_number":565,"context_line":"`Validation Rules`_. Releasing an instance does not resolve it. The operator"},{"line_number":566,"context_line":"must correct the exclusion list or group membership before restarting, subject"},{"line_number":567,"context_line":"to the membership-change restrictions above."}],"source_content_type":"text/x-rst","patch_set":7,"id":"612139f3_e0e8cf76","line":564,"in_reply_to":"88cec255_84baac4b","updated":"2026-11-05 16:46:19.000000000","message":"am the desgtion i was tryign to make in the next paragraph was\n\nif a device was previously allowed and allocated to a workload and say you monitoring system start giving warning of possible failure we shoudl not\nblock the agent start up via the addtion to the exclude list so you can still properly mange the vm and cordiate moving it with the end user.\n\nhowever thinking about my current poc locally i think i actully lost that distinction so i think i simplifed it to a straight intersect be tween the two list of adreses.\n\ndo you have a pafernce for the next revision?","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"a7583637ccf58007b86b5bbda401f54ca6bf950d","unresolved":false,"context_lines":[{"line_number":561,"context_line":"has changed incompatibly, nova-compute will refuse startup. After final"},{"line_number":562,"context_line":"release, Nova will remove missing devices from tracking."},{"line_number":563,"context_line":""},{"line_number":564,"context_line":"A group/exclusion intersection is instead a configuration error under"},{"line_number":565,"context_line":"`Validation Rules`_. Releasing an instance does not resolve it. The operator"},{"line_number":566,"context_line":"must correct the exclusion list or group membership before restarting, subject"},{"line_number":567,"context_line":"to the membership-change restrictions above."}],"source_content_type":"text/x-rst","patch_set":7,"id":"f86914e2_de90e6e6","line":564,"in_reply_to":"e5b175a0_a995ce0d","updated":"2026-11-17 13:38:19.000000000","message":"Done","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"22035d894b82db214fa0b445475f328a8ac8e726","unresolved":true,"context_lines":[{"line_number":697,"context_line":""},{"line_number":698,"context_line":"When upgrading a deployment:"},{"line_number":699,"context_line":""},{"line_number":700,"context_line":"* New resource classes (``CUSTOM_PCI_GROUP_*``) appear in Placement when"},{"line_number":701,"context_line":"  upgraded nova-compute services restart with group configurations"},{"line_number":702,"context_line":"* The scheduler will naturally gate usage to upgraded compute nodes since"},{"line_number":703,"context_line":"  older nodes will not report the new group resource classes"}],"source_content_type":"text/x-rst","patch_set":7,"id":"e89f85f1_506e82c1","line":700,"updated":"2026-11-09 09:46:54.000000000","message":"Please note about the CUSTOM_PCI_GROUP_* namespace reservation starts colliding with existing operator-invented RC names","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"a7583637ccf58007b86b5bbda401f54ca6bf950d","unresolved":false,"context_lines":[{"line_number":697,"context_line":""},{"line_number":698,"context_line":"When upgrading a deployment:"},{"line_number":699,"context_line":""},{"line_number":700,"context_line":"* New resource classes (``CUSTOM_PCI_GROUP_*``) appear in Placement when"},{"line_number":701,"context_line":"  upgraded nova-compute services restart with group configurations"},{"line_number":702,"context_line":"* The scheduler will naturally gate usage to upgraded compute nodes since"},{"line_number":703,"context_line":"  older nodes will not report the new group resource classes"}],"source_content_type":"text/x-rst","patch_set":7,"id":"e746df97_dd73e07d","line":700,"in_reply_to":"e89f85f1_506e82c1","updated":"2026-11-17 13:38:19.000000000","message":"Done","commit_id":"a5a83477c1344abc29bd3958eacccbb901dc298f"},{"author":{"_account_id":6926,"name":"Bogdan Dobrelya","email":"bdobreli@redhat.com","username":"bogdando"},"change_message_id":"11e5ca450d083d34deb672a940fea755917b35f0","unresolved":true,"context_lines":[{"line_number":448,"context_line":"sorting."},{"line_number":449,"context_line":""},{"line_number":450,"context_line":"Live-migration pre-checks must verify that both sides contain the requested"},{"line_number":451,"context_line":"number of complete groups of the requested type. Paired groups must have equal"},{"line_number":452,"context_line":"sizes and matching complete member-index sets. Violations must be rejected"},{"line_number":453,"context_line":"with a clear configuration error before constructing the device-address map."},{"line_number":454,"context_line":"Operators must ensure that devices at corresponding indices are compatible,"}],"source_content_type":"text/x-rst","patch_set":9,"id":"b021c847_df6d3ad1","line":451,"updated":"2026-11-17 14:35:39.000000000","message":"what is paired groups? implementation detail or leaked abstraction?","commit_id":"46519579f56c4439b796cb63863bff16aac5090a"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"248c4191eb9c1755a4a0454ea689a8372203ab49","unresolved":true,"context_lines":[{"line_number":448,"context_line":"sorting."},{"line_number":449,"context_line":""},{"line_number":450,"context_line":"Live-migration pre-checks must verify that both sides contain the requested"},{"line_number":451,"context_line":"number of complete groups of the requested type. Paired groups must have equal"},{"line_number":452,"context_line":"sizes and matching complete member-index sets. Violations must be rejected"},{"line_number":453,"context_line":"with a clear configuration error before constructing the device-address map."},{"line_number":454,"context_line":"Operators must ensure that devices at corresponding indices are compatible,"}],"source_content_type":"text/x-rst","patch_set":9,"id":"72ae6b0f_7851d8b8","line":451,"in_reply_to":"b021c847_df6d3ad1","updated":"2026-11-17 19:17:45.000000000","message":"when live migrating for each souce pci group an instnace has we need to calulate a matching destination group, i am refering to the maping between souce to destination as paired groups.\n\nhow we construct that exact paring is now an implementiaon detail but gibi\u0027s observation was that any source group of Type A can be paried with an desgintion group of type A since two groups with the same type should be equivelnt/interchangable.\n\nin the future there may be more constarits to how we do that pairing but for now we just need a group of the same type and as a safty check we need to check they are the saem size aith a 1:1 mapping of devices withing the groups.","commit_id":"46519579f56c4439b796cb63863bff16aac5090a"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"a7583637ccf58007b86b5bbda401f54ca6bf950d","unresolved":false,"context_lines":[{"line_number":691,"context_line":"The ``CUSTOM_PCI_GROUP_*`` resource class namespace is reserved for native PCI"},{"line_number":692,"context_line":"grouping and is not configurable. Operators already using this prefix for"},{"line_number":693,"context_line":"custom resource classes must discontinue that usage before adopting native"},{"line_number":694,"context_line":"PCI grouping."},{"line_number":695,"context_line":""},{"line_number":696,"context_line":"Rolling upgrades are supported without changing existing PCI configuration."},{"line_number":697,"context_line":"PCI grouping is opt-in through configuration changes. Operators should wait"}],"source_content_type":"text/x-rst","patch_set":9,"id":"cbcdea5b_59fa0baa","line":694,"updated":"2026-11-17 13:38:19.000000000","message":"+1\n\nIt is unfortunate that our standard resource classes lib cannot handle prefix definitions but that is what we have today.","commit_id":"46519579f56c4439b796cb63863bff16aac5090a"}]}
