SQLite3 Docker镜像

基于最新源代码构建的SQLite3 Alpine Docker镜像。

bash
docker pull keinos/sqlite3:latest

特性

• 当前SQLite3版本：
  • ![SQLite版本]([***]
  • 查看可用标签（SQLite版本） @ DockerHub
• 支持架构：
  • Arm64、Armv6、Armv7及Intel/AMD64
• INIT系统支持：
  • Tini（修复：#65）
• 扫描状态：
  • ![Snyk Docker扫描]([***]
  • ![容器扫描]([***]

镜像信息（Dockerfile、安全扫描、镜像签名、软件物料清单等）

• INIT支持：
  • 自标签3.47.2-20241207-tini起，镜像默认使用Tini作为init进程。（参见PR #65）
    • 原SQLite3作为PID 1进程运行，此变更确保容器在接收SIGTERM或SIGINT信号（如docker stop）时能优雅停止。
• 仓库/注册表：
  • 镜像仓库 @ DockerHub
  • Dockerfile @ GitHub
  • 问题反馈 @ GitHub
• 构建信息：
  • 基础镜像：alpine:latest
  • SQLite3源码：[***] @ SQLite.org
  • 更新频率：每周一次
• 基础漏洞扫描：
  • 推送、PR及合并时执行Snyk Docker扫描和Grype容器扫描
  • 扫描频率：每周一次
  • 详情参见安全概览
• 使用Cosign验证镜像签名：

  • 自3.50.4版本起，镜像使用Cosign签名。验证结果应包含“The cosign claims were validated”。（参见issue #86和#88）

    bash
    # 获取摘要
    DIGEST=$(docker buildx imagetools inspect "docker.io/keinos/sqlite3:latest" --format '{{json .}}' | jq -r '.manifest.digest')
    
    # 验证
    cosign verify \
      --certificate-identity '[***] \
      --certificate-oidc-issuer '[***] \
      "docker.io/keinos/sqlite3@${DIGEST}"
    

• 软件物料清单（SBOM）：
  • 镜像包含SBOM，可查看镜像中使用的软件组件：

  shellsession
  $ docker sbom keinos/sqlite3:latest
  Syft v0.43.0
  ✔ Loaded image
  ✔ Parsed image
  ✔ Cataloged packages      [14 packages]
  
  NAME                    VERSION      TYPE
  alpine-baselayout       3.6.5-r0     apk
  alpine-baselayout-data  3.6.5-r0     apk
  alpine-keys             2.4-r1       apk
  apk-tools               2.14.4-r0    apk
  busybox                 1.36.1-r29   apk
  busybox-binsh           1.36.1-r29   apk
  ca-certificates-bundle  20240226-r0  apk
  lib***3              3.3.1-r0     apk
  libssl3                 3.3.1-r0     apk
  musl                    1.2.5-r0     apk
  musl-utils              1.2.5-r0     apk
  scanelf                 1.3.7-r2     apk
  ssl_client              1.36.1-r29   apk
  zlib                    1.3.1-r1     apk
  

使用方法

拉取最新镜像

shellsession
$ docker pull keinos/sqlite3:latest
**snip**

指定版本拉取

shellsession
$ docker pull keinos/sqlite3:3.44.2
...

• 可用版本 @ hub.docker.com

本地构建

shellsession
$ docker build -t sqlite3:local [***]
...

交互模式

在容器内交互式运行sqlite3命令：

shellsession
$ docker run --rm -it -v "$(pwd):/workspace" -w /workspace keinos/sqlite3
SQLite version 3.28.0 2019-04-16 19:49:53
Enter ".help" for usage hints.
Connected to a transient in-memory database.
Use ".open FILENAME" to reopen on a persistent database.
sqlite> .open ./sample.db
sqlite> CREATE TABLE table_sample(timestamp TEXT, description TEXT);
sqlite> INSERT INTO table_sample VALUES(datetime('now'),'First sample data. Foo');
sqlite> INSERT INTO table_sample VALUES(datetime('now'),'Second sample data. Bar');
sqlite> .quit
$ ls
sample.db

• 注意：需将工作目录挂载为容器卷。

命令执行

• 运行sqlite3 --version命令：

shellsession
$ docker run --rm keinos/sqlite3 sqlite3 --version
3.38.2 2022-03-26 13:51:10 d33c709cc0af66bc5b6dc6216eba9f1f0b40960b9ae83694c986fbf4c1d6f08f

• 对挂载的数据库执行SQL查询：

shellsession
$ ls
sample.db
$ docker run --rm -it -v "$(pwd):/workspace" keinos/sqlite3 sqlite3 /workspace/sample.db -header -column 'SELECT rowid, * FROM table_sample;'
rowid  timestamp            description
-----  -------------------  -----------------------
1      2022-04-16 14:09:52  First sample data. Foo
2      2022-04-16 14:09:58  Second sample data. Bar

• 注意：需将工作目录挂载为容器卷。

运行测试

容器包含简单测试脚本，可验证容器及sqlite3二进制文件是否正常工作（不适用于HEALTHCHECK）：

shellsession
$ docker run --rm keinos/sqlite3 /run-test.sh
- Creating test DB ... created
rowid  timestamp            description
-----  -------------------  -----------------------
1      2022-04-16 14:18:34  First sample data. Hoo
2      2022-04-16 14:18:34  Second sample data. Bar
- Testing ...
  1st row value ... OK
  2nd row value ... OK

- Test result:
success
$ echo $?
0

• 如有测试需求，可反馈。

在Dockerfile中使用

若基于alpine构建镜像，可从本镜像复制sqlite3二进制文件：

Dockerfile
FROM keinos/sqlite3:latest AS sqlite3

FROM alpine:latest

COPY --from=sqlite3 /usr/bin/sqlite3 /usr/bin/sqlite3

ENV \
  USER_SQLITE=sqlite \
  GROUP_SQLITE=sqlite
RUN \
  addgroup -S $GROUP_SQLITE && \
  adduser  -S $USER_SQLITE -G $GROUP_SQLITE

... 执行其他操作 ...

待办事项

• DockerHub ARM支持（Issue #2，PR #20）

许可证

• Dockerfile：MIT许可证，由SQLite3 Dockerfile贡献者提供。
• SQLite：公共领域，由D. Richard Hipp及SQLite.org提供。
• 容器中以下包使用GPL-3.0-or-later许可证：
  • GNU patch
  • GNU make
  • GNU dbm（gdbm）
  • Debian fakeroot
  • GNU Readline Library
  • GNU Tar