WangMao's Blog

Create more bugs.

使用 Vagrant+Docker 构建 PHP 最优开发环境

成长笔记 5 评
PS: 此方案适用于 Windows、macOS

老祖宗说过磨刀不误砍柴工,又说过工欲善其事,必先利其器。这话无论放到何时都适用。上次折腾开发环境是 Docker 优化之 Docker-sync 解决 Docker 挂载缓慢 的问题,然而这一改问题更大了。

在我日常开发了数天后,总结了 docker-sync 的诸多问题:

  1. 宿主机修改时而不同步,这个在文章中有讲过,怀疑和内存/运行时间有关系
  2. 如果项目过大,start 命令的同步时间过长,这通常需要 10~20 分钟

试想,问题 1 和 2 通常是成对出现的,也就是说只要发现文件不同步,那可就一直不同步了,我曾认为同步是监听文件的修改事件来通知更新,然而 CTRL + S 按烂也没有反应。接着能做的只有清除掉同步的数据然后重新同步。[狂汗]

这通常折腾你两次你可能就很难受了,重新同步完你刚刚做的什么也忘得七七八八了,谁曾想装个同步工具反倒同步出了问题。[无奈]

上篇文章有提到,挂载速度损耗最小的是利用虚拟机挂载。

环境结构

简单描述这几套开发环境的结构。

只使用 Docker:本地文件 --挂载--> Docker 容器 --映射端口--> 宿主机

只使用 Vagrant:本地文件 --挂载--> 虚拟机 --映射端口--> 宿主机

Docker+Vagrant:本地文件 --挂载--> 虚拟机 --挂载--> Docker --映射端口--> 虚拟机 --映射端口--> 宿主机

安装

首先需要安装 Vagrant 和 VirtualBox 这两个程序。

选择你系统对应的最新版本,安装步骤不用细细的讲。

导入镜像

# 创建 vagrant 镜像配置目录
$ mkdir ~/vagrant
# 拉取 centos 镜像
$ cd ~/vagrant
$ vagrant init centos/7

通过 vagrant init 命令拉取镜像在国内速度很慢,你可以配置代理来加速拉取,前提是需要先启用代理。

$ export http_proxy=http://0.0.0.0:1087
$ export https_proxy=http://0.0.0.0:1087

或者你可以自己下载镜像,通过命令来手动导入镜像。

// 复制镜像到 vagrant 目录
$ cp /path/to/centos-7.box ~/vagrant
$ vagrant box add centos-7.box
$ vagrant init centos-7

配置

当镜像导入成功后,~/vagrant 目录将生成一个 Vagrantfile 你可以编辑它用于配置挂载的目录,映射的端口等。

# 映射端口
config.vm.network "forwarded_port", guest: 80, host: 80
config.vm.network "forwarded_port", guest: 80, host: 80, host_ip: "127.0.0.1"
# 挂载目录 忽略挂载 vagrant 目录
config.vm.synced_folder ".", "/vagrant", disabled: true
config.vm.synced_folder "~/dnmp", "/root/dnmp"
config.vm.synced_folder "~/Project", "/root/Project"

端口映射 80 和 3306 等,目录挂载我这里挂载了 ~/dnmp 目录,这个是一个类似 laradock/laradock 的项目,配置了我日常的开发环境,包括 PHP、Nginx、Redis、MySQL 等,使用 Docker 能快速构建我的开发环境。

安装 Docker

Vagrantfile 配置完成,便可以使用 vagrant up 命令启动虚拟机。但注意,关于 vagrant 相关的命令,你只能在 ~/vagrant 目录下才能执行,它依赖 Vagrantfile 文件。

$ cd ~/vgrant
# 开启虚拟机
$ vagrant up
...
# 登录到虚拟机
$ vagrant ssh
...
# 默认登录是 vagrant 用户,手动切换到 root 用户
$ sudo su -

至此虚拟机部分已经安装完成,后续如果调整 Vagrantfile 后需要执行 vagrant reload --provision 命令。

后续操作全部在虚拟机(使用 vagrant ssh 登录)中进行,然后准备 Docker 安装的必要的工具以及 Docker 的软件源。

$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
# 添加 docker 的软件源
$ sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
# 更新 yum 缓存
$ sudo yum makecache fast
# 安装 docker-ce 版本
$ sudo yum -y install docker-ce
...
# 安装完成后启动 docker 的后台程序
$ sudo systemctl start docker

安装完成后,你可以使用 docker -v 命令查看当前安装的 Docker 版本。

优化 Docker

首先需要修改 Docker 的镜像地址,大陆使用 Docker 官方镜像速度令人发指,这里我使用阿里云提供的镜像加速服务。你可以打开登录阿里云的容器镜像服务来获取加速地址。地址:容器镜像服务

然后复制上你的加速地址,并打开 Docker 的配置文件。

$ vi /etc/docker/daemon.json

增加配置文件,并复制替换加速地址,格式如下:

{
    "registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"]
}

配置完成后,需要重启 Docker 的镜像来加载加速地址。

sudo systemctl daemon-reload
sudo systemctl restart docker

构建开发环境

我这里使用的 yeszao/dnmp,我 fork 了一个分支到我的仓库并做了一些调整,地址:isecret/dnmp

本地我将仓库 clone~/dnmp 目录,并挂载到虚拟机的 /root/dnmp 目录,后续的操作使用同一套配置。

关于 dnmp 的操作可以查看对应的 README.md 来获得帮助。

注意事项

MySQL 无法启动,对应目录不可写入?

我曾在环境配置完成的时候发现 MySQL 拉不起来,查看日志发现对应目录不可写 [喷血],在查找相关文档的时候找到了 Docker 官方仓库的 Issues,地址:mysqld: Can't create/write to file '/var/lib/mysql/is_writable' (Errcode: 13 - Permission denied) #219,翻译下原文,这种情况通常在 macOS 和 Windows 挂载会出现,Docker 容器默认会以 mysql 用户运行,而挂载的文件则是 root 用户的 UID,需要指定容器的用户为 docker 用户的 UID 1000:50

配置文件如下:

mysql:
    image: mysql:${MYSQL_VERSION}
    user: "1000:50"
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
    ports:
      - "${MYSQL_HOST_PORT}:3306"
    volumes:
      - ${MYSQL_CONF_FILE}:/etc/mysql/conf.d/mysql.cnf:ro
      - ${MYSQL_DATA_DIR}:/var/lib/mysql/:rw
    command: --innodb-use-native-aio=0
    networks:
      - default

修改完成后,需要重新 bulid 容器。

使用 cURL 代替 Postman
5 评论
    renkxChrome 87OSX
    2020年12月23日回复

    我配置了 user: "1000:50" 还是启动不了mysql,请问是什么情况呢?

    2020-12-23 10:36:07+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.22-1debian10 started.
    2020-12-23 10:36:07+00:00 [Note] [Entrypoint]: Initializing database files
    2020-12-23T10:36:07.935696Z 0 [System] [MY-013169] [Server] /usr/sbin/mysqld (mysqld 8.0.22) initializing of server in progress as process 23
    2020-12-23T10:36:07.940711Z 0 [ERROR] [MY-010457] [Server] --initialize specified but the data directory has files in it. Aborting.
    2020-12-23T10:36:07.940726Z 0 [ERROR] [MY-013236] [Server] The designated data directory /var/lib/mysql/ is unusable. You can remove all files that the server added to it.
    2020-12-23T10:36:07.940822Z 0 [ERROR] [MY-010119] [Server] Aborting
    2020-12-23T10:36:07.941779Z 0 [System] [MY-010910] [Server] /usr/sbin/mysqld: Shutdown complete (mysqld 8.0.22) MySQL Community Server - GPL.
    2020-12-23 10:36:08+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.22-1debian10 started.
    2020-12-23 10:36:08+00:00 [Note] [Entrypoint]: Initializing database files
    2020-12-23T10:36:08.702774Z 0 [System] [MY-013169] [Server] /usr/sbin/mysqld (mysqld 8.0.22) initializing of server in progress as process 24
    2020-12-23T10:36:08.707890Z 0 [ERROR] [MY-010457] [Server] --initialize specified but the data directory has files in it. Aborting.
    2020-12-23T10:36:08.707910Z 0 [ERROR] [MY-013236] [Server] The designated data directory /var/lib/mysql/ is unusable. You can remove all files that the server added to it.
    2020-12-23T10:36:08.707994Z 0 [ERROR] [MY-010119] [Server] Aborting
    2020-12-23T10:36:08.708226Z 0 [System] [MY-010910] [Server] /usr/sbin/mysqld: Shutdown complete (mysqld 8.0.22) MySQL Community Server - GPL.
    2020-12-23 10:36:09+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.22-1debian10 started.

      SecretChrome 87OSX
      2020年12月23日回复

      @renkx 看日志是说 MySQL 的 data 目录已经有数据了,如果是新项目尝试清空试试,如果有数据建议用之前的 MySQL 先导出数据。

        renkxChrome 87OSX
        2020年12月23日回复

        @Secret 确实是这个原因,大佬谢谢

    LukaChenChrome 103OSX
    2019年07月12日回复

    文章写的不错。我想知道怎么在 centos6 下玩 docker。。

    Mao WangChrome 103OSX
    2019年07月12日回复

    CentOS 下直接安装 Docker,不过我看了下官方的文档,似乎最新版本只支持 CentOS 7,不过你可以尝试安装历史版本。