Skip to content

phvia/dkc

Repository files navigation

dkc

快速构建(LNMP+Nodejs)运行环境.

dkc 在此作为 docker-compose 的缩写,你可以理解为 alias dkc=docker-compose

准备

安装 docker


选择1) 从 repository 安装

@guide https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-using-the-repository

# 1.支持 Ubuntu 和 CentOS 的安装脚本
$ sudo wget https://raw.githubusercontent.com/farwish/delicateShell/master/support/installDockerCE.sh && chmod +x installDockerCE.sh && ./installDockerCE.sh && rm -f installDockerCE.sh

# 2.将普通用户 xxxx 加入 docker 组
$ sudo usermod -aG docker xxxx

# 3.退出终端重新登录才拥有 docker 执行权限

选择2) 下载 package 安装

@address https://download.docker.com/linux/ubuntu/dists/xenial/pool/stable/amd64/
@guide https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-from-a-package

# 通过 lsb_release -a 查看是不是 xenial,对号选择 package 下载.
$ wget https://download.docker.com/linux/ubuntu/dists/xenial/pool/stable/amd64/docker-ce_18.06.0~ce~3-0~ubuntu_amd64.deb

# Ubuntu
$ sudo dpkg -i /path/to/package.deb

# 用 dpkg 安装完deb包,依然执行上面 2,3 两步,让普通用户拥有 docker 执行权限.

安装 docker-compose


$ sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

@guide https://docs.docker.com/compose/install/#install-compose

下载项目并初始化


$ git clone https://github.com/phvia/dkc
$ cd dkc/ && cp .env.default .env
$ vi .env  # 编辑第一行,即本项目所在路径
$ dkc up -d # 启动所有服务

网站目录


默认您的网站项目代码放置于 web/,可以拷贝项目目录到 web/ 中。

(当然你可以修改 docker-compose.yml 中 volume 的映射关系,然后放置在任何地方。)

指南

如何自定义所有服务


dkc up -d 使用的是 docker-compose.yml 文件,
如果只是调整 volume/network/configuration,可以修改文件后重新运行命令。
docker-compose.yml 里面使用的 image 是基于 docker-compose-build.yml build 项使用的 Dockerfile 构建好的。)

所以,如果希望修改 Dockerfile 后重新构建,可以通过运行 dkc -f docker-compose-build.yml up --build -d 来构建。

如何运行 Nginx 静态站点


修改nginx服务 volumes 中 web 目录位于主机内的绝对路径; 修改 ports 需要暴露的端口.

$ vi docker-compose.yml

修改 nginx 的配置 nginx/nginx.confnginx/conf.d/default.conf

# 项目路径、暴露端口等配置一般在 nginx/conf.d/default.conf

$ vi nginx/conf.d/default.conf

常用命令

# 启动 nginx 服务
# 等同 docker run nginx:xxx

$ dkc up -d nginx

# 修改完配置都要重启 nginx 服务
# 等同 docker restart nginx-con

$ dkc restart nginx

# 停止 nginx 服务
# 等同 docker stop nginx-con

$ dkc stop nginx

# 跟踪查看 nginx 服务日志
# 等同 docker logs -f nginx-con

$ dkc logs -f --tail 20 nginx

# 查看所有运行的容器
# 等同 docker ps

$ dkc ps

# 进入 nginx 容器
# 等同 docker exec -it nginx-con bash

$ dkc exec nginx bash

现在可以在浏览器中访问: http://host-ip:port

更多内容见 nginx/README.md, nginx/Dockerfile

MySQL 服务


docker-compose.yml ports 选项的主机与容器开放的端口映射关系可以修改,以增加安全性。

# 启动 MySQL 服务,及其常用操作

$ dkc up -d mysql
$
$ dkc logs -f --tail 20 mysql
$
$ dkc exec mysql bash
$
$ mysql -uroot -p

导入本地数据库文件到容器中

# dkc exec [options] [-e KEY=VAL...] SERVICE COMMAND [ARGS...]

$ dkc exec -T mysql mysql -uroot -p123456 testdb < testdb.sql

MYSQL_ROOT_PASSWORD 环境变量用来初始化 root 用户密码, 只在第一次启动时使用。

一旦初始化数据文件后无法再通过设置本变量更改, 需要删除 volume 之后重新启动,或者进入容器中更改。

MYSQL_DATABASE 设置镜像启动时新建的数据库,同样只生效一次,只能进容器内更改 (或者删除 volume)。

更多内容见 mysql/README.md

其它:

使用自定义的 MySQL 配置文件,例如

The default configuration for MySQL can be found in /etc/mysql/my.cnf

$ docker run --name mysql-con -v /my/custom:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=123456 -d mysql-img-farwish:v1

把敏感配置值放在文件中,例如

docker run --name mysql-con -e MYSQL_ROOT_PASSWORD_FILE=/run/secrets/mysql-root -d mysql-img-farwish:v1

目前官方镜像只支持 MYSQL_ROOT_PASSWORD, MYSQL_ROOT_HOST, MYSQL_DATABASE, MYSQL_USER, and MYSQL_PASSWORD.

Dump 数据库到宿主机,例如

docker exec mysql-con sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > /home/ubuntu/all-databases.sql

使用一个已存在的数据库

如果启动MySQL容器时带上一个包含数据库的目录,$MYSQL_ROOT_PASSWORD 变量不应该放在命令行中;在任何项目中都该忽略此变量,然后已存在的数据库不会以任何方式改变。

PHP 服务


依赖 MySQL 服务。与 Web Server 配合使用时,关键在于 nginx 配置中要指明 PHP 后端服务的地址为 php, fastcgi_pass php:9000;

--links 不是必须的,默认服务之间可以通过服务名相互通讯,因为 network driver 默认使用 bridge,虽然容器间隔离,但是可以通过名称通信。

--links 的格式是 SERVICE:ALIAS,也就是使用其它服务的服务名(SERVICE)和别名(ALIAS)都可以来通讯。

当前已支持常用扩展(比如 pcntl sockets phpredis ...),现在可以在浏览器中访问: http://host-ip:port/phpinfo.php

更多内容见 php-fpm/README.md, php-fpm/Dockerfile

Redis 服务


需要手动解决前两个WARNING

1.vm.overcommit_memory is set to 0!

Host 切换至 root,然后按如下设置:

$ echo vm.overcommit_memory = 1 >> /etc/sysctl.conf
$ sysctl vm.overcommit_memory=1

2.you have Transparent Huge Pages (THP) support enabled in your kernel.

Host 切换至 root,然后按如下设置:

# 注意 rc.local 里面如果有 `exit 0`,要放在它之前.
$ echo 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' >> /etc/rc.local
$ source /etc/rc.local

3.no config file specified, using the default config.

已通过在 redis/Dockerfile 中使用配置文件 redis/redis.conf 解除了 WARNING,你可以修改 redis/redis.conf 的配置项满足你的需要。

4.The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.

已通过在 docker-compose.yml 中配置 sysctls 的选项解除了 WARNING。

更多内容见 redis/README.md, redis/Dockerfile

Web 服务


基于PHP服务镜像的PHP程序环境(包含 Composer 与 web项目目录),具体见 web/README.md

Fe 服务


基于Web服务镜像的Node程序环境(包含 nodejs npm webpack vue-cli ...),具体见 web/README.md

FAQ

phvia/dkc 能用在哪些宿主机环境


在 Ubuntu16.04 上总是能够 build 通过并运行。

其它环境暂时没有测试数据。

How To Custom Image.


ext-swoole/README.md 说明。

使用 COPY 还是 VOLUME


VOLUME 是支持热重载的,而 COPY 需要重新 build。

VOLUME 需要跟主机挂钩,而 COPY 直接拷贝到容器中。

正式环境建议使用 COPY 拷贝项目到镜像中,避免项目文件更改而影响到运行环境。

移除所有未使用的 volume:docker volume prune

PHP 文件如何连接 MySQL 和 Redis


配置的 host 填写服务名,port 填写容器中暴露的端口,非主机端口.

几个平常可能使用的脚本


  • ./remove_none_name_images.sh # 移除名称为 (即没有名称)的镜像
  • ./stop_and_remove_all_container.sh # 使用 docker 命令逐个停止并删除所有容器

最新可用镜像


$ docker pull phvia/php:7.3.9-fpm

$ docker pull phvia/php:7.3.9-fpm_web

$ docker pull phvia/php:7.3.9-fpm_swoole-4.3.5

$ docker pull phvia/php:7.3.9-fpm_swoole-4.3.5_web

$ docker pull phvia/fe:12.x

$ docker pull phvia/redis:3.2.12

$ docker pull phvia/mysql:5.7.22

自定义构建的方式:dkc -f docker-composer-custom.yml build php-fpm

镜像源设置

$ vi /etc/docker/daemon.json

{
    "registry-mirrors": [
        "https://docker.mirrors.ustc.edu.cn",
        "https://registry.docker-cn.com"
    ],
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "100m",
        "max-file": "3"
    },
    "max-concurrent-downloads": 10,
    "max-concurrent-uploads": 10
}

系列文章


http://www.cnblogs.com/farwish/tag/Docker/