kriss/webman-docker

docker for webman app


Keywords
docker, webman
License
MIT

Documentation

webman docker

简介

将 docker 用于 webman 的开发和生产部署

镜像地址和 tag

docker hub

  • krisss/docker-webman:7.4-cli-alpine
  • krisss/docker-webman:8.0-cli-alpine
  • krisss/docker-webman:8.1-cli-alpine
  • krisss/docker-webman:8.2-cli-alpine

此镜像会通过 github actions 动态更新 php 的小版本,镜像 tag 名不变

2.3.0 之后增加类似 7.4-cli-alpine-v2.3.0 形式的镜像版本,用于固定一个在发布版本时当前镜像中的各个组件版本(求稳可以用这种版本的镜像)

镜像中的组件

安装

composer require webman-tech/docker

会在项目根目录下提供 Dockerfile 用于构建镜像,提供 docker-compose.yml 用于开发

使用

当开发环境使用:目前代码未建立

启动镜像

docker run --rm --name webman \
 -v /local/workspace:/app \
 -p 8787:8787 \
 -it \
 --privileged -u root \
 --entrypoint /bin/sh \
 krisss/docker-webman:7.4-cli-alpine

创建项目

composer create-project workerman/webman

启动项目

cd webman
php start.php start

访问 http://localhost:8787 即可

当开发环境使用:已有 webman 代码

在项目下自建 docker-compose.yml,参考例子如下:

version: "3.7"

services:
  webman:
    image: krisss/docker-webman:${DOCKER_WEBMAN_VERSION:-7.4-cli-alpine}
    ports:
      - "${DOCKER_WEBMAN_PORT:-8787}:8787"
    volumes:
      - .:/app

启动:

docker-compose up

访问 http://localhost:8787 即可

打包项目成镜像

在项目下自建 Dockerfile,参考例子如下:

ARG WEBMAN_DOCKER_VERSION=7.4-cli-alpine

# https://github.com/krissss/docker-webman
FROM krisss/docker-webman:$WEBMAN_DOCKER_VERSION

# 增加额外的扩展
#RUN install-php-extensions imagick

# 设置配置文件
# 自定义 php 配置文件,如果需要的话
# 覆盖镜像自带的
#COPY environments/docker/php.ini "$PHP_INI_DIR/conf.d/app.ini"
# 扩展额外的
#COPY environments/docker/my_php.ini "$PHP_INI_DIR/conf.d/my_php.ini"
# 自定义 supervisor 配置,如果需要的话
# 覆盖镜像自带的
#COPY environments/docker/supervisord.conf /etc/supervisor/supervisord.conf
# 扩展额外的
#COPY environments/docker/my_supervisord.conf /etc/supervisor/conf.d/my_supervisord.conf

# 预先加载 Composer 包依赖,优化 Docker 构建镜像的速度
COPY ./composer.json /app/
COPY ./composer.lock /app/
RUN composer install --no-interaction --no-dev --no-autoloader --no-scripts

# 复制项目代码
COPY . /app

# 执行 Composer 自动加载和相关脚本
RUN composer install --no-interaction --no-dev && composer dump-autoload

编译:

docker build -t {image-name} .

运行:

docker run --rm -p 8787:8787 {image-name}

访问 http://localhost:8787 即可

For Developer

修改 Dockerfile 后测试方式:

  1. 新建 .env 文件,其中配置 docker-compose.yml 中的 env 变量
  2. 执行build:docker-compose build webman
  3. 本机测试:docker run --rm -it {ImageName}:{ImageTag} /bin/sh