starred/netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2026-01-11 21:10:29 +01:00
Code Issues 273 Packages Projects Releases 10 Wiki Activity

[PR #19371] [MERGED] Release v4.3.0 #15635

New Issue
Closed
opened 2025-12-30 00:23:07 +01:00 by adam · 0 comments
adam commented 2025-12-30 00:23:07 +01:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/netbox-community/netbox/pull/19371
Author: @jeremystretch
Created: 5/1/2025
Status: ✅ Merged
Merged: 5/1/2025
Merged by: @jeremystretch

Base: main ← Head: release-v4.3.0

📝 Commits (10+)

  • 4384193 Closes #18540: Track installed plugins in registry
  • 75417c9 Closes #17587: Add release_track attribute to PluginConfig
  • d202b35 Merge branch 'main' into feature
  • 697610d Closes #18541: Document support for auth_required attribute on PluginMenuItem
  • 701f40e Show parent contacts for nested models
  • d5316de Move contact queryset into model
  • 72adda1 Allow exclusion of inherited contacts
  • ef89fc1 Closes #18071: Remvoe legacy staged changes functionality
  • ca6b686 Limit inherited contacts to model
  • 2eaee8b Close #18635: Show only the semantic version

📊 Changes

426 files changed (+18996 additions, -12303 deletions)

View changed files

📝 .github/ISSUE_TEMPLATE/01-feature_request.yaml (+1 -1)
📝 .github/ISSUE_TEMPLATE/02-bug_report.yaml (+1 -1)
📝 base_requirements.txt (+9 -1)
📝 docs/administration/replicating-netbox.md (+1 -1)
📝 docs/configuration/plugins.md (+18 -0)
📝 docs/configuration/required-parameters.md (+35 -10)
📝 docs/configuration/security.md (+15 -1)
📝 docs/configuration/system.md (+56 -9)
📝 docs/customization/custom-scripts.md (+2 -0)
📝 docs/development/adding-models.md (+5 -3)
📝 docs/development/extending-models.md (+1 -1)
📝 docs/development/getting-started.md (+1 -1)
📝 docs/installation/1-postgresql.md (+7 -29)
📝 docs/installation/2-redis.md (+3 -12)
📝 docs/installation/3-netbox.md (+29 -51)
📝 docs/installation/6-ldap.md (+0 -8)
📝 docs/installation/index.md (+13 -4)
📝 docs/installation/upgrading.md (+44 -46)
📝 docs/integrations/graphql-api.md (+45 -5)
📝 docs/introduction.md (+1 -1)

...and 80 more files

📄 Description

Breaking Changes

  • The GraphQL API Now uses an advanced syntax for filtering, to enable e.g. logical AND/OR filtering and custom field lookups.
  • PostgreSQL 13 is no longer supported. NetBox v4.3 requires PostgreSQL 14.0 or later.
  • The ALLOW_TOKEN_RETRIEVAL configuration parameter now defaults to False.
  • The device and virtual_machine foreign keys on the Service model have been replaced with a generic parent relationship to support the assignment of services to FHRP groups as well.
  • The group foreign key on the Contact model has been replaced with a many-to-many groups field.
  • PluginTemplateExtension no longer supports registration via the singular model attribute (use models instead).
  • The legacy staged changes functionality has been removed.

New Features

Module Type Profiles & Custom Attributes (#19002)

The new module type profile model enables users to declare custom profiles for module types, with the ability to define custom attributes for each profile according to its functional role. For example, a CPU module type might declare architecture and clock speed attributes; a hard disk profile might declare attributes for type and speed.

Attributes can be declared on each profile using JSON schema, which allows for attributes to be declared as strings (text), integers, decimals, booleans, or choice fields. Profile attributes render as individual form fields when modifying a module type. Several profiles have been included by default to serve as examples, however these may be modified or removed.

Reusable Table Configurations (#14591)

After modifying the displayed columns and/or ordering for a specific object table in the user interface, users now have the option to save that configuration so that it can be reused in the future. Similar to saved filters, table configs can be shared with other users to easily replicate table layouts crafted to serve specific use cases.

Option to Treat IP Ranges as Fully Populated (#9763)

A new mark_populated boolean field has been added to the IPRange model. If set to true, NetBox will consider the IP range to be fully populated, and will not permit the creation of individual IP addresses within the range. For example, you might defer the management of an IP range to an external DHCP server, and wish for NetBox to treat the range as a opaque monolithic block for planning and allocation purposes.

Hierarchical Device Roles (#18245)

Device roles can now be arranged hierarchically, with one role optionally serving as a parent to one or more child roles. For example, you might wish to create a generic "Server" role for devices with "Application Server" and "Database Server" roles beneath it. A device could then be assigned to any of these three roles.

Periodic Synchronization of Data Sources (#18287)

Data sources can now be configured to synchronize automatically at a specified interval, as indicated by the new sync_interval field. No additional system configuration is necessary to support this functionality; background jobs will be scheduled automatically by the RQ worker process.

Proxy Routing (#18627)

User can now declare one or more proxy routers via the PROXY_ROUTERS configuration parameter to control the use of specific proxy servers for various outbound connections. For example, it is now possible to configure NetBox to use different proxies based on the type of outbound traffic or its destination.

Enhancements

  • #7598 - Adopt advanced query filtering in GraphQL API to support filtering by custom fields
  • #8423 - Enable assigning services to FHRP groups
  • #15842 - Introduce the LOGIN_FORM_HIDDEN configuration parameter
  • #16224 - Implement pagination support for the GraphQL API
  • #17170 - Enable the assignment of a contact to multiple contact groups
  • #17443 - Add a file_name field to the export template model
  • #17602 - Add a comments field to all nested group models (Region, SiteGroup, Location, ContactGroup, TenantGroup, and WirelessLANGroup)
  • #17608 - Add a status field to the L2VPN model
  • #17653 - Enable declaring Jinja environment parameters on export templates (similar to config templates)
  • #17793 - Introduce a REST API endpoint for tagged objects (/api/extras/tagged-objects/)
  • #17841 - Add a weight field to the Tag model to influence ordering
  • #18296 - Add a tenant field to the VLAN group model
  • #18352 - Add a status field to the power outlet model
  • #18417 - Add an outer_height field to the rack & rack type models
  • #18535 - The presence of incompatible plugins will no longer prevent NetBox from starting
  • #18780 - Introduce DATABASES and DATABASE_ROUTERS configuration parameters to enable defining connections to external databases (e.g. for plugins)
  • #18783 - Enable filtering all applicable models by tag ID
  • #18785 - Enable custom choices for rack, device, and module airflow

Plugins

  • #16630 - Plugins can now inject content within the HTML <head> block via the new plugin_head() method on PluginTemplateExtension
  • #17424 - Extend ViewTab with a visible argument to control tab rendering
  • #17857 - Added a release_track attribute to PluginConfig
  • #18305 - Introduce plugin support for ContactsMixin
  • #19073 - Allow installed plugins to be omitted from the plugins list

Other Changes

  • #18071 - Removed legacy staged changed functionality in favor of the netbox-branching plugin
  • #18072 - Drop support for the singular model attribute on PluginTemplateExtension (use models instead)
  • #18191 - Remove redundant PostgreSQL indexes
  • #18236 - Upgrade the HTMX library to v2.0
  • #18540 - Operational plugins are now recorded in the application registry
  • #18623 - Upgrade the Tabler CSS theme to v1.0
  • #18743 - Upgrade Django to v5.2
  • #18751 - Change the default value for ALLOW_TOKEN_RETRIEVAL to False
  • #18808 - Squashed migration dependencies have been altered to rectify an issue with Django's sqlmigrate management command
  • #18820 - PostgreSQL 13 is no longer supported
  • #19004 - The use of inventory items has been deprecated in favor of modules. Inventory items and roles may be removed in a future NetBox release.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/netbox-community/netbox/pull/19371 **Author:** [@jeremystretch](https://github.com/jeremystretch) **Created:** 5/1/2025 **Status:** ✅ Merged **Merged:** 5/1/2025 **Merged by:** [@jeremystretch](https://github.com/jeremystretch) **Base:** `main` ← **Head:** `release-v4.3.0` --- ### 📝 Commits (10+) - [`4384193`](https://github.com/netbox-community/netbox/commit/43841939a0b7c6140dae18c48d1aed3c770d4eb5) Closes #18540: Track installed plugins in registry - [`75417c9`](https://github.com/netbox-community/netbox/commit/75417c9cd5a9775b072855827baca43786d5b53e) Closes #17587: Add release_track attribute to PluginConfig - [`d202b35`](https://github.com/netbox-community/netbox/commit/d202b3529d5429ea00afb935106bc767e3f0c83c) Merge branch 'main' into feature - [`697610d`](https://github.com/netbox-community/netbox/commit/697610db94b6b5b54362edeb463dc6e962902d08) Closes #18541: Document support for auth_required attribute on PluginMenuItem - [`701f40e`](https://github.com/netbox-community/netbox/commit/701f40e2a8e46ebcf8bf11707f1c418bbc06c9c8) Show parent contacts for nested models - [`d5316de`](https://github.com/netbox-community/netbox/commit/d5316de9c84daf258b43af002e1f156ac41c18cb) Move contact queryset into model - [`72adda1`](https://github.com/netbox-community/netbox/commit/72adda11974f81fbc0cc9edfc74654009c74b1b9) Allow exclusion of inherited contacts - [`ef89fc1`](https://github.com/netbox-community/netbox/commit/ef89fc1264534539895dd2066b0230226b18dd87) Closes #18071: Remvoe legacy staged changes functionality - [`ca6b686`](https://github.com/netbox-community/netbox/commit/ca6b686b88ac68550712adf74b4f68cbcac3f8ee) Limit inherited contacts to model - [`2eaee8b`](https://github.com/netbox-community/netbox/commit/2eaee8bf45d4620ad5b624331a5d37993acbd0f6) Close #18635: Show only the semantic version ### 📊 Changes **426 files changed** (+18996 additions, -12303 deletions) <details> <summary>View changed files</summary> 📝 `.github/ISSUE_TEMPLATE/01-feature_request.yaml` (+1 -1) 📝 `.github/ISSUE_TEMPLATE/02-bug_report.yaml` (+1 -1) 📝 `base_requirements.txt` (+9 -1) 📝 `docs/administration/replicating-netbox.md` (+1 -1) 📝 `docs/configuration/plugins.md` (+18 -0) 📝 `docs/configuration/required-parameters.md` (+35 -10) 📝 `docs/configuration/security.md` (+15 -1) 📝 `docs/configuration/system.md` (+56 -9) 📝 `docs/customization/custom-scripts.md` (+2 -0) 📝 `docs/development/adding-models.md` (+5 -3) 📝 `docs/development/extending-models.md` (+1 -1) 📝 `docs/development/getting-started.md` (+1 -1) 📝 `docs/installation/1-postgresql.md` (+7 -29) 📝 `docs/installation/2-redis.md` (+3 -12) 📝 `docs/installation/3-netbox.md` (+29 -51) 📝 `docs/installation/6-ldap.md` (+0 -8) 📝 `docs/installation/index.md` (+13 -4) 📝 `docs/installation/upgrading.md` (+44 -46) 📝 `docs/integrations/graphql-api.md` (+45 -5) 📝 `docs/introduction.md` (+1 -1) _...and 80 more files_ </details> ### 📄 Description ### Breaking Changes * The GraphQL API Now uses an advanced syntax for filtering, to enable e.g. logical AND/OR filtering and custom field lookups. * PostgreSQL 13 is no longer supported. NetBox v4.3 requires PostgreSQL 14.0 or later. * The `ALLOW_TOKEN_RETRIEVAL` configuration parameter now defaults to False. * The `device` and `virtual_machine` foreign keys on the Service model have been replaced with a generic `parent` relationship to support the assignment of services to FHRP groups as well. * The `group` foreign key on the Contact model has been replaced with a many-to-many `groups` field. * PluginTemplateExtension no longer supports registration via the singular `model` attribute (use `models` instead). * The legacy staged changes functionality has been removed. ### New Features #### Module Type Profiles & Custom Attributes ([#19002](https://github.com/netbox-community/netbox/issues/19002)) The new [module type profile](../models/dcim/moduletypeprofile.md) model enables users to declare custom profiles for module types, with the ability to define custom attributes for each profile according to its functional role. For example, a CPU module type might declare architecture and clock speed attributes; a hard disk profile might declare attributes for type and speed. Attributes can be declared on each profile using [JSON schema](https://json-schema.org/), which allows for attributes to be declared as strings (text), integers, decimals, booleans, or choice fields. Profile attributes render as individual form fields when modifying a module type. Several profiles have been included by default to serve as examples, however these may be modified or removed. #### Reusable Table Configurations ([#14591](https://github.com/netbox-community/netbox/issues/14591)) After modifying the displayed columns and/or ordering for a specific object table in the user interface, users now have the option to save that configuration so that it can be reused in the future. Similar to saved filters, table configs can be shared with other users to easily replicate table layouts crafted to serve specific use cases. #### Option to Treat IP Ranges as Fully Populated ([#9763](https://github.com/netbox-community/netbox/issues/9763)) A new `mark_populated` boolean field has been added to the IPRange model. If set to true, NetBox will consider the IP range to be fully populated, and will not permit the creation of individual IP addresses within the range. For example, you might defer the management of an IP range to an external DHCP server, and wish for NetBox to treat the range as a opaque monolithic block for planning and allocation purposes. #### Hierarchical Device Roles ([#18245](https://github.com/netbox-community/netbox/issues/18245)) Device roles can now be arranged hierarchically, with one role optionally serving as a parent to one or more child roles. For example, you might wish to create a generic "Server" role for devices with "Application Server" and "Database Server" roles beneath it. A device could then be assigned to any of these three roles. #### Periodic Synchronization of Data Sources ([#18287](https://github.com/netbox-community/netbox/issues/18287)) Data sources can now be configured to synchronize automatically at a specified interval, as indicated by the new `sync_interval` field. No additional system configuration is necessary to support this functionality; background jobs will be scheduled automatically by the RQ worker process. #### Proxy Routing ([#18627](https://github.com/netbox-community/netbox/issues/18627)) User can now declare one or more proxy routers via the `PROXY_ROUTERS` configuration parameter to control the use of specific proxy servers for various outbound connections. For example, it is now possible to configure NetBox to use different proxies based on the type of outbound traffic or its destination. ### Enhancements * [#7598](https://github.com/netbox-community/netbox/issues/7598) - Adopt advanced query filtering in GraphQL API to support filtering by custom fields * [#8423](https://github.com/netbox-community/netbox/issues/8423) - Enable assigning services to FHRP groups * [#15842](https://github.com/netbox-community/netbox/issues/15842) - Introduce the `LOGIN_FORM_HIDDEN` configuration parameter * [#16224](https://github.com/netbox-community/netbox/issues/16224) - Implement pagination support for the GraphQL API * [#17170](https://github.com/netbox-community/netbox/issues/17170) - Enable the assignment of a contact to multiple contact groups * [#17443](https://github.com/netbox-community/netbox/issues/17443) - Add a `file_name` field to the export template model * [#17602](https://github.com/netbox-community/netbox/issues/17602) - Add a `comments` field to all nested group models (Region, SiteGroup, Location, ContactGroup, TenantGroup, and WirelessLANGroup) * [#17608](https://github.com/netbox-community/netbox/issues/17608) - Add a `status` field to the L2VPN model * [#17653](https://github.com/netbox-community/netbox/issues/17653) - Enable declaring Jinja environment parameters on export templates (similar to config templates) * [#17793](https://github.com/netbox-community/netbox/issues/17793) - Introduce a REST API endpoint for tagged objects (`/api/extras/tagged-objects/`) * [#17841](https://github.com/netbox-community/netbox/issues/17841) - Add a `weight` field to the Tag model to influence ordering * [#18296](https://github.com/netbox-community/netbox/issues/18296) - Add a `tenant` field to the VLAN group model * [#18352](https://github.com/netbox-community/netbox/issues/18352) - Add a `status` field to the power outlet model * [#18417](https://github.com/netbox-community/netbox/issues/18417) - Add an `outer_height` field to the rack & rack type models * [#18535](https://github.com/netbox-community/netbox/issues/18535) - The presence of incompatible plugins will no longer prevent NetBox from starting * [#18780](https://github.com/netbox-community/netbox/issues/18780) - Introduce `DATABASES` and `DATABASE_ROUTERS` configuration parameters to enable defining connections to external databases (e.g. for plugins) * [#18783](https://github.com/netbox-community/netbox/issues/18783) - Enable filtering all applicable models by tag ID * [#18785](https://github.com/netbox-community/netbox/issues/18785) - Enable custom choices for rack, device, and module airflow ### Plugins * [#16630](https://github.com/netbox-community/netbox/issues/16630) - Plugins can now inject content within the HTML `<head>` block via the new `plugin_head()` method on PluginTemplateExtension * [#17424](https://github.com/netbox-community/netbox/issues/17424) - Extend ViewTab with a `visible` argument to control tab rendering * [#17857](https://github.com/netbox-community/netbox/issues/17857) - Added a `release_track` attribute to PluginConfig * [#18305](https://github.com/netbox-community/netbox/issues/18305) - Introduce plugin support for ContactsMixin * [#19073](https://github.com/netbox-community/netbox/issues/19073) - Allow installed plugins to be omitted from the plugins list ### Other Changes * [#18071](https://github.com/netbox-community/netbox/issues/18071) - Removed legacy staged changed functionality in favor of the [netbox-branching](https://github.com/netboxlabs/netbox-branching) plugin * [#18072](https://github.com/netbox-community/netbox/issues/18072) - Drop support for the singular `model` attribute on PluginTemplateExtension (use `models` instead) * [#18191](https://github.com/netbox-community/netbox/issues/18191) - Remove redundant PostgreSQL indexes * [#18236](https://github.com/netbox-community/netbox/issues/18236) - Upgrade the HTMX library to v2.0 * [#18540](https://github.com/netbox-community/netbox/issues/18540) - Operational plugins are now recorded in the application registry * [#18623](https://github.com/netbox-community/netbox/issues/18623) - Upgrade the Tabler CSS theme to v1.0 * [#18743](https://github.com/netbox-community/netbox/issues/18743) - Upgrade Django to v5.2 * [#18751](https://github.com/netbox-community/netbox/issues/18751) - Change the default value for `ALLOW_TOKEN_RETRIEVAL` to False * [#18808](https://github.com/netbox-community/netbox/issues/18808) - Squashed migration dependencies have been altered to rectify an issue with Django's `sqlmigrate` management command * [#18820](https://github.com/netbox-community/netbox/issues/18820) - PostgreSQL 13 is no longer supported * [#19004](https://github.com/netbox-community/netbox/issues/19004) - The use of inventory items has been deprecated in favor of modules. Inventory items and roles may be removed in a future NetBox release. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
adam added the pull-request label 2025-12-30 00:23:07 +01:00
adam closed this issue 2025-12-30 00:23:07 +01:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
beta
breaking change
complexity: high
complexity: low
complexity: medium
needs milestone
netbox
pending closure
plugin candidate
pull-request
Mirrored from GitHub Pull Request
 severity: high
severity: low
severity: medium
status: accepted
status: backlog
status: blocked
status: duplicate
status: needs owner
status: needs triage
status: revisions needed
status: under review
topic: GraphQL
topic: Internationalization
topic: OpenAPI
topic: UI/UX
topic: cabling
topic: event rules
topic: htmx navigation
topic: industrialization
topic: migrations
topic: plugins
topic: scripts
topic: templating
topic: testing
type: bug
type: deprecation
type: documentation
type: feature
type: housekeeping
type: translation
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#15635
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?