unibz/wordpress

WordPress Docker镜像文档

本文档描述了单独的WordPress Docker镜像。

步骤0：先决条件

1. 克隆此仓库。
2. 构建镜像（以下示例使用标签unibz/wordpress:3.1.0，请根据实际需求修改）：cd docker && docker build -t unibz/wordpress:3.1.0 .
3. 确保MySQL已启动并运行，且已准备好数据库和用户。

构建镜像后，对于每个要创建的新WordPress实例，需执行以下两个步骤：

1. 使用初始化脚本/entrypoint-init.sh作为入口点运行镜像（初始化完成后终止）
2. 使用默认设置运行镜像

步骤1：初始化

初始化运行需要将空卷挂载到/root目录。初始化入口点会使用默认目录/var/www/html初始化WordPress，最终将所有文件复制到/root。复制完成后，初始化入口点终止，此时卷和数据库已准备好附加到最终容器。

注意：Apache日志文件目录也会复制到卷中。

初始化需要以下环境变量：

必填环境变量

• MYSQL_HOST：MySQL数据库所在的主机
• MYSQL_USER：连接MySQL的用户名
• MYSQL_PASS：连接MySQL的密码
• MYSQL_NAME：数据库名称
• WP_FQDN：WordPress将使用的完全限定域名
• WP_NAME：WordPress博客标题
• WP_ADMIN_USER：WordPress管理员用户名
• WP_ADMIN_MAIL：WordPress管理员***
• WP_ADMIN_PASS：WordPress管理员密码
• ICTADMIN_USERNAME：ICT WordPress管理员用户名
• ICTADMIN_EMAIL：ICT WordPress管理员***
• ICTADMIN_PASSWORD：ICT WordPress管理员密码

可选环境变量

• INSTANCE_SUPPORTED：若设置为1，创建的WordPress实例将受支持（自动安装主题和插件，应用一些默认设置）
• EXPIRY_DATE：可选文本，将添加到/root/container-data.txt，标识网站可停用的日期
• REQUEST_ID：可选文本，将添加到/root/container-data.txt，标识创建当前网站的工单ID

以下是运行初始化容器的参考命令：

bash
$ docker run                                 \
    --rm                                     \ # 终止后删除初始化容器
    -it                                      \ # 若有错误将输出到标准输出
    --entrypoint=/entrypoint-init.sh         \ # 覆盖默认入口点
    --name test.local-init                   \ # 容器名称
    -h test.local                            \ # FQDN，用于指示Docker容器名称
    --link mariadb.local:mariadb.local       \ # 仅macOS使用（Linux不需要），当数据库为另一个容器时
    -v /path/to/volume/test.local:/root      \ # 将卷绑定挂载到容器的/root目录
    -e MYSQL_HOST=mariadb.local              \ # MySQL主机
    -e MYSQL_USER=wp_user                    \ # MySQL用户名
    -e MYSQL_PASS=wp_pass                    \ # MySQL密码
    -e MYSQL_NAME=wp_db                      \ # MySQL数据库名称
    -e WP_FQDN=test.local                    \ # 指示WordPress监听的地址
    -e WP_NAME=Test                          \ # WordPress博客标题
    -e WP_ADMIN_USER=giuroman                \ # WordPress管理员用户名
    -e WP_ADMIN_MAIL=giuroman@eurac.edu      \ # WordPress管理员邮箱
    -e WP_ADMIN_PASS=secret111               \ # WordPress管理员密码
    -e ICTADMIN_USERNAME=ictadmin            \ # ICT WordPress管理员用户名
    -e ICTADMIN_EMAIL=it@unibz.it            \ # ICT WordPress管理员邮箱
    -e ICTADMIN_PASSWORD=password123         \ # ICT WordPress管理员密码
    -e INSTANCE_SUPPORTED=1                  \ # 受支持实例（可选）
    -e EXPIRY_DATE=2099-12-31                \ # 过期日期（可选）
    -e REQUEST_ID=123456                     \ # 网站对应的工单ID（可选）
    unibz/wordpress:3.1.0

初始化脚本退出时返回以下状态码：

• 0：成功
• 1：缺少必填环境变量
• 2：wp-cli无法下载、安装和配置WordPress
• 3：无法将/var/www/html复制到卷
• 4：无法将/var/log/apache2复制到卷

步骤2：运行镜像

初始化完成后，卷和数据库保留WordPress站点状态，可启动最终容器。容器运行需将步骤1中使用的卷的子目录挂载到以下位置：

以下是运行容器的参考命令：

bash
$ docker run                                                                  \
    -d                                                                        \ # 如需调试，可替换为-it
    --name test.local                                                         \ # 容器名称
    -h test.local                                                             \ # FQDN，用于指示Docker容器名称
    --link mariadb.local:mariadb.local                                        \ # 可选：当数据库为另一个容器时
    -p 80:80                                                                  \ # 将主机80端口绑定到容器80端口
    -v /path/to/volume/test.local/container-data.txt:/root/container-data.txt \ # 此文件存在表示容器可启动
    -v /path/to/volume/test.local/html:/var/www/html                          \ # Web根目录
    -v /path/to/volume/test.local/apache2:/var/log/apache2                    \ # Apache日志目录
    --restart always                                                          \ # 崩溃时自动重启
    unibz/wordpress:3.1.0

若容器以状态码1终止，说明未找到/root/container-data.txt文件，即尝试使用未初始化的卷。