一个完整的 Web 应用包含前端页面、数据库、后台逻辑等,按照一般流程去构建需要配置 Nginx、MySQL,以及后台服务器,运维涉及到的部分十分复杂。而 Docker 可以将这些东西(数据+服务)封装起来,虽然有些场合不建议数据和服务放在一起。本文就在一个 Docker 容器中完整部署整个 Web 应用的需求作详细的介绍。

  本文举例的 Web 应用为 「top-topic-Zhihu」(换个 timeline 看知乎),整个项目可以在 Github 中找到。

  Dockerfile 和依赖文件托管在 docker-toptopic,云服务商选择「灵雀云」提供容器服务。

  在「灵雀云」服务提供的域名 :19991/ 可以看到本网站。

  文件目录

  整个 Web 应用的目录结构如下所示:

  

├── docker-toptopic  │   ├── Dockerfile        │   ├── init.sh        # 启动 Nginx MySQL 和后台 Server 的初始化脚本  │   ├── mysql          # MySQL 配置文件  │   │   └── my.cnf      │   ├── nginx          # Nginx 配置文件  │   │   ├── global.conf  │   │   └── nginx.conf  │   ├── question.txt   # 需要导入到 DB 的数据  │   ├── README.md  │   └── web  │       ├── dataAccess.py # 后台 Server 的 AO 服务  │       ├── dataCGI.py    # 后台 Server  │       └── www           # 网站  │           ├── assets  │           │   ├── tuzhii.ico  │           │   └── tuzhii.jpg  │           ├── css  │           │   ├── button.css  │           │   └── toptopic.css  │           ├── index.html  │           └── js  │               └── template.js

  Dockerfile

  Dockerfile 描述了容器的依赖和进行构建的步骤,下面会逐步解释语句的含义。

  

FROM ubuntu  MAINTAINER titushuang "ituzhi@163.com"  ENV REFRESHED_AT 2015-10-12    RUN apt-get update \      && apt-get install -y mysql-server-5.6 python  python-dev python-pip libmysqlclient-dev nginx    RUN pip install MySQL-python flask   RUN pip install -U flask-cors    RUN mkdir -p /home/toptopic /home/toptopic/web    COPY init.sh /home/toptopic/init.sh  COPY web /home/toptopic/web  COPY question.txt /home/toptopic/question.txt    COPY nginx/global.conf /etc/nginx/conf.d/  COPY nginx/nginx.conf /etc/nginx/nginx.conf  COPY mysql/my.cnf /etc/mysql/my.cnf    RUN ln -s /home/toptopic/web/www /usr/share/nginx/html    RUN chmod +x /home/toptopic/init.sh   RUN chmod -R 755 /home/toptopic/web    RUN ./etc/init.d/mysql start &&\        mysql -e "grant all privileges on . to 'root'@'%' identified by 'dbpasswd';"&&\        mysql -e "grant all privileges on . to 'root'@'127.0.0.1' identified by 'dbpasswd';"&&\        mysql -e "CREATE DATABASE top_topic_zhihu; use top_topic_zhihu;"&&\       mysql -e "CREATE TABLE top_topic_zhihu.question(question_id varchar(30) NOT NULL, \      title varchar(200), ask_time datetime,followers int)"&&\       mysql -e "load data infile '/home/toptopic/question.txt' into \      table top_topic_zhihu.question fields terminated by ';;'"&&\       mysql -e "grant all privileges on . to 'root'@'localhost'\       identified by 'dbpasswd';"    EXPOSE 2223 5000    CMD ["/home/toptopic/init.sh"]

  MySQL 安装和配置

  MySQL 服务器只需要用包管理器安装 mysql-server-5.6,因为后台使用 Python 作为服务器语言,还需要安装 MySQL 对 Python 语言的支持。需要使用 apt 安装 python ,libmysqlclient-dev 和 python-dev,然后使用 pip 管理器安装 MySQL-python。

  MySQL 的默认字符集为 latin1,而网页显示一般是 utf8 字符集,需要将 MySQL 的配置文件的字符集置为 utf8。

  使用命令

  COPY mysql/my.cnf /etc/mysql/my.cnf

  将本地已修改好的配置文件覆盖 Docker 中的 MySQL 配置文件。查看字符集

  

mysql> SHOW VARIABLES LIKE 'character_set_%';   +--------------------------+----------------------------+  | Variable_name            | Value                      |  +--------------------------+----------------------------+  | character_set_client     | utf8                       |  | character_set_connection | utf8                       |  | character_set_database   | utf8                       |  | character_set_filesystem | binary                     |  | character_set_results    | utf8                       |  | character_set_server     | utf8                       |  | character_set_system     | utf8                       |  | character_sets_dir       | /usr/share/mysql/charsets/ |  +--------------------------+----------------------------+  8 rows in set (0.00 sec)

  若字符集如上所示,则说明已经修改成功。

  MySQL的坑

  在上面的 Dockerfile 中看到分别给 'root'@'127.0.0.1' 和 'root'@'localhost' 都加了权限, 'root'@'localhost' 的权限在 SQL 语句最后才加上。这是因为

  Access denied for user 'root'@'localhost' (using password: No)

  Access denied for user 'root'@'localhost' (using password: YES)

  于是这里用 'root'@'127.0.0.1' 来建数据库和表,最后再用 'root'@'localhost' 来连接数据库。

  Nginx 安装和配置

  Nginx 在这里作为静态页面的服务器,安装只需要用 apt 管理器安装即可。

  Nginx 需要配置 root 目录来指定网站的文件位置,把本地的 global.conf 和 nginx.conf 文件覆盖到 Docker 中。

  

COPY nginx/global.conf /etc/nginx/conf.d/  COPY nginx/nginx.conf /etc/nginx/nginx.conf

  在 global.conf 中我们指明服务器根目录为 /usr/share/nginx/html/www

  

server {          listen          0.0.0.0:2223;          server_name     _;            root            /usr/share/nginx/html/www;          index           index.html index.htm;          }

  在 Docker 中,我们将网站文件放到新建的 /home/toptopic/web/www目录。这里建立一个软链接将它们关联起来,便于修改和维护。

  

RUN ln -s /home/toptopic/web/www /usr/share/nginx/html

  EXPOSE 两个端口

  EXPOSE 在 Docker 中用来限制开放的端口。我们使用 Nginx 来提供静态页面访问,使用 Flask 框架来提供动态页面数据的获取,所以需要开放两个端口。

  

EXPOSE 2223 5000

  查询端口状态,可以看到宿主机 2333 端口被映射到 Docker 的 2333 端口,宿主机 5000 端口被映射到 Docker 的 5000 端口。

  

hy@HP /tmp $ sudo docker ps  [sudo] password for huangyi:   CONTAINER ID      IMAGE                COMMAND           CREATED           STATUS               PORTS         NAMES  2d1d03d08a95        titus/mysql:latest   /bin/bash     9 seconds ago      Up 9 seconds   0.0.0.0:2223->2223/tcp,0.0.0.0:5000->5000/tcp   clever_hoover

  2223 端口与上节中的 Nginx 中设定的端口必须保持一致,因为 Nginx 使用 2223 端口提供服务,Docker 刚好必须把这个端口开放出去。

  在基于 Flask 框架写的后台服务 dataCGI.py 中,服务器对应的监听地址为

  

app.run(host='0.0.0.0', port=5000, debug=True, threaded=True)

  host 必须设置为 0.0.0.0,表示监听所有的 IP 地址。如果 host 使用 127.0.0.1,在容器外将无法访问服务。同时,这里的端口 5000 和 Dockerfile 中开放的另一个端口一致。

  启动脚本

  在 Dockerfile 中的 CMD 中可以指定 Docker 运行时执行一些命令。

  

/etc/init.d/mysql start  /etc/init.d/nginx start &  /home/toptopic/web/dataCGI.py

  这三行分别启动 MySQL,Nginx 和后台服务。

  构建命令

  构建 Docker 容器

  

sudo docker build -t="titus/toptopic" .

  运行容器

  

sudo docker run -t -i -p 2223:2223 -p 5000:5000 titus/toptopic

  需要注意的是若使用

  

sudo docker run -t -i -p 2223:2223 -p 5000:5000 titus/toptopic /bin/bash

  无法启动 CMD 中的脚本命令,这是因为在 docker run 后指定了 /bin/bash 后会覆盖 CMD 中的命令。

  在云平台上部署

  在「灵雀云」上部署一个 Docker 应用需要两步:构建——创建服务。

  图片

  点击「构建」——「创建镜像构建仓库」,然后选择 Github 仓库源。需要把预先写好的 Dockerfile 放在 Github中。

  图片

  构建好仓库之后,点击「创建服务」。

  图片

  进行服务的设置,高级设置中服务地址类型选为 tcp-endpoint 即可(外部用户可以直接通过 TCP 方式访问这个服务地址,服务地址的端口是随机分配的,一般会大于 10000 小于 65535)

  最后点击最下方的「创建服务」完成部署。新建的服务如下所示:

  图片

  在浏览器中输入:19991/ 即可访问网站。

  参考

最后修改:2024 年 08 月 07 日
如果觉得我的文章对你有用,请随意赞赏