1
0
wiki/Blog/Python-项目终极部署解决方案.html

146 lines
402 KiB
HTML
Raw Normal View History

2024-07-19 18:08:14 +08:00
<!DOCTYPE html>
<html><head><title>Python 项目终极部署解决方案</title><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta property="og:title" content="Python 项目终极部署解决方案"/><meta property="og:description" content="Python 项目终极部署解决方案."/><meta property="og:image" content="https://wiki.7wate.com/static/og-image.png"/><meta property="og:width" content="1200"/><meta property="og:height" content="675"/><link rel="icon" href="../static/icon.png"/><meta name="description" content="Python 项目终极部署解决方案."/><meta name="generator" content="Quartz"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com"/><script async src="https://umami.7wate.com/script.js" data-website-id="c061efdc-95dd-4d21-9d04-a1ffda0a85b9"></script><script>
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?94d8ccb156eb7c65abf317e6e01cdba9";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script><script async src="https://www.googletagmanager.com/gtag/js?id=G-MHMEL0F832"></script><script>
(function() {
window.dataLayer = window.dataLayer || [];
function gtag() {
window.dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'G-MHMEL0F832');
})();
</script><link href="../index.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://fonts.googleapis.com/css2?family=IBM Plex Mono&amp;family=Schibsted Grotesk:wght@400;700&amp;family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&amp;display=swap" rel="stylesheet" type="text/css" spa-preserve/><script src="../prescript.js" type="application/javascript" spa-preserve></script><script type="application/javascript" spa-preserve>const fetchData = fetch(`../static/contentIndex.json`).then(data => data.json())</script></head><body data-slug="Blog/Python-项目终极部署解决方案"><div id="quartz-root" class="page"><div id="quartz-body"><div class="left sidebar"><h1 class="page-title "><a href="..">📚 X·Eden</a></h1><div class="spacer mobile-only"></div><div class="search "><div id="search-icon"><p>Search</p><div></div><svg tabIndex="0" aria-labelledby="title desc" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 19.9 19.7"><title id="title">Search</title><desc id="desc">Search</desc><g class="search-path" fill="none"><path stroke-linecap="square" d="M18.5 18.3l-5.4-5.4"></path><circle cx="8" cy="8" r="7"></circle></g></svg></div><div id="search-container"><div id="search-space"><input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search for something" placeholder="Search for something"/><div id="results-container"></div></div></div></div><div class="darkmode "><input class="toggle" id="darkmode-toggle" type="checkbox" tabIndex="-1"/><label id="toggle-label-light" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="dayIcon" x="0px" y="0px" viewBox="0 0 35 35" style="enable-background:new 0 0 35 35;" xmlSpace="preserve"><title>Light mode</title><path d="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5 S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5z M7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5 C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26z M17.5,6 C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6z M27.5,9 c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44 l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9z M6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5 c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06 L6.439,8.561z M33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16z M28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2 C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439z M17.5,29 c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5-1.5v-3C19,29.672,18.329,29,17.5,29z M17.5,7 C11.71,7,7,11.71,7,17.5S11.71,28,17.5,28S28,23.29,28,17.5S23.29,7,17.5,7z M17.5,25c-4.136,0-7.5-3.364-7.5-7.5 c0-4.136,3.364-7.5,7.5-7.5c4.136,0,7.5,3.364,7.5,7.5C25,21.636,21.636,25,17.5,25z"></path></svg></label><label id="toggle-label-dark" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="nightIcon" x="0px" y="0px" viewBox="0 0 100 100" style="enable-background='new 0 0 100 100'" xmlSpace="preserve"><title>Dark mode</title><path d="M96.76,66.458c-0.853-0.852-2.15-1.064-3.23-0.534c-6.063,2.991-12.858,4.571-19.655,4.571 C62.022,70.495,50.88,65.88,42.5,57.5C29.043,44.043,25.658,23.536,34.076,6.47c0.532-1.08,0.318-2.379-0.534-3.23 c-0.851-0.852-2.15-1.064-3.23-0.534c-4.918,2.427-9.375,5.619-13.246,9.491c-9.447,9.447-14.65,22.008-14.65,35.369 c0,13.36,5.203,25.921,14.65,35.368s22
<p>特别是自 2019 年 6 月起Python 采用了 PEP 602——Python 的年度发布周期。从 Python 3.9 开始,这个策略规定了 Python 版本的发布计划,确保每年 10 月发布新的特性版本。每个版本的开发周期长达 17 个月包括无版本、Alpha、Beta 和候选发布阶段。此外Python 版本将获得两年的全面支持,包括错误修复,随后是三年的安全修复。</p>
<pre><code class="mermaid">gantt
title Python 3.12 发布周期
dateFormat YYYY-MM
section 开发周期
无版本期 :2022-10, 2023-05
Alpha 阶段 :2023-05, 2023-07
Beta 阶段 :2023-07, 2023-09
候选发布阶段 :2023-09, 2023-10
正式发布 Python 3.12.0 :2023-10, 2023-10
全面支持期 :2023-10, 2025-10
安全更新期 :2025-10, 2028-10
</code></pre>
<p>但是目前在 Python 项目部署方面,依然还面临着许多问题和挑战,如环境一致性、依赖管理、版本控制、跨平台部署、性能优化、安全性、自动化部署、配置管理、离线部署、容器和虚拟化、资源管理和监控、文档和支持等等等。差点一口气顺不下来哈哈哈 ~</p>
<p>目前我的主要策略是遵循 DevSecOps 原则,实现标准化和流程化部署。</p>
<h2 id="仓库分支">仓库分支<a aria-hidden="true" tabindex="-1" href="#仓库分支" class="internal"> §</a></h2>
<ol>
<li><strong>主分支</strong><code>main</code><code>master</code>):用于稳定版本的代码和产品发布。</li>
<li><strong>开发分支</strong>:从主分支分出,用于日常开发和测试工作。</li>
<li><strong>依赖分支</strong>:从开发分支分出,专门管理和更新项目依赖。</li>
<li><strong>功能分支</strong>:从开发分支分出,用于开发新功能或修复错误。</li>
<li><strong>发布分支</strong>:从主分支分出,用于新版本的准备和发布。</li>
<li><strong>文档分支</strong>:专注于文档编写和更新,建议与发布分支合并。</li>
</ol>
<h2 id="开发环境">开发环境<a aria-hidden="true" tabindex="-1" href="#开发环境" class="internal"> §</a></h2>
<p>项目开发应基于项目需求和目标平台选择适当的 Python 版本,并根据需求评审更新。同时利用 <code>pyenv</code> 可灵活管理 Python 版本,而 <code>Pipenv</code> 则用于依赖管理,其 <code>Pipfile</code><code>Pipfile.lock</code> 确保依赖在所有环境中的一致性。同时,使用 Git 作为版本控制系统,保持代码的组织和可追溯性。此外,尤其是<strong>依赖更新应通过专门的依赖分支来管理。</strong></p>
<h2 id="测试环境">测试环境<a aria-hidden="true" tabindex="-1" href="#测试环境" class="internal"> §</a></h2>
<p>**测试环境的构建应尽可能模拟生产环境,以确保测试的有效性。**使用如 GitHub Actions 或 Jenkins 的自动化工具可以自动执行单元测试、集成测试等。同时,引入代码审查工具,如 SonarQube进行静态代码分析有助于发现代码质量问题和安全漏洞。测试环境中的配置管理应与生产环境保持一致例如通过环境变量或使用 Ansible 工具进行配置管理。</p>
<h2 id="构建部署">构建部署<a aria-hidden="true" tabindex="-1" href="#构建部署" class="internal"> §</a></h2>
<p>在部署方面,根据是否联网和部署形式(源代码或二进制),可以采取不同的策略:</p>
<p><img src="https://static.7wate.com//img/2024/01/24/b46b88e52db76804b6af517bdb7562e0.svg" alt="部署十字象限"/></p>
<h3 id="联网环境--源代码部署">联网环境 &amp; 源代码部署<a aria-hidden="true" tabindex="-1" href="#联网环境--源代码部署" class="internal"> §</a></h3>
<p>在联网环境中进行源代码部署时,使用 Github、GitLab 等版本控制系统VCS配合持续集成/持续部署CI/CD工具如 GitHub Actions、GitLab CI/CD是一种高效的方法。这些工具可以自动化测试、构建和部署过程从而提高部署效率和减少人为错误。</p>
<p>同时,为了确保环境和依赖的一致性,可以采用 <code>Pipenv</code><code>Pyenv</code><code>Pipenv</code> 提供了项目依赖的清晰定义和锁定机制,而 <code>Pyenv</code> 允许在同一系统中安装和使用多个 Python 版本,非常适合处理多项目环境。此外,可以集成静态代码分析和代码质量检测工具,如 SonarQube以提高代码质量和安全性。</p>
<h3 id="无网环境--源代码部署">无网环境 &amp; 源代码部署<a aria-hidden="true" tabindex="-1" href="#无网环境--源代码部署" class="internal"> §</a></h3>
<p>在无网环境下,虽然可以使用 <code>Pipenv</code><code>Pyenv</code> 等工具来管理 Python 版本和依赖,但无法直接从外部源下载依赖。因此,关键步骤是提<strong>前准备好所有必需的依赖包</strong>。这可以通过在联网环境中预先下载所有依赖并将其存储在一个本地仓库(如 <code>PyPI</code> 目录)中来实现。</p>
<p>此外,还可以构建一个 Python 独立版本,并将 Python 解释器与应用程序一起打包,确保环境的一致性。为此,可创建一个包含所有依赖的可执行文件。这种方法有助于减少环境差异和部署复杂性。</p>
<p>DemoProject 项目结构参考:</p>
<pre><code>DemoProject
├── ProjectSrc
├── Script
├── PyPI
└── Python3.10
</code></pre>
<ul>
<li>ProjectSrc项目代码</li>
<li>Script项目运行脚本</li>
<li>PyPI项目依赖包</li>
<li>Python3.10:独立版本 Python</li>
</ul>
<h3 id="联网环境--二进制部署">联网环境 &amp; 二进制部署<a aria-hidden="true" tabindex="-1" href="#联网环境--二进制部署" class="internal"> §</a></h3>
<p>二进制部署在联网环境下提供了更多的灵活性和可扩展性。使用 Docker 和 Kubernetes 可以实现应用程序的容器化,从而简化部署过程、增加应用程序的可移植性和可伸缩性。容器化还使得应用程序在不同环境之间的迁移变得更加容易,同时提供了隔离和安全性。</p>
<p>此外,可以利用现代化的部署策略,如蓝绿部署、金丝雀发布和灰度发布。这些策略通过逐渐引入新版本的方式来减少风险,允许在完全部署之前监控应用程序的表现并回滚至旧版本(如有必要)。</p>
<h3 id="无网环境--二进制部署">无网环境 &amp; 二进制部署<a aria-hidden="true" tabindex="-1" href="#无网环境--二进制部署" class="internal"> §</a></h3>
<p>在无网环境中,二进制部署通常依赖于将应用程序及其所有依赖打包成单个可执行文件。可以使用 PyInstaller 等工具来创建独立的二进制文件,这样就不需要在目标系统上单独安装 Python 或依赖包。</p>
<p>另外,针对特定的操作系统,可以考虑将应用程序打包成 APT (.deb) 包或 YUM (.rpm) 包。这种方法适合于在特定类型的 Linux 发行版上部署应用程序,可以利用操作系统的包管理器来处理依赖和升级。</p>
<h2 id="运维监控">运维监控<a aria-hidden="true" tabindex="-1" href="#运维监控" class="internal"> §</a></h2>
<p>部署后的监控和维护同样重要。使用如 Prometheus 和 Grafana 的工具组合可以有效进行性能监控,帮助及时发现和解决问题,保证系统的稳定运行。业内拥有多种一体化运维监控系统及开源软件,可以根据具体需求进行统一化安装配置管理。</p>
<h2 id="日志管理">日志管理<a aria-hidden="true" tabindex="-1" href="#日志管理" class="internal"> §</a></h2>
<p>ELK 堆栈是一种流行的日志管理解决方案,由 Elasticsearch、Logstash 和 Kibana 三个组件组成。</p>
<ul>
<li>Elasticsearch 作为核心,提供高效的数据存储、搜索和分析能力。</li>
<li>Logstash 负责日志数据的收集和处理,可以从多种来源获取数据,并转换后传输到 Elasticsearch。</li>
<li>Kibana 作为这套系统的前端界面,提供数据的实时可视化和分析功能。</li>
</ul>
<p>这套组合因其出色的灵活性和扩展性,适合用于各种规模的项目,帮助组织有效管理和分析大量日志数据,提升系统性能和安全性,同时支持更好的业务决策。</p></article></div><div class="right sidebar"><div class="graph "><h3>Graph View</h3><div class="graph-outer"><div id="graph-container" data-cfg="{&quot;drag&quot;:true,&quot;zoom&quot;:true,&quot;depth&quot;:1,&quot;scale&quot;:1.1,&quot;repelForce&quot;:0.5,&quot;centerForce&quot;:0.3,&quot;linkDistance&quot;:30,&quot;fontSize&quot;:0.6,&quot;opacityScale&quot;:1,&quot;showTags&quot;:true,&quot;removeTags&quot;:[]}"></div><svg version="1.1" id="global-graph-icon" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 55 55" fill="currentColor" xmlSpace="preserve"><path d="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17
s-3.542,0.634-4.898,1.688l-7.669-7.669C16.785,10.424,17,9.74,17,9c0-2.206-1.794-4-4-4S9,6.794,9,9s1.794,4,4,4
c0.74,0,1.424-0.215,2.019-0.567l7.669,7.669C21.634,21.458,21,23.154,21,25s0.634,3.542,1.688,4.897L10.024,42.562
C8.958,41.595,7.549,41,6,41c-3.309,0-6,2.691-6,6s2.691,6,6,6s6-2.691,6-6c0-1.035-0.263-2.009-0.726-2.86l12.829-12.829
c1.106,0.86,2.44,1.436,3.898,1.619v10.16c-2.833,0.478-5,2.942-5,5.91c0,3.309,2.691,6,6,6s6-2.691,6-6c0-2.967-2.167-5.431-5-5.91
v-10.16c1.458-0.183,2.792-0.759,3.898-1.619l7.669,7.669C41.215,39.576,41,40.26,41,41c0,2.206,1.794,4,4,4s4-1.794,4-4
s-1.794-4-4-4c-0.74,0-1.424,0.215-2.019,0.567l-7.669-7.669C36.366,28.542,37,26.846,37,25s-0.634-3.542-1.688-4.897l9.665-9.665
C46.042,11.405,47.451,12,49,12c3.309,0,6-2.691,6-6S52.309,0,49,0z M11,9c0-1.103,0.897-2,2-2s2,0.897,2,2s-0.897,2-2,2
S11,10.103,11,9z M6,51c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S8.206,51,6,51z M33,49c0,2.206-1.794,4-4,4s-4-1.794-4-4
s1.794-4,4-4S33,46.794,33,49z M29,31c-3.309,0-6-2.691-6-6s2.691-6,6-6s6,2.691,6,6S32.309,31,29,31z M47,41c0,1.103-0.897,2-2,2
s-2-0.897-2-2s0.897-2,2-2S47,39.897,47,41z M49,10c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S51.206,10,49,10z"></path></svg></div><div id="global-graph-outer"><div id="global-graph-container" data-cfg="{&quot;drag&quot;:true,&quot;zoom&quot;:true,&quot;depth&quot;:-1,&quot;scale&quot;:0.9,&quot;repelForce&quot;:0.5,&quot;centerForce&quot;:0.3,&quot;linkDistance&quot;:30,&quot;fontSize&quot;:0.6,&quot;opacityScale&quot;:1,&quot;showTags&quot;:true,&quot;removeTags&quot;:[]}"></div></div></div><div class="toc desktop-only"><button type="button" id="toc" class><h3>Table of Contents</h3><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="fold"><polyline points="6 9 12 15 18 9"></polyline></svg></button><div id="toc-content"><ul class="overflow"><li class="depth-0"><a href="#仓库分支" data-for="仓库分支">仓库分支</a></li><li class="depth-0"><a href="#开发环境" data-for="开发环境">开发环境</a></li><li class="depth-0"><a href="#测试环境" data-for="测试环境">测试环境</a></li><li class="depth-0"><a href="#构建部署" data-for="构建部署">构建部署</a></li><li class="depth-1"><a href="#联网环境--源代码部署" data-for="联网环境--源代码部署">联网环境 &amp; 源代码部署</a></li><li class="depth-1"><a href="#无网环境--源代码部署" data-for="无网环境--源代码部署">无网环境 &amp; 源代码部署</a></li><li class="depth-1"><a href="#联网环境--二进制部署" data-for="联网环境--二进制部署">联网环境 &amp; 二进制部署</a></li><li class="depth-1"><a href="#无网环境--二进制部署" data-for="无网环境--二进制部署">无网环境 &amp; 二进制部署</a></li><li class="depth-0"><a href="#运维监控" data-for="运维监控">运维监控</a></li><li class="depth-0"><a href="#日志管理" data-for="日志管理">日志管理</a></li></ul></div></div><div class="backlinks "><h3>Backlinks</h3><ul class="overflow"><li>No backlinks found</li></ul></div><div class="explorer mobile-only"><button type="button" id="explorer" data-behavior="collapse" data-collapsed="collapsed" data-savestate="true" data-tree="[{&quot;path&quot;:&quot;Basics&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Basics/english&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Blog&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/个人成长&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/医学健康&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/历史&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/哲学宗教&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/心理&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/政治军事&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/教育学习&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/文学&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/生活百科&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/社会文化&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/科学技术&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/经济理财&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/艺术&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Book/计算机&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Company&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Company/信息化&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Company/信息化/规范&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Culture&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Government&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Government/中国&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Government/中国/标准&quot;,&quot;collapsed&quot;:tru
function toggleCallout() {
const outerBlock = this.parentElement;
outerBlock.classList.toggle(`is-collapsed`);
const collapsed = outerBlock.classList.contains(`is-collapsed`);
const height = collapsed ? this.scrollHeight : outerBlock.scrollHeight;
outerBlock.style.maxHeight = height + `px`;
let current = outerBlock;
let parent = outerBlock.parentElement;
while (parent) {
if (!parent.classList.contains(`callout`)) {
return;
}
const collapsed2 = parent.classList.contains(`is-collapsed`);
const height2 = collapsed2 ? parent.scrollHeight : parent.scrollHeight + current.scrollHeight;
parent.style.maxHeight = height2 + `px`;
current = parent;
parent = parent.parentElement;
}
}
function setupCallout() {
const collapsible = document.getElementsByClassName(
`callout is-collapsible`
);
for (const div of collapsible) {
const title = div.firstElementChild;
if (title) {
title.removeEventListener(`click`, toggleCallout);
title.addEventListener(`click`, toggleCallout);
const collapsed = div.classList.contains(`is-collapsed`);
const height = collapsed ? title.scrollHeight : div.scrollHeight;
div.style.maxHeight = height + `px`;
}
}
}
document.addEventListener(`nav`, setupCallout);
window.addEventListener(`resize`, setupCallout);
</script><script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs';
const darkMode = document.documentElement.getAttribute('saved-theme') === 'dark'
mermaid.initialize({
startOnLoad: false,
securityLevel: 'loose',
theme: darkMode ? 'dark' : 'default'
});
document.addEventListener('nav', async () => {
await mermaid.run({
querySelector: '.mermaid'
})
});
</script><script src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js" type="application/javascript"></script><script src="../postscript.js" type="module"></script></html>