Instalação NetBox · 16 min read · Oct 22, 2025
Como Instalar a Ferramenta de Documentação e Gerenciamento de Rede NetBox no Ubuntu 22.04
NetBox é um aplicativo web de gerenciamento de endereços IP (IPAM) e infraestrutura de datacenter (DCIM) de código aberto usado para gerenciar e documentar redes de computadores e endereços IP. A equipe de engenharia de rede da DigitalOcean o concebeu inicialmente. É escrito usando o framework Django Python e usa o banco de dados PostgreSQL para armazenamento de dados. Também usa o banco de dados Redis para cache de consultas.
Este tutorial ensinará como instalar a ferramenta NetBox em um servidor Ubuntu 22.04 e Nginx como um servidor proxy reverso.
Pré-requisitos
- Um servidor rodando Ubuntu 22.04.
- Um usuário não-root com privilégios sudo.
- Um nome de domínio totalmente qualificado (FQDN) como
netbox.example.com. - Certifique-se de que tudo esteja atualizado.
$ sudo apt update $ sudo apt upgrade - Alguns pacotes que seu sistema precisa.
$ sudo apt install wget curl nano software-properties-common dirmngr apt-transport-https gnupg2 ca-certificates lsb-release ubuntu-keyring unzip -yAlguns desses pacotes podem já estar instalados em seu sistema.
Passo 1 - Configurar o Firewall
O primeiro passo é configurar o firewall. O Ubuntu vem com ufw (Uncomplicated Firewall) por padrão.
Verifique se o firewall está em execução.
$ sudo ufw status
Você deve obter a seguinte saída.
Status: inactive
Permita a porta SSH para que o firewall não interrompa a conexão atual ao ativá-lo.
$ sudo ufw allow OpenSSH
Permita também as portas HTTP e HTTPS.
$ sudo ufw allow http
$ sudo ufw allow https
Ative o Firewall
$ sudo ufw enable
Comando pode interromper conexões ssh existentes. Prosseguir com a operação (y|n)? y
Firewall está ativo e habilitado na inicialização do sistema
Verifique o status do firewall novamente.
$ sudo ufw status
Você deve ver uma saída semelhante.
Status: active
Para Ação De
-- ------ ----
OpenSSH ALLOW Anywhere
80/tcp ALLOW Anywhere
443 ALLOW Anywhere
OpenSSH (v6) ALLOW Anywhere (v6)
80/tcp (v6) ALLOW Anywhere (v6)
443 (v6) ALLOW Anywhere (v6)
Passo 2 - Instalar e Configurar o PostgreSQL
O NetBox funciona com PostgreSQL 11 e superior. O Ubuntu 22.04 vem com PostgreSQL 14 por padrão. Usaremos o PostgreSQL 15 para nosso tutorial.
Execute o seguinte comando para adicionar a chave GPG do PostgreSQL.
$ curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | sudo tee /usr/share/keyrings/postgresql-key.gpg >/dev/null
Adicione o repositório APT à sua lista de fontes.
$ sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/postgresql-key.gpg arch=amd64] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
Atualize o repositório do sistema.
$ sudo apt update
Agora, você pode instalar o PostgreSQL usando o comando abaixo.
$ sudo apt install postgresql postgresql-contrib
O pacote postgresql-contrib contém algumas utilidades extras.
Verifique o status do serviço PostgreSQL.
$ sudo systemctl status postgresql
? postgresql.service - PostgreSQL RDBMS
Loaded: loaded (/lib/systemd/system/postgresql.service; enabled; vendor preset: enabled)
Active: active (exited) since Tue 2022-11-27 9:10:35 UTC; 5s ago
Process: 30544 ExecStart=/bin/true (code=exited, status=0/SUCCESS)
Main PID: 30544 (code=exited, status=0/SUCCESS)
CPU: 2ms
Dec 27 9:10:35 netbox systemd[1]: Starting PostgreSQL RDBMS...
Dec 27 9:10:35 netbox systemd[1]: Finished PostgreSQL RDBMS.
Você pode ver que o serviço está habilitado e em execução por padrão.
Inicie o shell do PostgreSQL.
$ sudo -i -u postgres psql
Crie o banco de dados NetBox.
postgres=# CREATE DATABASE netbox;
Crie o usuário NetBox e escolha uma senha forte.
postgres-# CREATE USER netbox WITH PASSWORD 'Your_Password';
Altere o proprietário do banco de dados para o usuário NetBox.
postgres-# ALTER DATABASE netbox OWNER TO netbox;
Saia do shell.
postgres-# \q
Verifique se suas credenciais funcionam.
$ psql --username netbox --password --host localhost netbox
Senha para o usuário netbox:
psql (15.1 (Ubuntu 15.1-1.pgdg22.04+1))
Conexão SSL (protocolo: TLSv1.3, cifra: TLS_AES_256_GCM_SHA384, bits: 256, compressão: off)
Digite "help" para ajuda.
netbox=>
Saia do shell digitando \q.
Passo 3 - Instalar e Configurar o Redis
O Ubuntu vem com o Redis 6.0.16. Para nosso tutorial, instalaremos a versão mais recente do repositório oficial.
Importe a chave GPG oficial do Redis.
$ curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
Adicione o repositório APT à sua lista de fontes.
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
Atualize a lista de repositórios do sistema.
$ sudo apt update
Emita o seguinte comando para instalar o servidor Redis.
$ sudo apt install redis
Confirme a versão do Redis.
$ redis-server -v
Servidor Redis v=7.0.7 sha=00000000:0 malloc=jemalloc-5.2.1 bits=64 build=2260280010e18db8
Vamos verificar a conexão do serviço usando o seguinte comando.
$ redis-cli
Você será transferido para o shell do Redis.
O primeiro passo é definir a senha para o usuário padrão do Redis. Substitua Your_Redis_Password por uma senha forte de sua escolha.
127.0.0.1:6379> acl setuser default >Your_Redis_Password
Teste a autenticação do Redis.
127.0.0.1:6379> AUTH Your_Redis_Password
OK
Pingue o serviço.
127.0.0.1:6379> ping
PONG
Saia do serviço digitando exit.
Passo 4 - Baixar o NetBox
O NetBox requer Python Django para funcionar. O primeiro passo na instalação do NetBox é instalar os pacotes Python necessários. Execute o seguinte comando para instalar os pacotes Python necessários.
$ sudo apt install -y python3 python3-pip python3-venv python3-dev build-essential libxml2-dev libxslt1-dev libffi-dev libpq-dev libssl-dev zlib1g-dev
Verifique a versão do Python.
$ python3 -V
Python 3.10.6
Crie o diretório base para a instalação do NetBox.
$ sudo mkdir -p /opt/netbox/
Mude para o diretório.
$ cd /opt/netbox
Clone o branch master do repositório do GitHub do NetBox para o diretório atual.
$ sudo git clone -b master --depth 1 https://github.com/netbox-community/netbox.git .
A flag --depth 1 recupera apenas o commit mais recente do repositório. Se você quiser baixar todo o histórico de commits, pode omitir a flag.
Verifique a versão mais recente do NetBox na página de lançamentos e faça o checkout usando o Git. No momento da redação deste tutorial, 3.4.1 é a versão mais recente disponível.
$ git config --global --add safe.directory /opt/netbox
$ sudo git checkout v3.4.1
Antes de fazer o checkout, você precisa adicionar o diretório à lista de diretórios seguros do Git. Este é um novo recurso de segurança disponível nas versões recentes do Git.
O próximo passo é criar um usuário e grupo do sistema para o NetBox.
$ sudo adduser --system --group netbox
Dê permissão ao usuário no diretório de mídia do NetBox.
$ sudo chown --recursive netbox /opt/netbox/netbox/media/
Passo 5 - Configurar o NetBox
Mude para o diretório de configuração do NetBox.
$ cd /opt/netbox/netbox/netbox/
Copie o arquivo de configuração de exemplo para criar o arquivo real.
$ sudo cp configuration_example.py configuration.py
Antes de prosseguir com a configuração, precisamos criar uma chave secreta para o NetBox. Anote a chave porque precisamos dela para a configuração.
$ python3 ../generate_secret_key.py
dSSWi$Ar2cVvu1)V!B82sY1tJAQK9r)vzM8ReQRF7@C^+$=1+(
Abra o arquivo de configuração para edição.
$ sudo nano configuration.py
Encontre a variável ALLOWED_HOSTS e defina seus valores da seguinte forma. Esta variável contém uma lista dos nomes de host e endereços IP válidos pelos quais este servidor pode ser alcançado.
ALLOWED_HOSTS = ['netbox.example.com', '']
O próximo passo é editar os detalhes do banco de dados. Configure os detalhes do banco de dados da seguinte forma.
DATABASE = {
'NAME': 'netbox', # Nome do banco de dados
'USER': 'netbox', # Nome de usuário do PostgreSQL
'PASSWORD': 'Your_Password', # Senha do PostgreSQL
'HOST': 'localhost', # Servidor do banco de dados
'PORT': '', # Porta do banco de dados (deixe em branco para padrão)
'CONN_MAX_AGE': 300, # Idade máxima da conexão com o banco de dados
}
Configure a configuração do Redis como mostrado. Insira a senha do Redis que você definiu no passo 3.
REDIS = {
'tasks': {
'HOST': 'localhost',
'PORT': 6379,
# Comente as linhas `HOST` e `PORT` e descomente as seguintes se usar Redis Sentinel
# 'SENTINELS': [('mysentinel.redis.example.com', 6379)],
# 'SENTINEL_SERVICE': 'netbox',
'PASSWORD': 'Your_Redis_Password',
'DATABASE': 0,
'SSL': False,
# Defina isso como True para ignorar a verificação do certificado TLS
# Isso pode expor a conexão a ataques, tenha cuidado
# 'INSECURE_SKIP_TLS_VERIFY': False,
},
'caching': {
'HOST': 'localhost',
'PORT': 6379,
# Comente as linhas `HOST` e `PORT` e descomente as seguintes se usar Redis Sentinel
# 'SENTINELS': [('mysentinel.redis.example.com', 6379)],
# 'SENTINEL_SERVICE': 'netbox',
'PASSWORD': 'Your_Redis_Password',
'DATABASE': 1,
'SSL': False,
# Defina isso como True para ignorar a verificação do certificado TLS
# Isso pode expor a conexão a ataques, tenha cuidado
# 'INSECURE_SKIP_TLS_VERIFY': False,
}
}
Adicione o valor da chave secreta à variável.
SECRET_KEY = 'dSSWi$Ar2cVvu1)V!B82sY1tJAQK9r)vzM8ReQRF7@C^+$=1+('
Por padrão, o NetBox usa o sistema de arquivos local para armazenar arquivos enviados. Você pode armazenar arquivos em um sistema de arquivos remoto instalando a biblioteca django-storages. Execute o seguinte comando para adicionar o pacote django-storages ao requirements.txt do NetBox, que será instalado em um passo posterior. Também precisamos configurar os parâmetros de armazenamento. Descomente a seção de armazenamento do arquivo de configuração e prossiga da seguinte forma.
STORAGE_BACKEND = 'storages.backends.s3boto3.S3Boto3Storage'
STORAGE_CONFIG = {
'AWS_ACCESS_KEY_ID': 'Key ID',
'AWS_SECRET_ACCESS_KEY': 'Secret',
'AWS_STORAGE_BUCKET_NAME': 'netbox',
'AWS_S3_REGION_NAME': 'eu-west-1',
}
Outros tipos de armazenamento também são suportados, incluindo FTP, SFTP, Dropbox e outros provedores S3. Para aprender como configurá-los, você pode ler a página de ajuda do django-storages.
Salve o arquivo pressionando Ctrl + X e digitando Y quando solicitado.
Passo 6 - Instalar o NetBox
Execute o script de atualização do NetBox.
$ sudo /opt/netbox/upgrade.sh
O script de atualização realiza as seguintes tarefas.
- Cria um ambiente virtual Python
- Instala todos os pacotes Python necessários
- Executa migrações de esquema do banco de dados
- Compila a documentação localmente (para uso offline)
- Agrega arquivos de recursos estáticos no disco
Ative o ambiente virtual criado pelo script de atualização.
$ source /opt/netbox/venv/bin/activate
O próximo passo é criar um superusuário para acessar o NetBox. Mas primeiro, mude para o diretório necessário.
(venv) $ cd /opt/netbox/netbox
Crie o superusuário.
(venv) $ python3 manage.py createsuperuser
Você receberá a seguinte saída.
Nome de usuário (deixe em branco para usar 'navjot'):
Endereço de e-mail: [email protected]
Senha:
Senha (novamente):
Superusuário criado com sucesso.
O NetBox inclui um comando de gerenciamento housekeeping que lida com tarefas de limpeza recorrentes, como limpar sessões antigas e registros de alterações expirados. Você pode executar o comando manualmente ou usar o cron para executá-lo em intervalos regulares. O NetBox fornece um script shell para executar as tarefas de limpeza. Execute o seguinte comando para criar um link simbólico para o script no diretório diário do Cron. Isso garantirá que o comando será executado diariamente.
(venv) $ sudo ln -s /opt/netbox/contrib/netbox-housekeeping.sh /etc/cron.daily/netbox-housekeeping
O passo final é testar se o aplicativo NetBox funciona. Mas primeiro, precisamos abrir a porta 8000 para testes. Você pode usar qualquer porta.
(venv) $ sudo ufw allow 8000
Inicie uma instância de desenvolvimento do NetBox.
(venv) $ python3 manage.py runserver 0.0.0.0:8000 --insecure
Se bem-sucedido, você receberá a seguinte saída.
Realizando verificações do sistema...
Verificação do sistema não identificou problemas (0 silenciados).
27 de dezembro de 2022 - 09:27:37
Versão do Django 4.1.4, usando configurações 'netbox.settings'
Iniciando servidor de desenvolvimento em http://0.0.0.0:8000/
Saia do servidor com CONTROL-C.
Você deve conseguir acessar o NetBox através da URL http://. Você verá a seguinte tela.
Clique no botão Log In para abrir a página de login e insira as credenciais do superusuário criadas anteriormente.
Você será levado de volta ao painel do NetBox.
Pressione a tecla Ctrl + C para parar o servidor. Desative o ambiente virtual Python.
(venv) $ deactivate
Passo 7 - Configurar o Gunicorn e Criar um Arquivo de Serviço
O NetBox é executado como uma aplicação WSGI atrás de um servidor HTTP. O NetBox instala automaticamente o servidor Gunicorn. Neste passo, configuraremos o Gunicorn e criaremos um arquivo de serviço para o NetBox para que ele possa ser executado em segundo plano e em reinicializações do sistema.
O NetBox vem com um arquivo de configuração padrão do Gunicorn. Crie uma cópia dele.
$ sudo cp /opt/netbox/contrib/gunicorn.py /opt/netbox/gunicorn.py
A configuração padrão deve ser suficiente para nossos propósitos. Dependendo de suas necessidades, você pode editar o arquivo para alterar o nome do host, o número da porta ou fazer melhorias de desempenho alterando threads, workers e o número de solicitações.
O próximo passo é copiar os arquivos de serviço do NetBox e do Gunicorn para o diretório /etc/systemd/system.
$ sudo cp -v /opt/netbox/contrib/*.service /etc/systemd/system/
Recarregue o daemon de serviços.
$ sudo systemctl daemon-reload
Inicie e habilite os serviços netbox e netbox-rq.
$ sudo systemctl start netbox netbox-rq
$ sudo systemctl enable netbox netbox-rq
Verifique o status do serviço WSGI.
$ sudo systemctl status netbox
Você receberá uma saída semelhante.
? netbox.service - NetBox WSGI Service
Loaded: loaded (/etc/systemd/system/netbox.service; enabled; vendor preset: enabled)
Active: active (running) since Tue 2022-12-27 09:28:23 UTC; 17s ago
Docs: https://docs.netbox.dev/
Main PID: 4180 (gunicorn)
Tasks: 6 (limit: 1030)
Memory: 357.9M
CPU: 7.747s
CGroup: /system.slice/netbox.service
??4180 /opt/netbox/venv/bin/python3 /opt/netbox/venv/bin/gunicorn --pid /var/tmp/netbox.pid --pythonpath /opt/netbox/netbox --config /opt/netbox/gunicorn.py netbox.wsgi
??4181 /opt/netbox/venv/bin/python3 /opt/netbox/venv/bin/gunicorn --pid /var/tmp/netbox.pid --pythonpath /opt/netbox/netbox --config /opt/netbox/gunicorn.py netbox.wsgi
??4182 /opt/netbox/venv/bin/python3 /opt/netbox/venv/bin/gunicorn --pid /var/tmp/netbox.pid --pythonpath /opt/netbox/netbox --config /opt/netbox/gunicorn.py netbox.wsgi
??4183 /opt/netbox/venv/bin/python3 /opt/netbox/venv/bin/gunicorn --pid /var/tmp/netbox.pid --pythonpath /opt/netbox/netbox --config /opt/netbox/gunicorn.py netbox.wsgi
??4184 /opt/netbox/venv/bin/python3 /opt/netbox/venv/bin/gunicorn --pid /var/tmp/netbox.pid --pythonpath /opt/netbox/netbox --config /opt/netbox/gunicorn.py netbox.wsgi
??4185 /opt/netbox/venv/bin/python3 /opt/netbox/venv/bin/gunicorn --pid /var/tmp/netbox.pid --pythonpath /opt/netbox/netbox --config /opt/netbox/gunicorn.py netbox.wsgi
Dec 27 09:28:23 netbox systemd[1]: Started NetBox WSGI Service.
Dec 27 09:28:24 netbox gunicorn[4180]: [2022-12-27 09:28:24 +0000] [4180] [INFO] Starting gunicorn 20.1.0
Dec 27 09:28:24 netbox gunicorn[4180]: [2022-12-27 09:28:24 +0000] [4180] [INFO] Listening at: http://127.0.0.1:8001 (4180)
Dec 27 09:28:24 netbox gunicorn[4180]: [2022-12-27 09:28:24 +0000] [4180] [INFO] Using worker: gthread
Dec 27 09:28:24 netbox gunicorn[4181]: [2022-12-27 09:28:24 +0000] [4181] [INFO] Booting worker with pid: 4181
Dec 27 09:28:24 netbox gunicorn[4182]: [2022-12-27 09:28:24 +0000] [4182] [INFO] Booting worker with pid: 4182
Dec 27 09:28:24 netbox gunicorn[4183]: [2022-12-27 09:28:24 +0000] [4183] [INFO] Booting worker with pid: 4183
Dec 27 09:28:24 netbox gunicorn[4184]: [2022-12-27 09:28:24 +0000] [4184] [INFO] Booting worker with pid: 4184
Dec 27 09:28:24 netbox gunicorn[4185]: [2022-12-27 09:28:24 +0000] [4185] [INFO] Booting worker with pid: 4185
Como você pode ver, o Gunicorn escuta na porta 8001 por padrão. Esta informação será útil ao configurar o Nginx como um servidor proxy reverso.
Passo 8 - Instalar o Nginx
O Ubuntu 22.04 vem com uma versão mais antiga do Nginx. Para instalar a versão mais recente, você precisa baixar o repositório oficial do Nginx.
Importe a chave de assinatura do Nginx.
$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
Adicione o repositório para a versão estável do Nginx.
$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg arch=amd64] \
http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
Atualize os repositórios do sistema.
$ sudo apt update
Instale o Nginx.
$ sudo apt install nginx
Verifique a instalação.
$ nginx -v
versão do nginx: nginx/1.22.1
Inicie o servidor Nginx.
$ sudo systemctl start nginx
Passo 9 - Instalar SSL
Precisamos instalar o Certbot para gerar o certificado SSL. Você pode instalar o Certbot usando o repositório do Ubuntu ou pegar a versão mais recente usando a ferramenta Snapd. Usaremos a versão Snapd.
O Ubuntu 22.04 vem com o Snapd instalado por padrão. Execute os seguintes comandos para garantir que sua versão do Snapd esteja atualizada. Certifique-se de que sua versão do Snapd esteja atualizada.
$ sudo snap install core
$ sudo snap refresh core
Instale o Certbot.
$ sudo snap install --classic certbot
Use o seguinte comando para garantir que o comando Certbot seja executado criando um link simbólico para o diretório /usr/bin.
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot
Execute o seguinte comando para gerar um Certificado SSL.
$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m [email protected] -d netbox.example.com
O comando acima fará o download de um certificado para o diretório /etc/letsencrypt/live/netbox.example.com em seu servidor.
Gere um certificado de grupo Diffie-Hellman.
$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096
Para verificar se a renovação do SSL está funcionando bem, faça um teste do processo.
$ sudo certbot renew --dry-run
Se você não ver erros, está tudo pronto. Seu certificado será renovado automaticamente.
Passo 10 - Configurar o Nginx
Abra o arquivo /etc/nginx/nginx.conf para edição.
$ sudo nano /etc/nginx/nginx.conf
Adicione a seguinte linha antes da linha include /etc/nginx/conf.d/*.conf;.
server_names_hash_bucket_size 64;
Salve o arquivo pressionando Ctrl + X e digitando Y quando solicitado.
Crie e abra o arquivo /etc/nginx/conf.d/netbox.conf para edição.
$ sudo nano /etc/nginx/conf.d/netbox.conf
Cole o seguinte código nele.
server {
# Redireciona qualquer solicitação http para https
listen 80;
listen [::]:80;
server_name netbox.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name netbox.example.com;
access_log /var/log/nginx/netbox.access.log;
error_log /var/log/nginx/netbox.error.log;
# Configuração TLS
ssl_certificate /etc/letsencrypt/live/netbox.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/netbox.example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/netbox.example.com/chain.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384';
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:50m;
ssl_session_timeout 1d;
# OCSP Stapling ---
# busca registros OCSP da URL no ssl_certificate e os armazena em cache
ssl_stapling on;
ssl_stapling_verify on;
ssl_dhparam /etc/ssl/certs/dhparam.pem;
client_max_body_size 25m;
# Proxy tudo para o servidor netbox
location /static/ {
alias /opt/netbox/netbox/static/;
}
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $http_host;
proxy_pass http://127.0.0.1:8001;
}
}
Salve o arquivo pressionando Ctrl + X e digitando Y quando solicitado ao terminar.
Verifique a sintaxe do arquivo de configuração do Nginx.
$ sudo nginx -t
nginx: o arquivo de configuração /etc/nginx/nginx.conf a sintaxe está ok
nginx: teste do arquivo de configuração /etc/nginx/nginx.conf bem-sucedido
Reinicie o serviço Nginx.
$ sudo systemctl restart nginx
Agora você pode acessar o Painel do NetBox através da URL https://netbox.example.com.
Passo 11 - Atualizar o NetBox
Atualizar o NetBox é bastante fácil. Os passos envolvem fazer o checkout do branch master do repositório Git, puxar os commits mais recentes e, em seguida, fazer o checkout da nova versão estável.
Mude para o diretório do NetBox.
$ cd /opt/netbox
Faça o checkout do branch master.
$ sudo git checkout master
Puxe os commits mais recentes do repositório.
$ sudo git pull origin master
Faça o checkout da nova versão. Se 3.4.2 for a versão mais nova, você pode fazer o checkout dela.
$ sudo git checkout v3.4.2
Execute o script de atualização.
$ sudo ./upgrade.sh
Para o processo de atualização, o script realiza as seguintes funções.
- Destrói e reconstrói o ambiente virtual Python
- Instala todos os pacotes Python necessários (listados em
requirements.txt) - Instala quaisquer pacotes adicionais do
local_requirements.txt - Aplica quaisquer migrações de banco de dados que foram incluídas no lançamento
- Compila a documentação localmente (para uso offline)
- Coleta todos os arquivos estáticos a serem servidos pelo serviço HTTP
- Exclui tipos de conteúdo obsoletos do banco de dados
- Exclui todas as sessões de usuário expiradas do banco de dados
Reinicie o serviço Gunicorn e NetBox.
$ sudo systemctl restart netbox netbox-rq
Conclusão
Isso conclui nosso tutorial sobre como instalar a Ferramenta de Documentação e Gerenciamento de Rede NetBox em um servidor Ubuntu 22.04 junto com o NGinx como um servidor proxy reverso. Se você tiver alguma dúvida, poste nos comentários abaixo.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.