Tarsail

Tarsail 是一个 Plystra 项目。它遵循 Plystra 关于克制、可理解性、清晰边界和长期维护的原则。

它用于在目标服务器不能稳定访问镜像仓库时部署 Docker Compose 应用。

它会在能访问网络的机器上构建并保存镜像，创建发布包，通过 SSH 上传到 Linux 服务器，在服务器上 docker load 镜像，然后使用打包进去的 Compose 文件运行 docker compose up -d。

本机 Docker 构建
  -> 发布包
  -> SSH 上传
  -> 服务器 docker load
  -> docker compose up -d

当前状态

Tarsail 处于 Phase 0。它已经可用于简单的单服务器部署循环，但仍应按早期软件对待。

Phase 0 只专注一件事：在本机打包一个 Docker Compose 项目，并通过 SSH 部署到一台 Linux 服务器。

部署时不需要镜像仓库

目标服务器接收发布包里的镜像 tar 文件，并通过 docker load 加载。

单服务器 Compose

Tarsail 支持一个 Compose 文件、一台目标服务器和显式镜像标签。

显式传输密钥文件

环境文件和密钥文件只有在配置后才会上传。它们存放在 shared/ 中，不进入发布包。

按发布回滚

可以重新激活上一个已打包发布。数据库和 Docker volume 不在 Tarsail 的回滚边界内。

从这里开始

• 阅读概览理解部署模型。
• 按安装和升级安装 Tarsail。
• 按快速上手完成最短可用路径。
• 适配现有 Docker 项目时阅读适配 Compose 项目。
• 查阅配置了解所有支持字段。
• 上传环境文件或密钥文件前阅读安全模型。

Tarsail 不是什么

Tarsail 不是 PaaS、CI/CD 系统、镜像仓库、密钥管理器、监控平台、Kubernetes 抽象层或 Docker 图形界面。

它刻意保持在 SSH、tar、Docker 和 Docker Compose 附近。这个窄范围让部署路径更容易理解和维护。