Bot releases are hidden (Show)
Published by cimnine over 4 years ago
This is the first release that is compatible with Netbox Docker 2.7.x.
The Docker Images with the tags 2.7
, 2.7.0
, 2.7.1
and 2.7.2
have been updated on Docker Hub.
If you have not updated this project since January 2020, please be sure to also check the release notes for the previous version, 0.20.0
!
This release contains the following notable changes:
This project has been updated to work with Netbox 2.7.
Updates to our configuration.py
file were necessary. This should not impact you if you upgrade from an earlier version of our project. But you will have the possibility to use separate Redis instances for caching and for the rqworker (i.e. webhooks delivery). The current Redis variables are used for the rqworker (i.e. REDIS_HOST
, REDIS_PORT
, etc.) and there are new variables for the cache (i.e. REDIS_CACHE_HOST
, REDIS_CACHE_PORT
, etc.). If the variables REDIS_CACHE_*
are not defined the configuration file will fall back to the REDIS_*
counterparts.
Please note that it is no longer possible to run Netbox without Redis. The variable WEBHOOKS_ENABLED
was removed upstream.
Updates to the default startup scripts were necessary. If you have files in the initializers
directory, be aware of the following breaking changes:
initializers/custom_fields.yml
: (see c001626b85ba07bf2203faee16b09372fbe42ba6)
selection
type was changed to select
select_field:
- type: selection
+ type: select
label: Choose between items
required: false
filter_logic: exact
weight: 30
on_objects:
- dcim.models.Device
choices:
- value: First Item
weight: 10
- value: Second Item
weight: 20
initializers/racks.yml
(see 7b914d31d66f56bb9cf6ab8fbba131a23a6127a8)
- site: AMS 2
name: rack-02
role: Role 2
- type: 4-post cabinet
+ type: 4-post-cabinet
- width: 19 inches
+ width: 19
u_height: 47
custom_fields:
text_field: Description
initializers/devices.yml
(see 4a58676647e41115d5ecc10c4e9035ca73db53ee)
- name: server01
device_role: server
device_type: Other
site: AMS 1
rack: rack-01
- face: Front
+ face: front
position: 1
custom_fields:
text_field: Description
initializers/vlans.yml
(see 8d8b9a157e219ce3ed5944f8fd19ca668b4c6cb2)
- name: vlan1
site: AMS 1
- status: Active
+ status: active
vid: 5
role: Main Management
description: VLAN 5 for MGMT
initializers/prefixes.yml
(see f3403cd0f5a5c26e5aea9afed2e4d3a5a129a1b2)
- description: prefix1
prefix: 10.1.1.0/24
site: AMS 1
- status: Active
+ status: active
tenant: tenant1
vlan: vlan1
initializers/virtual_machines.yml
(see f3403cd0f5a5c26e5aea9afed2e4d3a5a129a1b2)
- cluster: cluster1
comments: VM1
disk: 200
memory: 4096
name: virtual machine 1
platform: Platform 2
- status: Active
+ status: active
tenant: tenant1
vcpus: 8
- cluster: cluster1
comments: VM2
disk: 100
memory: 2048
name: virtual machine 2
platform: Platform 2
initializers/dcim_interfaces.yml
dcim/choices.py
- device: server01
enabled: true
- type: Virtual
+ type: virtual
name: to-server02
initializers/ip_addresses.yml
- address: 10.1.1.1/24
device: server01
interface: to-server02
- status: Active
+ status: active
vrf: vrf1
We've changed our build system once more. It is based on Github Actions now. This provides us more flexibility and hopefully more reliable feedback on pull requests.
Our users should benefit as well by having more reliable releases when a new version of Netbox is out.
The last benefit is that all build-related configurations are now in this repository. This means we can track changes and retrieve pull-requests on them. Additionally, forks get the same build-configuration as well.
release
We have switched to a new branching model in the previous version of this project.
Thereby we changed the default branch to be the develop
branch. This has led to some confusion. We are now changing the default branch back to the stable branch, i.e. release
.
This is also due to the new build system (see above).
This version is compatible with Netbox 2.7.x (and hopefully later versions as well).
⚠️ This version is not compatible with Netbox 2.6.x or lower!
There are no known issues.
Published by cimnine almost 5 years ago
This release contains the following notable changes:
We have switched the branching model of this repository. What was the master
branch will become the release
branch. There is a new develop
branch already.
This new branching model and the reasons for the change are documented in our wiki.
If you want to update your local docker-compose scripts, this means you have to checkout the new branch:
git fetch --prune
git checkout -b release --track origin/release
The Netbox Docker image was enhanced to be compatible with setups that require the container to be run as non-root user. This was suggested originally by @Furragen in #172 and was implemented in #186.
The changes to the image are kept to a minimum. You can now run the netbox
and netbox-worker
containers by defining an uid, e.g. 101
. The way Linux works is that this user does not have to exist, so we don't actually create it.
All files created with this new image will be created using umask 002
.
If you have read-write-enabled mounts (e.g. for the media folder of Netbox), make sure that they are group-writable for root. The same is valid for the static filed folder.
The simplest way to do this is by deleting the volume:
docker-compose stop netbox
docker volume rm netbox-docker_netbox-static-files
docker-compose up -d netbox
(If your project folder is not called netbox-docker
, use the following command to figure out the name of the volume to delete: docker volume ls | grep netbox-static-files
).
Our docker-compose file was updated to use PostgreSQL 11.
If you have experience with running Netbox with PostgreSQL 12, please open an issue.
We'd love to upgrade!
Also note that you will need to take manual action after you upgrade a live PostgreSQL database.
If your database is not too big, a full backup (with PostgreSQL 10) and restore (with a clean PostgreSQL 11) is probably the easiest to achieve. Our troubleshooting wiki page has instructions on how to backup and restore a Netbox database. Please test the procedure on a test system first!
Note that there is no requirement to update to PostgreSQL 11, you can stick to version 10 just fine. You could do this with a docker-compose.override.yml
like so:
version: '3.4'
services:
postgres:
image: postgres:10-alpine
Our docker-compose file was updated to use Redis 5.
It was possible to change the way the startup_scripts are executed. Initializers are startup_scripts as well, and they ship by default.
Before it used to take minutes to run through all the startup_scripts, now it's a matter of seconds.
There's almost no reason anymore to disable the execution of startup_scripts ;)
A contribution by @sdktr enables the use of TLS when connection to a PostgreSQL database. TLS is often required if you use this image on cloud platforms. The default mode is set to prefer
, which means that if TLS is available, Netbox will use it. Else it will fall-back to the unencrypted connection.
Most of our documentation was removed from the README.md
file, which has grown quite a bit.
That file now only contains the bare-minimum to get started with Netbox Docker.
Everything else, especially the troubleshooting section, are now in our wiki.
There have been a bunch of other maintenance tasks. See milestone 0.20.0 for a list of issues that are related to this release.
This version is compatible with Netbox 2.6.x, and probably earlier.
⚠️ This version does not work with Netbox 2.7.x! This is planned for the next version, 0.21.0.
It seems that are labels are not correctly applied when we build our image on Docker Hub. See #210 .
Published by cimnine almost 5 years ago
This release contains the following changes:
The Docker image will contain more labels. The labels follow label-schema.org and the OpenContainer image spec, section annotations, specifications.
This provides more information for debugging problems and allows MicroBadger to extract information from the Docker image.
This repository now also displays some status badges in the README:
@markhoney shared how he customizes the docker-compose.yml
file: He creates a docker-compose.override.yml
file, an official docker-compose feature. He also submitted a PR that adds that file to the .gitignore
file. Thank you!
@edenpark59 suggested to update Nginx to a more recent version and submitted a PR. Thank you!
SKIP_GIT
#191@mattolenik reported that the SKIP_GIT
environment variable of the build.sh
script has no effect and submitted a PR to fix that. Thank you!
There are no known issues.
Published by tobiasge almost 5 years ago
This release is a bugfix release for #179. Thanks to @ananace for reporting this first.
There are no known issues.
Published by cimnine almost 5 years ago
This release is a bugfix release for #170. Thanks to @fdebonneval for reporting this first and to @tobiasge for providing a fix.
There are no known issues.
Published by cimnine about 5 years ago
This release contains two changes:
See also 0.19.1, because it contains some important changes.
There are no known issues.
Published by cimnine about 5 years ago
This is a huge release that changes completely how this image is built:
✅ If you just use the image to run Netbox, nothing should notably change for you.
✅ If you extend the image for your own purposes, nothing should change for your either.
⚠️ If you built the image yourself, you will either have to use ./build.sh
or maintain your own Netbox clone. See the wiki page on building the Netbox Docker image.
There are no known issues.
Published by cimnine about 5 years ago
This release is a bugfix release to address #165.
See also the release notes from 0.18.0.
There are no known issues.
As always, it will take some time for the Docker images to appear on Docker Hub. Existing Docker Images tagged with v2.6.6
(or older) will not be updated. v2.6
will only be updated if a new version v2.6.7
(or later) of Netbox is released.
The PRs #159 and #164 are on the horizon, in which the Dockerfile is reworked. Any input on the PRs is appreciated.
Published by cimnine about 5 years ago
This release includes the following changes:
See also the release notes from 0.18.0.
There are no known issues.
As always, it will take some time for the Docker images to appear on Docker Hub. Existing Docker Images tagged with v2.6.6
(or older) will not be updated. v2.6
will only be updated if a new version v2.6.7
(or later) of Netbox is released.
There is PR #159 in which the Dockerfile is reworked. Any input on the PR is appreciated.
Published by cimnine about 5 years ago
This release includes the following changes:
The following issues are known and confirmed:
As always, it will take some time for the Docker images to appear on Docker Hub. Existing Docker Images tagged with v2.6.5
(or older) will not be updated. v2.6
will only be updated if a new version v2.6.6
(or later) of Netbox is released.
There is PR #159 in which the Dockerfile is reworked. Any input on the PR is appreciated.
Published by cimnine about 5 years ago
This release includes the following changes:
AttributeError: module 'ruamel.yaml' has no attribute 'SafeDumper'
by @takumin (in #149)At the time of writing there are no known issues.
As always, it will take some time for the Docker images to appear on Docker Hub. Existing Docker Images tagged with v2.6.1
(or older) will not be updated. v2.6
will only be updated if a new version v2.6.2
(or later) of Netbox is released.
Published by cimnine about 5 years ago
This release includes the following changes:
python:3.7-alpine3.10
by @tobiasge (#144)At the time of writing there are no known issues.
As always, it will take some time for the Docker images to appear on Docker Hub. Existing version tags before and including v2.6.1
will not be updated. v2.6
will only be updated if a new version v2.6.2
(or later) of Netbox is released.
This release reflects the fact that Netbox has grow up and moved out. The project's URL has changed from https://github.com/digitalocean/netbox to https://github.com/netbox-community/netbox.
At this point I would like to express my gratitude to Digitalocean for making Netbox opensource and sponsoring a huge part of it's development.
This release also includes a fix by @miso231, see #142. Thank you for your contribution!
At the time of writing there are no known issues.
As always, it will take some time for the Docker images to appear on Docker Hub. Existing version tags before and including v2.6.1
will not be updated. v2.6
will only be updated if a new version v2.6.2
(or later) of Netbox is released.
As there are no changes to the way the container works, this does not actually matter in this release.
Published by cimnine over 5 years ago
This release contains changes required to work with Netbox v2.6.0.
There are also breaking changes, as the configuration file was updated to match the latest version from Netbox.
Also, at the time of this release, there is a known issue in Netbox that prevents netbox-docker:2.6.0
to start properly. A fix has already been merged an will be released with Netbox v2.6.1
.
The configuration/configuration.py
file has been updated to match the file from Netbox.
CORS_ORIGIN_WHITELIST
has a new default value of http://localhost
.
To provide a nice development environment, CORS_ORIGIN_ALLOW_ALL
added to env/netbox.env
with a default value of True
.
There are also new options:
REDIS_CACHE_DATABASE
CACHE_TIMEOUT
(set to 0 to disable caching)CHANGELOG_RETENTION
CORS_ORIGIN_REGEX_WHITELIST
(space separated list of regular expressions)EXEMPT_VIEW_PERMISSIONS
(space separated list)METRICS_ENABLED
As always, it will take some time for the Docker images to appear on Docker Hub. Existing version tags before and including v2.6.0
will not be updated. v2.6
will only be updated if a new version v2.6.1
(or later) of Netbox is released.
Published by cimnine over 5 years ago
Features:
AUTH_LDAP_GROUP_TYPE
. Thanks @mryauch, see #135.As always, it will take some time for the Docker images to appear on Docker Hub. Existing version tags before and including v2.5.13
will not be updated. 2.5
will only be updated if a new version v2.5.14
(or later) of Netbox is released.
Published by cimnine over 5 years ago
Netbox recently upgraded to Django 2.2. To speed up the build this dependency is hardcoded in our Dockerfile
. This releases addresses this incompatibility.
Published by cimnine over 5 years ago
This release allows to extract the AUTH_LDAP_BIND_PASSWORD
into the secrets file /run/secrets/auth_ldap_bind_password
. Thanks go out to @mryauch for the PR #133.
Please not that version 0.12.0 was released earlier today. It added support for securing your Redis connection with TLS by exporting the environment variable REDIS_SSL
.
Published by cimnine over 5 years ago
This release adds support to secure the connection to your Redis with TLS. Support for this was added in Netbox 2.5.9. Thanks go out to @ajknv for the PR #129.
Published by cimnine over 5 years ago
This release features two PRs:
MAJOR.MINOR
releases, i.e. v2.5.8
will also be tagged as v2.5
, starting with the next release of Netbox.Published by cimnine over 5 years ago
This release contains a new feature contributed by @tobiasge in #128:
To speed up the startup time of netbox-docker
it is possible to disable the execution of the startup scripts.
As documented, a new environment variable SKIP_STARTUP_SCRIPTS
was introduced. If the variable is set to true
, netbox-docker
will not run the startup scripts.
To enable this new behaviour, you could add the following line to the netbox.env
file:
SKIP_STARTUP_SCRIPTS=true