mirror of
https://github.com/netbox-community/netbox.git
synced 2026-04-14 05:00:13 +02:00
Draft v4.6 release notes
This commit is contained in:
Jeremy Stretch
@@ -70,7 +70,7 @@ django-timezone-field
|
||||
# A REST API framework for Django projects
|
||||
# https://www.django-rest-framework.org/community/release-notes/
|
||||
# TODO: Re-evaluate the monkey-patch of get_unique_validators() before upgrading
|
||||
djangorestframework==3.16.1
|
||||
djangorestframework==3.17.1
|
||||
|
||||
# Sane and flexible OpenAPI 3 schema generation for Django REST framework.
|
||||
# https://github.com/tfranzel/drf-spectacular/blob/master/CHANGELOG.rst
|
||||
|
||||
@@ -10,6 +10,14 @@ Minor releases are published in April, August, and December of each calendar yea
|
||||
|
||||
This page contains a history of all major and minor releases since NetBox v2.0. For more detail on a specific patch release, please see the release notes page for that specific minor release.
|
||||
|
||||
#### [Version 4.6](./version-4.6.md) (May 2026)
|
||||
|
||||
* Virtual Machine Types ([#5795](https://github.com/netbox-community/netbox/issues/5795))
|
||||
* Cable Bundles ([#20151](https://github.com/netbox-community/netbox/issues/20151))
|
||||
* Rack Groups ([#20961](https://github.com/netbox-community/netbox/issues/20961))
|
||||
* ETag Support for REST API ([#21356](https://github.com/netbox-community/netbox/issues/21356))
|
||||
* Cursor-based Pagination for REST API ([#21363](https://github.com/netbox-community/netbox/issues/21363))
|
||||
|
||||
#### [Version 4.5](./version-4.5.md) (January 2026)
|
||||
|
||||
* Lookup Modifiers in Filter Forms ([#7604](https://github.com/netbox-community/netbox/issues/7604))
|
||||
|
||||
130
docs/release-notes/version-4.6.md
Normal file
130
docs/release-notes/version-4.6.md
Normal file
@@ -0,0 +1,130 @@
|
||||
# NetBox v4.6
|
||||
|
||||
## v4.6.0 (FUTURE)
|
||||
|
||||
### Breaking Changes
|
||||
|
||||
* NetBox now uses django-tables2 v3.0. Plugin developers are advised review the list of [breaking changes](https://github.com/jieter/django-tables2/blob/master/CHANGELOG.md#300-2026-04-13) in that release. Specifically:
|
||||
* The `querystring` template tag has been renamed to `querystring_replace` to avoid conflicting with Django's new built-in `querystring` tag.
|
||||
* `RelatedLinkColumn` has been removed.
|
||||
|
||||
### New Features
|
||||
|
||||
#### Virtual Machine Types ([#5795](https://github.com/netbox-community/netbox/issues/5795))
|
||||
|
||||
A new VirtualMachineType model has been introduced to enable categorization of virtual machines by instance type, analogous to how DeviceType categorizes physical hardware. VM types can be defined once and reused across many virtual machines.
|
||||
|
||||
#### Cable Bundles ([#20151](https://github.com/netbox-community/netbox/issues/20151))
|
||||
|
||||
A new CableBundle model allows individual cables to be grouped together to represent physical cable runs that are managed as a unit; e.g. a bundle of 48 CAT6 cables between two patch panels. (Please note that this feature is _not_ suitable for modeling individual fiber strands within a single cable.)
|
||||
|
||||
#### Rack Groups ([#20961](https://github.com/netbox-community/netbox/issues/20961))
|
||||
|
||||
A flat RackGroup model has been reintroduced to provide a lightweight secondary axis of rack organization (e.g. by row or aisle) that is independent of the location hierarchy. Racks carry an optional foreign key to a RackGroup, and RackGroup can also serve as a scope for VLANGroup assignments.
|
||||
|
||||
#### ETag Support for REST API ([#21356](https://github.com/netbox-community/netbox/issues/21356))
|
||||
|
||||
The REST API now returns an `ETag` header on responses for individual objects, derived from the object's last-updated timestamp. Clients can supply an `If-Match` header on PUT/PATCH requests to guard against conflicting concurrent updates; if the object has been modified since the ETag was issued, the server returns a 412 (Precondition Failed) response.
|
||||
|
||||
#### Cursor-based Pagination for REST API ([#21363](https://github.com/netbox-community/netbox/issues/21363))
|
||||
|
||||
A new `start` query parameter has been introduced as an efficient alternative to the existing `offset` parameter for paginating large result sets. Rather than scanning the table up to a relative offset, the `start` parameter filters for objects with a primary key equal to or greater than the given value, enabling constant-time pagination regardless of result set size.
|
||||
|
||||
### Enhancements
|
||||
|
||||
* [#12024](https://github.com/netbox-community/netbox/issues/12024) - Permit virtual machines to be assigned to devices without a cluster
|
||||
* [#14329](https://github.com/netbox-community/netbox/issues/14329) - Improve diff highlighting for custom field data in change logs
|
||||
* [#15513](https://github.com/netbox-community/netbox/issues/15513) - Add bulk creation support for IP prefixes
|
||||
* [#17654](https://github.com/netbox-community/netbox/issues/17654) - Support role assignment for ASNs
|
||||
* [#19025](https://github.com/netbox-community/netbox/issues/19025) - Support optional schema validation for JSON custom fields
|
||||
* [#19034](https://github.com/netbox-community/netbox/issues/19034) - Annotate total reserved unit count on rack reservations
|
||||
* [#19138](https://github.com/netbox-community/netbox/issues/19138) - Include NAT addresses for primary & out-of-band IP addresses in REST API
|
||||
* [#19796](https://github.com/netbox-community/netbox/issues/19796) - Support `{module}` position inheritance for nested module bays
|
||||
* [#19953](https://github.com/netbox-community/netbox/issues/19953) - Enable debugging support for ConfigTemplate rendering
|
||||
* [#20123](https://github.com/netbox-community/netbox/issues/20123) - Introduce options to control adoption/replication of device components (replicates UI behavior)
|
||||
* [#20152](https://github.com/netbox-community/netbox/issues/20152) - Support for marking module and device bays as disabled
|
||||
* [#20162](https://github.com/netbox-community/netbox/issues/20162) - Provide an option to execute as a background job when adding components to devices in bulk
|
||||
* [#20163](https://github.com/netbox-community/netbox/issues/20163) - Add changelog message support for bulk device component creation
|
||||
* [#20698](https://github.com/netbox-community/netbox/issues/20698) - Add read-only `total_vlan_ids` attribute on VLAN group representation in REST & GraphQL APIs
|
||||
* [#20916](https://github.com/netbox-community/netbox/issues/20916) - Include stack trace for unhandled exceptions in job logs
|
||||
* [#21157](https://github.com/netbox-community/netbox/issues/21157) - Include all public model classes in export template context
|
||||
* [#21409](https://github.com/netbox-community/netbox/issues/21409) - Introduce `CHANGELOG_RETAIN_CREATE_LAST_UPDATE` configuration parameter to retain creation & most recent update record in change log for each object
|
||||
* [#21575](https://github.com/netbox-community/netbox/issues/21575) - Introduce `{vc_position}` template variable for device component template name/label
|
||||
* [#21662](https://github.com/netbox-community/netbox/issues/21662) - Increase `rf_channel_frequency` precision to 3 decimal places
|
||||
* [#21702](https://github.com/netbox-community/netbox/issues/21702) - Include a serialized representation of the HTTP request in each webhook
|
||||
* [#21720](https://github.com/netbox-community/netbox/issues/21720) - Align HTTP basic auth regex of `EnhancedURLValidator` with Django's `URLValidator`
|
||||
* [#21770](https://github.com/netbox-community/netbox/issues/21770) - Enable specifying columns to include/exclude on embedded tables
|
||||
* [#21771](https://github.com/netbox-community/netbox/issues/21771) - Add support for partial tag assignment (`add_tags`) and removal (`remove_tags`) via REST API
|
||||
* [#21780](https://github.com/netbox-community/netbox/issues/21780) - Add changelog message support to bulk creation of IP addresses
|
||||
* [#21865](https://github.com/netbox-community/netbox/issues/21865) - Allow setting empty `INTERNAL_IPS` to enable debug toolbar for all clients
|
||||
|
||||
### Performance
|
||||
|
||||
* [#21455](https://github.com/netbox-community/netbox/issues/21455) - Ensure PostgreSQL indexes exists to support the default ordering of each model
|
||||
|
||||
### Plugins
|
||||
|
||||
* [#20924](https://github.com/netbox-community/netbox/issues/20924) - Introduce support for declarative layouts and reusable UI components
|
||||
* [#21357](https://github.com/netbox-community/netbox/issues/21357) - Provide an API for plugins to register custom model actions (for permission assignment)
|
||||
|
||||
### Deprecations
|
||||
|
||||
* [#21284](https://github.com/netbox-community/netbox/issues/21284) - Deprecate the `username` and `request_id` fields in event data
|
||||
* [#21304](https://github.com/netbox-community/netbox/issues/21304) - Deprecate the `housekeeping` management command
|
||||
* [#21331](https://github.com/netbox-community/netbox/issues/21331) - Deprecate NetBox's custom `querystring` template tag
|
||||
* [#21881](https://github.com/netbox-community/netbox/issues/21881) - Deprecate legacy Sentry configuration parameters
|
||||
* [#21884](https://github.com/netbox-community/netbox/issues/21884) - Deprecate the obsolete `DEFAULT_ACTION_PERMISSIONS` mapping
|
||||
* [#21887](https://github.com/netbox-community/netbox/issues/21887) - Deprecate support for legacy view actions
|
||||
* [#21890](https://github.com/netbox-community/netbox/issues/21890) - Deprecate `models` key in application registry
|
||||
|
||||
### Other Changes
|
||||
|
||||
* [#20984](https://github.com/netbox-community/netbox/issues/20984) - Upgrade to Django 6.0
|
||||
* [#21635](https://github.com/netbox-community/netbox/issues/21635) - Migrate documentation site from mkdocs to Zensical
|
||||
* [#21902](https://github.com/netbox-community/netbox/issues/21902) - Upgrade `django-tables2` to v3.0
|
||||
|
||||
### REST API Changes
|
||||
|
||||
* New features:
|
||||
* `ETag` response header and `If-Match` request header support for all individual object endpoints
|
||||
* `start` query parameter for cursor-based pagination on all list endpoints
|
||||
* `add_tags` and `remove_tags` write-only fields on all taggable model serializers
|
||||
* New endpoints:
|
||||
* `GET/POST /api/dcim/cable-bundles/`
|
||||
* `GET/PUT/PATCH/DELETE /api/dcim/cable-bundles/<id>/`
|
||||
* `GET/POST /api/dcim/rack-groups/`
|
||||
* `GET/PUT/PATCH/DELETE /api/dcim/rack-groups/<id>/`
|
||||
* `GET/POST /api/virtualization/vm-types/`
|
||||
* `GET/PUT/PATCH/DELETE /api/virtualization/vm-types/<id>/`
|
||||
* `dcim.Cable`
|
||||
* Add optional foreign key field `bundle`
|
||||
* `dcim.Device`
|
||||
* The `primary_ip`, `primary_ip4`, `primary_ip6`, and `oob_ip` nested representations now include `nat_inside` and `nat_outside`
|
||||
* `dcim.DeviceBay`
|
||||
* Add boolean field `enabled`
|
||||
* Add read-only boolean field `_occupied`
|
||||
* `dcim.DeviceBayTemplate`
|
||||
* Add boolean field `enabled`
|
||||
* `dcim.Module`
|
||||
* Add write-only boolean fields `replicate_components` and `adopt_components`
|
||||
* `dcim.ModuleBay`
|
||||
* Add boolean field `enabled`
|
||||
* Add read-only boolean field `_occupied`
|
||||
* `dcim.ModuleBayTemplate`
|
||||
* Add boolean field `enabled`
|
||||
* `dcim.Rack`
|
||||
* Add optional foreign key field `group`
|
||||
* `dcim.RackReservation`
|
||||
* Add read-only integer field `unit_count`
|
||||
* `extras.CustomField`
|
||||
* Add JSON field `validation_schema`
|
||||
* `ipam.ASN`
|
||||
* Add optional foreign key field `role`
|
||||
* `ipam.Role`
|
||||
* Annotate count of assigned ASNs (`asn_count`)
|
||||
* `ipam.VLANGroup`
|
||||
* Add read-only field `total_vlan_ids`
|
||||
* `virtualization.VirtualMachine`
|
||||
* Add optional foreign key field `virtual_machine_type`
|
||||
* The `primary_ip`, `primary_ip4`, and `primary_ip6` nested representations now include `nat_inside` and `nat_outside`
|
||||
* The `cluster` field is now optional (nullable)
|
||||
@@ -327,6 +327,7 @@ nav:
|
||||
- git Cheat Sheet: 'development/git-cheat-sheet.md'
|
||||
- Release Notes:
|
||||
- Summary: 'release-notes/index.md'
|
||||
- Version 4.6: 'release-notes/version-4.6.md'
|
||||
- Version 4.5: 'release-notes/version-4.5.md'
|
||||
- Version 4.4: 'release-notes/version-4.4.md'
|
||||
- Version 4.3: 'release-notes/version-4.3.md'
|
||||
|
||||
@@ -15,7 +15,7 @@ django-storages==1.14.6
|
||||
django-tables2==2.8.0
|
||||
django-taggit==6.1.0
|
||||
django-timezone-field==7.2.1
|
||||
djangorestframework==3.16.1
|
||||
djangorestframework==3.17.1
|
||||
drf-spectacular==0.29.0
|
||||
drf-spectacular-sidecar==2026.4.1
|
||||
feedparser==6.0.12
|
||||
|
||||
Reference in New Issue
Block a user