Skip to content

Commit 570dcbe

Browse files
author
Exploding Labs Bot
committed
Update site from docs source repo
1 parent af81ccd commit 570dcbe

File tree

2 files changed

+45
-58
lines changed

2 files changed

+45
-58
lines changed

superstack/advanced/index.html

Lines changed: 44 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -194,23 +194,16 @@
194194
</a>
195195
</li>
196196
<li class="md-nav__item">
197-
<a class="md-nav__link" href="#1-adjust-the-application">
197+
<a class="md-nav__link" href="#1-create-a-new-proxy-project">
198198
<span class="md-ellipsis">
199-
1. Adjust the Application
199+
1. Create a new proxy project
200200
</span>
201201
</a>
202202
</li>
203203
<li class="md-nav__item">
204-
<a class="md-nav__link" href="#2-start-a-new-proxy-project">
204+
<a class="md-nav__link" href="#2-adjust-the-application">
205205
<span class="md-ellipsis">
206-
2. Start a new proxy project
207-
</span>
208-
</a>
209-
</li>
210-
<li class="md-nav__item">
211-
<a class="md-nav__link" href="#start-the-services">
212-
<span class="md-ellipsis">
213-
Start the services
206+
2. Adjust the Application
214207
</span>
215208
</a>
216209
</li>
@@ -278,23 +271,16 @@
278271
</a>
279272
</li>
280273
<li class="md-nav__item">
281-
<a class="md-nav__link" href="#1-adjust-the-application">
282-
<span class="md-ellipsis">
283-
1. Adjust the Application
284-
</span>
285-
</a>
286-
</li>
287-
<li class="md-nav__item">
288-
<a class="md-nav__link" href="#2-start-a-new-proxy-project">
274+
<a class="md-nav__link" href="#1-create-a-new-proxy-project">
289275
<span class="md-ellipsis">
290-
2. Start a new proxy project
276+
1. Create a new proxy project
291277
</span>
292278
</a>
293279
</li>
294280
<li class="md-nav__item">
295-
<a class="md-nav__link" href="#start-the-services">
281+
<a class="md-nav__link" href="#2-adjust-the-application">
296282
<span class="md-ellipsis">
297-
Start the services
283+
2. Adjust the Application
298284
</span>
299285
</a>
300286
</li>
@@ -372,37 +358,7 @@ <h2 id="deployment-flow">🔄 Deployment Flow</h2>
372358
<li>Tear down the old one when ready.</li>
373359
</ol>
374360
<p>Ok, we need to make some changes to the repository.</p>
375-
<h2 id="1-adjust-the-application">1. Adjust the Application</h2>
376-
<p>Remove the app's exposed ports, and connect to the proxy's network:</p>
377-
<div class="highlight"><span class="filename">app/compose.yaml</span><pre><span></span><code><span class="nt">services</span><span class="p">:</span>
378-
<span class="w"> </span><span class="nt">caddy</span><span class="p">:</span>
379-
<span class="w"> </span><span class="nt">build</span><span class="p">:</span>
380-
<span class="w"> </span><span class="nt">context</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./caddy</span>
381-
<span class="hll"><span class="w"> </span><span class="nt">environment</span><span class="p">:</span>
382-
</span><span class="hll"><span class="w"> </span><span class="nt">CADDY_SITE_ADDRESS</span><span class="p">:</span><span class="w"> </span><span class="s">":80"</span>
383-
</span><span class="hll"><span class="w"> </span><span class="nt">networks</span><span class="p">:</span>
384-
</span><span class="hll"><span class="w"> </span><span class="nt">default</span><span class="p">:</span>
385-
</span><span class="hll"><span class="w"> </span><span class="nt">proxy_default</span><span class="p">:</span>
386-
</span><span class="hll"><span class="w"> </span><span class="nt">aliases</span><span class="p">:</span>
387-
</span><span class="hll"><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${COMPOSE_PROJECT_NAME}_caddy</span>
388-
</span>
389-
<span class="hll"><span class="nt">networks</span><span class="p">:</span>
390-
</span><span class="hll"><span class="w"> </span><span class="nt">proxy_default</span><span class="p">:</span>
391-
</span><span class="hll"><span class="w"> </span><span class="nt">external</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
392-
</span></code></pre></div>
393-
<p>What's changed?</p>
394-
<ol>
395-
<li>The exposed ports were removed.</li>
396-
<li>Caddy's site address has changed to <code>:80</code> (The application layer no longer
397-
handles TLS).</li>
398-
<li>We connect to the proxy's network, so the proxy can direct traffic to the
399-
app.</li>
400-
<li>A container alias was added. This alias allows the proxy to target this
401-
container, while still allowing Docker to manage the container name.</li>
402-
</ol>
403-
<p>The <code>CADDY_SITE_ADDRESS</code> environment variable can be removed from the override
404-
file.</p>
405-
<h2 id="2-start-a-new-proxy-project">2. Start a new <code>proxy</code> project</h2>
361+
<h2 id="1-create-a-new-proxy-project">1. Create a new <code>proxy</code> project</h2>
406362
<p>From the root of the repository, create a new <code>proxy</code> project:</p>
407363
<div class="highlight"><pre><span></span><code>mkdir<span class="w"> </span>proxy
408364
</code></pre></div>
@@ -445,11 +401,42 @@ <h2 id="2-start-a-new-proxy-project">2. Start a new <code>proxy</code> project</
445401

446402
<span class="k">COPY</span><span class="w"> </span>Caddyfile<span class="w"> </span>/etc/caddy/Caddyfile
447403
</code></pre></div>
448-
<h2 id="start-the-services">Start the services</h2>
449-
<p>Start the proxy first, then the app which connects to its network.</p>
450-
<div class="highlight"><pre><span></span><code><span class="l l-Scalar l-Scalar-Plain">cd proxy &amp;&amp; docker compose up -d</span>
451-
<span class="l l-Scalar l-Scalar-Plain">cd ../app &amp;&amp; docker compose up -d</span>
404+
<p>Start the proxy service:</p>
405+
<div class="highlight"><pre><span></span><code><span class="l l-Scalar l-Scalar-Plain">docker compose up -d</span>
406+
</code></pre></div>
407+
<h2 id="2-adjust-the-application">2. Adjust the Application</h2>
408+
<p>Remove the app's exposed ports, and connect to the proxy's network:</p>
409+
<div class="highlight"><span class="filename">app/compose.yaml</span><pre><span></span><code><span class="nt">services</span><span class="p">:</span>
410+
<span class="w"> </span><span class="nt">caddy</span><span class="p">:</span>
411+
<span class="w"> </span><span class="nt">build</span><span class="p">:</span>
412+
<span class="w"> </span><span class="nt">context</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./caddy</span>
413+
<span class="hll"><span class="w"> </span><span class="nt">environment</span><span class="p">:</span>
414+
</span><span class="hll"><span class="w"> </span><span class="nt">CADDY_SITE_ADDRESS</span><span class="p">:</span><span class="w"> </span><span class="s">":80"</span>
415+
</span><span class="hll"><span class="w"> </span><span class="nt">networks</span><span class="p">:</span>
416+
</span><span class="hll"><span class="w"> </span><span class="nt">default</span><span class="p">:</span>
417+
</span><span class="hll"><span class="w"> </span><span class="nt">proxy_default</span><span class="p">:</span>
418+
</span><span class="hll"><span class="w"> </span><span class="nt">aliases</span><span class="p">:</span>
419+
</span><span class="hll"><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${COMPOSE_PROJECT_NAME}_caddy</span>
420+
</span>
421+
<span class="hll"><span class="nt">networks</span><span class="p">:</span>
422+
</span><span class="hll"><span class="w"> </span><span class="nt">proxy_default</span><span class="p">:</span>
423+
</span><span class="hll"><span class="w"> </span><span class="nt">external</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
424+
</span></code></pre></div>
425+
<p>What's changed?</p>
426+
<ol>
427+
<li>The exposed ports were removed.</li>
428+
<li>Caddy's site address has changed to <code>:80</code> (The application layer no longer
429+
handles TLS).</li>
430+
<li>We connect to the proxy's network, so the proxy can direct traffic to the
431+
app.</li>
432+
<li>A container alias was added. This alias allows the proxy to target this
433+
container, while still allowing Docker to manage the container name.</li>
434+
</ol>
435+
<p>The <code>CADDY_SITE_ADDRESS</code> environment variable can be removed from the override
436+
file.</p>
437+
<div class="highlight"><pre><span></span><code>docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d<span class="w"> </span>app
452438
</code></pre></div>
439+
<p>Commit these changes.</p>
453440
<h2 id="deploying">Deploying</h2>
454441
<div class="highlight"><pre><span></span><code>proxy/
455442
compose.yaml

0 commit comments

Comments
 (0)