Docker 微服务教程 - 阮一峰的网络日志

一、预备工作：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 。

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 \ --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 提示要输入数据库参数。输入的参数如下。

三、方法 B：Wordpress 官方镜像

上一部分的自建 WordPress 容器，还是挺麻烦的。其实不用这么麻烦，Docker 已经提供了官方 WordPress image，直接用那个就可以了。有了上一部分的基础，下面的操作就很容易理解了。

3.1 基本用法

首先，新建并启动 MySQL 容器。

$ docker container run \ --rm \ --name wordpressdb \ --env MYSQL_ROOT_PASSWORD=123456 \ --env MYSQL_DATABASE=wordpress \ mysql:5.7

然后，基于官方的 WordPress image，新建并启动 WordPress 容器。

$ docker container run \ --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 \ -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

的

端口。


    --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 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

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.

我基于官方镜像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不通.

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.

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

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

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

这是什么原因？

我在mac下使用如下命令可以正常访问，不知道为什么：

docker container run -p 8080:80 -it --rm --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache

然后可以访问http://localhost:8080

解压wordpress后，访问localhost:8080/wordpress报如下的错：
Warning: require_once(/var/www/html/wordpress/wp-includes/load.php): failed to open stream: No such file or directory in /var/www/html/wordpress/wp-load.php on line 49

Fatal error: require_once(): Failed opening required '/var/www/html/wordpress/wp-includes/load.php' (include_path='.:/usr/local/lib/php') in /var/www/html/wordpress/wp-load.php on line 49

请问如下如何配置

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 Nov 08 03:04:10.465347 2018] [mpm_prefork:notice] [pid 1] AH00163: Apache/2.4.25 (Debian) PHP/5.6.38 configured -- resuming normal operations
[Thu Nov 08 03:04:10.465414 2018] [core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'

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.

查了好久，解决之后发现评论里就有……

执行： docker container run --rm --name wordpress --volume "$PWD/":/var/www/html php:5.6-apache
访问 http://172.17.0.2/index.php
错误 403 Forbidden
[Thu Mar 21 07:59:59.356883 2019] [core:error] [pid 16] (13)Permission denied: [client 172.17.0.1:40606] AH00035: access to /index.php denied (filesystem path '/var/www/html/index.php') because search permissions are missing on a component of the path
怎么解决呢？万分感谢

这是什么原因？

把"$pwd"改成${pwd}

1.映射本地目录到docker容器，运行以下指令：
docker container run -d -p 127.0.0.2:8081:80 --rm -v "C:\Users\ligy\Desktop\pic:/usr/share/nginx/html" --name mynginx01 nginx
2.浏览器访问报403
3.不映射目录启动docker容器，访问可进入nginx欢迎页

为什么映射本地目录到docker容器会发生403？

Fatal error: require_once(): Failed opening required '/var/www/html/wordpress/wp-includes/load.php' (include_path='.:/usr/local/lib/php') in /var/www/html/wordpress/wp-load.php on line 49

create ${PWD}: "${PWD}" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]"

${PWD} 不能这么命名，$符号不允许，怎么解决

引用糊糊晗的发言：

create ${PWD}: "${PWD}" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]"

${PWD} 不能这么命名，$符号不允许，怎么解决

windows版用 “%cd%”

Permission denied啊，写着呢

我碰到的问题
1：我返回的IPAddress是172.17.0.3，但是我浏览器无法访问，我用HostIp（0.0.0.0）可以访问
2：我执行 docker container run -d 127.0.0.2:8080:80... 会报错：
Error response from daemon: Ports are not available: listen tcp 127.0.0.2:8080: bind: can't assign requested address. 我修改端口也没用，最后，我去掉了 ip 地址，改成： docker container run -d -p 8080:80 ，然后就好了，最后页面访问：http://0.0.0.0:8080/ 不知道为啥，求指教！！！

3.1节基本用法，起了两个容器后，访问对应 IP 提示“Error establishing a database connection”

原因是 docker 官方 WordPress 镜像默认的数据库用户名既然是“example username”

起 WordPress 容器时，增加一个环境变量`--env WORDPRESS_DB_USER=root`即可

一、预备工作：image 仓库的镜像网址

二、方法 A：自建 WordPress 容器

2.1 官方 的 PHP image

2.2 拷贝 WordPress 安装包

2.3 官方的 MySQL 容器

2.4 定制 PHP 容器

2.5 Wordpress 容器连接 MySQL

三、方法 B：Wordpress 官方镜像

3.1 基本用法

3.2 WordPress 容器的定制

四、方法 C：Docker Compose 工具

4.1 Docker Compose 简介

4.2 Docker Compose 的安装

4.3 WordPress 示例

五、参考链接

2.1 官方的 PHP image