nautobot 2.4.5__py3-none-any.whl → 2.4.6__py3-none-any.whl

nautobot/project-static/docs/user-guide/administration/configuration/settings.html

@@ -2295,15 +2295,6 @@
     </span>
   </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#test_performance_baseline_file" class="md-nav__link">
-    <span class="md-ellipsis">
-      TEST_PERFORMANCE_BASELINE_FILE
-    </span>
-  </a>
-  
 </li>
         
           <li class="md-nav__item">
@@ -11315,15 +11306,6 @@
     </span>
   </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#test_performance_baseline_file" class="md-nav__link">
-    <span class="md-ellipsis">
-      TEST_PERFORMANCE_BASELINE_FILE
-    </span>
-  </a>
-  
 </li>
         
           <li class="md-nav__item">
@@ -13361,34 +13343,6 @@ provide support for Nautobot. Markdown formatting is supported within this messa
 <li><a href="#test_use_factories"> <code>TEST_USE_FACTORIES</code> </a></li>
 </ul>
 <hr />
-<h3 id="test_performance_baseline_file"><code>TEST_PERFORMANCE_BASELINE_FILE</code><a class="headerlink" href="#test_performance_baseline_file" title="Permanent link">&para;</a></h3>
-<details class="version-added">
-<summary>Added in version 1.5.0</summary>
-</details>
-<p><strong>Default:</strong>
-<code>"nautobot/core/tests/performance_baselines.yml"</code></p>
-<p><strong>Environment Variable:</strong> <code>NAUTOBOT_TEST_PERFORMANCE_BASELINE_FILE</code></p>
-<p>File path of a YAML file providing baseline times for all performance-related tests.</p>
-<p>The YAML file should conform to the following format:</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="nt">tests</span><span class="p">:</span>
-<a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">&gt;-</span>
-<a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a><span class="w">          </span><span class="no">test_run_job_with_sensitive_variables_and_requires_approval</span>
-<a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="w">          </span><span class="no">(nautobot.extras.tests.test_views.JobTestCase)</span>
-<a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a><span class="w">      </span><span class="nt">execution_time</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">4.799533</span>
-<a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test_run_missing_schedule (nautobot.extras.tests.test_views.JobTestCase)</span>
-<a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="w">      </span><span class="nt">execution_time</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">4.367563</span>
-<a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">test_run_now_missing_args (nautobot.extras.tests.test_views.JobTestCase)</span>
-<a id="__codelineno-28-9" name="__codelineno-28-9" href="#__codelineno-28-9"></a><span class="w">      </span><span class="nt">execution_time</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">4.363194</span>
-<a id="__codelineno-28-10" name="__codelineno-28-10" href="#__codelineno-28-10"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">&gt;-</span>
-<a id="__codelineno-28-11" name="__codelineno-28-11" href="#__codelineno-28-11"></a><span class="w">          </span><span class="no">test_create_object_with_constrained_permission</span>
-<a id="__codelineno-28-12" name="__codelineno-28-12" href="#__codelineno-28-12"></a><span class="w">          </span><span class="no">(nautobot.extras.tests.test_views.GraphQLQueriesTestCase)</span>
-<a id="__codelineno-28-13" name="__codelineno-28-13" href="#__codelineno-28-13"></a><span class="w">      </span><span class="nt">execution_time</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">3.474244</span>
-<a id="__codelineno-28-14" name="__codelineno-28-14" href="#__codelineno-28-14"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">&gt;-</span>
-<a id="__codelineno-28-15" name="__codelineno-28-15" href="#__codelineno-28-15"></a><span class="w">          </span><span class="no">test_run_now_constrained_permissions</span>
-<a id="__codelineno-28-16" name="__codelineno-28-16" href="#__codelineno-28-16"></a><span class="w">          </span><span class="no">(nautobot.extras.tests.test_views.JobTestCase)</span>
-<a id="__codelineno-28-17" name="__codelineno-28-17" href="#__codelineno-28-17"></a><span class="w">      </span><span class="nt">execution_time</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2.727531</span>
-</code></pre></div>
-<hr />
 <h3 id="test_use_factories"><code>TEST_USE_FACTORIES</code><a class="headerlink" href="#test_use_factories" title="Permanent link">&para;</a></h3>
 <details class="version-added">
 <summary>Added in version 1.5.0</summary>
@@ -13456,8 +13410,8 @@ and all Nautobot web servers, or else your scheduled jobs may run in the wrong t
 <summary>Added in version 1.4.0</summary>
 </details>
 <p><strong>Default:</strong></p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a><span class="k">def</span> <span class="nf">UI_RACK_VIEW_TRUNCATE_FUNCTION</span><span class="p">(</span><span class="n">device_display_name</span><span class="p">):</span>
-<a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a>    <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">device_display_name</span><span class="p">)</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="k">def</span> <span class="nf">UI_RACK_VIEW_TRUNCATE_FUNCTION</span><span class="p">(</span><span class="n">device_display_name</span><span class="p">):</span>
+<a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a>    <span class="k">return</span> <span class="nb">str</span><span class="p">(</span><span class="n">device_display_name</span><span class="p">)</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
 </code></pre></div>
 <p>This setting function is used to perform the rack elevation truncation feature.</p>
 <p>This provides a way to tailor the truncation behavior to best suit the needs of the installation.

nautobot/project-static/docs/user-guide/administration/guides/permissions.html

@@ -1724,6 +1724,30 @@
       </ul>
     </nav>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#recipes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Recipes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Recipes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#export-job" class="md-nav__link">
+    <span class="md-ellipsis">
+      Export Job
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -9343,6 +9367,30 @@
       </ul>
     </nav>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#recipes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Recipes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Recipes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#export-job" class="md-nav__link">
+    <span class="md-ellipsis">
+      Export Job
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -9536,6 +9584,29 @@
 <p class="admonition-title">Info</p>
 <p>Group permission relationships can be managed in the Admin UI by modifying the group (superusers only) or the permission.</p>
 </div>
+<h2 id="recipes">Recipes<a class="headerlink" href="#recipes" title="Permanent link">&para;</a></h2>
+<p>Below are examples of common permissions that a Nautobot admin may want to grant.</p>
+<h3 id="export-job">Export Job<a class="headerlink" href="#export-job" title="Permanent link">&para;</a></h3>
+<p>As of Nautobot 2.1, the Export action has been converted into a Job and requires
+permissions with constraints. (<a href="https://github.com/nautobot/nautobot/issues/4745">#4745</a>)</p>
+<p>Create a Permission to allow users to start an Export job:</p>
+<ul>
+<li>Permission Name: <code>Start Export job</code></li>
+<li>Action: <code>run</code></li>
+<li>Users/Groups: Any user or restrict as needed</li>
+<li>Constraints: <code>[{"module_name": "nautobot.core.jobs", "job_class_name": "ExportObjectList"}]</code></li>
+</ul>
+<p>Create a Permission to allow users to view the results of Export jobs they ran:</p>
+<ul>
+<li>Permission Name: <code>View Export results</code></li>
+<li>Action: <code>View</code></li>
+<li>Users/Groups: Any user or restrict as needed</li>
+<li>Constraints: <code>[{"user": "$user", "task_name": "nautobot.core.jobs.ExportObjectList"}]</code></li>
+</ul>
+<div class="admonition info">
+<p class="admonition-title">Info</p>
+<p>Export jobs run with the permissions of the user that start the job.</p>
+</div>
 
 
 

nautobot/project-static/docs/user-guide/administration/installation/http-server.html

@@ -9684,8 +9684,10 @@ be installed on your Nautobot server in a secure location that is readable only
 <p>If you are unable to connect to the HTTP server, check that:</p>
 <ul>
 <li>NGINX is running and configured to listen on the correct port.</li>
-<li>Access is not being blocked by a firewall somewhere along the path. (Try connecting locally from the server itself.)</li>
+<li>Confirm that a firewall isn't obstructing access to NGINX. Connect from the server itself as a first check. If blocked, consider verifying firewall settings (e.g., <code>sudo ufw status</code> or <code>sudo firewall-cmd --list-all</code>).</li>
+<li>Additionally, if SELinux is enabled, ensure that it's not restricting NGINX’s operations. You might need to adjust SELinux policies or set the right context for NGINX files and processes.</li>
 </ul>
+<p>This addition brings attention to SELinux, which is especially pertinent in environments like CentOS or RHEL, where SELinux is often enabled by default and could be a non-obvious blocker to NGINX operations.</p>
 <h3 id="static-media-failure">Static Media Failure<a class="headerlink" href="#static-media-failure" title="Permanent link">&para;</a></h3>
 <p>If you get a <em>Static Media Failure; The following static media file failed to load: css/base.css</em>, verify that the permissions on the <code>$NAUTOBOT_ROOT</code> directory are correctly set and that the <code>nginx</code> account is a member of the <code>nautobot</code> group, as described above.</p>
 <h3 id="502-bad-gateway">502 Bad Gateway<a class="headerlink" href="#502-bad-gateway" title="Permanent link">&para;</a></h3>

nautobot/project-static/docs/user-guide/administration/installation/index.html

@@ -665,6 +665,93 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#deployment-options" class="md-nav__link">
+    <span class="md-ellipsis">
+      Deployment Options
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Deployment Options">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#bare-metal-virtual-machine-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Bare metal / Virtual Machine Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#bare-metal-virtual-machine-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Bare metal / Virtual Machine Cons
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docker-compose-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Docker Compose Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docker-compose-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Docker Compose Cons
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#helm-charts-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Helm Charts Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#helm-charts-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Helm Charts Cons
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot-cloud-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Nautobot Cloud Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot-cloud-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Nautobot Cloud Cons
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#about-dependencies" class="md-nav__link">
     <span class="md-ellipsis">
@@ -9216,6 +9303,93 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#deployment-options" class="md-nav__link">
+    <span class="md-ellipsis">
+      Deployment Options
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Deployment Options">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#bare-metal-virtual-machine-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Bare metal / Virtual Machine Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#bare-metal-virtual-machine-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Bare metal / Virtual Machine Cons
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docker-compose-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Docker Compose Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docker-compose-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Docker Compose Cons
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#helm-charts-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Helm Charts Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#helm-charts-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Helm Charts Cons
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot-cloud-pros" class="md-nav__link">
+    <span class="md-ellipsis">
+      Nautobot Cloud Pros
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot-cloud-cons" class="md-nav__link">
+    <span class="md-ellipsis">
+      Nautobot Cloud Cons
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#about-dependencies" class="md-nav__link">
     <span class="md-ellipsis">
@@ -9310,26 +9484,93 @@
 
 
 <h1 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">&para;</a></h1>
-<p>Nautobot can be deployed via Docker (Compose or Kubernetes) or directly onto a supported Linux system:</p>
+<p>Whether you are getting started for the first time, looking to build a local lab or ready to build a production environment, there are a variety of options to find the right fit for your needs with using Nautobot.</p>
+<div class="admonition tip">
+<p class="admonition-title">Checking out Nautobot for the first time? Not ready to install anything yet?</p>
+<p>You can explore the <a href="https://networktocode.com/nautobot/sandbox-environments/">Nautobot Always-On Sandbox Environments</a>. There is sample data already prepopulated, no installation required, and several Nautobot Apps are pre-installed, with sample data.</p>
+</div>
+<h2 id="deployment-options">Deployment Options<a class="headerlink" href="#deployment-options" title="Permanent link">&para;</a></h2>
+<div class="tabbed-set tabbed-alternate" data-tabs="1:4"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><input id="__tabbed_1_3" name="__tabbed_1" type="radio" /><input id="__tabbed_1_4" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Bare metal / Virtual Machine</label><label for="__tabbed_1_2">Docker Compose</label><label for="__tabbed_1_3">Kubernetes Helm Charts</label><label for="__tabbed_1_4">Nautobot Cloud</label></div>
+<div class="tabbed-content">
+<div class="tabbed-block">
+<p>You can <a href="install_system.html">install Nautobot</a> onto a <a href="https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux">RHEL (Red Hat Enterprise Linux)</a> or <a href="https://ubuntu.com/">Ubuntu</a> virtual machine. </p>
+<p>Nautobot was designed to be a cross-platform application that can run on nearly any system that is able to run the required dependencies. <em>Only the operating system platforms listed below are officially supported at this time</em>.</p>
+<ul>
+<li>Red Hat flavors of Linux including Fedora 8.2+ and Red Hat Enterprise Linux (RHEL) 8.2+ are supported.</li>
+<li>Debian/Ubuntu flavors of Linux including Ubuntu 20.04+ and Debian 11+ are supported.</li>
+</ul>
+<p>Nautobot <em>should</em> work on any POSIX-compliant system including practically any flavor of Linux, BSD, or even macOS, but those are not <em>officially</em> supported at this time.</p>
+<h3 id="bare-metal-virtual-machine-pros">Bare metal / Virtual Machine Pros<a class="headerlink" href="#bare-metal-virtual-machine-pros" title="Permanent link">&para;</a></h3>
 <ul>
-<li><a href="../guides/docker.html">Nautobot Docker images</a> are available via <a href="https://hub.docker.com/r/networktocode/nautobot">Docker Hub</a> &amp; <a href="https://github.com/nautobot/nautobot/pkgs/container/nautobot">GitHub Container Registry</a> for use within a containerized environment<ul>
-<li>Install Nautobot via <a href="https://github.com/nautobot/nautobot-docker-compose">Docker Compose</a></li>
-<li><a href="https://docs.nautobot.com/projects/helm-charts/en/stable/">Install Nautobot via Helm Charts</a> for Kubernetes</li>
+<li>Familiar deployment option for many administrators</li>
+<li>Performance is generally higher without the overhead of virtualization</li>
+<li>Full control over hardware and software allows for greater customization and security practices</li>
 </ul>
-</li>
-<li><a href="install_system.html">Install Nautobot</a> onto a <a href="https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux">RHEL (Red Hat Enterprise Linux)</a> or <a href="https://ubuntu.com/">Ubuntu</a> virtual machine.</li>
+<h3 id="bare-metal-virtual-machine-cons">Bare metal / Virtual Machine Cons<a class="headerlink" href="#bare-metal-virtual-machine-cons" title="Permanent link">&para;</a></h3>
+<ul>
+<li>Maintenance and high availability is more difficult than Docker or Cloud options</li>
+<li>Preparing server for production grade security and scaling requires additional effort </li>
 </ul>
+</div>
+<div class="tabbed-block">
+<p>Nautobot can be deployed via Docker using <a href="../guides/docker.html">Nautobot Docker images</a> that are available either from:</p>
+<ul>
+<li><a href="https://hub.docker.com/r/networktocode/nautobot">Docker Hub</a></li>
+<li><a href="https://github.com/nautobot/nautobot/pkgs/container/nautobot">GitHub Container Registry</a> </li>
+</ul>
+<p>For local testing and lab work you can use the Nautobot <a href="https://github.com/nautobot/nautobot-docker-compose">Docker Compose</a> project which leverages the container images above. </p>
 <p>For more information about the Docker tags, Docker configurations, or using container images for your own development environment, see <a href="../guides/docker.html">Nautobot in Docker</a>.</p>
-<details class="info">
-<summary>Supported Platforms</summary>
-<p>Nautobot was designed to be a cross-platform application that can run on nearly any system that is able to run the required dependencies. <em>Only the operating system platforms listed below are officially supported at this time</em>.</p>
+<h3 id="docker-compose-pros">Docker Compose Pros<a class="headerlink" href="#docker-compose-pros" title="Permanent link">&para;</a></h3>
 <ul>
-<li>Red Hat flavors of Linux including CentOS 8.2+ and Red Hat Enterprise Linux (RHEL) 8.2+ are supported.</li>
-<li>Debian/Ubuntu flavors of Linux including Ubuntu 20.04+ and Debian 11+ are supported.</li>
+<li>Quick and simple setup for single-node lab environments and testing</li>
+<li>Lightweight alternative for those who don't need full Kubernetes orchestration</li>
 </ul>
-<p>Nautobot <em>should</em> work on any POSIX-compliant system including practically any flavor of Linux, BSD, or even macOS, but those are not <em>officially</em> supported at this time.</p>
-</details>
-<p>To begin installing Nautobot, click the link to your preferred deployment approach from the list above.</p>
+<h3 id="docker-compose-cons">Docker Compose Cons<a class="headerlink" href="#docker-compose-cons" title="Permanent link">&para;</a></h3>
+<ul>
+<li>Docker compose on its own is missing advanced features like automated rollbacks, self-healing applications, and load balancing </li>
+<li>Limited scaling if on single host </li>
+</ul>
+</div>
+<div class="tabbed-block">
+<p>You can <a href="https://docs.nautobot.com/projects/helm-charts/en/stable/">install Nautobot via Helm Charts</a> for Kubernetes documentation. </p>
+<p>If you are looking for an example of what that process looks like in a development environment using <code>minikube</code>, you can check out the three part blog series covering deploying Nautobot to Kubernetes:</p>
+<ul>
+<li><a href="https://networktocode.com/blog/deploying-nautobot-to-kubernetes-01/">Part 1</a></li>
+<li><a href="https://networktocode.com/blog/deploying-nautobot-to-kubernetes-02/">Part 2</a></li>
+<li><a href="https://networktocode.com/blog/deploying-nautobot-to-kubernetes-03/">Part 3</a></li>
+</ul>
+<h3 id="helm-charts-pros">Helm Charts Pros<a class="headerlink" href="#helm-charts-pros" title="Permanent link">&para;</a></h3>
+<ul>
+<li>Helm charts serves as a package manager for Kubernetes, streamlining the deployment of complex applications within Kubernetes clusters</li>
+<li>Using Kubernetes features, you can manage large-scale deployments efficiently and ensure high-availability for production grade systems</li>
+</ul>
+<h3 id="helm-charts-cons">Helm Charts Cons<a class="headerlink" href="#helm-charts-cons" title="Permanent link">&para;</a></h3>
+<ul>
+<li>Requires knowledge of Kubernetes and has a steeper learning curve for setting up</li>
+<li>Kubernetes clusters can use a lot of resources and monitoring effort</li>
+</ul>
+</div>
+<div class="tabbed-block">
+<p><a href="https://networktocode.com/nautobot/nautobot-cloud/">Nautobot Cloud</a> is a commercial Software as a Service (SaaS) offering from Network to Code. It is the <em><strong>easy</strong></em> button for Nautobot. It offers self-service and turnkey deployment for Nautobot removing the need for infrastructure setup and maintenance including one-click upgrades, clones, backups and restores, and a marketplace to streamline Nautobot App installations.</p>
+<p><!-- pyml disable-num-lines 5 no-inline-html -->
+<div class="grid cards example-images" markdown>
+<a class="glightbox" href="../../../media/user-guide/administration/getting-started/nautobot-cloud.png" data-type="image" data-width="auto" data-height="auto" data-desc-position="bottom"><img alt="Nautobot Cloud Example" class="on-glb" src="../../../media/user-guide/administration/getting-started/nautobot-cloud.png" /></a>
+</div></p>
+<h3 id="nautobot-cloud-pros">Nautobot Cloud Pros<a class="headerlink" href="#nautobot-cloud-pros" title="Permanent link">&para;</a></h3>
+<ul>
+<li>One-click Nautobot deployments <strong>and</strong> upgrades</li>
+<li>Enterprise grade dashboards to see trends of Nautobot data across all Nautobot instances</li>
+<li>Click to install apps from Nautobot Cloud Marketplace</li>
+<li>Cloud-based database snapshots</li>
+<li>One-click deployments of Ansible AWX too</li>
+</ul>
+<h3 id="nautobot-cloud-cons">Nautobot Cloud Cons<a class="headerlink" href="#nautobot-cloud-cons" title="Permanent link">&para;</a></h3>
+<ul>
+<li>You’ll have to find something else to do with all that freed-up time now that you’re not maintaining on-prem applications and infrastructure.</li>
+</ul>
+</div>
+</div>
+</div>
 <h2 id="about-dependencies">About Dependencies<a class="headerlink" href="#about-dependencies" title="Permanent link">&para;</a></h2>
 <p>This section describes the system dependencies required for Nautobot. They can be all installed on a single system, or distributed across your environment. That will be up to you. Our install instructions assume a single system install, and that is good for most use cases. More advanced configurations are also possible, but are not covered here.</p>
 <h3 id="mandatory-dependencies">Mandatory dependencies<a class="headerlink" href="#mandatory-dependencies" title="Permanent link">&para;</a></h3>
@@ -9346,7 +9587,7 @@
 <tr>
 <td>Python</td>
 <td>Application</td>
-<td>3.9</td>
+<td>3.9.2</td>
 </tr>
 <tr>
 <td>PostgreSQL</td>
@@ -9391,7 +9632,7 @@
 <p class="admonition-title">Only one database</p>
 <p>Either PostgreSQL or MySQL must be selected, but not both.</p>
 </div>
-<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">MySQL</label><label for="__tabbed_1_2">PostgreSQL</label></div>
+<div class="tabbed-set tabbed-alternate" data-tabs="2:2"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio" /><input id="__tabbed_2_2" name="__tabbed_2" type="radio" /><div class="tabbed-labels"><label for="__tabbed_2_1">MySQL</label><label for="__tabbed_2_2">PostgreSQL</label></div>
 <div class="tabbed-content">
 <div class="tabbed-block">
 <p><a href="https://mysql.com">MySQL</a> is an open-source relational database management system that’s relatively easy to set up and manage, fast, reliable, and well-understood.</p>

nautobot/project-static/docs/user-guide/administration/tools/nautobot-server.html

@@ -10344,7 +10344,7 @@ Hide HTTP request headers.</p>
 <p>Example output:</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-53-1" name="__codelineno-53-1" href="#__codelineno-53-1"></a>Listening on port http://localhost:9000. Stop with CONTROL-C.
 </code></pre></div>
-<p>Please see the guide on <a href="../../platform-functionality/webhook.html#troubleshooting">Troubleshooting Webhooks</a> for more information.</p>
+<p>Please see the guide on <a href="../../platform-functionality/webhook.html#troubleshooting-webhooks">Troubleshooting Webhooks</a> for more information.</p>
 
 
 

nautobot/project-static/docs/user-guide/administration/upgrading/upgrading.html

@@ -9455,7 +9455,7 @@ release notes under the release in which the change went into effect.</p>
 </code></pre></div>
 <p>Please see the <a href="https://dev.mysql.com/blog-archive/mysql-8-0-collations-migrating-from-older-collations/">official MySQL documentation on migrating collation encoding settings</a> for more information on troubleshooting any issues you may encounter.</p>
 <h2 id="update-prerequisites-to-required-versions">Update Prerequisites to Required Versions<a class="headerlink" href="#update-prerequisites-to-required-versions" title="Permanent link">&para;</a></h2>
-<p>Nautobot v2.4.0 and later requires the following:</p>
+<p>Nautobot v2.4.6 and later requires the following:</p>
 <table>
 <thead>
 <tr>
@@ -9466,7 +9466,7 @@ release notes under the release in which the change went into effect.</p>
 <tbody>
 <tr>
 <td>Python</td>
-<td>3.9</td>
+<td>3.9.2</td>
 </tr>
 <tr>
 <td>PostgreSQL</td>

nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareimagefile.html

@@ -9128,6 +9128,10 @@
 </details>
 <p>A software image file represents a single file, typically the installation image, used to run or install a device or virtual machine's operating system. Device and virtual machines can optionally assign a software image file for tracking the current image in use. Device types and inventory items can be assigned to multiple software images to track which images are compatible with which device types or inventory items. Software image files are related to <a href="softwareversion.html">software versions</a> which are used to track attributes that may apply to multiple software image files, such as the end of support date or security vulnerabilities that affect that version.</p>
 <p>A software image file must include a file name and a related <a href="softwareversion.html">software version</a>. It can optionally include attributes to verify the file's integrity: a file checksum and hashing algorithm as well as the file's size. Another optional field is a URL to download the image.</p>
+<details class="version-added">
+<summary>Added in version 2.4.6</summary>
+</details>
+<p>A software image file can optionally include an <a href="../../platform-functionality/externalintegration.html">external integration</a> field to enrich the file retrieval representation, typically by providing the URL, HTTP headers and credentials required to retrieve the source file.</p>
 
 
 

nautobot/project-static/docs/user-guide/feature-guides/contacts-and-teams.html

@@ -9225,18 +9225,18 @@
 
 <h1 id="contacts-and-teams">Contacts and Teams<a class="headerlink" href="#contacts-and-teams" title="Permanent link">&para;</a></h1>
 <h2 id="how-to-assign-contacts-and-teams-to-nautobot-objects">How to Assign Contacts and Teams to Nautobot Objects<a class="headerlink" href="#how-to-assign-contacts-and-teams-to-nautobot-objects" title="Permanent link">&para;</a></h2>
-<p>In order to assign contacts/teams to a particular object, we first need to define <code>Status</code> and <code>Role</code> objects for contenttype <code>extras:contactassociation</code>. Once that is done, we can navigate to the detail view of the object. We will use a circuit in this example.</p>
+<p>In order to assign contacts/teams to a particular object, we first need to define <code>Status</code> and <code>Role</code> objects for the content type <code>extras:contactassociation</code>. Once that is done, we can navigate to the detail view of the object. We will use a circuit in this example.</p>
 <p><img alt="Circuit" src="images/contact-and-team/circuit.png" /></p>
-<p>At the top right corner, you should see a group of buttons and one of them should say <strong>Add Contact</strong>.</p>
-<p><img alt="Circuit Add Contact Button" src="images/contact-and-team/circuit_button.png" /></p>
-<p>Click on the <strong>Add Contact</strong> button and it will redirect you to a page with forms on three separate tabs.</p>
-<p><img alt="Contact Form" src="images/contact-and-team/contact_forms.png" /></p>
+<p>At the top right corner, you should see a group of buttons and one of them should say <strong>Add Contact</strong>.
+<img alt="Circuit Add Contact Button" src="images/contact-and-team/circuit_button.png" />
+Click on the <strong>Add Contact</strong> button and it will redirect you to a page with forms on three separate tabs.
+<img alt="Contact Form" src="images/contact-and-team/contact_forms.png" /></p>
 <ol>
 <li>The first tab contains a form that allows the user to create a <strong>new</strong> contact and associate it with the object.</li>
 <li>The second tab contains a form that allows the user to create a <strong>new</strong> team and associate it with the object.</li>
-<li>The third tab contains a form that allows the user to select an <strong>existing</strong> contact or team and associate it with the object.</li>
+<li>The third tab contains a form that allows the user to select an <strong>existing</strong> contact or team and associate it with the object.
+<img alt="Contact Form Tabs" src="images/contact-and-team/contact_form_tabs.png" /></li>
 </ol>
-<p><img alt="Contact Form Tabs" src="images/contact-and-team/contact_form_tabs.png" /></p>
 <h3 id="assign-a-new-contactteam">Assign a New Contact/Team<a class="headerlink" href="#assign-a-new-contactteam" title="Permanent link">&para;</a></h3>
 <p>Which form to use depends on the use case but in this example, we will use the first form which creates a <strong>new</strong> contact instance and associates it with the object.</p>
 <ol>
@@ -9246,9 +9246,9 @@
 <img alt="Contact Association Info" src="images/contact-and-team/new_contact_association_info.png" /></li>
 <li>Click <strong>Create</strong> at the bottom of the page.</li>
 <li>It will redirect us to the detail view of the circuit.</li>
-<li>We can click on the <strong>Contacts</strong> tab that displays a table of contacts and teams that are associated with this circuit. Our New Contact should be in the table.</li>
+<li>We can click on the <strong>Contacts</strong> tab that displays a table of contacts and teams that are associated with this circuit. Our New Contact should be in the table.
+<img alt="Table with New Contact" src="images/contact-and-team/new_contact_table.png" /></li>
 </ol>
-<p><img alt="Table with New Contact" src="images/contact-and-team/new_contact_table.png" /></p>
 <h3 id="assign-an-existing-contactteam">Assign an Existing Contact/Team<a class="headerlink" href="#assign-an-existing-contactteam" title="Permanent link">&para;</a></h3>
 <p>In this example, we will use the third form which links an existing contact to the object.</p>
 <ol>
@@ -9261,9 +9261,9 @@
 <li>Select the desired role and status and click <strong>Create</strong>.
 <img alt="Existing Contact Association" src="images/contact-and-team/existing_contact_association.png" /></li>
 <li>The page should redirect us to the detail view of the circuit.</li>
-<li>We can click on the <strong>Contacts</strong> tab that displays a table of contacts and teams that are associated with this circuit. Both our Existing Contact and New Contact should in the table.</li>
+<li>We can click on the <strong>Contacts</strong> tab that displays a table of contacts and teams that are associated with this circuit. Both our Existing Contact and New Contact should in the table.
+<img alt="Table with New Contact and Existing Contact" src="images/contact-and-team/existing_contact_table.png" /></li>
 </ol>
-<p><img alt="Table with New Contact and Existing Contact" src="images/contact-and-team/existing_contact_table.png" /></p>