容器指令备忘

发表于

如今容器技术已经十分成熟了，前后端或运维的日常都离不开它。平时老是用公司线上 CI/CD 平台来完成部署，突然有了一台隔离环境需要徒手敲命令，却发现自己把命令行的操作指令遗忘了七七八八。这里记录一下 docker 的常用指令，特别是在单台环境部署多个服务时，docker-compose 的内容。

基本操作

  • 登陆 docker hub docker login。
  • 拉取镜像 docker pull。
  • 给镜像打 tag docker tag image-id xxxx:yyy。
  • 查看 image docker image ls。
  • 查看 container docker ps会显示当前正在运行的镜像。ps:有些时候镜像运行完就退出了，可以加上-a参数来找到它。
  • 杀掉某一正在运行镜像 docker kill xxx。xxx 可以是镜像的名称、container Id 等等。
  • 查看镜像的 log docker logs 464fced66de3。可以帮助定位出问题的镜像。
  • 查看本地存储卷 docker volume ls。
  • 运行镜像 docker run -p localhost-port:image-expose-port -d your-docker-image。-p绑定端口，-d让镜像可以在后台运行，-e增加环境变量。这里还有一堆参数，请看docker run指令。注意，your-docker-image后面还可以增加类似/bin/bash的指令，如果镜像是用 Dockerfile 打出来的话，这句话会覆盖你的CMD指令。
  • 镜像打包 docker save 4837420db37e | gzip > 4837420db37e.tgz。
  • 镜像复原 docker load -i 4837420db37e.tgz。这两个指令可以方便的迁移我们的镜像。
  • 自动清理 docker [commmand like: volume/container] prune。docker rm $(docker ps -aq)。docker system prune --volumes清除所有不相关或不使用的 Docker 数据。
  • 编译镜像 docker build -f your-Dockerfile。
  • docker build 过程中使用代理 docker build --build-arg http_proxy=xxx --build-arg https_proxy=xxx .。dockerfile 中设置环境变量ENV http_proxy xxx，会在 docker 启动后才生效，且该代理会一直存在。具体参考 pdf 目录下相关文件。
  • 查看 docker 的事件。这时，我们需要多开一个 shell 进入docker events中。在另一个 shell 中，正常执行我们的指令。你会发现，我们在第一个 shell 中可以实时显示容器的内部事件了。
  • PS:各种命令都可以加上docker xxx --help来快速查看额外参数的作用。

有时候我们想要运行镜像后，进入此镜像的 shell 中。这里有三个有用的指令：

  • docker run -it your-image适用于启动镜像时进入命令行界面。如果写成docker run -it your-image /bin/bash则不会执行 dockerfile 中的 CMD 命令，而是进入命令行待命。若参数带了-d或写成了-itd，则依旧进入后台运行，而不是进入命令行。

  • docker attach container-id用来连接到正在运行中的容器中。

  • 退出 attach 的镜像，不关闭它

  • docker exec [OPTIONS] container-id COMMAND [ARG...]用来在运行的镜像中执行相关命令。我们也可以使用docker exec -it container-id /bin/bash来进入一个运行的镜像。

  • 用守护进程进入没有明确 CMD 指令的镜像，这类镜像一起动就会自动退出：docker run -it container-id /bin/sh。

  • dockerfile 指令:

    • COPY 复制文件
    • ADD 更高级的复制文件
    • CMD 容器启动命令
    • ENTRYPOINT 入口点
    • ENV 设置环境变量
    • ARG 写在 dockerfile 里的，用于构建镜像时的构建参数
    • VOLUME 定义匿名卷
    • EXPOSE 暴露端口
    • WORKDIR 指定工作目录

  • 我们可以通过docker network ls来查看当前docker的网络类型。其包含以下几种驱动模式：

    • bridge 默认方式。采用网络桥接，功能强大
    • host 此方式下，容器直接使用宿主机的网络环境
    • macvlan 此方式下，可以为容器添加一个mac地址
    • overlay 此方式下，使不同主机上的容器可以互相通讯
    • none 此方式下，容器不启用任何网络
    • 有时候我们从外部访问容器，可能出现connection reset by peer的错误，而在容器内部却访问的通。我们可以试试使用docker run -d --network="host"改变使用的网络方式，来判断是不是网络问题引起的。但是”host”模式并不是很安全。
  • 查看存储卷 docker volume ls
  • 创建存储卷 docker volume create --name xxx
  • 获取容器/镜像的元数据 docker inspect可以查看镜像（image）、存储卷（volume）、容器（container）信息

在 ARM 架构下编译

现在 cpu 的架构很多，平时我们使用的都是x86，在此环境下编译出的镜像，是不能在ARM架构下使用的。想要构建ARM架构下的镜像，需要从头开始编译。
运行与架构不匹配的镜像时，可能出现以下错误:

1
2
# 一个arm架构的信息 uname -a
# Linux localhost.localdomain 4.14.0-115.el7a.0.1.aarch64 #1 SMP Sun Nov 25 20:54:21 UTC 2018 aarch64 aarch64 aarch64 GNU/Linux

standard_init_linux.go:211: exec user process caused “exec format error”

同样的问题在docker build中也可能出现，这是由于使用了RUN命令：

解决方案是在对应的平台构建对应的镜像。现在有一个库buildx来方便构建多平台任务。

利用 docker-compose 部署多个服务

在需要同时部署多个服务的时，我们当然可以每次运行一个镜像来启动每一个服务。但有时候，如果服务直接存在相互的依赖关系，一个服务未启动会使另一个服务挂掉，就需要docker-compose出马了。我们这里以一个 node 服务和一个 mongo 服务为例，且 node 服务是依赖 mongo 服务的。

写一个”compose-file”

我们需要在合适的目录下，建立一个docker-compose.yml文件。

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
version: '3.7'

services:
  mongodb:
    image: mongo:3.4.3
    container_name: mongodb
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: root
      MONGO_INITDB_DATABASE: admin
      MONGO_USERNAME: dbuser
      MONGO_PASSWORD: dbpwd
      MONGO_DATABASE: dbname
    ports:
      - 27017:27017
    volumes:
      - ./mongo-init.sh:/docker-entrypoint-initdb.d/mongo-init.sh:ro
      - mongo-volume:/data/db
  web:
    image: my-web:latest
    container_name: web
    depends_on:
      - "mongodb"
    ports:
      - 3000:3000
      - 6789:6789
    environment:
      PORT: '3000'

volumes:
  mongo-volume:
    external: false

最外层并行的三个配置项是：

  • version指的是使用的 compose 文件的格式版本。目前使用的是3.7。
  • services需要 docker 启动的服务。这个对象下的每一项，都是一个会被启动的服务。
  • volumes需要 docker 创建的内部文件系统。同理，它的每一项，都将生成一个存储卷。

ports 和 expose 的区别，前者可以被外部访问，expose 暴露的只能在容器内访问参考。

其他子配置项的作用可以在官网中寻找，这里就不赘述了。下面就本次工程，指出几个关键的配置的作用。

对于 mongo

在建立数据库服务时，我们会考虑下面的问题：

  1. 初始数据如何导入？
  2. 数据如何持久化？

在查询了官方 mongo 镜像的Dockerfile后，我们可以通过一些环境变量来配置数据库。简单来说，如果环境变量MONGO_INITDB_ROOT_USERNAME和MONGO_INITDB_ROOT_PASSWORD存在，将会创建一个admin数据库和一个 root 用户，用来进行后续管理。同时，在启动镜像前，mongo 将会执行/docker-entrypoint-initdb.d/下的文件，我们通过这个方式，可以完成数据库的初始化。

对于第二个问题，docker 为我们提供了volume存储卷模式。在上面的配置文件中，我们通过volumes指定了要创建的存储卷 mongo-volume。然后我们在服务 mongodb 下，定义了 volumes 的使用方式：

1
2
- ./mongo-init.sh:/docker-entrypoint-initdb.d/mongo-init.sh:ro # 这里把我们的初始化脚本复制进执行目录。参数:ro的意思是只读。
- mongo-volume:/data/db # 这里挂载了mongodb存储位置

下面是初始化脚本

1
2
3
4
5
6
7
#!/bin/bash
"${mongo[@]}" "$MONGO_INITDB_DATABASE" <<EOF
  var dbname = db.getSiblingDB('dbname');
  var user = "$MONGO_USERNAME";
  var passwd = "$MONGO_PASSWORD";
  dbname.createUser({user: user, pwd: passwd, roles:[{role: "readWrite",db: "dbname"}] });
EOF

另外推荐一个 mongo 可视化连接工具Robo 3T来方便操作。

对于 node

node 服务其实比较简单，通过 Dockerfile 构建好镜像后，暴露出相应的服务端口即可。在这里，depends_on解决了上面提到的依赖问题。此时，docker 会先启动被依赖的服务。这里记录一个 Dockerfile，当碰到依赖库(imagemin-pngquant)需要主动编译情况下的解决方案：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
FROM node:10.16-alpine
LABEL author=my@my.com
WORKDIR /home/my-web
COPY . ./
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories
RUN apk update && \
  apk add --no-cache git \
    autoconf \
    automake \
    bash \
    g++ \
    libc6-compat \
    libjpeg-turbo-dev \
    libpng-dev \
    make \
    nasm # 安装这么一大堆东西来编译imagemin-pngquant的依赖

RUN npm install  && \
  npm run build

CMD ["npm", "run", "start:prod"]

需要指出的是，默认情况下，镜像里的 localhost 不是你本机的 localhost 啦。我就是忘记了这一点，在调试的过程中浪费了许多时间。docker-compose 在启动的时候，会建立一系列的工作，其中之一便是建立一个虚拟网络。所以我们在 node 服务中连接数据库时，数据库的 host 是你的服务名mongo（上面的配置文件中）了。正确的写法应该是:mongodb://dbuser:dbpwd@mongo:27017/dbname。当然，这种网络模式也可以改变，可以参考网络的bridge mode和host mode。

启动/更新/关闭

  • docker-compose up -d-启动服务。默认将会在当前目录下寻找配置文件docker-compose.yml。
  • docker-compose pull web && docker-compose down && docker-compose up -d-更新镜像并重启，数据不会丢失。
  • docker-compose down-关闭并销毁。

参考

Docker-YApi
Managing MongoDB on docker with docker-compose
how to set docker mongo data volume

最后

到了最后，发现这篇就是一个大杂烩，也不知道再看还有没有效果～～