目标

基于 Centos 7.6 , 封装出一个可用于运行 php 项目的开箱即用镜像

本文作出以下假设

  • 你懂得基本的类unix 操作系统常识
  • 拥有类unix 运行环境 (包括但不限于安装了 类unix 的实体机unix虚拟机
  • 你懂得基本的 docker 操作和有一定的 dockerfile 阅读与创作能力

准备工作

建立工作目录

1
2
mkdir ~/docker-learn
cd ~/docker-learn

创建Dockerfile

1
touch Dockerfile

然后拷贝你常用的 nginx.conf 到工作目录

1
cp xxx/nginx.conf nginx.conf

封装基础镜像

编辑我们创建好的 Dockerfile

基础内容

声明本镜像继承自 centos 最新版

1
FROM centos

安装 nginx

  • 创建nginx源文件

    由于 centos 仓库里是没有 nginx 的 , 所以我们要自力更新添加nginx的源到 docker 里
    复制 nginx.org 里关于 RHEL 源的内容到 nginx.repo 文件

    也可以本地执行以下命令创建 nginx.repo

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    sudo tee ./nginx.repo <<-'EOF'
    [nginx-stable]
    name=nginx stable repo
    baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
    gpgcheck=1
    enabled=1
    gpgkey=https://nginx.org/keys/nginx_signing.key

    [nginx-mainline]
    name=nginx mainline repo
    baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
    gpgcheck=1
    enabled=0
    gpgkey=https://nginx.org/keys/nginx_signing.key
    EOF
  • 写入复制 nginx.repo 指令到docker镜像中

    1
    COPY nginx.repo /etc/yum.repos.d/nginx.repo
  • 使用yum安装nginx并设置为开机启动

    1
    2
    3
    RUN yum makecache && 
    yum install nginx &&
    chkconfig nginx on

安装 php

centos 默认源中拥有低版本的 php 以及相关包 , 我们需要换一个版本新一些的源 .
本文 remi开源镜像

  • 安装 remi 源

    1
    2
       RUN rpm -ivh http://rpms.famillecollet.com/enterprise/remi-release-7.rpm && 
    yum update -y
  • 使用 yum 安装php和相关包并设置为开机启动

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
      RUN yum install -y --enablerepo=remi --enablerepo=remi-php72 
    php
    php-openssl
    php-curl
    php-bcmath
    php-devel
    php-mbstring
    php-mcrypt
    php-mysqlnd
    php-pdo
    php-gd
    php-xml
    php-opcache
    php-fpm &&
    chkconfig php-fpm on

清理工作

众所周知,如果要推送到线上的话镜像越小越好,docker yum 的运行会生成大量缓存,那么我们就很有必要做一些清理工作了

1
2
3
4
RUN yum clean headers && 
yum clean packages &&
yum clean metadata &&
rm -rf /usr/share/man

声明镜像运行时入口点

即容器运行时执行的第一个命令,如果不是 init 的话很有可能部分特权命令无法运行,例如 chkconfig

1
ENTRYPOINT ["/sbin/init"]

合并 dockerfile

dockerfile 中的每个指令都会单独生成一层镜像,这样势必会增加我们的镜像体积
通常做法是尽可能把多条指令整理顺序合并为一条,就可以有效减小镜像体积

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
FROM centos

# 复制两个repo
COPY conf/tsinghua-base.repo /etc/yum.repos.d/CentOS-Base.repo
COPY conf/nginx.repo /etc/yum.repos.d/nginx.repo

# 安装组件和相关包
RUN yum makecache &&
yum -y install nginx &&
chkconfig nginx on &&
yum install -y epel-release &&
rpm -ivh http://rpms.famillecollet.com/enterprise/remi-release-7.rpm &&
yum update -y &&
yum install -y --enablerepo=remi --enablerepo=remi-php72
php
php-openssl
php-curl
php-bcmath
php-devel
php-mbstring
php-mcrypt
php-mysqlnd
php-pdo
php-gd
php-xml
php-opcache
php-fpm &&
chkconfig php-fpm on &&
yum clean headers &&
yum clean packages &&
yum clean metadata &&
rm -rf /usr/share/man

# 声明入口点
ENTRYPOINT ["/sbin/init"]

测试镜像可用性

  • 构建镜像

    值得注意的是 nginx 官方 repo 并不是很稳定 , 运行时可能会出错 , 重试几次一般都可以成功
    如果是其他类型的错误,那么就要检查环境以及 dockerfile 有没有问题

    1
    docker build . -t first-build
  • 带有特权启动一个后台运行的容器,将会返回一个ID

    使用了 –privileged 选项之后,容器会拥有真的 root 权限,否则就只有本地普通用户权限.容器中执行了某些特殊操作(例如 systemctl)时才需要该选项

    1
    docker run -d --privileged first-build
  • 测试镜像的运行状况

    1
    docker exec -it ( docker run 命令返回的ID ) ps aux | grep '[nginx|php]'

    如果返回结果类似这样,那么说明我们的操作是正确的

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    > docker exec -it cca6 ps aux | grep '[nginx|php]'
    root 1 0.0 0.0 43112 4888 ? Ss 09:15 0:00 /sbin/init
    root 17 0.0 0.0 39096 6476 ? Ss 09:15 0:00 /usr/lib/system
    root 29 0.1 0.0 35100 3308 ? Ss 09:15 0:00 /usr/lib/system
    root 370 0.0 0.1 371588 21424 ? Ss 09:15 0:00 php-fpm: master
    root 381 0.0 0.0 24264 2784 ? Ss 09:15 0:00 /usr/lib/system
    dbus 386 0.0 0.0 58000 4164 ? Ss 09:15 0:00 /usr/bin/dbus-d
    root 418 0.0 0.0 46432 980 ? Ss 09:15 0:00 nginx: master p
    nginx 421 0.0 0.0 46832 3512 ? S 09:15 0:00 nginx: worker p
    root 564 0.0 0.0 8096 1820 tty1 Ss+ 09:15 0:00 /sbin/agetty --
    apache 822 0.0 0.0 371588 12468 ? S 09:15 0:00 php-fpm: pool w
    apache 825 0.0 0.0 371588 12468 ? S 09:15 0:00 php-fpm: pool w
    root 2859 0.0 0.0 51752 3448 pts/0 Rs+ 09:21 0:00 ps aux
  • 此时如果使用了端口映射来启动镜像,那么你甚至可以在本地浏览器里看到 nginx 的默认欢迎页

    1
    docker run -d --privileged -p 8080:80 first-build


推送镜像到阿里云容器服务

界面大概长像这样

  • 使用镜像加速器

点开左下角的镜像加速器https://cr.console.aliyun.com/cn-zhangjiakou/instances/mirrors,你会看到你专属的加速链接

找到你的操作系统,逐条执行即可,本文使用 Ubuntu 版本.
可见执行很顺利,没有任何异常

  • 登录到阿里云docker仓库

    1
    2
    3
    sudo docker login --username=你的阿里云用户名 registry.cn-zhangjiakou.aliyuncs.com
    Password: 你的阿里云密码
    Login Succeeded
  • 建立命名空间

点击左侧的命名空间,点击创建命名空间,输入你的命名空间名称

命名空间可以理解为镜像所属的组织
例如: centos 镜像的全名是 docker.io/centos,docker.io 就是centos镜像的命名空间,但是docker.io这个命名空间下却存在不止centos一种镜像.

公开和私有是指镜像是否可以在阿里云镜像市场中被大众查看和是否能够不需要任何权限拉取

  • 建立仓库

刚才我们已经创建好了命名空间,那么接下来就是创建仓库了.

仓库可以理解为组织创建的软件包包名
例如: centos 镜像的全名是 docker.io/centos,centos 就是docker.io的一个仓库(软件),同时centos这个软件可以有很多个版本.

进入 https://cr.console.aliyun.com/cn-zhangjiakou/instances/repositories 仓库页面 , 点击新建仓库.

命名空间选择刚才创建好的,摘要即为镜像简介.

点击下一步,代码源选择本地仓库

点击创建镜像仓库之后,就会发现页面上多了一行数据,说明创建成功

鼠标放到那个下载一样的图标上,会看到仓库的专属地址

  • 修改镜像名

我们要把我们刚才构建的一个叫做 first-build 的镜像推送到阿里云仓库中.首先我们使用 docker images | grep first-build 查找到它镜像ID.接下来我们修改镜像的名字为符合docker第三方仓库的镜像名格式.

第三方镜像仓库镜像名格式:仓库地址/组织/镜像名:镜像版本号

以阿里云为例:阿里云仓库地址/命名空间/仓库名:版本 registry.cn-zhangjiakou.aliyuncs.com/leasn-docker/learn-docker:1

然后执行以下命令来修改:

1
docker tag 3482e8529a90 registry.cn-zhangjiakou.aliyuncs.com/leasn-docker/learn-docker:1

再次使用 docker images | grep first-build 发现已经找不到了,因为它的名字已经变掉了

  • 推送镜像
1
sudo docker push registry.cn-zhangjiakou.aliyuncs.com/leasn-docker/learn-docker


等所有的 Pushing 运行结束之后我们会发现阿里云仓库中多了一个版本.

至此,镜像已经推送成功.我们已经可以基于阿里云的支持,在全世界范围内使用我们的镜像.

对于向开源事业无私奉献的阿里云致敬


封装项目运行镜像

现在我们就要研究怎么让镜像跑我们自己的项目了

  • 这次就可以基于我们推送阿里云的镜像了

    1
    FROM registry.cn-zhangjiakou.aliyuncs.com/leasn-docker/learn-docker:1
  • 复制我们准备好的 nginx.conf 到镜像里

    1
    COPY nginx.conf /etc/nginx/conf/nginx.conf

    nginx.conf 全文

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    user nginx;
    worker_processes auto;
    pid /run/nginx.pid;

    events {
    worker_connections 1024;
    }

    http {
    server {
    listen 80;
    server_name 127.0.0.1;
    root /var/www/html;
    index index.php;

    location ~ \.php($|/) {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_split_path_info ^(.+\.php)(.*)$;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    }
    }
    }
  • 复制工程源码到镜像里

    在当前目录建立我们的工程,并且假装我们的工程只有一个文件,它位于./proj

    复制我们的工程到镜像里并为运行目录加权

    1
    2
    COPY proj /var/www/html
    RUN chmod -R 755 /var/www/html/

    Dockerfile 全文

    1
    2
    3
    4
    5
    FROM registry.cn-zhangjiakou.aliyuncs.com/leasn-docker/learn-docker:1
    COPY nginx.conf /etc/nginx/nginx.conf

    COPY proj /var/www/html
    RUN chmod -R 755 /var/www/html/

    构建镜像并使用端口映射运行我们的容器

    1
    2
    docker build .
    docker run --privileged -d -p 8080:80 773ed8872493

    如果不出意外,我们已经可以在本地的 127.0.0.1:8080 中看到 phpinfo() 了

    既然phpinfo已经看到了,那么如何让整个工程跑起来我就不赘述了.

值得一提的是,推送新版本到

使用 docker-compose 编排镜像

Compose 是一个用于定义和运行多容器Docker应用程序的工具。使用Compose,您可以使用YAML文件来配置应用程序的服务。然后,使用单个命令,您可以从配置中创建并启动所有服务

该应用使用 sudo apt install docker-compose 安装

  • 调整目录结构

    在我们现在工作目录外面再加一层目录,大致是: 工作目录 > docker-learn (以前的工作目录) && docker-compose.yaml

    目录树形结构:

  • 编辑 docker-compose.yaml

    docker-compose 包含多个指令,并采用yaml语言编写.可以理解为把我们在命令行运行的 run 命令参数写到了文件里,经过统一的工具协调启动.

    主要指令:

version 版本信息,不知道为什么必须是 3

1
version: 3

services 需要编排的服务列表,本次我们主要编写一个叫做 docker-learn 的服务

1
services:
  • docker-compose.yaml 全文
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

version: '3'
services:
# 服务名
docker-learn:
# 该服务是否以特权启动 , 即 --privileged
privileged: true
# 构建
build:
# 构建上下文 即: docker build ./docker-learn
context: ./docker-learn
# 端口映射,即 -p 80:80
ports:
- 80:80
# 对外暴露的端口 ,相当于Dockerfile 的 EXPOSE 指令
# EXPOSE指令只是声明了容器应该打开的端口,但是并没有实际上将它打开!
# 该选项在 docker run -it -P(大写) 时会真的起作用
expose:
- 80
# 目录映射 , 相当于 docker run -v
# volumes:
# - ./logs/php-fpm:/var/log/php-fpm
# - ./logs/nginx:/var/log/nginx
  • 使用docker-compose 启动镜像

    关闭其他运行中的容器,以免与我们即将运行的容器冲突

    1
    docker ps | awk '{print $1}' | grep -v CON | xargs docker kill

    启动镜像

    单独 up 不使用服务名会运行 services 中定义的所有容器.
    如果services中有多个服务,那么可以使用 up 服务名来单独 up 一个服务容器
    up 默认会使用 build:context 中的 Dockerfile 文件编译好的镜像进行容器启动,–build 是强制再次使用 Dockerfile 进行重新编译镜像再启动 . 但是 –build 仍然会使用已经存在的镜像层的缓存
    –force-recreate 重新编译时不使用镜像层缓存 , 完全重新编译

    如果出现 bind: address already in use 类似的提示 , 就换一个 ports 里的绑定端口重试

    1
    docker-compose up [docker-learn] [--build] [--force-recreate]

    我们发现现在访问 127.0.0.1:8080 仍然可以看到 phpinfo

接入 jenkins 进行持续集成

更新中

接入 kubernetes

更新中

大功告成