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