Docker 是一个容器工具,提供虚拟环境。很多人认为,它改变了我们对软件的认识。
站在 Docker 的角度,软件就是容器的组合:业务逻辑容器、数据库容器、储存容器、队列容器......Docker 使得软件可以拆分成若干个标准化容器,然后像搭积木一样组合起来。
这正是微服务(microservices)的思想:软件把任务外包出去,让各种外部服务完成这些任务,软件本身只是底层服务的调度中心和组装层。
微服务很适合用 Docker 容器实现,每个容器承载一个服务。一台计算机同时运行多个容器,从而就能很轻松地模拟出复杂的微服务架构。
上一篇教程介绍了 Docker 的概念和基本用法,本文接着往下介绍,如何在一台计算机上实现多个服务,让它们互相配合,组合出一个应用程序。
我选择的示例软件是 WordPress。它是一个常用软件,全世界用户据说超过几千万。同时它又非常简单,只要两个容器就够了(业务容器 + 数据库容器),很适合教学。而且,这种"业务 + 数据库"的容器架构,具有通用性,许多应用程序都可以复用。
为了加深读者理解,本文采用三种方法,演示如何架设 WordPress 网站。
- 方法 A:自建 WordPress 容器
- 方法 B:采用官方的 WordPress 容器
- 方法 C:采用 Docker Compose 工具
一、预备工作:image 仓库的镜像网址
本教程需要从仓库下载 image 文件,但是国内访问 Docker 的官方仓库很慢,还经常断线,所以要把仓库网址改成国内的镜像站。这里推荐使用官方镜像 registry.docker-cn.com 。下面是我的 Debian 系统的默认仓库修改方法,其他系统的修改方法参考官方文档。
打开/etc/default/docker
文件(需要sudo
权限),在文件的底部加上一行。
DOCKER_OPTS="--registry-mirror=https://registry.docker-cn.com"
然后,重启 Docker 服务。
$ sudo service docker restart
现在就会自动从镜像仓库下载 image 文件了。
二、方法 A:自建 WordPress 容器
前面说过,本文会用三种方法演示 WordPress 的安装。第一种方法就是自建 WordPress 容器。
2.1 官方 的 PHP image
首先,新建一个工作目录,并进入该目录。
$ mkdir docker-demo && cd docker-demo
然后,执行下面的命令。
$ docker container run \ --rm \ --name wordpress \ --volume "$PWD/":/var/www/html \ php:5.6-apache
上面的命令基于php
的 image 文件新建一个容器,并且运行该容器。php
的标签是5.6-apache
,说明装的是 PHP 5.6,并且自带 Apache 服务器。该命令的三个参数含义如下。
--rm
:停止运行后,自动删除容器文件。--name wordpress
:容器的名字叫做wordpress
。--volume "$PWD/":/var/www/html
:将当前目录($PWD
)映射到容器的/var/www/html
(Apache 对外访问的默认目录)。因此,当前目录的任何修改,都会反映到容器里面,进而被外部访问到。
运行上面的命令以后,如果一切正常,命令行会提示容器对外的 IP 地址,请记下这个地址,我们要用它来访问容器。我分配到的 IP 地址是 172.17.0.2。
打开浏览器,访问 172.17.0.2,你会看到下面的提示。
Forbidden You don't have permission to access / on this server.
这是因为容器的/var/www/html
目录(也就是本机的docker-demo
目录)下面什么也没有,无法提供可以访问的内容。
请在本机的docker-demo
目录下面,添加一个最简单的 PHP 文件index.php
。
<?php phpinfo(); ?>
保存以后,浏览器刷新172.17.0.2
,应该就会看到熟悉的phpinfo
页面了。
2.2 拷贝 WordPress 安装包
既然本地的docker-demo
目录可以映射到容器里面,那么把 WordPress 安装包拷贝到docker-demo
目录下,不就可以通过容器访问到 WordPress 的安装界面了吗?
首先,在docker-demo
目录下,执行下面的命令,抓取并解压 WordPress 安装包。
$ wget https://cn.wordpress.org/wordpress-4.9.4-zh_CN.tar.gz $ tar -xvf wordpress-4.9.4-zh_CN.tar.gz
解压以后,WordPress 的安装文件会在docker-demo/wordpress
目录下。
这时浏览器访问http://172.17.0.2/wordpress
,就能看到 WordPress 的安装提示了。
2.3 官方的 MySQL 容器
WordPress 必须有数据库才能安装,所以必须新建 MySQL 容器。
打开一个新的命令行窗口,执行下面的命令。
$ docker container run \ -d \ --rm \ --name wordpressdb \ --env MYSQL_ROOT_PASSWORD=123456 \ --env MYSQL_DATABASE=wordpress \ mysql:5.7
上面的命令会基于 MySQL 的 image 文件(5.7版本)新建一个容器。该命令的五个命令行参数的含义如下。
-d
:容器启动后,在后台运行。--rm
:容器终止运行后,自动删除容器文件。--name wordpressdb
:容器的名字叫做wordpressdb
--env MYSQL_ROOT_PASSWORD=123456
:向容器进程传入一个环境变量MYSQL_ROOT_PASSWORD
,该变量会被用作 MySQL 的根密码。--env MYSQL_DATABASE=wordpress
:向容器进程传入一个环境变量MYSQL_DATABASE
,容器里面的 MySQL 会根据该变量创建一个同名数据库(本例是WordPress
)。
运行上面的命令以后,正常情况下,命令行会显示一行字符串,这是容器的 ID,表示已经新建成功了。
这时,使用下面的命令查看正在运行的容器,你应该看到wordpress
和wordpressdb
两个容器正在运行。
$ docker container ls
其中,wordpressdb
是后台运行的,前台看不见它的输出,必须使用下面的命令查看。
$ docker container logs wordpressdb
2.4 定制 PHP 容器
现在 WordPress 容器和 MySQL 容器都已经有了。接下来,要把 WordPress 容器连接到 MySQL 容器了。但是,PHP 的官方 image 不带有mysql
扩展,必须自己新建 image 文件。
首先,停掉 WordPress 容器。
$ docker container stop wordpress
停掉以后,由于--rm
参数的作用,该容器文件会被自动删除。
然后,在docker-demo
目录里面,新建一个Dockerfile
文件,写入下面的内容。
FROM php:5.6-apache RUN docker-php-ext-install mysqli CMD apache2-foreground
上面代码的意思,就是在原来 PHP 的 image 基础上,安装mysqli
的扩展。然后,启动 Apache。
基于这个 Dockerfile 文件,新建一个名为phpwithmysql
的 image 文件。
$ docker build -t phpwithmysql .
2.5 Wordpress 容器连接 MySQL
现在基于 phpwithmysql image,重新新建一个 WordPress 容器。
$ docker container run \ --rm \ --name wordpress \ --volume "$PWD/":/var/www/html \ --link wordpressdb:mysql \ phpwithmysql
跟上一次相比,上面的命令多了一个参数--link wordpressdb:mysql
,表示 WordPress 容器要连到wordpressdb
容器,冒号表示该容器的别名是mysql
。
这时还要改一下wordpress
目录的权限,让容器可以将配置信息写入这个目录(容器内部写入的/var/www/html
目录,会映射到这个目录)。
$ chmod -R 777 wordpress
接着,回到浏览器的http://172.17.0.2/wordpress
页面,点击"现在就开始!"按钮,开始安装。
WordPress 提示要输入数据库参数。输入的参数如下。
- 数据库名:
wordpress
- 用户名:
root
- 密码:
123456
- 数据库主机:
mysql
- 表前缀:
wp_
(不变)
点击"下一步"按钮,如果 Wordpress 连接数据库成功,就会出现下面的页面,这就表示可以安装了。
至此,自建 WordPress 容器的演示完毕,可以把正在运行的两个容器关闭了(容器文件会自动删除)。
$ docker container stop wordpress wordpressdb
三、方法 B:Wordpress 官方镜像
上一部分的自建 WordPress 容器,还是挺麻烦的。其实不用这么麻烦,Docker 已经提供了官方 WordPress image,直接用那个就可以了。有了上一部分的基础,下面的操作就很容易理解了。
3.1 基本用法
首先,新建并启动 MySQL 容器。
$ docker container run \ -d \ --rm \ --name wordpressdb \ --env MYSQL_ROOT_PASSWORD=123456 \ --env MYSQL_DATABASE=wordpress \ mysql:5.7
然后,基于官方的 WordPress image,新建并启动 WordPress 容器。
$ docker container run \ -d \ --rm \ --name wordpress \ --env WORDPRESS_DB_PASSWORD=123456 \ --link wordpressdb:mysql \ wordpress
上面命令中,各个参数的含义前面都解释过了,其中环境变量WORDPRESS_DB_PASSWORD
是 MySQL 容器的根密码。
上面命令指定wordpress
容器在后台运行,导致前台看不见输出,使用下面的命令查出wordpress
容器的 IP 地址。
$ docker container inspect wordpress
上面命令运行以后,会输出很多内容,找到IPAddress
字段即可。我的机器返回的 IP 地址是172.17.0.3
。
浏览器访问172.17.0.3
,就会看到 WordPress 的安装提示。
3.2 WordPress 容器的定制
到了上一步,官方 WordPress 容器的安装就已经成功了。但是,这种方法有两个很不方便的地方。
- 每次新建容器,返回的 IP 地址不能保证相同,导致要更换 IP 地址访问 WordPress。
- WordPress 安装在容器里面,本地无法修改文件。
解决这两个问题很容易,只要新建容器的时候,加两个命令行参数就可以了。
先把刚才启动的 WordPress 容器终止(容器文件会自动删除)。
$ docker container stop wordpress
然后,使用下面的命令新建并启动 WordPress 容器。
$ docker container run \ -d \ -p 127.0.0.2:8080:80 \ --rm \ --name wordpress \ --env WORDPRESS_DB_PASSWORD=123456 \ --link wordpressdb:mysql \ --volume "$PWD/wordpress":/var/www/html \ wordpress
上面的命令跟前面相比,命令行参数只多出了两个。
-p 127.0.0.2:8080:80
:将容器的 80 端口映射到127.0.0.2
的8080
端口。--volume "$PWD/wordpress":/var/www/html
:将容器的/var/www/html
目录映射到当前目录的wordpress
子目录。
浏览器访问127.0.0.2:8080:80
就能看到 WordPress 的安装提示了。而且,你在wordpress
子目录下的每次修改,都会反映到容器里面。
最后,终止这两个容器(容器文件会自动删除)。
$ docker container stop wordpress wordpressdb
四、方法 C:Docker Compose 工具
上面的方法 B 已经挺简单了,但是必须自己分别启动两个容器,启动的时候,还要在命令行提供容器之间的连接信息。因此,Docker 提供了一种更简单的方法,来管理多个容器的联动。
4.1 Docker Compose 简介
Compose 是 Docker 公司推出的一个工具软件,可以管理多个 Docker 容器组成一个应用。你需要定义一个 YAML格式的配置文件docker-compose.yml
,写好多个容器之间的调用关系。然后,只要一个命令,就能同时启动/关闭这些容器。
# 启动所有服务 $ docker-compose up # 关闭所有服务 $ docker-compose stop
4.2 Docker Compose 的安装
Mac 和 Windows 在安装 docker 的时候,会一起安装 docker compose。Linux 系统下的安装参考官方文档。
安装完成后,运行下面的命令。
$ docker-compose --version
4.3 WordPress 示例
在docker-demo
目录下,新建docker-compose.yml
文件,写入下面的内容。
mysql: image: mysql:5.7 environment: - MYSQL_ROOT_PASSWORD=123456 - MYSQL_DATABASE=wordpress web: image: wordpress links: - mysql environment: - WORDPRESS_DB_PASSWORD=123456 ports: - "127.0.0.3:8080:80" working_dir: /var/www/html volumes: - wordpress:/var/www/html
上面代码中,两个顶层标签表示有两个容器mysql
和web
。每个容器的具体设置,前面都已经讲解过了,还是挺容易理解的。
启动两个容器。
$ docker-compose up
浏览器访问 http://127.0.0.3:8080,应该就能看到 WordPress 的安装界面。
现在关闭两个容器。
$ docker-compose stop
关闭以后,这两个容器文件还是存在的,写在里面的数据不会丢失。下次启动的时候,还可以复用。下面的命令可以把这两个容器文件删除(容器必须已经停止运行)。
$ docker-compose rm
五、参考链接
- How to Manually Build Docker Containers for WordPress, by Aleksander Koko
- How to Use the Official Docker WordPress Image, by Aleksander Koko
- Deploying WordPress with Docker, by Aleksander Koko
(完)
laixintao 说:
另外提供一个vagrant虚拟机安装wordpress的Vagrantfile:https://github.com/laixintao/vagrant-wordpress
内含Wordpress各个组件的安装脚本。
2018年2月13日 10:34 | # | 引用
辣条拌鱼翅 说:
哈哈, 我还是第一?
一直在用docker, 但是在windows下还是有很多问题. 在慢慢研究中.
win7下可以用 DockerToolbox - 原理是利用VirtualBox
win10可以直接安装, 但VirtualBox就无法使用了, 两者只能用一个.
2018年2月13日 10:40 | # | 引用
bluestonechina 说:
自从用了docker-compose,我现在很多服务都往docker里扔了
2018年2月13日 11:21 | # | 引用
liuderchi 说:
請問 『2.1 官方 的 PHP image』段落的第二個指令
docker container run \
--rm \
--name wordpress \
--volume "$PWD/":/var/www/html \
php:5.6-apache
是否需要提供 -p 選項來揭露 port 呢?
2018年2月13日 15:29 | # | 引用
andyGe 说:
mac机器上不能运行,172.17.0.3访问不了,利用docker-compose运行之后报错如下:
Creating dockerdemo_mysql_1 ... done
Creating dockerdemo_mysql_1 ...
Creating dockerdemo_web_1 ... error
ERROR: for dockerdemo_web_1 Cannot start service web: driver failed programming external connectivity on endpoint dockerdemo_web_1 (e8589fe39aa43060a1c4d2171bc109ffd41f593fb0ea1aede1cbb178c7778797): Error starting userland proxy: listen tcp 127.0.0.3:8080: bind: cannot assign requested address
ERROR: for web Cannot start service web: driver failed programming external connectivity on endpoint dockerdemo_web_1 (e8589fe39aa43060a1c4d2171bc109ffd41f593fb0ea1aede1cbb178c7778797): Error starting userland proxy: listen tcp 127.0.0.3:8080: bind: cannot assign requested address
ERROR: Encountered errors while bringing up the project.
2018年2月14日 11:56 | # | 引用
皮皮李 说:
楼上的问题可以试试改变docker-compose.yml 里面的port 设置:
ports:
- "127.0.0.3:8080:80" 里面 8080 变成 8888.
Mac 上一般apache 已经占用了8080端口。可以设置一下禁止apache自动启动,也可以把端口改一下。
2018年2月18日 07:56 | # | 引用
小胡 说:
我也遇到楼上的问题, 改了端口也报同样的错误
2018年2月18日 11:38 | # | 引用
灵风子 说:
我基于官方镜像library/ubuntu:latest创建了容器,安装了mysql-server 5.7可以正常使用,
但是退出容器后再次进入,就无法启动mysql server,
一直提示
/usr/sbin/mysqld: error while loading shared libraries: libaio.so.1: cannot stat shared object: Permission denied
请问有人知道这是什么原因吗?
2018年2月20日 10:45 | # | 引用
都督府 说:
AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message
AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message
[Thu Feb 22 10:27:49.568597 2018] [mpm_prefork:notice] [pid 1] AH00163: Apache/2.4.10 (Debian) PHP/5.6.33 configured -- resuming normal operations
[Thu Feb 22 10:27:49.568685 2018] [core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'
本机无法ping通172.17.0.2 不知道这个问题有没有遇到的。。。
2018年2月22日 18:35 | # | 引用
win 说:
AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message
AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message
[Sat Feb 24 07:34:21.648186 2018] [mpm_prefork:notice] [pid 1] AH00163: Apache/2.4.10 (Debian) PHP/5.6.33 configured -- resuming normal operations
[Sat Feb 24 07:34:21.648289 2018] [core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'
mac上一样的问题,
172.17.0.2ping不通.
2018年2月24日 15:37 | # | 引用
暖暖 说:
@都督府:
有遇到的,window7 下各种问题,很多命令用不了呀
2018年2月24日 16:49 | # | 引用
牙医 说:
大神,建议用 Nginx 和 Docker-Gen https://hub.docker.com/r/jwilder/docker-gen/,启动命令设置 Virtual_Host 和 Virtual_Port
2018年2月26日 08:50 | # | 引用
QYW 说:
mac上无法ping容器的问题:
https://docs.docker.com/docker-for-mac/networking/#known-limitations-use-cases-and-workarounds
Docker for Mac can’t traffic to containers, and from containers back to the host.
2018年2月26日 12:03 | # | 引用
QYW 说:
@win:
mac上因为系统限制ping不了docker的容器
所以可以设置-p 8080:80 把端口映射出来
2018年2月26日 12:09 | # | 引用
森 说:
在这个WordPress的例子中,把数据存储和程序分成两个container有什么好处么?感觉做成一个container更方便些。
2018年2月26日 14:59 | # | 引用
Crazy Boy 说:
registry.docker-cn.com已经无法访问
2018年2月26日 16:09 | # | 引用
river 说:
原文:浏览器访问127.0.0.2:8080:80就能看到 WordPress 的安装提示了。
原文中8080:80应该为8080。
2018年2月27日 18:05 | # | 引用
liuxueliang 说:
阮老师,您好!参照您的教程成功跑起了WordPress,但是这个是内部模拟局域网的ip,怎么在别的机器访问呢?
2018年2月28日 15:43 | # | 引用
liuxueliang 说:
是我没仔细看 -p 外网端口:容器端口
2018年2月28日 16:37 | # | 引用
DerekNg622 说:
教程很棒,从头做了一遍算是入门。
2018年2月28日 16:38 | # | 引用
付超 说:
相同问题,Mac配置完后重启崩溃
2018年3月 2日 11:31 | # | 引用
a14907 说:
访问 curl http://172.17.0.2/wordpress
返回这个:
301 Moved Permanently
Moved Permanently
The document has moved here.
Apache/2.4.10 (Debian) Server at 172.17.0.2 Port 80
这个算是wordpress的问题吗?
2018年3月 9日 00:29 | # | 引用
海风 说:
@win:
在Mac 上 使用 -p 80:80, 然后访问: http://localhost/
docker run --rm -p 80:80 --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache
2018年3月21日 04:26 | # | 引用
煎鱼 说:
$ docker container run --rm --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache
AH00534: apache2: Configuration error: No MPM loaded.
心塞,有小伙伴遇到这个问题吗
2018年3月22日 11:49 | # | 引用
沐雨 说:
为社么不把mysql容器中的数据文件影射出来?数据的安全性第一
2018年3月30日 10:38 | # | 引用
陆崖 说:
- wordpress:/var/www/html
这里建议用扩展语法,新手容易看不懂,不知道中间没有空格就报错了
2018年4月 3日 12:45 | # | 引用
陆崖 说:
按照文章的步骤我的出现了一个问题,就是所有静态资源的链接是错误的都404了,静态资源请求的host是127.0.0.1,但实际上应该是一个域名
2018年4月 3日 15:57 | # | 引用
陆崖 说:
已经解决了是nginx反向代理的问题
2018年4月 3日 16:15 | # | 引用
luckynk 说:
官方文档说了,mac上不用写127.0.0.3,直接写成8080:80就可以,然后用http://localhost:8080/去访问就可以
2018年4月10日 23:06 | # | 引用
luckynk 说:
@liuderchi:
我在mac上测试需要,添加-p 8080:80,然后访问的时候用http://localhost:8080/就可以了,不用172.17.0.2这个ip
2018年4月10日 23:15 | # | 引用
sss 说:
第一种第二种都试过了,都不行,第一种显示没权限,第二种 wordpress 启动之后一会子关了,日志是说连接不到mysql
2018年5月 4日 00:43 | # | 引用
ZZX 说:
第一种方法,在win10上运行下面的指令
docker container run --rm --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache
报错: Error parsing reference: ":/var/www/html" is not a valid repository/tag: invalid reference format.
这是什么原因?
2018年5月 8日 11:38 | # | 引用
色色程序狗 说:
我用java 的springboot 挂在服务器上面用java -jar 启动数据库访问没问题,用noup 命令启动服务器访问不了容器的mysql,用容器内部的ip也访问不了,公网ip3306映射也不能访问,蛋疼n次方
2018年5月17日 10:53 | # | 引用
turbo 说:
阮老师,你好,我想问程序运行都会运行相关的文件。现在在一台机器上跑了两个mysql容器。也就是相当于有两个mysql进程。那么两个mysql进程应该各自都有自己的执行文件对吗?这样是不是相当于安装了两次mysql
2018年6月 2日 16:55 | # | 引用