Commit Graph

4423 Commits

Author SHA1 Message Date
Sylvain Bauza e3c494cbd9 [doc] Adding vGPUs max_instances caveat fix for virtual-gpu
When I069879a333152bb849c248b3dcb56357a11d0324 merged in Caracal, we forgot
to add documentation for the SR-IOV GPU caveat fix.
Also, given the new max_instances option was dynamic, we can't even see it
in the configuration list, so actually none of our operators can know that we
fixed it and how to do it 🤦

Change-Id: I3402c28f76cc51dd8c003181f11e0820ce5d9b7d
Related-Bug: #2041519
2025-05-14 19:26:11 +02:00
Sean Mooney 02d72b9d56 Remove nova debugger functionality
The nova debuger functionality was intended
to help debugging running process however it has
never been reliable due to our use of eventlet and is generally
not required when not using eventlet. I.e. you can just
run the nova console-scripts form a debugger or add pdb
statements as required.

As part of the eventlet removal the debugger functionality is
removed given its untested and undocumented.

Change-Id: I7bf88f06f3d1dbd2c7e342b27a21440a123c631d
2025-04-25 14:37:44 +02:00
Zuul f1e843af0d Merge "[doc]Describe file based GMR triggering" 2025-04-25 10:57:52 +00:00
Zuul 2fa61a0ad2 Merge "[doc]Remove eventlet based API endpoints" 2025-04-25 10:57:41 +00:00
Balazs Gibizer 05bab98aba [doc]Describe file based GMR triggering
We learned during recent installer development that triggering
GMR with apache/mod_wsgi API services via signals is hard due
to multiple reasons. We ended up using file based triggers instead of
signals. This patch document this approach.

Change-Id: I1fdbe6314ce4a1b173d01d3ebd9db07a0beb25a2
2025-04-17 16:27:46 +02:00
Balazs Gibizer e25418c857 [doc]Remove eventlet based API endpoints
The previous patch[1] removed the entry points. As there is sizable
amount of doc change needed to remove all the references from the doc
to the removed entry points a separate patch, this, is created to do so.

[1] Ie758550c0b8fb02aeb398396961467d9f845fcc9

Change-Id: Ibe8e45e86912e747f07e5fabd5b1204341c1e606
2025-04-17 16:24:16 +02:00
Zuul 33f859cab7 Merge "doc: Remove non-existent [service_user] auth_strategy" 2025-04-17 11:49:22 +00:00
Zuul 16a5923a55 Merge "doc: Drop deprecated [api] auth_strategy" 2025-04-17 11:49:14 +00:00
Dan Smith 3dc42b8422 Add one-time-use devices docs and reno
This adds documentation to the PCI-passthrough doc in the admin guide,
explaining how to use one-time-use devices.

Keeping this separate so we can iterate on it separate from the code.

Related to blueprint one-time-use-devices

Change-Id: Iff91c0726bbb37c7a3ef885a73e3c3586feb6004
2025-04-02 11:53:54 -07:00
Dan Smith 28a266461a Support "one-time-use" PCI devices
This adds support for devices that will be allocated to an instance
once and left in a reserved=total state. An external workflow can
put them back into allocatable state by dropping reserved back to
zero. Note this requires PCI-in-placement tracking for the affected
devices and it is only valid for type-PCI and type-PF devices.

Related to blueprint one-time-use-devices

Depends-On: https://review.opendev.org/c/openstack/requirements/+/946181
Co-Authored-By: Balazs Gibizer <gibi@redhat.com>
Change-Id: Idfe8a746a97d68cd4eae30afb7d22f4e3af80327
2025-04-02 11:53:36 -07:00
René Ribaud c6a96a17db FUP Update pci-passthrough and virtual-gpu documentation
This patch adds the necessary documentation identified in:

- pci-passthrough: Explaining live migration and known issues.
- virtual-gpu: Updating the caveats section to clarify what to do
  when VF devices are available instead of `mdev`.

The target goal of these series of patch is to enable VFIO devices
migration with kernel variant drivers.

Implements: blueprint migrate-vfio-devices-using-kernel-variant-drivers
Change-Id: I41271a8af5687fb1d18f9d0852492756e096720d
2025-03-26 10:02:41 +01:00
Zuul 6042300453 Merge "Bump MIN_{LIBVIRT,QEMU} for "Epoxy"" 2025-03-18 12:43:44 +00:00
Takashi Kajinami 5c50b8d5a9 doc: Remove non-existent [service_user] auth_strategy
The option does not actually exist.

Change-Id: I52f8566d197b74365b442fab36932dfee7fe898e
2025-03-11 21:09:30 +09:00
Takashi Kajinami 50ca86d329 doc: Drop deprecated [api] auth_strategy
It was deprecated 5+ years ago[1].

Also remove the keystone_authtoken section from compute node because
these options are unused by nova-compute.

[1] 18de63deaa

Change-Id: Ie37a1593e101d76b003aeddef2294d52386b2050
2025-03-11 21:09:08 +09:00
Zuul 406eedb1ce Merge "Fix microversion 2.98 doc/tests for update/rebuild APIs" 2025-03-04 01:45:13 +00:00
Zuul cf326d4375 Merge "Fix microversion 2.96 for update/rebuild APIs" 2025-03-04 01:38:24 +00:00
René Ribaud 03915cd59d Update driver to deal with managed flag
The target goal of these series of patch is to enable VFIO devices
with kernel variant drivers.

Implements: blueprint enable-vfio-devices-with-kernel-variant-drivers
Change-Id: I7949ba6da8b6257865d8e9e48bf3feabc10bdf17
2025-03-02 21:37:47 +01:00
Ghanshyam Mann 7a00971b8f Fix microversion 2.98 doc/tests for update/rebuild APIs
microversion 2.98 changed the GET and GET list details
API response to expand the image field
- https://review.opendev.org/c/openstack/nova/+/939649

but when we change the views/servers.py then update server
and rebuild server API response also gets updated.
- https://review.opendev.org/c/openstack/nova/+/939649/12/nova/api/openstack/compute/views/servers.py#595

The microversion change actually changed the response for
the update and rebuild API but did not update the documentation
about this change. Neither added test for rebuild and update
which verify the response change.

Since microversion 2.75, we have made all these 4 APIs response
consistent.

Implements: blueprint image-properties-in-server-show

Change-Id: Ifc2edc59c601391a31fd8953c742969e5b368767
2025-02-28 17:13:59 +00:00
Ghanshyam Mann f9e89bc0d1 Fix microversion 2.96 for update/rebuild APIs
microversion 2.96 changed the GET and GET list details
APi response to add a new field 'pinned_availability_zone'
- https://review.opendev.org/c/openstack/nova/+/904568

but when we change the views/servers.py then update server
and rebuild server API response also gets updated.
- https://review.opendev.org/c/openstack/nova/+/904568/17/nova/api/openstack/compute/views/servers.py#309

The microversion change actually changed the response for
the update and rebuild API but did not update the documentation
about this change. Neither added test for rebuild and update
which verify the response change.

Since microversion 2.75, we have made all these 4 APIs response
consistent.

Change-Id: I31fbb3c5e689302713bfb7a254c5d0cc12de2dc4
2025-02-28 17:06:18 +00:00
Zuul a933c7fbab Merge "Add support for showing scheduler_hints in server details" 2025-02-28 02:14:07 +00:00
Zuul 4fdbbb6a91 Merge "doc: Use dnf instead of yum" 2025-02-27 23:06:26 +00:00
René Ribaud f7d99623ed Bump MIN_{LIBVIRT,QEMU} for "Epoxy"
The minimum required version of QEMU is now 6.2.0, and of libvirt is
8.0.0.

Minimum cleanup to make the tests happy.
Adjust the related unit tests accordingly.

Following patch will clean all constants not useful anymore.

Change-Id: I381a6c180494ed7b6ae47853132673f153733587
2025-02-27 11:52:01 +01:00
Douglas Viroel 2db8af71dd Add support for showing scheduler_hints in server details
Nova currently lacks a straightforward way to expose scheduler hints
associated with a server. This change extends existing Nova's
API to allow users to retrieve this information when it is available.
It adds a new API microversion to support returning the associated
scheduler_hints in ``GET /servers/{server_id}``, `GET /servers/detail``,
``PUT /servers/{server_id}`` and ``POST /server/{server_id}/action``
(rebuild) responses.

Implements: blueprint show-scheduler-hints-in-server-details
Change-Id: If0070cfbc218e0515bf3b58fc8c5067ae22c7072
2025-02-26 17:50:25 -03:00
Zuul 8de6a43a43 Merge "Per-Property ImageMetaPropsWeigher" 2025-02-25 19:16:49 +00:00
Michael Still cbc263f6bc libvirt: allow direct SPICE connections to qemu
This patch adds a new console type, "spice-direct", which provides
the connection information required to talk the native SPICE protocol
directly to qemu on the hypervisor. This is intended to be fronted
by a proxy which will handle authentication separately.

A new microversion is introduced which adds the type "spice-direct"
to the existing "spice" protocol.

An example request:

POST /servers/<uuid>/remote-consoles
{
  "remote_console": {
    "protocol": "spice",
    "type": "spice-direct"
  }
}

An example response:

{
  "remote_console": {
    "protocol": "spice",
    "type": "spice-direct",
    "url": "http://localhost:13200/nova?token=XXX";
  }
}

This token can then be used to lookup connection details for the
console using a request like this:

GET /os-console-auth-tokens/<consoletoken>

Which returns something like this:

{
  "console": {
    "instance_uuid": <uuid>,
    "host": <hypervisor>,
    "port": <a TCP port number>,
    "tls_port": <another TCP port number>,
    "internal_access_path": null
  }
}

APIImpact

Change-Id: I1e701cbabc0e2c435685e31465159eec09e3b1a0
2025-02-22 08:25:38 +11:00
Sylvain Bauza 7388362f28 Per-Property ImageMetaPropsWeigher
Add a new config option that will only check specific properties
and allow per-property weights.

Change-Id: Iae51558b9eb03da705e0da939cbd459b4d3b51f7
2025-02-20 03:00:03 +00:00
Sylvain Bauza acd6c733c6 Add a new ImagePropertiesWeigher
This weigher will check how many instances in the host have the image
properties that are requested and will prefer by default to pack
instances with the same properties.

Implements blueprint: image-metadata-props-weigher

Change-Id: I3bfed44bd089c6b226d13c3ac4a0003411737cbd
2025-02-20 02:49:08 +00:00
Rajesh Tailor 05c6b6cdbb Add support for showing image properties in server show response
This change adds a new api microversion to add support for
including image properties in ``server show`` and ``server list
--long`` responses as well as in response for ``server rebuild``
instance action.

Implements: blueprint image-properties-in-server-show
Change-Id: Ic135389954e43e6478288c0cdcffd780915cdb40
2025-02-12 10:57:03 +05:30
Zuul a2e555574c Merge "docs: Show the recommended way to PXE boot an instance" 2025-01-10 03:17:48 +00:00
Zuul 4871641b85 Merge "Modify the url of openstack client commands." 2025-01-10 03:02:42 +00:00
Takashi Kajinami d94a9925a7 doc: Use dnf instead of yum
The yum command has been replaced by the dnf command in recent releases
of Fedora-based distributions. Use the native command instead of
the alias kept for compatibility.

Partial-Bug: #2091586
Change-Id: I34cb4f28af65f426f8dd453435c79cbfd7d97394
2025-01-07 01:39:40 +00:00
Zuul 4860c40d82 Merge "Manila shares admin guide documentation" 2024-12-13 10:40:25 +00:00
Zuul 728337f200 Merge "Add instance.share_detach_error notification" 2024-12-12 21:36:13 +00:00
Zuul f729a7fb13 Merge "docs: Add contributor docs for response body validation" 2024-12-11 10:02:29 +00:00
Zuul ac5e9c71e9 Merge "Update contributor process documentation" 2024-12-10 18:56:46 +00:00
Zuul 6efc5eb3b7 Merge "Add instance.share_attach_error notification" 2024-12-09 19:35:07 +00:00
Zuul 338cbea72a Merge "Add shares to InstancePayload" 2024-12-09 00:38:54 +00:00
Zuul e517c36bcf Merge "Add instance.share_detach notification" 2024-12-08 04:07:34 +00:00
Zuul 8c9894e61b Merge "Add instance.share_attach notification" 2024-12-06 22:29:13 +00:00
Zuul a5997aa10f Merge "Attach Manila shares via virtiofs (API)" 2024-12-06 18:38:52 +00:00
Ildiko Vancsa 115c9b685f Update contributor process documentation
This patch updates the contributor/process.rst file to remove outdated
process descriptions, such as runways and gerrit review labels.

The patch also adds the description of the current tracking etherpad
that the team uses to track priorities and ongoing work items. It also
adds the link to the process.rst doc to README.rst for improved
visibility.

Closes-Bug: #2089325

Change-Id: I1713f84fc521759333d1d07fc12d0fc23a5cb807
Signed-off-by: Ildiko Vancsa <ildiko.vancsa@gmail.com>
2024-12-06 07:30:17 -08:00
Zuul 3b075492e3 Merge "[codespell] Fixes for latest version" 2024-11-27 18:15:39 +00:00
René Ribaud 73a7c1b295 Manila shares admin guide documentation
Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares

Change-Id: I3963e9929c61751ed3ea176d1ef9dcc29c02de82
2024-11-27 14:09:45 +01:00
René Ribaud 7dfb15235e Add instance.share_detach_error notification
This patch add a notification when a share can not be unmounted on the
compute host.

Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares
Change-Id: Ic1aeb2308af5bf645fa67fe1f47e5a076efd6071
2024-11-27 14:09:45 +01:00
René Ribaud 9f8b05fd90 Add instance.share_attach_error notification
This patch add a notification when a share can not be mounted on the
compute host.

Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares
Change-Id: Idd44f5ad96c0a1dd62eba5d283e614c324854a80
2024-11-27 14:09:45 +01:00
René Ribaud bf96ca7c9a Add shares to InstancePayload
This patch add share information to the InstancePayload that can be sent
if the include_share_mapping configuration parameter is enabled.

Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares

Change-Id: I3d5005eab9e3f23be149e955e8cb4608a6ee1312
2024-11-27 14:09:45 +01:00
René Ribaud 13d45b6d37 Add instance.share_detach notification
This patch add a notification when a share is detached from an instance.

Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares

Change-Id: I203b71a39878c3929b22b53220f58c12c0a4c0b9
2024-11-27 14:09:45 +01:00
René Ribaud 320dca5391 Add instance.share_attach notification
This patch add a notification when a share is attached to an instance.

Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares

Change-Id: I6fe3807164bd2ca6439342abd32f8e4ce9057c8c
2024-11-27 14:09:45 +01:00
René Ribaud 5e508a09b3 Attach Manila shares via virtiofs (API)
This patch introduce the REST API modifications to attach/detach a share
and list/show share mappings.

Manila is the OpenStack Shared Filesystems service.
These series of patches implement changes required in Nova to allow the shares
provided by Manila to be associated with and attached to instances using
virtiofs.

Implements: blueprint libvirt-virtiofs-attach-manila-shares

Change-Id: I0255a5697cd4ea148bd91c4f6fd183841d69a333
2024-11-27 14:09:42 +01:00
Zuul d9f9b3abb3 Merge "api: Add response body schemas for remaining server action APIs" 2024-11-26 20:24:35 +00:00