logilab/cubicweb

CubicWeb Docker镜像

该项目帮助将基于CubicWeb的应用构建为https://www.docker.com/%E9%95%9C%E5%83%8F%E3%80%82%E6%9E%84%E5%BB%BA%E5%8C%85%E5%90%AB%E5%A4%9A%E7%A7%8D%E7%89%88%E6%9C%AC%E7%9A%84CubicWeb%E5%92%8CPython%EF%BC%8C%E5%B9%B6%E4%BD%BF%E7%94%A8https://www.debian.org/%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E3%80%82

标签

预安装CubicWeb的镜像

• latest、3.32、py37-buster-3.32
• dev、py37-buster-dev（使用最新的Mercurial变更集构建）
• 3.31、py37-buster-3.31
• 3.30、py37-buster-3.30
• 3.29、py37-buster-3.29
• 3.28、py37-buster-3.28
• 3.27、py37-buster-3.27
• 3.26、py37-buster-3.26
• 3.25、py27-buster-3.25
• py35-stretch-3.27
• py35-stretch-3.26
• py27-buster-3.26
• py27-stretch-3.26
• py27-buster-3.25
• py27-stretch-3.25

未安装CubicWeb的镜像

• py37、py37-buster
• py35、py35-stretch
• py27、py27-buster
• py27-stretch

用于构建Debian包的镜像

• buildpackage、buster-buildpackage
• stretch-buildpackage

包含内容

该镜像包含构建适用于生产环境的CubicWeb应用镜像所需的必要包，设计为应用Dockerfile的基础镜像。

核心组件

• 带psycopg2的Python环境
• /usr/bin/python和/usr/bin/pip符号链接到选定的Python版本（2.7、3.5或3.7）
• gettext、graphviz工具
• uwsgi服务器及配置文件（/etc/uwsgi/uwsgi.ini）
• 基于环境变量的pyramid配置模板（/pyramid.ini）
• 入口点脚本，用于配置pyramid.ini、管理静态数据文件（/etc/cubicweb.d/instance/data）及数据库自动升级

镜像预期

• 顶级cube源代码应位于/src目录，若从其他位置或PyPI安装需设置CUBE环境变量
• 默认实例名称为"instance"，配置目录位于/etc/cubicweb.d/instance，可通过CW_INSTANCE环境变量修改

构建CubicWeb应用镜像

选择建议

• 预安装CubicWeb的镜像：构建速度更快
• 未安装CubicWeb的镜像：允许使用自定义版本的CubicWeb
• onbuild镜像：已弃用，仅在Dockerfile位于源代码树且无需构建工具链时使用

构建示例

源码树构建

在cubicweb-blog源代码树中：

dockerfile
FROM docker.xuanyuan.run/logilab/cubicweb
USER root
COPY . /src
RUN pip install -e /src
USER cubicweb
RUN docker-cubicweb-helper create-instance

非源码树构建

从PyPI安装或非/src目录安装时：

dockerfile
FROM docker.xuanyuan.run/logilab/cubicweb
USER root
RUN pip install cubicweb-blog
USER cubicweb
ENV CUBE=blog
RUN docker-cubicweb-helper create-instance

onbuild镜像（已弃用）

警告：onbuild镜像包含自动操作逻辑，已弃用。

所有镜像均有-onbuild后缀版本，onbuild标签是py37-buster-3.28-onbuild的别名。

极简Dockerfile示例：

dockerfile
FROM docker.xuanyuan.run/logilab/cubicweb:onbuild

无Dockerfile构建命令：

bash
echo "FROM logilab/cubicweb:onbuild" | docker build -f - -t cubicweb-blog .

使用未预安装CubicWeb的onbuild镜像：

dockerfile
FROM docker.xuanyuan.run/logilab/cubicweb:py37-onbuild

运行生成的镜像

环境变量配置

关键环境变量：

• CW_BASE_URL：实例访问URL（默认：http://localhost:8080%EF%BC%89%EF%BC%8C%E9%9C%80%E5%8C%85%E5%90%AB%E5%8D%8F%E8%AE%AE%EF%BC%88%E5%A6%82https://myapp.example.com%EF%BC%89
• 数据库设置：CW_DB_DRIVER（默认：postgres）、CW_DB_NAME、CW_DB_USER、CW_DB_PASSWORD
• 管理员凭证：CW_LOGIN（默认：admin）、CW_PASSWORD（默认：admin）

快速测试（非持久化SQLite）

验证镜像功能：

bash
docker run --rm -it -e CW_DB_NAME=db.sqlite docker.xuanyuan.run/myimage sh -c "cubicweb-ctl db-create -a instance && uwsgi --ini /etc/uwsgi/uwsgi.ini"

访问 http://localhost:8080 查看实例

创建初始数据库

本地PostgreSQL

bash
docker run --rm -it -e CW_DB_NAME=myapp -e CW_DB_USER=me -v /var/run/postgresql:/var/run/postgresql docker.xuanyuan.run/myimage db-create

远程PostgreSQL

bash
docker run --rm -it -e CW_DB_NAME=myapp -e CW_DB_USER=me -e CW_DB_PASSWORD=secret -e CW_DB_HOST=dbserver docker.xuanyuan.run/myimage db-create

SQLite文件

bash
docker run --rm -it -e CW_DB_NAME=/tmp/db.sqlite -v /tmp/db.sqlite:/tmp/db.sqlite docker.xuanyuan.run/myimage db-create

运行WSGI服务器

前台运行

bash
docker run --rm -it -p 8080:8080 docker.xuanyuan.run/myapp

后台运行

bash
docker run -d --restart=always --name docker.xuanyuan.run/myapp myapp

运行调度任务（循环任务）

前台运行

bash
docker run --rm -it docker.xuanyuan.run/myapp cubicweb-ctl scheduler instance

后台运行

bash
docker run -d --restart=always --name myapp-scheduler docker.xuanyuan.run/myapp cubicweb-ctl scheduler instance

最佳实践

.dockerignore配置

避免复制无用文件：

.*
*.egg-info
**/__pycache__
Dockerfile
Jenkinsfile
Makefile
tox.ini
test
debian

基础镜像更新

构建前拉取最新基础镜像，确保包含安全更新和依赖更新：

bash
docker pull docker.xuanyuan.run/logilab/cubicweb

buildpackage镜像使用

用于构建Debian包并集成到多阶段构建中。

多阶段构建示例

假设依赖来自"deb [***] buster cubicweb-3.28"仓库：

dockerfile
FROM docker.xuanyuan.run/logilab/cubicweb:buildpackage as buildpackage
COPY . /src
RUN buildpackage -d /src

FROM docker.xuanyuan.run/logilab/cubicweb:3.28
COPY --from=buildpackage /repo /repo
RUN apt-get update && apt-get -y --no-install-recommends install cubicweb-blog
ENV CUBE=blog
USER cubicweb
RUN docker-cubicweb-helper create-instance

构建特定版本

从归档URL构建：

dockerfile
FROM logilab/cubicweb:buster-buildpackage
RUN buildpackage -u [***]
COPY . /src
RUN buildpackage -d /src