fix(stack): 修正构建上下文路径层级 ../../.. 并将 base-build 重命名为 author

2026-08-30 12:45:32 +08:00 · 2026-07-22 01:16:24 +08:00
parent 62e72af93d
commit bed965a9b1
10 changed files with 21 additions and 21 deletions
--- a/source/stack/author/Dockerfile
+++ b/source/stack/author/Dockerfile
@@ -0,0 +1,33 @@
+ARG BASE_IMAGE=ulthon/ulthon_admin-base:latest
+FROM ${BASE_IMAGE}
+
+# 设置工作目录
+WORKDIR /var/www/html
+
+# 预先拷贝 composer 文件并安装依赖，利用 Docker 缓存
+COPY composer.json composer.lock /var/www/html/
+RUN composer install --no-dev --no-interaction --no-scripts --no-autoloader
+
+# 将当前目录下的文件拷贝到工作目录
+COPY . /var/www/html
+
+# 生成自动加载文件
+RUN composer dump-autoload --optimize --no-dev --classmap-authoritative
+
+VOLUME /var/www/html/runtime
+VOLUME /var/www/html/public/storage
+VOLUME /var/www/html/public/build
+VOLUME /var/www/html/storage
+
+# 挂载主目录，也可以选择直接挂载主目录，可以把上面的几个指定的目录删掉
+# VOLUME ["/var/www/html"]
+
+# 暴露 Nginx 端口
+EXPOSE 8000
+
+RUN chmod +x /var/www/html/source/docker/run.sh
+
+# 启动 Nginx PHP 然后阻塞
+ENTRYPOINT ["/bin/bash", "/var/www/html/source/docker/run.sh"]
+
+CMD ["server"]
--- a/source/stack/author/docker-compose.yaml
+++ b/source/stack/author/docker-compose.yaml
@@ -0,0 +1,22 @@
+
+name: ulthon_admin
+
+
+services:
+    ulthon_admin:
+        # 正式环境中，您应当构建一个完整镜像，使用镜像名称或id运行，不要使用dockerfile
+        # image: ulthon/ulthon_admin:v1
+        build:
+            context: ../../.. # 仓库根目录（B-route：从模式目录 cd 进来后指向根）
+            dockerfile: source/stack/author/Dockerfile # Dockerfile 的名称
+        restart: always
+        ports:
+            - "8000:8000" # HTTP
+        volumes:
+            - ../../..:/var/www/html  # 直接分发代码可以去掉注释并将下面的目录增加注释
+            # - ./runtime:/var/www/html/runtime
+            # - ./public/storage:/var/www/html/public/storage
+            # - ./public/build:/var/www/html/public/build
+            # - ./storage:/var/www/html/storage
+        extra_hosts:
+            - "host.docker.internal:host-gateway"
--- a/source/stack/author/docker/Dockerfile.base
+++ b/source/stack/author/docker/Dockerfile.base
@@ -0,0 +1,39 @@
+FROM php:8.2-fpm-bookworm
+
+RUN rm -rf /etc/apt/sources.list.d/* \
+    && echo "deb http://mirrors.ustc.edu.cn/debian/ bookworm main contrib non-free non-free-firmware" > /etc/apt/sources.list \
+    && echo "deb http://mirrors.ustc.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware" >> /etc/apt/sources.list \
+    && echo "deb http://mirrors.ustc.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware" >> /etc/apt/sources.list
+
+RUN apt-get update
+
+# 安装 nginx
+RUN apt-get install -y nginx
+
+ADD --chmod=0755 https://nexus.hl7.top:1243/repository/github-raw-proxy/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
+
+# 配置代理
+RUN sed -i 's|aomedia.googlesource.com|nexus.hl7.top:1243/repository/raw-aomedia.googlesource.com|g' /usr/local/bin/install-php-extensions
+RUN sed -i 's|chromium.googlesource.com|nexus.hl7.top:1243/repository/raw-chromium.googlesource.com|g' /usr/local/bin/install-php-extensions
+RUN sed -i 's|https://github.com|https://nexus.hl7.top:1243/repository/github-raw-proxy|g' /usr/local/bin/install-php-extensions
+
+RUN install-php-extensions pdo_mysql
+RUN install-php-extensions gd
+RUN install-php-extensions fileinfo
+RUN install-php-extensions opcache
+RUN install-php-extensions redis
+RUN install-php-extensions event
+RUN install-php-extensions imagick
+RUN install-php-extensions zip
+RUN install-php-extensions pcntl
+
+# 清理默认 Nginx 配置
+RUN rm /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default
+
+# 安装 Composer
+COPY --from=composer:2 /usr/bin/composer /usr/local/bin/composer
+RUN chmod +x /usr/local/bin/composer
+RUN composer config -g repos.packagist composer https://nexus.hl7.top:1243/repository/composer-proxy/
+
+# 设置工作目录
+WORKDIR /var/www/html
--- a/source/stack/author/docker/README.md
+++ b/source/stack/author/docker/README.md
@@ -0,0 +1,96 @@
+# Dockerfile.base 使用说明
+
+## 1. 文件作用
+
+`source/stack/author/docker/Dockerfile.base` 是 **ulthon_admin 的基础镜像构建文件**，用于提前固化这些“低频变更但构建耗时高”的基础层：
+
+- Debian 源与系统包（如 `nginx`）
+- PHP 扩展安装能力（`install-php-extensions`）
+- 常用 PHP 扩展（`pdo_mysql`、`gd`、`redis`、`imagick` 等）
+- Composer 二进制与全局仓库配置
+
+这个文件**不包含业务代码**（不会 `COPY .` 项目代码），只负责构建底座环境。
+
+---
+
+## 2. 与其他 Dockerfile 的关系
+
+当前模式设计下有三类 Dockerfile：
+
+- `source/stack/full/Dockerfile`：全量构建（历史兼容方案）
+- `source/stack/author/docker/Dockerfile.base`：基础镜像构建（本文件）
+- `source/stack/author/Dockerfile`：应用镜像构建（`FROM <base-image>`，再拷贝业务代码）
+
+推荐流程是：
+
+1. 先构建并推送基础镜像（用本文件）
+2. 应用构建基于基础镜像进行（减少重复安装依赖）
+
+---
+
+## 3. 你该如何做（标准步骤）
+
+以下以 DockerHub 仓库 `ulthon/ulthon_admin-base` 为例。
+
+### 3.1 登录 DockerHub
+
+```bash
+docker login
+```
+
+### 3.2 构建基础镜像（latest + 时间戳）
+
+在项目根目录执行：
+
+```bash
+docker build -f source/stack/author/docker/Dockerfile.base -t ulthon/ulthon_admin-base:latest .
+docker build -f source/stack/author/docker/Dockerfile.base -t ulthon/ulthon_admin-base:20260424233000 .
+```
+
+### 3.3 推送基础镜像
+
+```bash
+docker push ulthon/ulthon_admin-base:latest
+docker push ulthon/ulthon_admin-base:20260424233000
+```
+
+### 3.4 应用构建引用基础镜像
+
+当前项目 `Dockerfile`（默认）已支持：
+
+```dockerfile
+ARG BASE_IMAGE=ulthon/ulthon_admin-base:latest
+FROM ${BASE_IMAGE}
+```
+
+如果要固定版本，构建应用时可指定：
+
+```bash
+docker build --build-arg BASE_IMAGE=ulthon/ulthon_admin-base:20260424233000 -t ulthon/ulthon_admin-app:test .
+```
+
+---
+
+## 4. 何时需要重建基础镜像
+
+出现以下情况时，建议重建并推送 `Dockerfile.base`：
+
+- 新增/删除 PHP 扩展
+- 修改系统依赖（apt 包）
+- 调整 Composer 全局配置
+- 需要安全更新（基础镜像、系统包漏洞修复）
+
+如果只是业务代码变化，一般不需要重建基础镜像。
+
+---
+
+## 5. 注意事项
+
+- `Dockerfile.base` 建议由框架作者维护（避免业务方随意改底座导致环境漂移）。
+- 标签建议同时维护：
+  - `latest`：默认引用
+  - 时间戳：可追溯、可回滚
+- 若默认模式为 `author`，请保持：
+  - 根目录 `Dockerfile`
+  - `source/stack/default/Dockerfile`
+  二者内容一致（符合 `source/stack` 目录规范）。
--- a/source/stack/author/source/docker/run.sh
+++ b/source/stack/author/source/docker/run.sh
@@ -0,0 +1,37 @@
+#!/bin/bash
+
+# 将代码中的nginx复制到nginx配置文件中
+cp /var/www/html/source/docker/nginx.conf /etc/nginx/sites-available/default
+ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default
+
+# 将代码中的php配置文件复制到php配置文件中
+cp /var/www/html/source/docker/zz-phprun.ini /usr/local/etc/php/conf.d
+cp /var/www/html/source/docker/zz-phpfpm.conf /usr/local/etc/php-fpm.d
+
+
+# 设置目录权限，确保挂载卷后依然有效
+mkdir -p /var/www/html/runtime && chmod -R 777 /var/www/html/runtime
+mkdir -p /var/www/html/public/storage && chmod -R 777 /var/www/html/public/storage
+mkdir -p /var/www/html/public/build && chmod -R 777 /var/www/html/public/build
+mkdir -p /var/www/html/storage && chmod -R 777 /var/www/html/storage
+mkdir -p /var/www/html/memoryspace && chown -R www-data:www-data /var/www/html/memoryspace
+
+
+# 运行redis
+# nohup redis-server --requirepass "" &
+
+# 输出参数
+echo "参数为：$@"
+
+# TODO：增加自动批量运行并阻塞的脚本，比如：group default ，会调用auto.sh的default的部分，最终阻塞，auth.sh的default部分，可能会运行一系列的命令，比如清空缓存，踢人下线，重置密码
+
+if [ "$1" = "server" ] || [ "$1" = "" ]; then
+    # 运行定时任务 TODO:以指定用户运行
+    su - www-data -c "nohup php /var/www/html/think timer --local --quiet &"
+    # 运行nginx
+    service nginx start
+    # 运行php-fpm
+    php-fpm
+else
+    php "/var/www/html/""$@"
+fi