feat(gservice): restore PoolAgentDriver, add back gcl_sdk libvirt extra

Wires gcl_sdk's PoolAgentDriver into GeneralService as a universal
agent, so a MachinePool with driver_spec kind "libvirt" is actually
managed again (previously removed as dead code before the pool driver
existed in gcl_sdk). This is the counterpart to LocalPoolAgentDriver:
it runs inside core itself and reaches libvirt over the network,
instead of via a dedicated agent on the hypervisor host.

Requires the gcl_sdk[libvirt] extra for the libvirt python bindings.

Note: uv.lock is stale until a gcl_sdk release with the libvirt extra
is published (the currently locked 3.1.1 predates it); regenerate the
lock once that's out.

Author: VasilyStepanov

docs/usage/local_deployment.md

@@ -86,7 +86,8 @@ Run `exordos bootstrap --help` to see all available options. The most important
 | `--admin-password TEXT` | Password for the admin user. If not provided, a password is generated automatically. |
 | `--save-admin-password-file TEXT` | Save the admin password to a file instead of printing it to the console. |
 | `--ssh-public-key PATH` | Path to a public SSH key to inject into the VM. Can be specified multiple times. |
-| `--hyper-connection-uri TEXT` | Connection URI for the hypervisor, e.g. `qemu+tcp://10.0.0.1/system` or `qemu+ssh://user@10.0.0.1/system`. |
+| `--pool-agent-placement [core\|local]` | Where the pool agent that drives the hypervisor's libvirt runs. `core` (default) runs it inside core's own services, reaching libvirt over the network. `local` installs a dedicated universal agent on this host that talks to the local libvirt socket directly. |
+| `--hyper-connection-uri TEXT` | Connection URI for the hypervisor, e.g. `qemu+tcp://10.0.0.1/system` or `qemu+ssh://user@10.0.0.1/system`. Only used with `--pool-agent-placement=core`; defaults to the main network's first address (`qemu+tcp`) if not set. |
 | `--hyper-storage-pool TEXT` | Libvirt storage pool to use for VM disks. Defaults to `default`. |
 | `--force` / `-f` | Force rebuild if the output already exists. |
 

docs/usage/local_deployment.ru.md

@@ -86,7 +86,8 @@ exordos bootstrap -i https://repo.exordos.com/exordos-elements/core/0.0.6/ -m co
 | `--admin-password TEXT` | Пароль администратора. Если не задан, генерируется автоматически. |
 | `--save-admin-password-file TEXT` | Сохранить пароль администратора в файл вместо вывода в консоль. |
 | `--ssh-public-key PATH` | Путь к публичному SSH-ключу для добавления в виртуальную машину. Можно указать несколько раз. |
-| `--hyper-connection-uri TEXT` | URI подключения к гипервизору, например `qemu+tcp://10.0.0.1/system` или `qemu+ssh://user@10.0.0.1/system`. |
+| `--pool-agent-placement [core\|local]` | Где будет жить пул-агент, управляющий libvirt гипервизора. `core` (по умолчанию) — агент работает внутри сервисов core и обращается к libvirt по сети. `local` — на этом хосте устанавливается отдельный универсальный агент, который обращается к локальному сокету libvirt напрямую. |
+| `--hyper-connection-uri TEXT` | URI подключения к гипервизору, например `qemu+tcp://10.0.0.1/system` или `qemu+ssh://user@10.0.0.1/system`. Используется только с `--pool-agent-placement=core`; если не задан, по умолчанию берётся первый адрес основной сети (`qemu+tcp`). |
 | `--hyper-storage-pool TEXT` | Пул хранилища libvirt для дисков виртуальных машин. По умолчанию: `default`. |
 | `--force` / `-f` | Принудительная пересборка, если результат уже существует. |
 

exordos_core/gservice/service.py

@@ -23,6 +23,7 @@
 from gcl_sdk.agents.universal.clients.backend import db as db_back
 from gcl_sdk.agents.universal.clients.orch import db as orch_db
 from gcl_sdk.agents.universal.drivers import core as ua_core_drivers
+from gcl_sdk.agents.universal.drivers import pool as ua_pool_drivers
 from gcl_sdk.agents.universal.services import agent as ua_agent_service
 from gcl_sdk.agents.universal.services import scheduler as ua_scheduler_service
 from gcl_sdk.events import constants as event_c
@@ -102,6 +103,17 @@ def __init__(self, iter_min_period=3, iter_pause=0.1):
         volume_builder = volume_builder_svc.VolumeBuilderService(
             iter_min_period=iter_min_period
         )
+        pool_driver = ua_pool_drivers.PoolAgentDriver(
+            meta_file="/var/lib/exordos/exordos_core/pool_agent_meta.json"
+        )
+        machine_pool_agent = ua_agent_service.UniversalAgentService(
+            agent_uuid=sys_uuid.uuid5(ua_utils.system_uuid(), "machine_pool_agent"),
+            orch_client=orch_db.DatabaseOrchClient(),
+            caps_drivers=[pool_driver],
+            facts_drivers=[],
+            iter_min_period=iter_min_period,
+            payload_path=None,
+        )
         set_builder = set_builder_svc.NodeSetBuilderService(
             instance_model=node_set_models.NodeSet,
             project_id=nc.NODE_SET_PROJECT,
@@ -217,6 +229,7 @@ def __init__(self, iter_min_period=3, iter_pause=0.1):
             pool_builder_service,
             node_builder,
             volume_builder,
+            machine_pool_agent,
             cfg_service,
             service_builder,
             net_lb_iaas_builder,

pyproject.toml

@@ -28,7 +28,7 @@ dependencies = [
     "Jinja2>=3.1.5,<4.0.0",  # BSD License (BSD-3-Clause)
     "izulu>=0.50.0,<1.0.0",  # MIT License
     "gcl_iam>=1.3.2,<2.0.0",  # Apache-2.0
-    "gcl_sdk>=3.1.0,<4.0.0",  # Apache-2.0
+    "gcl_sdk[libvirt]>=3.1.0,<4.0.0",  # Apache-2.0
     "gcl_certbot_plugin>=0.0.9,<1.0.0",  # Apache-2.0
     "pyotp>=2.9.0,<3.0.0",  # MIT License
     "pyyaml>=6.0.0,<7.0.0",  # MIT