使用 Docker / Docker Compose 部署 Swoft 应用

php基础

浏览数:226

2018-12-8

AD:资源代下载服务

Swoft

首个基于 Swoole 原生协程的新时代 PHP 高性能协程全栈框架,内置协程网络服务器及常用的协程客户端,常驻内存,不依赖传统的 PHP-FPM,全异步非阻塞 IO 实现,以类似于同步客户端的写法实现异步客户端的使用,没有复杂的异步回调,没有繁琐的 yield, 有类似 Go 语言的协程、灵活的注解、强大的全局依赖注入容器、完善的服务治理、灵活强大的 AOP、标准的 PSR 规范实现等等,可以用于构建高性能的Web系统、API、中间件、基础服务等等。

Swoft 的 Docker 镜像

突然白话文 clipboard.png
使用 docker 安装 swoft 其实听起来比较怪怪的,swoft 是一套 php 框架,依赖 swoole 扩展,说 docker 安装 swoft,其实是 docker 安装 swoft 运行所需的组件依赖和环境。

swoft 框架运行环境所需的依赖和环境挨个安装搭建还是需要一些时间的,比如 php 版本 >= 7.1, swoole 版本 >= 2.1, 而且还要安装 hiredis 来协助开启 swoole 的异步 redis 客户端,同时要求 swoole 开启协程模式等。

所以呢,为了节省我们的时间,官方提供了一个 docker 镜像包,里面包含了 swoft 运行环境所需要的各项组件:

php 7.1+
swoole 2.1+ –enable-async-redis-client –enable-coroutine
composer
pecl

我们只需要下载镜像并新建一个容器,这个容器就提供了 swoft 框架所需的所有依赖和环境,然后将宿主机上的 sowft 项目挂载到 swoft 镜像的工作目录 /var/www/swoft 下,就可以继续我们的开发或生产工作了。让你从 swoft 略繁琐的依赖和环境搭建中解放出来,直接进入业务开发工作中去。

一开始我没理解好这个 swoft 镜像,镜像里自带的框架其实是单纯的用来体验的,我一直误以为要编辑镜像
的 swoft 框架源码做开发….clipboard.png

需要特别注意的是,sowft 镜像的 entrypoint 命令(运行初始化命令)是

ENTRYPOINT ["php", "/var/www/swoft/bin/swoft", "start"]

即容器启动时会同时启动 swoft 框架,这就需要如果我们挂载本地 swoft 项目到镜像工作目录时,本地的 swoft 项目需已安装好框架的各依赖组件。我们从 git 上直接拉取的 swoft 项目是没有安装这些组件的,需使用 composer install [–no-dev] 安装,框架才能正常启动,这就要求宿主机上至少要有基础的 php + composer 的环境。当然,镜像内是工作目录下是有一套完全安装的 swoft 框架的,如果你只是为了体验,直接启动容器就好,但没什么直接的意义。在后面我们将给出一个只需要在宿主机上安装运维所需的 docker docker-compose git 即可完全借助 swoft 镜像去部署开发或生产环境的方法(修改镜像 entrypoint 到 bash 模式,然后进入镜像后使用 composer 安装依赖,启动 swoft)

Docker 部署 swoft

宿主机仍需安装基本的 php / composer(或者你把自己本地开发的项目cp过来,但这样可能会导致部分组件版本不一致,还是提交业务代码 + composer.json + composer.lock 文件,排除 vendor 目录,在线上服务器再 composer install 一遍最为规范)

1、在宿主机创建 swoft 项目(宿主机需实安装基础的 php 环境来使用 composer)

composer create-project --prefer-dist swoft/swoft swoft [--dev] && cd swoft
或者
git clone git@github.com:swoft-cloud/swoft.git && cd swoft && composer install && cd swoft

2、拉取 swoft 镜像 创建 swoft 容器 并将宿主机上安装好的 swoft 项目挂载到 swoft 容器的工作目录

// 拉取 swoft 镜像
// 关联本地 swoft 项目目录到镜像的项目目录(/var/www/swoft)
// 映射主机 8081 端口 到 容器 80 端口
// 容器命名为 mySwoft
// 守护模式启动
docker run -v $(pwd):/var/www/swoft -p 8081:80 --name mySwoft -d swoft/swoft
// 查看容器是否运行
docker ps
// 查看容器日志
docker logs mySwoft

3、进入 swoft 容器 shell

// 交互模式执行 mySwoft 容器的 bash
docker exec -it mySwoft bash
// stop 会停止容器所以会退出 shell 后用 docker start mySwoft 启动就好
root@cce12db9add3:/var/www/swoft# php bin/swoft start|stop|reload
// 因我们将宿主机上的swoft项目挂载到了swoft容器的项目目录/var/www/swoft 所以后期开发修改宿主机上的项目即可
// 可以使用PS的FTP同步工具

可以在 swoft 的容器 shell 里通过命令查看相应的组件版本

root@cce12db9add3:/var/www/swoft# php -v         
root@cce12db9add3:/var/www/swoft# php --ri swoole
root@cce12db9add3:/var/www/swoft# composer -V    
root@cce12db9add3:/var/www/swoft# pecl -V

Docker Composer 部署 Swoft

宿主机仍需安装基本的 php / composer(或者你把自己本地开发的项目cp过来,但这样可能会导致部分组件版本不一致,还是提交业务代码 + composer.json + composer.lock 文件,排除 vendor 目录,在线上服务器再 composer install 一遍最为规范)
swoft 项目中是有 docker-compose.yml 文件的

version: '3'

services:
    swoft:
       image: swoft/swoft:latest
#      build: ./
       ports:
         - "80:80" #端口映射
       volumes:
         - ./:/var/www/swoft # 挂载当前路径下的本地swoft项目到镜像项目路径
       stdin_open: true #打开标准输出
       tty: true # 打开 tty 会话
       privileged: true # 给与权限 比如创建文件夹之类的
       entrypoint: ["php", "/var/www/swoft/bin/swoft", "start"] # 入口启动命令 即启动 swoft 服务

使用方法自然比直接用 docker 方便些,不过依旧是要在宿主机上先创建一个 swoft 项目

1、在宿主机创建 swoft 项目(宿主机需实安装基础的 php 环境来使用 composer)

composer create-project --prefer-dist swoft/swoft swoft [--dev] && cd swoft
或者
git clone git@github.com:swoft-cloud/swoft.git && cd swoft && composer install && cd swoft

2、使用 docker-compose 来编排启动容器

编辑 docker-compose.yaml 文件 给容器自定义个名字

version: '3'

services:
    swoft:
       image: swoft/swoft:latest
       container_name: mySwoft # 给容器自定义个名称便于管理
#      build: ./
       ports:
         - "80:80" #端口映射
       volumes:
         - ./:/var/www/swoft # 挂载当前路径下的本地swoft项目到镜像项目路径
       stdin_open: true #打开标准输出
       tty: true # 打开 tty 会话
       privileged: true # 给与权限 比如创建文件夹之类的
       entrypoint: ["php", "/var/www/swoft/bin/swoft", "start"] # 入口启动命令 即启动 swoft 服务
# 启动容器
docker-compose up -d swoft
# 查看容器是否成功运行
docker ps
# 进入容器shell
docker exec -it mySwoft bash

如何在未安装 PHP 环境的宿主机上部署 swoft

前面两种部署 swoft 的方法都需要在宿主机上安装 php 基础环境来使用 composer 安装好本地 swoft 项目的依赖组件,才能与 swoft 镜像的工作目录挂载,启动容器(因为容器的入口命令就是直接启动 swoft,如果我们挂载本地未安装好依赖的 swoft 项目到镜像工作目录,那容器就会启动失败退出了),下面我们介绍一种不需要在宿主机上安装 php / composer 的方法。

git+ docker + docker-composer

1、拉取 swoft(拉取就好,不需要安装)

git clone git@github.com:swoft-cloud/swoft.git && cd swoft && cd swoft

2、编辑 docker-composer.yaml 文件

修改容器启动的 entrypoint 命令,让容器启动,但不启动 swoft,等我们进入容器,使用容器中自带的 composer 安装好框架组件依赖后再启动 swoft

version: '3'

services:
    swoft:
       container_name: mySwoft
       image: swoft/swoft:latest
#      build: ./
       ports:
         - "8082:80" # 映射宿主机 8082 端口到 容器 80
       volumes:
         - ./:/var/www/swoft
       stdin_open: true # 一定要开启此项 否则容器会因 bash 执行完退出
       tty: true
       privileged: true
#      entrypoint: ["php", "/var/www/swoft/bin/swoft", "start"]
       entrypoint: ["bash"] # 改为此命令后 启动容器时默认不会启动 swoft 所以即使框架依赖未安装 也不会影响容器启动

3、保存 docker-composer.yaml 后启动容器

docker-composer up -d swoft

4、进入容器 shell 使用容器种的 composer 安装框架依赖

docker exec -it mySwoft bash

composer install [--no-dev]

5、启动 swoft

php bin/swoft start|stop|restart

这种方法使得宿主机完全省去了还要事先简单安装下 php / composer 的工作,完全发挥镜像的功能~

原文地址:https://segmentfault.com/a/1190000017297770