前言
在树莓派中搭建php环境,按正常流程一般是直接在系统中apt-get install相关的软件,不过如果某天我想无缝迁移到另一个地方,就又得在重新安装一次环境。所以为了方便,就直接在树莓派中使用docker镜像来构建环境,这样以后在任意地方直接拉镜像就可以一键启动环境。
1.安装docker
$ curl -fsSL https://get.docker.com -o get-docker.sh $ sh get-docker.sh --mirror Aliyun
使用aliyun镜像下载安装,速度更快,脚本能自动识别arm架构,安装对应的架构版本
安装好后,可以执行下面语句查看docker版本
$ sudo docker version
如果不想切root去操作容器,可以将pi用户加进docker用户组
$ sudo usermod -aG docker pi
pi用户加进docker用户组后,就有权限查看和操作docker的所有容器,只是不能操作docker server
最后可以启动一个镜像来试试效果
$ docker run -it --rm hello-world
如果本地没有hello-world镜像,则会从官方镜像库拉取,而且会自动拉取arm版本的,执行成功后,应该会看到几段输出
备注:
树莓派是arm架构的,所以不能使用x86平台的镜像,在使用docker pull 拉取时,docker会自动根据当前架构去查找是否有架构匹配的镜像,所以,如果是自制镜像,则需要分平台编译,或者在x86平台使用QEMU虚拟机实现跨平台编译
查看当前架构的方法
$ uname -a
在树莓派的raspberrypi系统中执行,则会输出
Linux raspberrypi 4.14.98-v7+ #1200 SMP Tue Feb 12 20:27:48 GMT 2019 armv7l GNU/Linux
可以看到我的树莓派是armv7
2.编译nginx和php的arm镜像
镜像库中已经有现成的nginx和php官方镜像,也是开箱即用,不过我们得增加一些配置和扩展,以便于自己的使用,所以我们在官方镜像的基础上再编译一个新的属于自己专用的镜像。
首先在raspberrypi上建立文件夹专门管理这些文件
$ mkdir -p ~/docker/rpi
2.1 编译nginx镜像
在raspberrypi建立对应管理文件夹
$ cd ~/docker/rpi $ mkdir nginx $ cd nginx
首先是创建Dockerfile
$ touch Dockerfile
然后编辑文件写入构建语句
$ vim Dockerfile #如果没有vim可以使用nano,或者手动安装vim #写入以下语句 # 依赖的基础镜像 FROM nginx:latest #创建者名称 MAINTAINER olivercj #创建日志目录 RUN mkdir -p /data/web_log/nginx_log # 添加fastcgi参数配置文件 ADD ./fastcgi.conf /etc/nginx # 修改原来的nginx配置 ADD ./nginx.conf /etc/nginx/nginx.conf #打开端口80和443 EXPOSE 80 EXPOSE 443
以下是对应fastcgi.conf和nginx.conf的文件内容,,都需要在Dockerfile的同级目录创建并写入
# fastcgi.conf文件内容 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; fastcgi_param SCRIPT_NAME $fastcgi_script_name; fastcgi_param REQUEST_URI $request_uri; fastcgi_param DOCUMENT_URI $document_uri; fastcgi_param DOCUMENT_ROOT $document_root; fastcgi_param SERVER_PROTOCOL $server_protocol; fastcgi_param REQUEST_SCHEME $scheme; fastcgi_param HTTPS $https if_not_empty; fastcgi_param GATEWAY_INTERFACE CGI/1.1; fastcgi_param SERVER_SOFTWARE nginx/$nginx_version; fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; # PHP only, required if PHP was built with --enable-force-cgi-redirect fastcgi_param REDIRECT_STATUS 200;
================================分割线=========================
# nginx.conf文件内容
worker_processes 1; error_log /data/web_log/nginx_log/error.log warn; pid /var/run/nginx.pid; events { worker_connections 1024; } http { include /etc/nginx/mime.types; default_type application/octet-stream; log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"'; access_log /data/web_log/nginx_log/access.log main; sendfile on; #tcp_nopush on; keepalive_timeout 65; client_max_body_size 10m; proxy_connect_timeout 65s; proxy_send_timeout 65s; proxy_read_timeout 65s; #gzip on; include /data/webconfig/nginx/conf.d/*.conf; #include /etc/nginx/conf.d/*.conf; }
这里我们修改了原来nginx默认的日志目录,默认虚拟机配置加载目录,增加了fastcgi参数配置文件,修改了默认的nginx配置文件
目的是为了后面方便挂载目录,以后查看日志,增加配置什么的都更方便。
现在配置什么的都准备好了,可以构建了,执行以下命令
$ docker build -t my_nginx_arm:0.1 .
最后一个点千万不能省掉,他表示当前目录,命令执行后悔在当前目录查找Dockerfile文件,然后根据文件描述自动进行构建编译,当成功后会使用-t后面的设置给新的镜像命名。由于本地没有nginx:latest镜像,所以第一步他会去官方镜像库下载。
等编译完成,执行
$ docker images
就可以看到已经编译好的新的镜像了,他的TAG为my_nginx_arm ,版本为0.1
2.2 编译php镜像
在raspberrypi建立对应管理文件夹
$ cd ~/docker/rpi $ mkdir php $ cd php
首先是创建Dockerfile
$ touch Dockerfile
然后编辑文件写入构建语句
$ vim Dockerfile #如果没有vim可以使用nano,或者手动安装vim #写入以下语句 FROM php:7.1-fpm MAINTAINER olivercj WORKDIR /data RUN apt-get update && apt-get install --allow-downgrades -y \ zlib1g=1:1.2.8.dfsg-5 \ zlib1g-dev \ libfreetype6-dev \ libjpeg62-turbo-dev \ libmcrypt-dev \ libpng-dev \ && docker-php-ext-install -j$(nproc) iconv mcrypt \ && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \ && docker-php-ext-install -j$(nproc) gd bcmath calendar gettext mysqli pdo_mysql RUN pecl install redis-4.1.1 \ && pecl install yaf-3.0.5 \ && docker-php-ext-enable redis yaf RUN echo "yaf.use_spl_autoload=1\n" \ "yaf.environ=product\n" \ "yaf.use_namespace=1\n" \ >> /usr/local/etc/php/conf.d/docker-php-ext-yaf.ini RUN rm -rf /usr/local/etc/php-fpm.d/*.conf ADD ./php-fpm.conf /usr/local/etc/php-fpm.conf ADD ./www.conf /usr/local/etc/php-fpm.d/www.conf #ADD ./php.ini /usr/local/etc/php RUN mkdir -p /data/web_log/php_log EXPOSE 9000
以下是对应php-fpm.conf和www.conf的文件内容,都需要在Dockerfile的同级目录创建并写入。php.ini因为文件内容很长,这里不方便贴出,而且只是改动了一些时区,超时等配置,我们可以在镜像启动后手动进入容器修改配置,所以这里就注释掉,不替换默认的配置
#php-fpm.conf文件内容 [global] daemonize = no error_log = /data/web_log/php_log/error.log include=etc/php-fpm.d/*.conf ===============分割线================ #www.conf文件内容 [www] user = www-data group = www-data access.log = /data/web_log/php_log/access.log clear_env = no ; Ensure worker stdout and stderr are sent to the main error log. catch_workers_output = yes listen = 0.0.0.0:9000 pm = dynamic pm.max_children = 5 pm.start_servers = 2 pm.min_spare_servers = 1 pm.max_spare_servers = 3 pm.status_path = /php-status
这里我们依赖的是php-fpm7.1,如果需要其他Php版本,可以自行修改,同时也修改了原来php的默认日志目录,而且在dokcerfile中我们增加了很多新的扩展,当然如果你有自己需要的其他扩展,也可以自己加进去,其中zlib1g这个需要注意,在debian不同的系统版本中,对应的依赖版本号是不一样的,当前zlib1g=1:1.2.8.dfsg-5 对应的是stretch版本系统。
准备好配置文件,就可以进行构建,执行以下命令
$ docker build -t my_php-fpm71_arm:0.1 .
由于需要下载php镜像,还有安装扩展,可能会花费非常长的时间
编译完后同样执行docker iamges可以看到新的php镜像已经出现在列表中
镜像构建好只是存放在本地,在其他地方并不能直接拉取使用,所以需要存到远程仓库里,我们可以直接使用官方仓库,,首先去https://hub.docker.com/注册账号,创建自己的仓库,然后在raspberrypi系统中执行docker login,用刚注册的账号密码登录,登录后就可以执行推送了
#推送nginx镜像 $ docker push xxxxxx/my_nginx_arm:0.1 #推送php镜像 $ docker push xxxxxx/my_php-fpm71_arm:0.1
xxxx表示创建的仓库名
3. 启动
镜像有了,启动就很简单了,不过在启动之前需要做些准备,因为,我们镜像中改变了默认的日志,配置目录,为了方便管理,我们使用挂载的方式,打通宿主机和容器之间的存储,这样以后直接在宿主机就可以查看和修改一些重要内容
在raspberrypi系统中执行
#创建php日志目录 $ sudo mkdir -p /data/web_log/php_log #创建Nginx日志目录 $ sudo mkdir -p /data/web_log/nginx_log #创建nginx虚拟机配置目录 $ sudo mkdir -p /data/webconfig/nginx/conf.d/ #创建代码存放目录 $ sudo mkdir -p /data/web_root
#修改目录及其子目录权限
$ sudo chown -R pi:pi /data
现在可以启动容器了
#启动php容器 $ docker run -itd -P --name php --restart always -v /data:/data olivercj/my_php-fpm71_arm:0.1 #启动nginx容器 $ docker run -itd -p 80:80 -p 443:443 --name nginx --link php --restart always -v /data:/data olivercj/my_nginx_arm:0.1
我们必须按顺序先启动php容器,再启动nginx容器,因为nginx容器link了php容器,主要是为了方便容器间通信,使nginx可以方便的发送fastcgi请求到php.
我们使用-v命令挂载了宿主机的data目录。
到目前为止,整个php+nginx环境已经构建好了,下次如果换系统,只需要安装个docker,然后Pull相关镜像,直接run起来就搞定。
4.搭建pi-dashboard
接下来我们搭建pi-dashboard,作为在这套环境下搭建网站的例子
首先还是在raspberrypi系统中,进入站点根目录
$ cd /data/web_root
我们把这个目录作为所有网站的总的目录
拉取pi-dashboard代码
$git clone https://github.com/spoonysonny/pi-dashboard.git
拉取完成后,目录下会生成pi-dashboard的目录,里面就是我们需要的代码
然后创建虚拟机配置
$ cd /data/webconfig/nginx/conf.d/
在这个目录下创建一个Pi-dashboard的虚拟机配置
$ vim pi-dashboard.conf #写入以下配置内容 server { listen 80; server_name pi-board.local.com; access_log /data/web_log/nginx_log/pi_access.log main; error_log /data/web_log/nginx_log/pi_error.log error; root /data/web_root/pi-dashboard/; location / { index index.php index.html index.htm; try_files $uri $uri/ =404; } location ~ \.php$ { fastcgi_pass php:9000; fastcgi_index index.php; include fastcgi_params; include fastcgi.conf; } }
其中server_name 可以改成自己喜欢的域名,root指向刚刚拉取的代码的目录
保存后,为了使配置生效,需要重新nginx,有2种方式,1个就是直接重启容器,不过这种方式有点暴力,我们通常还是采用nginx的平滑重启来加载更新配置
nginx运行在容器中,所以有2种方式进行平滑重启
1.登录到容器中,执行平滑重启
#登录容器 $ docker exec -it nginx /bin/bash #登录后,会切换到容器的bash中,执行以下命令 #检查配置合法性,如果没问题再执行下一条 $ nginx -t # 平滑重启 $ nginx -s reload
2. 直接在docker命令上执行,其实是将登录和执行串起来
#检查配置合法性,如果没问题再执行下一条
$ docker exec nginx nginx -t
#平滑重启
$ docker exec nginx nginx -s reload
nginx重启之后,整个网站搭建就完成了
这时如果我们需要在个人电脑访问这个网站,就需要做hosts映射
linux/unix类系统在/etc/hosts中增加一条记录
x.x.x.x pi-board.local.com
x.x.x.x表示树莓派对应的IP地址,可以在raspberrypi中通过ifconfig获取
然后在个人电脑的浏览器中直接输入pi-board.local.com就可以访问了
5.
至此,环境搭建已经完成,我们可以在树莓派上轻松愉快的搭建自己的网站,如果有同学不想构建镜像,可以直接拉取我已经构建好的,开箱即用
nginx: https://cloud.docker.com/u/olivercj/repository/docker/olivercj/ningx-arm
php: https://cloud.docker.com/u/olivercj/repository/docker/olivercj/php-fpm-arm