Litestream 与 Docker 集成示例教程

1. 项目介绍

本项目是基于开源项目 litestream 的一个Docker集成示例。Litestream 是一个为 SQLite 数据库提供实时复制功能的工具。本项目通过在一个 Docker 容器中同时运行一个 Go 应用程序和 Litestream，展示了如何为 SQLite 应用实现数据复制。

2. 项目快速启动

环境准备

• Docker
• S3 兼容存储（用于 Litestream 数据复制）

配置存储

首先，您需要设置一个 S3 兼容存储，并将存储的访问密钥设置为环境变量：

export LITESTREAM_AUTH_KEY=您的AuthKey
export LITESTREAM_SECRET_KEY=您的SecretKey

构建镜像

使用以下命令构建 Docker 镜像：

docker build -t myapp .

运行容器

构建完成后，运行以下命令启动容器：

docker run \
-p 8080:8080 \
-v ${PWD}:/data \
-e REPLICA_URL=s3://您的Bucket名称/db \
-e LITESTREAM_AUTH_KEY \
-e LITESTREAM_SECRET_KEY \
myapp

参数解释：

• -p 8080:8080: 将容器的 8080 端口映射到宿主机的 8080 端口。
• -v ${PWD}:/data: 将当前工作目录挂载到容器内的 /data 目录。
• -e REPLICA_URL=s3://您的Bucket名称/db: 设置环境变量，指定 Litestream 的数据复制地址。
• -e LITESTREAM_AUTH_KEY: 传递 S3 认证密钥到容器。
• -e LITESTREAM_SECRET_KEY: 传递 S3 密钥到容器。

3. 应用案例和最佳实践

数据恢复

如果容器意外停止，您可以通过删除数据库文件来模拟灾难恢复：

rm -rf db db-shm db-wal .db-litestream

重新启动容器时，Litestream 会检测到数据库不存在，并从复制的副本中恢复：

docker run ...

持续集成

在持续集成（CI）流程中集成此镜像，确保在部署前数据库状态是最新的，并且复制功能正常。

4. 典型生态项目

• SQLite 数据库管理工具：结合其他开源的 SQLite 管理工具，如 Adminer，在同一个 Docker 容器中管理数据库。
• Web 应用程序：与各种 Web 框架（如 Flask、Django、Rails 等）集成，为 Web 应用提供数据复制功能。
• 微服务架构：在微服务架构中，为每个服务提供独立的数据库复制，确保数据的一致性。

通过上述实践，可以更好地将 Litestream 集成到您的应用程序中，确保数据的安全性和可靠性。