• build

    build

    • 用法
    1. Usage: docker build [OPTIONS] PATH | URL | -
    3. Build a new image from the source code at PATH
    5.  -f, --file=""            Name of the Dockerfile (Default is 'PATH/Dockerfile')
    6.  --force-rm=false         Always remove intermediate containers
    7.  --no-cache=false         Do not use cache when building the image
    8.  --pull=false             Always attempt to pull a newer version of the image
    9.  -q, --quiet=false        Suppress the verbose output generated by the containers
    10.  --rm=true                Remove intermediate containers after a successful build
    11.  -t, --tag=""             Repository name (and optionally a tag) for the image
    12.  -m, --memory=""          Memory limit for all build containers
    13.  --memory-swap=""         Total memory (memory + swap), `-1` to disable swap
    14.  -c, --cpu-shares         CPU Shares (relative weight)
    15.  --cpuset-mems=""         MEMs in which to allow execution, e.g. `0-3`, `0,1`
    16.  --cpuset-cpus=""         CPUs in which to allow execution, e.g. `0-3`, `0,1`
    17.  --cgroup-parent=""       Optional parent cgroup for the container
    18.  --ulimit=[]              Ulimit options
    • 例子

    使用该命令，将会从参数指定的路径中的 Dockerfile的文件执行构建镜像，文件的指向可以是一个本地文件PATH或者是一个URL。

    例如：

    1. $ sudo docker build https://github.com/docker/rootfs.git#container:docker

    或者用标准输入：

    1. $ sudo docker build - < Dockerfile

    如果你采用以上两种方式构建镜像，-f 或者－file参数将失效。

    默认情况下，docker build 指令将会在指定根目录下查找Dockerfile文件，如果指定-f/-file参数，将指定该构建目录文件，这样的好处是可以多次构建。需要注意的是，路径必须包含构建信息的文件。

    在多数情况下，最好保证构建目录为空。然后添加所需要的软件包到该文件夹。为了提高构建效率，可以加入 .dockerignore 文件排除一些不需要的文件。

    返回值

    如果构建成功，将会返回0，当失败时，将会返回相应错误返回值：

    1. $ docker build -t fail .
    2. Sending build context to Docker daemon 2.048 kB
    3. Sending build context to Docker daemon
    4. Step 0 : FROM busybox
    5.  ---> 4986bf8c1536
    6. Step 1 : RUN exit 13
    7.  ---> Running in e26670ec7a0a
    8. INFO[0000] The command [/bin/sh -c exit 13] returned a non-zero code: 13
    9. $ echo $?
    10. 1

    一般例子：

    1. $ docker build .
    2. Uploading context 10240 bytes
    3. Step 1 : FROM busybox
    4. Pulling repository busybox
    5.  ---> e9aa60c60128MB/2.284 MB (100%) endpoint: https://cdn-registry-1.docker.io/v1/
    6. Step 2 : RUN ls -lh /
    7.  ---> Running in 9c9e81692ae9
    8. total 24
    9. drwxr-xr-x    2 root     root        4.0K Mar 12  2013 bin
    10. drwxr-xr-x    5 root     root        4.0K Oct 19 00:19 dev
    11. drwxr-xr-x    2 root     root        4.0K Oct 19 00:19 etc
    12. drwxr-xr-x    2 root     root        4.0K Nov 15 23:34 lib
    13. lrwxrwxrwx    1 root     root           3 Mar 12  2013 lib64 -> lib
    14. dr-xr-xr-x  116 root     root           0 Nov 15 23:34 proc
    15. lrwxrwxrwx    1 root     root           3 Mar 12  2013 sbin -> bin
    16. dr-xr-xr-x   13 root     root           0 Nov 15 23:34 sys
    17. drwxr-xr-x    2 root     root        4.0K Mar 12  2013 tmp
    18. drwxr-xr-x    2 root     root        4.0K Nov 15 23:34 usr
    19.  ---> b35f4035db3f
    20. Step 3 : CMD echo Hello world
    21.  ---> Running in 02071fceb21b
    22.  ---> f52f38b7823e
    23. Successfully built f52f38b7823e
    24. Removing intermediate container 9c9e81692ae9
    25. Removing intermediate container 02071fceb21b

    上面例子中，指定路径是 .,这个路径告诉docker构建的目录为当前目录，里面包含构建文件的信息，以及所要添加的文件。如果想保留构建过程中的容器，可以使用—rm=false ，这样操作不会影响构建缓存。

    下面这个例子使用了.dockerignore文件来排除.git文件的使用方法，将会影响上下文文件大小。

    1. $ docker build .
    2. Uploading context 18.829 MB
    3. Uploading context
    4. Step 0 : FROM busybox
    5.  ---> 769b9341d937
    6. Step 1 : CMD echo Hello world
    7.  ---> Using cache
    8.  ---> 99cc1ad10469
    9. Successfully built 99cc1ad10469
    10.     $ echo ".git" > .dockerignore
    11. $ docker build .
    12. Uploading context  6.76 MB
    13. Uploading context
    14. Step 0 : FROM busybox
    15.  ---> 769b9341d937
    16. Step 1 : CMD echo Hello world
    17.  ---> Using cache
    18.  ---> 99cc1ad10469
    19. Successfully built 99cc1ad10469

    使用-t参数指定name以及tag：

    1. $ docker build -t vieux/apache:2.0 .

    从标准输入读取Dockerfile：

    1. $ docker build - < Dockerfile

    使用压缩文件，目前支持的格式是bzip2, gzip and xz

    1. $ docker build - < context.tar.gz

    从克隆的GitHub仓库作为上下文构建镜像，在仓库根目录下的Dockerfile文件将作为构建文件。

    1. $ docker build github.com/creack/docker-firefox

    注意，若要加前缀必须是 git:// 或者 git@ 。

    使用-f参数指定文件构建

    1. $ docker build -f Dockerfile.debug .

    在.目录下从不同文件构建镜像：

    1. $ docker build -f dockerfiles/Dockerfile.debug -t myapp_debug .
    2. $ docker build -f dockerfiles/Dockerfile.prod  -t myapp_prod .

    我们在观察下面例子：

    1. $ cd /home/me/myapp/some/dir/really/deep
    2. $ docker build -f /home/me/myapp/dockerfiles/debug /home/me/myapp
    3. $ docker build -f ../../../../dockerfiles/debug /home/me/myapp

    这个例子执行的两次构建操作所做事情是一模一样的，都会寻找debug文件作为Dockerfile来构建镜像。