KEEL · 龙骨 · A CURRICULUM FOR THE AI ERA
课程导读 · 私有化部署基础课 — keel 龙骨
私有化部署基础课：从一个装不上的包，到能自己跑起来 的参考信息：课程导读 · 私有化部署基础课
从「听过这个词」到「自己把交付包跑起来，并说得清边界」
你现在的起点
先花一分钟对一下。下面四条你都能说清，这门课可以跳过，直接去《私有化交付工程》：
- 交付包里装的是什么？为什么它不能只是「压缩一下发过去」？
docker compose up报No such image时，第一件该查的是网络还是制品？- 客户机器没有外网，这件事倒逼出了哪些设计？
- 什么情况下不该做私有化交付？
只要有一条答不上来，往下读。这门课不要求你会写代码，也不要求你搭过任何服务。
一条能走通的学习路径
它是什么 01 它到底解决了什么问题
↓
跑一个现成的 02 跑起第一个交付包
↓
装自己的东西 03 把自己的东西装进去
↓
边界在哪 04 什么时候别做私有化
四章，每章一个能跑出来的结果。 不需要服务器，本机有一个能用的 Docker 就够。
章节地图
| 章 | 关键问题 | 你会亲手跑出什么 |
|---|---|---|
| 01 它到底解决了什么问题 | 「在我机器上是好的」到底坏在哪？私有化做了什么？ | 一份交付包内容清单 |
| 02 跑起第一个交付包 | 一条 ./install.sh 里每一段在做什么？哪一行说明它活了？ |
一屏成功的安装输出 + 自检结果 |
| 03 把自己的东西装进去 | 你的东西在包里占哪一块？怎么重新打进去？ | 一次重新打包 + 包内容清单 |
| 04 什么时候别做私有化 | 哪五种情况不该做私有化？ | 一张判断速查表 + 这条约束的形态 |
本章会遇到的词
遇到不认识的词，回这张表查一句话就够；要更完整的来历，点对应的课程链接。
| 词 | 出现在 | 一句话 |
|---|---|---|
| 交付包（bundle） | 01、03 | 一次安装所需的全部输入，加一份完整性证明；不是「压缩包」 |
| 内网隔离（airgap） | 01、04 | 不是「网慢」，是没有出口——它倒逼出包里的每一条设计 |
| 实例（instance） | 01 | 一套部署：一个资源名前缀 + 一份配置 + 一份数据 |
| 镜像 / 容器 | 全课 | 镜像是一份「装好的、能搬走的运行环境」；容器是把它跑起来的那一次 |
docker load |
02 | 把一只镜像 tar 灌进本机 daemon，不需要外网 |
MANIFEST.sha256 |
02 | 包里每个制品的哈希清单；现场靠它判断包在搬运途中坏没坏 |
migrate |
02 | 一次性进程：把库结构移动到某一版，跑完就退，退出码是它唯一的产物 |
| 结构版本 | 02、04 | 数据库结构当前跑到第几版；镜像要求的那一版和它必须对得上 |
--pull never |
03 | 告诉 compose「本地没有就报错、别去网上取」——离线场景的正确默认 |
internal=true |
04 | 一张没有出口的网络；私有化所有设计的前提 |
词表里没解释清楚的，可以在《Docker 基础课》把容器那套东西补齐。
这门课怎么读
- 每一章的代码块，请真的跑一遍。 这门课知识量不大，但「跑过一次」和「读过一次」差别很大。
- 不要背命令。 第 04 章有一张速查表，用的时候回来查就行。
- 遇到不认识的词不要停下来查。 每个词第一次出现都会给一句话解释，或用上面那张表兜住。
前置要求
- 能用命令行执行一条命令（会敲回车就够了）；
- 本机有一个能用的 Docker（
docker version里Client和Server两段都在）与 Docker Compose v2； - 不需要会编程。 正文里要你改的是位置和版本号，不是写代码。
实验环境说明
- 命令是标准写法，Windows / macOS / Linux 通用；路径写法有差异的地方会单独说明。
- 正文里「跑起来会看到什么」的输出版块，环境是 Docker Engine 29.8.2 + Docker Compose v2，
被交付物是board（1.0.0/1.1.0）。 - 但数字必定不同：容器 id、耗时、磁盘可用量、现场随机生成的数据库密码都随环境变——
要读的是形状（有哪几段、哪一行表示成功）。