0. 背景

本文讲解如何构建一个镜像，和发布到 Docker Hub。

基于 Docker 的开发流程
一般来说基于 Docker 的开发流程是这样的：

• （1）创建Docker镜像，它承载了你的程序运行的必要环境，是创建和测试独立的基础。
• （2）测试，验证你的镜像。
• （2）发布/分享你的镜像。比如在 Docker Hub 上发布你的Docker镜像

本文关注第一步，创建一个基础的镜像，这个镜像是你的容器的基础。一个镜像包含了用于承载容器运行的私有的文件系统。基于此，我们需要把我们的应用程序的能够运行的所需文件/ 组件放入镜像中。

容器化的开发环境，相比于传统的开发环境更容易配置。由于一个容器化的开发环境会把应用程序所需要的文件依赖项，隔离在镜像的内部。那么，在你的真实开发主机上，仅需要安装Docker就够了。

通过这种方式，你可以轻松地为不同的技术栈开发应用程序，而无需更改开发者主机上的内容。

1. 在开始之前的准备

从 git 克隆一个示例项目到你本地：

git clone https://github.com/dockersamples/node-bulletin-board
cd node-bulletin-board/bulletin-board-app

2. 创建Docker镜像

步骤拆解：

• (1) 编写 Dockerfile 文件
• (2) 执行

下面分别说明。

2.1 编写 Dockerfile 文件

进入项目的根目录，新一个 Dockerfile 文件，内容如下：

# 指定一个 作为基础的 官方镜像
FROM node:current-slim

# 设置工作目录，这里是你的Docker镜像文件系统中的文件位置
WORKDIR /usr/src/app
# 拷贝你机器中的 package.json 到 镜像文件系统中
COPY package.json .
# 要使用npm，先指定一个国内的源
RUN npm config set registry https://registry.npm.taobao.org
# 执行 npm install
RUN npm install

# 暴露Docker镜像的 8080 端口
EXPOSE 8080

# 执行 指令 npm start
CMD [ "npm", "start" ]

# 拷贝当前文件下的内容到 Docker镜像中
COPY . .

说明：

• FROM：指定一个 作为基础的 官方镜像
• WORKDIR：设置Docker镜像文件系统中的工作目录，后续操作以这个为基础。
• RUN ：后面跟的是在你的Docker镜像中执行的指令。
• EXPOSE：暴露Docker镜像的 8080 端口
  上面的步骤构建了镜像的文件系统。
• CMD：是第一个在映像中运行的指令。

这些步骤与您在主机上设置和安装应用程序的步骤大致相同。由于使用了Dockerfile，它可以使您在可移植的、独立的Docker镜像中执行相同的操作。

2.2 执行构建 docker build

在命令行执行：

docker build --tag bulletinboard:1.0 .

执行后，将会看到按步骤执行的过程。

image.png

最后看到 Successfully tagged "你的镜像名"，说明构建完成。

查看你本机的所有镜像
执行 docker images 查看你本机的所有镜像，看下是不是有了。

docker images

3. 用这个镜像启动容器

用这个镜像启动容器，执行：
docker run --publish 8000:8080 --detach --name bb bulletinboard:1.0

说明：
--publish： 指定端口映射，比如这里它将主机端口8000的流量转发到容器端口8080。容器的端口是私有的，想从网络中访问就必须以这种方式将流量转发给它。
--detach：表示将在后台运行此容器。
--name：指定容器的名称。

访问启动后的程序
在浏览器中打开,可以看到部署成功的应用web页面

http://localhost:8000

移除这个容器
上面指定了名字叫 bb ，那么执行：

docker rm --force bb

4. 在 Docker Hub 上发布你的Docker镜像

Docker Hub 存放着 Docker 及其组件的很多资源，很多人在这里发布/分享镜像，这里我们也发布一个。分这么几步：

• （1）注册账户
• （2） 创建 一个 仓库 repository
• （3） 推送(push)你的镜像

4.1 注册账户

在 https://hub.docker.com/signup. 完成注册。

4.2 创建 一个 仓库 repository

找到 Repositories > Create ，填写一些信息，按引导完成创建。

4.3 推送(push)你的镜像

建立镜像关联到远程仓库
注意下面 gordon 改成你的账户名。

docker tag bulletinboard:1.0 gordon/bulletinboard:1.0

执行push

docker push gordon/bulletinboard:1.0

现在镜像已经可以在Docker Hub上使用了，在新机器上部署使用它会非常方便，Docker将自动尝试并从Docker Hub下载它。

一个至关重要的最佳实践是：将你的 Dockerfile 放在版本控制中，可能与应用程序的源代码放在一起。并在 Docker Hub 存储库描述指示可以在何处找到这个文件。这样不仅保留镜像构建方式的记录，还保留镜像作为完整应用程序运行的方式的记录。

5. 参考

https://docs.docker.com/get-started/part2/

https://www.widuu.com/chinese_docker/userguide/dockerhub.html

https://docs.docker.com/get-started/part3/

END