Docker 微服务教程

  • 上一篇:Docker 入门教程
  • 下一篇:Node 定时器详解 

分类

 
  • 开发者手册

Docker 微服务教程

作者: 阮一峰

日期: 2018年2月13日

珠峰培训

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,表示已经新建成功了。

这时,使用下面的命令查看正在运行的容器,你应该看到wordpresswordpressdb两个容器正在运行。


$ 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.28080端口。
  • --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

上面代码中,两个顶层标签表示有两个容器mysqlweb。每个容器的具体设置,前面都已经讲解过了,还是挺容易理解的。

启动两个容器。


$ 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

(完)

Docker 微服务教程_第1张图片

Docker 微服务教程_第2张图片

广告(购买广告位)

Docker 微服务教程_第3张图片
Docker 微服务教程_第4张图片

留言(34条)

另外提供一个vagrant虚拟机安装wordpress的Vagrantfile:https://github.com/laixintao/vagrant-wordpress

内含Wordpress各个组件的安装脚本。

哈哈, 我还是第一?

一直在用docker, 但是在windows下还是有很多问题. 在慢慢研究中.

win7下可以用 DockerToolbox - 原理是利用VirtualBox

win10可以直接安装, 但VirtualBox就无法使用了, 两者只能用一个.

自从用了docker-compose,我现在很多服务都往docker里扔了

請問 『2.1 官方 的 PHP image』段落的第二個指令

docker container run \
--rm \
--name wordpress \
--volume "$PWD/":/var/www/html \
php:5.6-apache

是否需要提供 -p 選項來揭露 port 呢?

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.

楼上的问题可以试试改变docker-compose.yml 里面的port 设置:
ports:
- "127.0.0.3:8080:80" 里面 8080 变成 8888.
Mac 上一般apache 已经占用了8080端口。可以设置一下禁止apache自动启动,也可以把端口改一下。

我也遇到楼上的问题, 改了端口也报同样的错误

我基于官方镜像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
请问有人知道这是什么原因吗?

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 不知道这个问题有没有遇到的。。。

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不通.

@都督府:

有遇到的,window7 下各种问题,很多命令用不了呀

大神,建议用 Nginx 和 Docker-Gen https://hub.docker.com/r/jwilder/docker-gen/,启动命令设置 Virtual_Host 和 Virtual_Port

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.

@win:

mac上因为系统限制ping不了docker的容器

所以可以设置-p 8080:80 把端口映射出来

在这个WordPress的例子中,把数据存储和程序分成两个container有什么好处么?感觉做成一个container更方便些。

registry.docker-cn.com已经无法访问

原文:浏览器访问127.0.0.2:8080:80就能看到 WordPress 的安装提示了。
原文中8080:80应该为8080。

阮老师,您好!参照您的教程成功跑起了WordPress,但是这个是内部模拟局域网的ip,怎么在别的机器访问呢?

是我没仔细看 -p 外网端口:容器端口

教程很棒,从头做了一遍算是入门。

引用Crazy Boy的发言:

registry.docker-cn.com已经无法访问

相同问题,Mac配置完后重启崩溃

访问 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的问题吗?

@win:

在Mac 上 使用 -p 80:80, 然后访问: http://localhost/
docker run --rm -p 80:80 --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache

$ docker container run --rm --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache
AH00534: apache2: Configuration error: No MPM loaded.


心塞,有小伙伴遇到这个问题吗

为社么不把mysql容器中的数据文件影射出来?数据的安全性第一

- wordpress:/var/www/html
这里建议用扩展语法,新手容易看不懂,不知道中间没有空格就报错了

按照文章的步骤我的出现了一个问题,就是所有静态资源的链接是错误的都404了,静态资源请求的host是127.0.0.1,但实际上应该是一个域名

引用陆崖的发言:

按照文章的步骤我的出现了一个问题,就是所有静态资源的链接是错误的都404了,静态资源请求的host是127.0.0.1,但实际上应该是一个域名

已经解决了是nginx反向代理的问题

引用皮皮李的发言:

楼上的问题可以试试改变docker-compose.yml 里面的port 设置:
ports:
- "127.0.0.3:8080:80" 里面 8080 变成 8888.
Mac 上一般apache 已经占用了8080端口。可以设置一下禁止apache自动启动,也可以把端口改一下。

官方文档说了,mac上不用写127.0.0.3,直接写成8080:80就可以,然后用http://localhost:8080/去访问就可以

@liuderchi:

我在mac上测试需要,添加-p 8080:80,然后访问的时候用http://localhost:8080/就可以了,不用172.17.0.2这个ip

第一种第二种都试过了,都不行,第一种显示没权限,第二种 wordpress 启动之后一会子关了,日志是说连接不到mysql

第一种方法,在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.

这是什么原因?

我用java 的springboot 挂在服务器上面用java -jar 启动数据库访问没问题,用noup 命令启动服务器访问不了容器的mysql,用容器内部的ip也访问不了,公网ip3306映射也不能访问,蛋疼n次方

阮老师,你好,我想问程序运行都会运行相关的文件。现在在一台机器上跑了两个mysql容器。也就是相当于有两个mysql进程。那么两个mysql进程应该各自都有自己的执行文件对吗?这样是不是相当于安装了两次mysql

我要发表看法

您的留言 (HTML标签部分可用)

您的大名:

 «-必填

电子邮件:

 «-必填,不公开

个人网址:

 «-我信任你,不会填写广告链接

记住个人信息?

你可能感兴趣的:(Docker)