add mysql README

52fhy · 52fhy · commit 4729d78100c8 · 2018-02-25T17:10:49.000+08:00
diff --git a/centos/README.md b/centos/README.md
@@ -1,16 +1,16 @@
 # CentOS
 
-官方镜像地址：https://hub.docker.com/_/centos/
+仓库官网：https://hub.docker.com/_/centos/
 
 https://github.com/docker-library/docs/tree/master/centos
 
 获取：
 ```
 docker pull centos
+docker pull daocloud.io/library/centos
+docker pull hub.c.163.com/library/centos
 ```
 
-## CentOS
-
 CentOS 是一个基于 RedHat Linux 提供的可自由使用源代码的企业级 Linux 发行版本。每个版本的 CentOS 都会获得十年的支持（通过安全更新方式）。 新版本的 CentOS 大约每两年发行一次，而每个版本的 CentOS 会定期（大概每六个月）更新一次，以便支持新的硬件。 这样，建立一个安全、低维护、稳定、高预测性、高重复性的 Linux 环境。 CentOS 是 Community Enterprise Operating System 的缩写。
 
 ### 支持的tag
diff --git a/mysql/README.md b/mysql/README.md
@@ -0,0 +1,135 @@
+# MySQL
+
+仓库官网：https://hub.docker.com/_/mysql/
+
+获取：
+```
+docker pull mysql
+docker pull daocloud.io/library/mysql
+docker pull hub.c.163.com/library/mysql
+```
+
+版本：
+
+- 5.7.4 (latest)
+- 5.7.5
+- 5.7.6
+- 8.0.2
+- 5.5.44
+- 5.6.17
+- 5.6.21
+
+MySQL 由于其性能高、成本低、可靠性好，已经成为全球最流行的开源数据库软件，被广泛地被应用在 Internet 上的中小型网站中。随着 MySQL 的不断成熟，它也逐渐出现在更多大规模网站和应用上，比如 Facebook、Twitter 和 Yahoo! 等站点。
+
+## 如何使用本镜像
+
+
+### 启动一个 mysql 服务实例
+
+启动一个 MySQL 实例非常简单：
+```
+$ docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d daocloud.io/mysql:tag
+```
+
+在上述命令中，some-mysql 指定了该容器的名字，my-secret-pw 指定了 root 用户的密码，tag 参数指定了你想要的 MySQL 版本。
+
+### 从另外一个 Docker 容器连接 MySQL 服务
+
+本镜像会暴露 MySQL 的标准端口 3306，你可以使用 link 功能来让其他应用容器能够访问 MySQL 容器，就像下面这样：
+```
+$ docker run --name some-app --link some-mysql:mysql -d app-that-uses-mysql
+```
+
+### 使用 MySQL 命令行工具连接 MySQL
+
+下面的命令启动了另一个 MySQL 容器并使用 MySQL 命令行工具访问你之前的 MySQL 服务，之后你就能向你的数据库执行 SQL 语句了：
+```
+$ docker run -it --link some-mysql:mysql --rm daocloud.io/mysql sh -c 'exec mysql -h"$MYSQL_PORT_3306_TCP_ADDR" -P"$MYSQL_PORT_3306_TCP_PORT" -uroot -p"$MYSQL_ENV_MYSQL_ROOT_PASSWORD"'
+```
+
+在上述命令中 some-mysql 就是你原来 MySQL 服务容器的名字。
+
+想要了解更多有关 MySQL 命令行工具的信息可以参考 MySQL 官方文档：http://dev.mysql.com/doc/en/mysql.html。
+
+### 查看 MySQL 日志
+
+docker exec 命令能让你在一个容器中额外地运行新命令。比如你可以执行下面的命令来获得一个 bash shell：
+```
+$ docker exec -it some-mysql bash
+```
+
+你可以通过查看 Docker 容器的日志获得 MySQL 服务的日志：
+```
+$ docker logs some-mysql
+```
+
+### 使用自定义 MySQL 配置文件
+
+当 MySQL 服务启动时会以 /etc/mysql/my.cnf 为配置文件，本文件会导入 /etc/mysql/conf.d 目录中所有以 .cnf 为后缀的文件。这些文件会拓展或覆盖 /etc/mysql/my.cnf 文件中的配置。因此你可以创建你自己需要的配置文件并挂载至 MySQL 容器中的 /etc/mysql/conf.d 目录。
+
+假设 /my/custom/config-file.cnf 是你自定义的配置文件，你可以像这样启动一个 MySQL 容器（注意这里直接挂载了配置文件的目录）：
+```
+$ docker run --name some-mysql -v /my/custom:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=my-secret-pw -d daocloud.io/mysql:tag
+```
+
+这会启动一个名为 some-mysql 且同时加载了 /etc/mysql/my.cnf 和 /etc/mysql/conf.d/config-file.cnf 这两个配置文件的新容器，注意这时以后者的配置优先。
+
+SELinux 用户在这里可能会遇到一个问题，目前的解决方法是为你的配置文件指定相关的 SELinux 策略配置，那样容器才可以访问它：
+```
+$ chcon -Rt svirt_sandbox_file_t /my/custom
+```
+
+## 环境变量
+
+当你启动 mysql 镜像时，你可以通过 docker run 命令传递几个特定的环境变量来调整相关设置，特别注意当容器启动时，所有环境变量都不会影响一个容器中已存在的数据库内容。
+
+### MYSQL_ROOT_PASSWORD
+
+本变量必填，它指定了 MySQL root 的用户的密码。在刚才的例子中，该密码被设置为 my-secret-pw。
+
+### MYSQL_DATABASE
+
+本变量可选，通过该变量当 MySQL 启动时会创建一个由你指定的数据库。如果你另外又提供了一对用户名和密码（见下方），那么他将会被授予本数据库的所有权限。
+
+### MYSQL_USER, MYSQL_PASSWORD
+
+这两个变量可选，同时使用的话会创建一个新用户并设置相应的密码，该用户会被授予由 MYSQL_DATABASE 变量指定的数据库的所有权限（见上方）。只有当同时提供了这两个变量时该用户才会被创建。
+
+特别注意没有必要使用这个机制来创建 root 用户，root 用户的密码会被设置为 MYSQL_ROOT_PASSWORD 变量的值。
+
+### MYSQL_ALLOW_EMPTY_PASSWORD
+
+本变量可选，当其被设置为 yes 时将会允许当前容器中的 root 用户能够使用空密码。注意：绝对不建议将该变量设置为 yes，除非你知道自己在做什么。如果这么做的话你的 MySQL 服务将会失去保护，所有人都可以以超级用户的身份访问该 MySQL 服务。
+
+## 重要说明
+
+### 储存数据的位置
+
+摘要：下面介绍了多种储存 Docker 容器中数据的方式，我们鼓励 mysql 镜像用户熟悉下面各项技术：
+
+- 使用 Docker 自带的 [Volume 机制](https://docs.docker.com/userguide/dockervolumes/#adding-a-data-volume)将数据库文件写入宿主机的磁盘。这是默认的方式，对用户来讲简单且透明。缺点是宿主机上的工具或应用可能难以定位这些文件。
+- 在宿主机上创建一个数据目录（在容器外部）并把他挂载至容器内部。此时数据库文件被放置在宿主机上一个已知的目录里，那样容器外部的应用和工具就可以方便地访问这些文件。缺点是用户需要确保这些目录存在，且宿主机上正确配置了权限设置。
+
+阅读 Docker 文档能快速了解不同的储存选项，并且有很多博客或论坛讨论并给出了这方面的建议。我们会在下面简单地演示一下：
+
+1) 在宿主机上创建一个数据目录，例：/my/own/datadir。
+2) 使用下面的命令启动 mysql 容器：
+```
+$ docker run --name some-mysql -v /my/own/datadir:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d daocloud.io/mysql:tag
+```
+
+我们通过 -v /my/own/datadir:/var/lib/mysql 参数从宿主机挂载 /my/own/datadir 目录至容器内作为 /var/lib/mysql 目录，那样 MySQL 就会默认将数据文件写入这个目录中。
+
+注意 SELinux 用户可能会遇到一个问题，目前的解决方法是为你的数据目录指定相关的 SELinux 策略配置，那样容器才可以访问它：
+```
+$ chcon -Rt svirt_sandbox_file_t /my/own/datadir
+```
+
+### MySQL 初始化完成前无连接
+
+如果容器启动时没有任何数据库被初始化，那么就会创建一个默认的数据库。这是一个预料中的行为，它意味着除非初始化完成，否则 MySQL 不会接受任何连接。当你使用 docker-compose 等自动化工具同时启动一系列容器时，可能会因为这个特性而造成一些问题。
+
+### 使用已存在的数据库
+
+如果从一个已存在数据库文件的目录上启动一个 mysql 容器的话（特别是一个 mysql 子目录），那么 $MYSQL_ROOT_PASSWORD 变量应该在启动命令中略去；即使设置了也会被忽略，已存在的数据库不会以任何方式被改变。
+
diff --git a/nginx/README.md b/nginx/README.md
@@ -1,84 +1,85 @@
-# Nginx
-
-官方仓库：https://registry.hub.docker.com/_/nginx/
-
-获取：
-```
-docker pull nginx
-docker pull daocloud.io/library/nginx
-```
-
-版本：
-
-- latest
-- alpine
-- 1.13.0-alpine
-- 1.12.2
-- 1.12.2-alpine
-- 1.7.10
-- 1.7.9
-- 1.13.2-perl
-
-等等。
-
-
-## 什么是 Nginx？
-
-Nginx 是一款轻量级的 Web 服务器、反向代理服务器、及电子邮件（IMAP/POP3）代理服务器，并在一个 BSD-like 协议下发行。由俄罗斯的程序设计师 Igor Sysoev 所开发，供俄国大型的入口网站及搜索引擎 Rambler（俄文：Рамблер）使用。其特点是占有内存少，并发能力强，事实上 Nginx 的并发能力确实在同类型的网页服务器中表现较好，中国大陆使用 Nginx 网站用户有：新浪、网易、腾讯等。
-
-## 如何使用这个镜像？
-
-### 托管静态网页内容
-```
-docker run --name some-nginx -v /some/content:/usr/share/nginx/html:ro -d daocloud.io/nginx
-```
-另外一种比上面绑定 volume 更推荐的做法是用Dockerfile生成包含网页内容的新镜像，如下所示：
-```
-FROM daocloud.io/nginx
-COPY static-html-directory /usr/share/nginx/html
-```
-把上面的Dockerfile和您的网页内容（static-html-directory）放在同一目录下，然后运行命令生成新镜像：
-```
-docker build -t some-content-nginx .
-```
-最后启动容器：
-```
-docker run --name some-nginx -d some-content-nginx
-```
-
-### 暴露端口
-```
-docker run --name some-nginx -d -p 8080:80 some-content-nginx
-```
-
-这样启动，您就可以通过 http://localhost:8080 或者 http://宿主 IP:8080 访问 Nginx 了。
-
-### 进阶配置
-```
-docker run --name some-nginx -v /some/nginx.conf:/etc/nginx/nginx.conf:ro -d daocloud.io/nginx
-```
-
->了解详细的 Nginx 配置文件语法，请参考：官方文档：http://nginx.org/en/docs/。
-
-为了确保 Nginx 容器能够持续运行，请务必在您自定义的 Nginx 配置文件中包含deamon off配置项。
-
-下面的命令从一个正在运行的 Nginx 容器中复制出配置文件：
-```
-docker cp some-nginx:/etc/nginx/nginx.conf /some/nginx.conf
-```
-您也可以通过推荐的Dockerfile方式来生成一个包含自定义配置文件的镜像，如下所示：
-```
-FROM daocloud.io/nginx
-COPY nginx.conf /etc/nginx/nginx.conf
-```
-再用下面的命令构建镜像：
-```
-docker build -t some-custom-nginx . 
-```
-最后启动容器：
-```
-docker run --name some-nginx -d some-custom-nginx
-```
-支持的Docker版本
-
+# Nginx
+
+仓库官网：https://registry.hub.docker.com/_/nginx/
+
+获取：
+```
+docker pull nginx
+docker pull daocloud.io/library/nginx
+docker pull hub.c.163.com/library/nginx
+```
+
+版本：
+
+- latest
+- alpine
+- 1.13.0-alpine
+- 1.12.2
+- 1.12.2-alpine
+- 1.7.10
+- 1.7.9
+- 1.13.2-perl
+
+等等。
+
+
+## 什么是 Nginx？
+
+Nginx 是一款轻量级的 Web 服务器、反向代理服务器、及电子邮件（IMAP/POP3）代理服务器，并在一个 BSD-like 协议下发行。由俄罗斯的程序设计师 Igor Sysoev 所开发，供俄国大型的入口网站及搜索引擎 Rambler（俄文：Рамблер）使用。其特点是占有内存少，并发能力强，事实上 Nginx 的并发能力确实在同类型的网页服务器中表现较好，中国大陆使用 Nginx 网站用户有：新浪、网易、腾讯等。
+
+## 如何使用这个镜像？
+
+### 托管静态网页内容
+```
+docker run --name some-nginx -v /some/content:/usr/share/nginx/html:ro -d daocloud.io/nginx
+```
+另外一种比上面绑定 volume 更推荐的做法是用Dockerfile生成包含网页内容的新镜像，如下所示：
+```
+FROM daocloud.io/nginx
+COPY static-html-directory /usr/share/nginx/html
+```
+把上面的Dockerfile和您的网页内容（static-html-directory）放在同一目录下，然后运行命令生成新镜像：
+```
+docker build -t some-content-nginx .
+```
+最后启动容器：
+```
+docker run --name some-nginx -d some-content-nginx
+```
+
+### 暴露端口
+```
+docker run --name some-nginx -d -p 8080:80 some-content-nginx
+```
+
+这样启动，您就可以通过 http://localhost:8080 或者 http://宿主 IP:8080 访问 Nginx 了。
+
+### 进阶配置
+```
+docker run --name some-nginx -v /some/nginx.conf:/etc/nginx/nginx.conf:ro -d daocloud.io/nginx
+```
+
+>了解详细的 Nginx 配置文件语法，请参考：官方文档：http://nginx.org/en/docs/。
+
+为了确保 Nginx 容器能够持续运行，请务必在您自定义的 Nginx 配置文件中包含deamon off配置项。
+
+下面的命令从一个正在运行的 Nginx 容器中复制出配置文件：
+```
+docker cp some-nginx:/etc/nginx/nginx.conf /some/nginx.conf
+```
+您也可以通过推荐的Dockerfile方式来生成一个包含自定义配置文件的镜像，如下所示：
+```
+FROM daocloud.io/nginx
+COPY nginx.conf /etc/nginx/nginx.conf
+```
+再用下面的命令构建镜像：
+```
+docker build -t some-custom-nginx . 
+```
+最后启动容器：
+```
+docker run --name some-nginx -d some-custom-nginx
+```
+支持的Docker版本
+
 这个镜像在 Docker 1.7.0 上提供最佳的官方支持，对于其他老版本的 Docker（1.0 之后）也能提供基本的兼容。
