Update site from docs source repo

Author: Exploding Labs Bot

superstack/404.html

@@ -386,6 +386,28 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="/superstack/bluegreen.md" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="/superstack/upgrading/" class="md-nav__link">
 

superstack/deploying/index.html

@@ -461,61 +461,32 @@
 
 </li>
 
-        <li class="md-nav__item">
-  <a href="#bluegreen-deployments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Blue/Green Deployments
-    </span>
-  </a>
+    </ul>
 
-    <nav class="md-nav" aria-label="Blue/Green Deployments">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-caddyfile" class="md-nav__link">
-    <span class="md-ellipsis">
-      1. Caddyfile
-    </span>
-  </a>
+</nav>
+      
+    </li>
 
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-start-two-stacks" class="md-nav__link">
-    <span class="md-ellipsis">
-      2. Start two Stacks
-    </span>
-  </a>
+
+    
+      
+      
 
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-front-proxy" class="md-nav__link">
-    <span class="md-ellipsis">
-      3. Front Proxy
-    </span>
-  </a>
 
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-deploying" class="md-nav__link">
-    <span class="md-ellipsis">
-      4. Deploying
-    </span>
-  </a>
 
-</li>
+  
+    <li class="md-nav__item">
+      <a href="../bluegreen.md" class="md-nav__link">
 
-      </ul>
-    </nav>
 
-</li>
-      
-    </ul>
 
-</nav>
-      
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
     </li>
 
 
@@ -602,57 +573,6 @@
     </span>
   </a>
 
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#bluegreen-deployments" class="md-nav__link">
-    <span class="md-ellipsis">
-      Blue/Green Deployments
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Blue/Green Deployments">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#1-caddyfile" class="md-nav__link">
-    <span class="md-ellipsis">
-      1. Caddyfile
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#2-start-two-stacks" class="md-nav__link">
-    <span class="md-ellipsis">
-      2. Start two Stacks
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#3-front-proxy" class="md-nav__link">
-    <span class="md-ellipsis">
-      3. Front Proxy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#4-deploying" class="md-nav__link">
-    <span class="md-ellipsis">
-      4. Deploying
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
 
     </ul>
@@ -724,71 +644,6 @@ <h2 id="4-launch-your-stack">🚀 4. Launch your Stack</h2>
 docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d
 docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>postgres<span class="w"> </span>migrate
 </code></pre></div>
-<h2 id="bluegreen-deployments">Blue/Green Deployments</h2>
-<p>This is a deployment method where two complete stacks are running side-by-side.
-One is serving production traffic, while the other is idle. You deploy to the
-idle stack, test it, and when you’re ready you swap roles — the idle stack
-becomes production instantly, and the old production becomes idle. This
-provides near-zero downtime and an easy rollback path.</p>
-<p>We’ll bring up two stacks, <code>blue</code> and <code>green</code>, with no ports exposed. A
-separate lightweight front proxy binds to <code>:80</code> and <code>:443</code> and routes traffic
-to whichever stack is active.</p>
-<h3 id="1-caddyfile">1. Caddyfile</h3>
-<p>Remove the exposed ports from the Caddy service. Also set <code>CADDY_SITE_ADDRESS</code>
-to only <code>:80</code> (leaving TLS termination to the front proxy):</p>
-<div class="highlight"><span class="filename">compose.yaml</span><pre><span></span><code><span class="nt">caddy</span><span class="p">:</span>
-<span class="w">  </span><span class="nt">environment</span><span class="p">:</span>
-<span class="w">    </span><span class="nt">CADDY_SITE_ADDRESS</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">:80</span>
-</code></pre></div>
-<p>To share data between the two stacks (database, uploads, etc.), give volumes
-explicit names:</p>
-<div class="highlight"><span class="filename">compose.yaml</span><pre><span></span><code><span class="nt">volumes</span><span class="p">:</span>
-<span class="w">  </span><span class="nt">postgres_data</span><span class="p">:</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">postgres-data</span>
-<span class="w">  </span><span class="nt">user_data</span><span class="p">:</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">user-data</span>
-</code></pre></div>
-<h3 id="2-start-two-stacks">2. Start two Stacks</h3>
-<p>On the server, bring up two stacks, <code>blue</code> and <code>green</code>:</p>
-<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>compose<span class="w"> </span>-p<span class="w"> </span>blue<span class="w"> </span>up<span class="w"> </span>-d
-docker<span class="w"> </span>compose<span class="w"> </span>-p<span class="w"> </span>green<span class="w"> </span>up<span class="w"> </span>-d
-</code></pre></div>
-<h3 id="3-front-proxy">3. Front Proxy</h3>
-<p>The front proxy is a single Caddy container that binds <code>:80</code> and <code>:443</code> on the
-server and routes requests into either the Blue or Green stack.</p>
-<p>On the server, create a simple <code>Caddyfile</code>:</p>
-<div class="highlight"><span class="filename">Caddyfile</span><pre><span></span><code>api.myapp.com reverse_proxy blue_caddy:80
-
-# Optionally point a second hostname to the idle stack for testing
-next.myapp.com reverse_proxy blue_caddy:80
-</code></pre></div>
-<p>The front proxy manages TLS, so give it a persistent volume for certificates:</p>
-<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>volume<span class="w"> </span>create<span class="w"> </span>caddy_data
-</code></pre></div>
-<p>Start the proxy and attach it to both networks:</p>
-<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>run<span class="w"> </span>-d<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>--name<span class="w"> </span>front-proxy<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>-p<span class="w"> </span><span class="m">80</span>:80<span class="w"> </span>-p<span class="w"> </span><span class="m">443</span>:443<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>-v<span class="w"> </span>./Caddyfile:/etc/caddy/Caddyfile<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>-v<span class="w"> </span>caddy_data:/data<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>--network<span class="w"> </span>blue_default<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>--network<span class="w"> </span>green_default<span class="w"> </span><span class="se">\</span>
-<span class="w">  </span>caddy:2
-</code></pre></div>
-<h3 id="4-deploying">4. Deploying</h3>
-<p>Update the idle stack:</p>
-<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>compose<span class="w"> </span>pull
-docker<span class="w"> </span>compose<span class="w"> </span>-p<span class="w"> </span>green<span class="w"> </span>up<span class="w"> </span>-d
-</code></pre></div>
-<p>Edit the front proxy's config to flip traffic:</p>
-<div class="highlight"><span class="filename">Caddyfile</span><pre><span></span><code>api.myapp.com reverse_proxy green_caddy:80
-next.myapp.com reverse_proxy blue_caddy:80
-</code></pre></div>
-<p>Restart Caddy:</p>
-<div class="highlight"><pre><span></span><code>docker<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>front-proxy<span class="w"> </span>caddy<span class="w"> </span>reload
-</code></pre></div>
-<p>Cutover is instant. Green is now live, and Blue is the idle stack.</p>
-<p>And rollback is simple: flip the <code>Caddyfile</code> back and <code>caddy reload</code>.</p>
 
 
 

superstack/extensions/index.html

@@ -490,6 +490,28 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="../bluegreen.md" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../upgrading/" class="md-nav__link">
 

superstack/gettingstarted/index.html

@@ -508,6 +508,28 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="../bluegreen.md" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../upgrading/" class="md-nav__link">
 

superstack/index.html

@@ -220,6 +220,14 @@
 </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="bluegreen.md">
+<span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+</a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="upgrading/">
 <span class="md-ellipsis">
     Upgrading SuperStack

superstack/migrations/index.html

@@ -493,6 +493,28 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="../bluegreen.md" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../upgrading/" class="md-nav__link">
 

superstack/psql/index.html

@@ -517,6 +517,28 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="../bluegreen.md" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../upgrading/" class="md-nav__link">
 

superstack/search/search_index.json

@@ -388,6 +388,28 @@
 
 
 
+  
+  
+    <li class="md-nav__item">
+      <a href="../bluegreen.md" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Blue/Green Deployments
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+