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 #13614] [MERGED] Release v3.6.0 #14222

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

📋 Pull Request Information

Original PR: https://github.com/netbox-community/netbox/pull/13614
Author: @jeremystretch
Created: 8/30/2023
Status: ✅ Merged
Merged: 8/30/2023
Merged by: @jeremystretch

Base: master ← Head: develop

📝 Commits (10+)

  • 02db0bc Closes #11766: Remove obsolete custom ChoiceField and MultipleChoiceField classes
  • 4208b79 Closes #12320: Remove obsolete fields napalm_driver and napalm_args from Platform
  • 2e2ff09 Merge branch 'develop' into feature
  • 4f76dcd 11305 Add GPS coordinates to device (#12782)
  • b4a3156 9077 audit alters_data=True
  • e635f0d Merge branch 'develop' into feature
  • e7edccd Merge branch 'develop' into feature
  • bace24b 12180 available objects api (#12935)
  • 518fd8c 12794 change User ref to get_user_model (#12905)
  • eff4a37 12175 rack with starting unit > 1 (#12778)

📊 Changes

587 files changed (+135239 additions, -5985 deletions)

View changed files

📝 .github/ISSUE_TEMPLATE/bug_report.yaml (+1 -1)
📝 .github/ISSUE_TEMPLATE/feature_request.yaml (+1 -1)
📝 base_requirements.txt (+3 -11)
📝 docs/administration/permissions.md (+6 -1)
📝 docs/administration/replicating-netbox.md (+1 -1)
📝 docs/configuration/plugins.md (+1 -1)
📝 docs/configuration/required-parameters.md (+1 -1)
📝 docs/configuration/security.md (+33 -1)
📝 docs/customization/custom-fields.md (+1 -1)
📝 docs/customization/custom-scripts.md (+1 -1)
📝 docs/development/application-registry.md (+4 -0)
➕ docs/development/internationalization.md (+123 -0)
📝 docs/features/configuration-rendering.md (+8 -2)
📝 docs/features/customization.md (+6 -0)
📝 docs/features/synchronized-data.md (+4 -2)
📝 docs/installation/1-postgresql.md (+3 -3)
📝 docs/installation/3-netbox.md (+16 -0)
📝 docs/installation/index.md (+1 -1)
📝 docs/installation/upgrading.md (+2 -2)
📝 docs/integrations/rest-api.md (+8 -11)

...and 80 more files

📄 Description

Breaking Changes

  • PostgreSQL 11 is no longer supported (dropped in Django 4.2). NetBox v3.6 requires PostgreSQL 12 or later.
  • The device_role field on the Device model has been renamed to role. The device_role field has been temporarily retained on the REST API serializer for devices for backward compatibility, but is read-only.
  • The choices array field has been removed from the CustomField model. Any defined choices are automatically migrated to CustomFieldChoiceSets, accessible via the new choice_set field on the CustomField model.
  • The napalm_driver and napalm_args fields (which were deprecated in v3.5) have been removed from the Platform model.
  • The device and device_id filter for interfaces will no longer include interfaces from virtual chassis peers. Two new filters, virtual_chassis_member and virtual_chassis_member_id, have been introduced to match all interfaces belonging to the specified device's virtual chassis (if any).
  • Reports and scripts are now returned within a results list when fetched via the REST API, consistent with other models.
  • Superusers can no longer retrieve API token keys via the web UI if ALLOW_TOKEN_RETRIEVAL is disabled. (The admin view has been removed per #13044.)

New Features

Relocated Admin UI Views (#12589, #12590, #12591, #13044)

Management views for the following object types, previously available only under the backend admin interface, have been relocated to the primary user interface:

  • Users
  • Groups
  • Object permissions
  • API tokens
  • Configuration revisions

This migration provides a more consistent user experience and unlocks advanced functionality not feasible using Django's built-in views. The admin UI is scheduled for complete removal in NetBox v4.0.

Configurable Default Permissions (#13038)

Administrators now have the option of configuring default permissions for all users globally, regardless of explicit permission or group assignments granted in the database. This is accomplished by defining the DEFAULT_PERMISSIONS configuration parameter. By default, all users are granted permission to manage their own bookmarks and API tokens.

User Bookmarks (#8248)

Users can now bookmark their favorite objects in NetBox. Bookmarks are accessible under each user's personal bookmarks list, and can also be added as a dashboard widget.

Custom Field Choice Sets (#12988)

Selection and multi-select custom fields now employ discrete, reusable choice sets containing the valid options for each field. A choice set may be shared by multiple custom fields. Additionally, each choice within a set can now specify both a raw value and a human-friendly label (see #13241). Pre-existing custom field choices are migrated to choice sets automatically during the upgrade process.

Pre-Defined Location Choices for Custom Fields (#12194)

Users now have the option to employ one of several pre-defined sets of choices when creating a custom field. These include:

  • IATA airport codes
  • ISO 3166 country codes
  • UN/LOCODE location identifiers

When defining a choice set, one of the above can be employed as the base set, with the option to define extra, custom choices as well.

Restrict Tag Usage by Object Type (#11541)

Tags may now be restricted to use with designated object types. Tags that have no specific object types assigned may be used with any object that supports tag assignment.

Enhancements

  • #6347 - Cache the number of assigned components for devices and virtual machines
  • #8137 - Add a field for designating the out-of-band (OOB) IP address for devices
  • #10197 - Cache the number of member devices on each virtual chassis
  • #11305 - Add GPS coordinate fields to the device model
  • #11478 - Introduce virtual_chassis_member filter for interfaces & restore default behavior for device filter
  • #11519 - Add a SQL index for IP address host values to optimize queries
  • #11732 - Prevent inadvertent overwriting of object attributes by competing users
  • #11936 - Introduce support for tags and custom fields on webhooks
  • #12175 - Permit racks to start numbering at values greater than one
  • #12210 - Add tenancy assignment for power feeds
  • #12461 - Add config template rendering for virtual machines
  • #12814 - Expose NetBox models within ConfigTemplate rendering context
  • #12882 - Add tag support for contact assignments
  • #13037 - Return reports & scripts within a results list when fetched via the REST API
  • #13170 - Add rf_role to InterfaceTemplate
  • #13269 - Cache the number of assigned component templates for device types

Bug Fixes

  • #13513 - Prevent exception when rendering bookmarks widget for anonymous user
  • #13599 - Fix errant counter increments when editing device/VM components
  • #13605 - Optimize cached counter migrations to avoid excessive memory consumption

Other Changes

  • Work has begun on introducing translation and localization support in NetBox. This work is being performed in preparation for release 4.0.
  • #6391 - Rename the device_role field on Device to role for consistency with VirtualMachine
  • #9077 - Prevent the errant execution of dangerous instance methods in Django templates
  • #11766 - Remove obsolete custom ChoiceField and MultipleChoiceField classes
  • #12180 - All API endpoints for available objects (e.g. IP addresses) now inherit from a common parent view
  • #12237 - Upgrade Django to v4.2
  • #12794 - Avoid direct imports of Django's stock user model
  • #12320 - Remove obsolete fields napalm_driver and napalm_args from Platform
  • #12964 - Drop support for PostgreSQL 11
  • #13309 - User account-specific resources have been moved to a new account app for better organization

🔄 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/13614 **Author:** [@jeremystretch](https://github.com/jeremystretch) **Created:** 8/30/2023 **Status:** ✅ Merged **Merged:** 8/30/2023 **Merged by:** [@jeremystretch](https://github.com/jeremystretch) **Base:** `master` ← **Head:** `develop` --- ### 📝 Commits (10+) - [`02db0bc`](https://github.com/netbox-community/netbox/commit/02db0bcc2e6b00e965a5efa2c346d9f863290957) Closes #11766: Remove obsolete custom ChoiceField and MultipleChoiceField classes - [`4208b79`](https://github.com/netbox-community/netbox/commit/4208b79514a022137144b6088750777999d55e17) Closes #12320: Remove obsolete fields napalm_driver and napalm_args from Platform - [`2e2ff09`](https://github.com/netbox-community/netbox/commit/2e2ff0982273446e18a76fab99117e47a2ba8124) Merge branch 'develop' into feature - [`4f76dcd`](https://github.com/netbox-community/netbox/commit/4f76dcd2ea856fa9411dbf287696501f59d6a6c1) 11305 Add GPS coordinates to device (#12782) - [`b4a3156`](https://github.com/netbox-community/netbox/commit/b4a315604610e9016fd0a5046782e4e81c1d0ba5) 9077 audit alters_data=True - [`e635f0d`](https://github.com/netbox-community/netbox/commit/e635f0defd2dfc52e171358058d331e3b8dedfef) Merge branch 'develop' into feature - [`e7edccd`](https://github.com/netbox-community/netbox/commit/e7edccd9bac921654da48ec5694c08fa4e0fec4d) Merge branch 'develop' into feature - [`bace24b`](https://github.com/netbox-community/netbox/commit/bace24b68e4f38456f275802e64a6b595c69e263) 12180 available objects api (#12935) - [`518fd8c`](https://github.com/netbox-community/netbox/commit/518fd8cca62db9c558dfc72a440c94c052448e82) 12794 change User ref to get_user_model (#12905) - [`eff4a37`](https://github.com/netbox-community/netbox/commit/eff4a3741c05b5d3fa6dc216f19c329291bbe23e) 12175 rack with starting unit > 1 (#12778) ### 📊 Changes **587 files changed** (+135239 additions, -5985 deletions) <details> <summary>View changed files</summary> 📝 `.github/ISSUE_TEMPLATE/bug_report.yaml` (+1 -1) 📝 `.github/ISSUE_TEMPLATE/feature_request.yaml` (+1 -1) 📝 `base_requirements.txt` (+3 -11) 📝 `docs/administration/permissions.md` (+6 -1) 📝 `docs/administration/replicating-netbox.md` (+1 -1) 📝 `docs/configuration/plugins.md` (+1 -1) 📝 `docs/configuration/required-parameters.md` (+1 -1) 📝 `docs/configuration/security.md` (+33 -1) 📝 `docs/customization/custom-fields.md` (+1 -1) 📝 `docs/customization/custom-scripts.md` (+1 -1) 📝 `docs/development/application-registry.md` (+4 -0) ➕ `docs/development/internationalization.md` (+123 -0) 📝 `docs/features/configuration-rendering.md` (+8 -2) 📝 `docs/features/customization.md` (+6 -0) 📝 `docs/features/synchronized-data.md` (+4 -2) 📝 `docs/installation/1-postgresql.md` (+3 -3) 📝 `docs/installation/3-netbox.md` (+16 -0) 📝 `docs/installation/index.md` (+1 -1) 📝 `docs/installation/upgrading.md` (+2 -2) 📝 `docs/integrations/rest-api.md` (+8 -11) _...and 80 more files_ </details> ### 📄 Description ### Breaking Changes * PostgreSQL 11 is no longer supported (dropped in Django 4.2). NetBox v3.6 requires PostgreSQL 12 or later. * The `device_role` field on the Device model has been renamed to `role`. The `device_role` field has been temporarily retained on the REST API serializer for devices for backward compatibility, but is read-only. * The `choices` array field has been removed from the CustomField model. Any defined choices are automatically migrated to CustomFieldChoiceSets, accessible via the new `choice_set` field on the CustomField model. * The `napalm_driver` and `napalm_args` fields (which were deprecated in v3.5) have been removed from the Platform model. * The `device` and `device_id` filter for interfaces will no longer include interfaces from virtual chassis peers. Two new filters, `virtual_chassis_member` and `virtual_chassis_member_id`, have been introduced to match all interfaces belonging to the specified device's virtual chassis (if any). * Reports and scripts are now returned within a `results` list when fetched via the REST API, consistent with other models. * Superusers can no longer retrieve API token keys via the web UI if [`ALLOW_TOKEN_RETRIEVAL`](https://docs.netbox.dev/en/stable/configuration/security/#allow_token_retrieval) is disabled. (The admin view has been removed per [#13044](https://github.com/netbox-community/netbox/issues/13044).) ### New Features #### Relocated Admin UI Views ([#12589](https://github.com/netbox-community/netbox/issues/12589), [#12590](https://github.com/netbox-community/netbox/issues/12590), [#12591](https://github.com/netbox-community/netbox/issues/12591), [#13044](https://github.com/netbox-community/netbox/issues/13044)) Management views for the following object types, previously available only under the backend admin interface, have been relocated to the primary user interface: * Users * Groups * Object permissions * API tokens * Configuration revisions This migration provides a more consistent user experience and unlocks advanced functionality not feasible using Django's built-in views. The admin UI is scheduled for complete removal in NetBox v4.0. #### Configurable Default Permissions ([#13038](https://github.com/netbox-community/netbox/issues/13038)) Administrators now have the option of configuring default permissions for _all_ users globally, regardless of explicit permission or group assignments granted in the database. This is accomplished by defining the `DEFAULT_PERMISSIONS` configuration parameter. By default, all users are granted permission to manage their own bookmarks and API tokens. #### User Bookmarks ([#8248](https://github.com/netbox-community/netbox/issues/8248)) Users can now bookmark their favorite objects in NetBox. Bookmarks are accessible under each user's personal bookmarks list, and can also be added as a dashboard widget. #### Custom Field Choice Sets ([#12988](https://github.com/netbox-community/netbox/issues/12988)) Selection and multi-select custom fields now employ discrete, reusable choice sets containing the valid options for each field. A choice set may be shared by multiple custom fields. Additionally, each choice within a set can now specify both a raw value and a human-friendly label (see [#13241](https://github.com/netbox-community/netbox/issues/13241)). Pre-existing custom field choices are migrated to choice sets automatically during the upgrade process. #### Pre-Defined Location Choices for Custom Fields ([#12194](https://github.com/netbox-community/netbox/issues/12194)) Users now have the option to employ one of several pre-defined sets of choices when creating a custom field. These include: * IATA airport codes * ISO 3166 country codes * UN/LOCODE location identifiers When defining a choice set, one of the above can be employed as the base set, with the option to define extra, custom choices as well. #### Restrict Tag Usage by Object Type ([#11541](https://github.com/netbox-community/netbox/issues/11541)) Tags may now be restricted to use with designated object types. Tags that have no specific object types assigned may be used with any object that supports tag assignment. ### Enhancements * [#6347](https://github.com/netbox-community/netbox/issues/6347) - Cache the number of assigned components for devices and virtual machines * [#8137](https://github.com/netbox-community/netbox/issues/8137) - Add a field for designating the out-of-band (OOB) IP address for devices * [#10197](https://github.com/netbox-community/netbox/issues/10197) - Cache the number of member devices on each virtual chassis * [#11305](https://github.com/netbox-community/netbox/issues/11305) - Add GPS coordinate fields to the device model * [#11478](https://github.com/netbox-community/netbox/issues/11478) - Introduce `virtual_chassis_member` filter for interfaces & restore default behavior for `device` filter * [#11519](https://github.com/netbox-community/netbox/issues/11519) - Add a SQL index for IP address host values to optimize queries * [#11732](https://github.com/netbox-community/netbox/issues/11732) - Prevent inadvertent overwriting of object attributes by competing users * [#11936](https://github.com/netbox-community/netbox/issues/11936) - Introduce support for tags and custom fields on webhooks * [#12175](https://github.com/netbox-community/netbox/issues/12175) - Permit racks to start numbering at values greater than one * [#12210](https://github.com/netbox-community/netbox/issues/12210) - Add tenancy assignment for power feeds * [#12461](https://github.com/netbox-community/netbox/issues/12461) - Add config template rendering for virtual machines * [#12814](https://github.com/netbox-community/netbox/issues/12814) - Expose NetBox models within ConfigTemplate rendering context * [#12882](https://github.com/netbox-community/netbox/issues/12882) - Add tag support for contact assignments * [#13037](https://github.com/netbox-community/netbox/issues/13037) - Return reports & scripts within a `results` list when fetched via the REST API * [#13170](https://github.com/netbox-community/netbox/issues/13170) - Add `rf_role` to InterfaceTemplate * [#13269](https://github.com/netbox-community/netbox/issues/13269) - Cache the number of assigned component templates for device types ### Bug Fixes * [#13513](https://github.com/netbox-community/netbox/issues/13513) - Prevent exception when rendering bookmarks widget for anonymous user * [#13599](https://github.com/netbox-community/netbox/issues/13599) - Fix errant counter increments when editing device/VM components * [#13605](https://github.com/netbox-community/netbox/issues/13605) - Optimize cached counter migrations to avoid excessive memory consumption ### Other Changes * Work has begun on introducing translation and localization support in NetBox. This work is being performed in preparation for release 4.0. * [#6391](https://github.com/netbox-community/netbox/issues/6391) - Rename the `device_role` field on Device to `role` for consistency with VirtualMachine * [#9077](https://github.com/netbox-community/netbox/issues/9077) - Prevent the errant execution of dangerous instance methods in Django templates * [#11766](https://github.com/netbox-community/netbox/issues/11766) - Remove obsolete custom `ChoiceField` and `MultipleChoiceField` classes * [#12180](https://github.com/netbox-community/netbox/issues/12180) - All API endpoints for available objects (e.g. IP addresses) now inherit from a common parent view * [#12237](https://github.com/netbox-community/netbox/issues/12237) - Upgrade Django to v4.2 * [#12794](https://github.com/netbox-community/netbox/issues/12794) - Avoid direct imports of Django's stock user model * [#12320](https://github.com/netbox-community/netbox/issues/12320) - Remove obsolete fields `napalm_driver` and `napalm_args` from Platform * [#12964](https://github.com/netbox-community/netbox/issues/12964) - Drop support for PostgreSQL 11 * [#13309](https://github.com/netbox-community/netbox/issues/13309) - User account-specific resources have been moved to a new `account` app for better organization --- <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-29 23:23:15 +01:00
adam closed this issue 2025-12-29 23:23:16 +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#14222
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?