Docker Compose安装使用,及搭建nginx+php+mysql基础应用实例

Posted the丶only

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Docker Compose安装使用,及搭建nginx+php+mysql基础应用实例相关的知识,希望对你有一定的参考价值。

当在容器搭建多个实例时,如果用run命令,需要很多遍,如搭建LNMP(nginx+php+mysql),这时可以考虑用Compose这个服务来搭建配置。

一、 Docker Compose简介:

Docker-Compose 是 Docker 的一种编排服务,是一个用于在 Docker 上定义并运行复杂应用的工具,可以让用户在集群中部署分布式应用。compose、machine 和 swarm 是docker 原生提供的三大编排工具,又称docker三剑客。

通过 Docker-Compose 用户可以很容易地用一个配置文件定义一个多容器的应用,然后使用一条指令安装这个应用的所有依赖,完成构建。Docker-Compose 解决了容器与容器之间如何管理编排的问题。

Compose 中有两个重要的概念:

  • 服务 (service) :一个应用的容器,实际上可以包括若干运行相同镜像的容器实例。
  • 项目 (project) :由一组关联的应用容器组成的一个完整业务单元,在 docker-compose.yml 文件中定义。

运用Docker-Compose前提还要知道Dockerfile的运用,可参考另一篇文章中有介绍:docker安装使用

二、 Docker Compose的安装使用:

1:安装

Docker Compose是独自产品,需要在安装docker后单独安装。相关官方文档查看:Compose
在github地址查看版本安装:Compose版本
目前为止最新为1.29.2,安装此版本。

#下载
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

#添加可执行权限
sudo chmod +x /usr/local/bin/docker-compose

安装完成,查看版本

docker-compose --version


注意:如果安装完成后,docker-compose命令无法使用,请检查您的路径。您还可以/usr/bin在路径中创建一个软链接如下。

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

2:基本命令使用

docker-compose up //启动yml文件定义的 container
docker-compose up -d //后台运行
docker-compose up --help //查看up帮助
docker-compose -f docker-compose.yml up //-f 指定yml文件
docker-compose stop //停止
docker-compose start 
docker-compose ls  //查看
docker-compose down //停止删除
docker-compose ps
docker-compose images
docker-compose exec {service_name} {bash}

三、Compose搭建nginx+php+mysql实例

安装版本如下:
centos 8 ,docker 20.10.7,docker-compose 1.29.2,nginx 1.20.1,php 8,mysql 5.7.34

1:构建目录结构

镜像版本,默认选择标签Tag为latest 最新版本,别写错了,写错直接报错read: connection reset by peer

创建目录lnmp_compose,将相关配置文件放在此目录。
目录结构如下:

[root@localhost lnmp_compose]# tree
.
|-- docker-compose.yml
|-- mysql
|   `-- conf.d
|       `-- my.cnf
|-- nginx
|   |-- conf.d
|   |   `-- www.conf
|   `-- Dockerfile
|-- php
|   `-- Dockerfile
`-- www
    |-- conn.php
    `-- index.php

6 directories, 7 files

2:配置php的Dockerfile

因为php涉及到很多扩展库,所以我们需要用到Dockerfile配置扩展创建新的镜像。

vim /lnmp_compose/php/Dockerfile

输入以下内容,从centos镜像采用yum安装php8的版本。内容参考:yum方式安装php最新版

FROM centos
RUN groupadd -g 1002 www && useradd -u 1001 -g www -s /sbin/nologin www \\
        && yum -y install epel-release yum-utils \\
        && yum -y install https://rpms.remirepo.net/enterprise/remi-release-8.rpm \\
        && dnf -y module list php \\
        && dnf -y module enable php:remi-8.0 \\
        && dnf -y install php php-cli php-fpm php-mysqlnd php-zip php-devel php-gd php-mbstring php-curl php-xml php-pear php-bcmath php-json php-redis --skip-broken \\
        && sed -i 's/user = apache/user = www/g' /etc/php-fpm.d/www.conf \\
        && sed -i 's/group = apache/group = www/g' /etc/php-fpm.d/www.conf \\
        && sed -i 's/listen = \\/run\\/php-fpm\\/www.sock/listen = 0.0.0.0:9000/g' /etc/php-fpm.d/www.conf \\
        && sed -i 's/listen.allowed_clients = 127.0.0.1/;listen.allowed_clients/g' /etc/php-fpm.d/www.conf \\
        && mkdir /run/php-fpm

CMD ["php-fpm","--nodaemonize"]

Dockerfile相关参数解释,创建www用户及www用户组,安装php扩展包。

需注意的坑:

  1. 创建www用户和组,uid和gid需要和宿主机www用户一致,宿主机 id www 查看gid和uid。这里宿主机gid 1002,uid 1001。
  2. /etc/php-fpm.d/www.conf配置文件,默认监听listen = run/php-fpm/www.sock改为listen = 0.0.0.0:9000,网上很多写127.0.0.1:9000也行,但是可能版本原因,我亲测不行。
  3. /etc/php-fpm.d/www.conf配置文件,默认只允许本机IP,需要将listen.allowed_clients = 127.0.0.1改注释掉。
  4. 缺少/run/php-fpm文件夹,无法启动php-fpm,无法创建PID文件,在容器中php-fpm启动报错:ERROR: Unable to create the PID file (/run/php-fpm/php-fpm.pid).: No such file or directory (2)ERROR: FPM initialization failed,需自己创建mkdir /run/php-fpm

3:配置nginx的Dockerfile

由于也需要更改www用户,所以需要Dockerfile文件重建镜像。
有两种,可自行根据自己需求配置。
1:第一种,可以直接nginx官方镜像,默认最新版本,在里面更改配置文件。
同时更新apt-get,和安装vi,以便后续在容器中简单编辑配置文件。配置如下:

FROM nginx
RUN groupadd -g 1002 www && useradd -u 1001 -g www -s /sbin/nologin www \\
        && apt-get -y update && apt-get -y install vi \\
        && sed -i 's/user  nginx/user  www/g' /etc/nginx/nginx.conf

2:第二种,直接从centos镜像安装nginx指定版本,构建新的nginx镜像。
这种无需安装vi等命令,已具备基础的命令可操作行强一点。这里采用yum安装方式。配置如下:

FROM centos
RUN groupadd -g 1002 www && useradd -u 1001 -g www -s /sbin/nologin www \\
        && yum install -y yum-utils \\
    && echo -e "[nginx-stable] \\
    \\nname=nginx stable repo \\
    \\nbaseurl=http://nginx.org/packages/centos/\\$releasever/\\$basearch \\
    \\ngpgcheck=1 \\
    \\nenabled=1 \\
    \\ngpgkey=https://nginx.org/keys/nginx_signing.key \\
    \\nmodule_hotfixes=true \\
    \\n[nginx-mainline] \\
    \\nname=nginx mainline repo \\
    \\nbaseurl=http://nginx.org/packages/mainline/centos/\\$releasever/\\$basearch \\
    \\ngpgcheck=1 \\
    \\nenabled=0 \\
    \\ngpgkey=https://nginx.org/keys/nginx_signing.key \\
    \\nmodule_hotfixes=true" > /etc/yum.repos.d/nginx.repo \\
    && yum install -y nginx-1.20.1 \\
        && sed -i 's/user  nginx/user  www/g' /etc/nginx/nginx.conf

CMD ["nginx", "-g", "daemon off;"]

需注意的坑:

  1. 同php一样,www用户和组,uid和gid需要和宿主机www用户一致。
  2. 配置文件/etc/nginx/nginx.conf中替换用户时,user nginx中间是两个空格,不是一个。

4:配置nginx的www.conf文件

在宿主机,创建的nginx/conf.d中配置 www.conf 文件,内容如下:

server {
    listen       80;
    server_name  localhost;

    location / {
        root   /usr/share/nginx/html;
                index  index.html index.htm index.php;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    location ~ \\.php$ {
        root           /var/www/html;
        fastcgi_pass   php_compose:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  /var/www/html$fastcgi_script_name;
        include        fastcgi_params;
    }
}

需注意的坑:

  1. 路径问题,location ~ \\.php$ 的root为php容器中的路径,location /中的root为nginx容器中的路径,不能像装在同一机器下配置一样的路径,因为现在动静分离,需要考虑到对应容器是否存在这个默认路径,否则报404错误。
  2. fastcgi_pass配置为 “容器名:端口” 方式。

5:配置yml文件

这里yml已命名为docker-compose.yml

vim docker-compose.yml

输入以下内容:

version: '3.8'
services:
    nginx:
      build: ./nginx
      container_name: nginx_compose
      ports:
        - "80:80"
        - "443:443"
      volumes:
        - "$PWD/nginx/conf.d:/etc/nginx/conf.d"
        - "$PWD/www:/usr/share/nginx/html"
      depends_on:
        - "php"
        - "mysql"
      networks:
        - lnmp
    php:
      build: ./php
      container_name: php_compose
      volumes:
        - "$PWD/www:/var/www/html"
      ports:
        - "9000:9000"
      networks:
        - lnmp

    mysql:
      image: mysql:5.7.34
      container_name: mysql_compose
      ports:
        - "3306:3306"
      volumes:
        - "$PWD/mysql/conf.d/my.cnf:/etc/mysql/conf.d/mysql.cnf"
      networks:
        - lnmp
      command: --character-set-server=utf8
      environment:
        MYSQL_ROOT_PASSWORD: 123456
        MYSQL_DATABASE: wordpress
        MYSQL_USER: lnmp
        MYSQL_PASSWORD: lnmp123

networks:
    lnmp:

相关参数说明:

  • version: ‘3’:指的docker-compose 的版本,有1,2,3版本,对应docker版本,可参考:https://docs.docker.com/compose/compose-file/compose-file-v3/
  • services:指的安装哪些服务,lnmp服务
  • container_name:容器的名字,docker ps -a 中的
  • image:引入镜像,若是本地没有,就去官网下载
  • networks:自定义网络,默认是桥接模式,可以用docker images ls 看
  • volumes:相当于bind这样的数据卷挂载,可以使用绝对或者相对路径
  • build:通过Dockerfile构建镜像
  • ports: 开放端口,比如3306:3306 ,那这样宿主机也可以连接管理
  • depends_on:依赖启动,先启动php,mysql,再启动nginx
  • environment :mysql参数设置,这里例子为,设置root密码,创建wordpress数据库,创建user用户及密码。

6:创建测试网页

在www创建index.php页面,测试php和nginx是否连接成功:

vim www/index.php

内容:

<?php
        phpinfo();
?>

创建conn.php页面,测试php和mysql是否连接成功:

vim www/conn.php

内容:

<?php
$servername = "mysql_compose";
$username = "lnmp";
$password = "lnmp123";
try {
    $conn = new PDO("mysql:host=$servername;", $username, $password);
    echo "连接mysql成功";
}
catch(PDOException $e)
{
    echo $e->getMessage();
}
?>

7:启动docker-compose并测试

后台启动:

docker-compose up -d

查看状态为up成功:

docker-compose ps


打开浏览器分别输入自己的服务器地址如:127.0.0.1/index.php127.0.0.1/conn.php 地址连接测试,成功如下图所示:


配置成功完成!!!

以上是关于Docker Compose安装使用,及搭建nginx+php+mysql基础应用实例的主要内容,如果未能解决你的问题,请参考以下文章

docker—compose搭建

畅享docker-compose之旅及编排wordpress报错解决

基于docker-compose搭建gitlab

基于docker-compose搭建gitlab

Zookeeper 集群搭建(使用 docker-compose)及基础操作

Docker环境下使用docker-compose一键式搭建kafka集群及kafka管理工具EFAK