Docker 微服务教程

古城微笑少年丶 2022-05-26 04:06 219阅读 0赞

## 简介 ##

Docker 是一个容器工具，可提供虚拟环境。它改变了我们对软件的认识。

站在 Docker 的角度，软件就是容器的组合：业务逻辑容器、数据库容器、储存容器、队列容器等等。

Docker 使得软件可以拆分成若干个标准化容器，然后像搭积木一样组合起来。

这正是微服务（microservices）的思想：软件把任务外包出去，让各种外部服务去完成这些任务，软件本身只是底层服务的调度中心和组装层。

微服务很适合用 Docker 容器实现，每个容器承载一个服务。一台计算机同时运行多个容器，从而就能很轻松地模拟出复杂的微服务架构。

上一篇教程介绍了 Docker 的基本用法，本文接着往下介绍，如何在一台计算机上实现多个服务，让它们互相配合，组合出一个应用程序。

这里，选择的示例软件是 WordPress。它是一个常用软件，全世界用户据说超过几千万。同时它又非常简单，只要两个容器就够了（业务容器 + 数据库容器），很适合教学。

而且，这种 “业务 + 数据库” 的容器架构，具有通用性，许多应用程序都可以复用。

为了加深读者理解，本文采用三种方法，演示如何架设 WordPress 网站。

*  方法 A：自建 WordPress 容器
 *  方法 B：使用官方的 WordPress 镜像
 *  方法 C：使用 Docker Compose 工具

## 准备工作 ##

### 配置国内的仓库镜像 ###

为了加快拉取（下载） image 文件的速度，我们需要配置国内的仓库镜像网址 [https://registry.docker-cn.com][https_registry.docker-cn.com] 。

修改了 Docker 守护进程的 --registry-mirror 选项。

您可以在 Docker 守护进程启动时传入 --registry-mirror 参数：

$ docker --registry-mirror=https://registry.docker-cn.com daemon

为了永久性保留更改，您可以修改 /etc/docker/daemon.json 文件，并添加上 registry-mirrors 键值。

{
      "registry-mirrors": ["https://registry.docker-cn.com"]
    }

然后，重启 Docker 以使配置生效。

$ sudo service docker restart

说明：Docker 服务所在的系统不同，配置国内镜像和重启的方式也有所不同。

## 方法 A：自建 WordPress 容器 ##

前面说过，本文会用三种方法演示 WordPress 的安装。第一种方法就是自建 WordPress 容器。

### 官方 的 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 页面了。

### 拷贝 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][http_172.17.0.2_wordpress] ，就能看到 WordPress 的安装提示了。

### 官方的 MySQL image ###

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

### 定制 PHP image ###

现在 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 .

### 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][http_172.17.0.2_wordpress] 页面，点击 "现在就开始！" 按钮，就可以开始安装。

至此，自建 WordPress 容器的演示完毕，可以把正在运行的两个容器关闭了（容器文件会自动删除）。

$ docker container stop wordpress wordpressdb

## 方法 B：使用官方的 WordPress 镜像 ##

方法 A 的自建 WordPress 容器，还是挺麻烦的。

其实不用这么麻烦，Docker 已经提供了官方的 WordPress image，直接用它就可以了。

### 基本用法 ###

首先，新建并启动 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 的安装提示。

### 定制 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 就能看到 WordPress 的安装提示了。

而且，你在 wordpress 子目录下的每次修改，都会反映到容器里面。

可以使用下面的命令终止这两个容器（容器文件会自动删除）。

$ docker container stop wordpress wordpressdb

## 方法 C：使用 Docker Compose 工具 ##

上面的方法 B 已经挺简单了，但是必须自己分别启动两个容器，启动的时候，还要在命令行提供容器之间的连接信息。

为此，Docker 提供了一种更简单的方法，来管理多个容器的联动。

### Docker Compose 简介 ###

Compose 是 Docker 公司推出的一个工具软件，可以管理多个 Docker 容器组成一个应用。

你需要定义一个 YAML 格式的配置文件 docker-compose.yml，写好多个容器之间的调用关系。然后，只要一个命令，就能同时启动或关闭这些容器。

# 启动所有服务
    $ docker-compose up
    
    # 关闭所有服务
    $ docker-compose stop

### Docker Compose 的安装 ###

Mac 和 Windows 在安装 docker 的时候，会一起安装 docker compose。

Linux 系统下的安装，请参考[官方文档][Link 1]。

安装完成后，运行下面的命令，检测是否安装成功。

$ docker-compose --version

### 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][http_127.0.0.3_8080] ，应该就能看到 WordPress 的安装界面了。

关闭两个容器：

$ docker-compose stop

容器关闭以后，这两个容器文件还是存在的，写在里面的数据不会丢失。下次启动的时候，还可以复用。

如果你想删除这两个容器文件，可以执行下面的命令：

$ docker-compose rm

注意：删除容器时，容器必须已经停止运行。

推荐使用 Docker Compose 工具来管理网站的运行环境。

【 本文转载自：[http://www.ruanyifeng.com/blog/2018/02/docker-wordpress-tutorial.html][http_www.ruanyifeng.com_blog_2018_02_docker-wordpress-tutorial.html] 】

[https_registry.docker-cn.com]: https://registry.docker-cn.com
[http_172.17.0.2_wordpress]: http://172.17.0.2/wordpress
[Link 1]: https://docs.docker.com/compose/install/#install-compose
[http_127.0.0.3_8080]: http://127.0.0.3:8080
[http_www.ruanyifeng.com_blog_2018_02_docker-wordpress-tutorial.html]: http://www.ruanyifeng.com/blog/2018/02/docker-wordpress-tutorial.html