netbox-docker

Upgrade Django #123 according to Netbox.

Upgrade to Alpine Linux 3.9 #126

This release features an example about how custom reports are integrated with netbox-docker. This was contributed by @bdlamprecht and is documented in the README.md

Additionally, in this release the value of the MAX_PAGE_SIZE variable was changed to 1000, which reflects netbox's default. @tyler-8 suggested this, and @TakeMeNL implemented it.

Thanks to all the contributors and users!

While you're here: We also have a Slack Channel on the networktocode Slack.

There are now a lot more initializers that are already implemented. Find examples for each of them in the initializers folder. Thanks to @aradunovic for implementing them!

netbox-docker builds containing these improvements will appear soon on Docker Hub. Images targeting a specific version of Netbox are not rebuilt however. You will need to wait on the next Netbox release in order to get them, or build them yourself.

The initializers for users and groups now support a permissions array. Examples:

# initializers/groups.yml
a-group-called-writer:
  users:
  - a-user-called-writer
  permissions:
  - add_device
  - change_device
  - delete_device
  - add_virtualmachine
  - change_virtualmachine
  - delete_virtualmachine

# initializers/users.yml
a-user-called-writer:
  password: writer
  permissions:
  - add_device
  - change_device
  - delete_device
  - add_virtualmachine
  - change_virtualmachine
  - delete_virtualmachine

Get a list of all available permissions:

echo "from django.contrib.auth.models import Permission\nfor p in Permission.objects.all():\n  print(p.codename);" | docker-compose exec -T netbox ./manage.py shell

Thanks to @bdlamprecht for the research that made this improvement possible.

• Alpine was updated to 3.8
• All the .env files have been moved into an /env folder.

From the Breaking Changes section of the README.md:

In order to use Netbox webhooks you need to add Redis and a netbox-worker to your docker-compose.yml.

Also, make sure you delete the netbox-nginx-config volume, or your nginx might get stuck.

# Stop your local netbox-docker installation
$ docker-compose down

# Find the volume
$ docker volume ls | grep netbox-nginx-config
local               netbox-docker_netbox-nginx-config

# Remove the volume
$ docker volume rm netbox-docker_netbox-nginx-config
netbox-docker_netbox-nginx-config

These changes were applied to images tagged with v2.4.3 and up. Here's how you can check if your affected by these changes:

$ docker inspect ninech/netbox:v2.4.3 --format "{{json .ContainerConfig.Labels}}"
{"NETBOX_DOCKER_PROJECT_VERSION":"0.4.0","SRC_URL":"https://github.com/digitalocean/netbox/archive/v2.4.3.tar.gz"}

If the NETBOX_DOCKER_PROJECT_VERSION says 0.4.0, you're affected.