[Docker#7] 容器 | OOM | 常用命令 | 交互模式

- 描述: 如果容器中的应用耗尽了主机系统分配给容器的内存限额，就会触发 OOM 事件。
- 示例: 假设主机分配给容器的内存上限为 1GB，当容器内的应用请求超过 1GB 的内存时，会触发 OOM 事件。内存溢出，系统会杀死“胖”进程
- 结果: 容器会被强制关闭。
- 关闭者: 宿主机操作系统，而不是 Docker Daemon。因为容器实际上是运行在宿主机操作系统中的进程，宿主机通过 cgroups 设定了资源上限，当这些进程请求的资源达到上限时，触发的是宿主机操作系统的内核 OOM 事件，因此由宿主机内核关闭这些进程。

禁用 OOM-Killer

- 描述: 用户可以选择 --oom-kill-disable 参数来禁用 OOM-Killer。
- 注意事项: 如果使用 -m 参数设置了容器的内存上限，当容器达到内存资源上限时，主机不会关闭容器，但也不会继续向容器分配资源，此时容器将处于 hung 状态。
- 目的: 将最坏的情况封闭在一定范围内，防止问题蔓延。

无内存上限

- 描述: 如果用户使用了 --oom-kill-disable 参数，但没有使用 -m 参数设定内存上限，容器将尽可能多地使用主机内存资源。
- 结果: 主机内存有多大，容器就将用多大。

3.2 容器异常退出

Init 进程: 每个容器内部都存在一个 Init 进程，容器中其他所有进程都是此进程的子进程。
退出机制: 运行的容器是因为 Init 进程在运行，如果一个子进程因为某种原因造成了退出，那么其父进程也会同步退出，直至 Init 进程也退出。当 Init 进程退出时，容器就被关闭。
Docker Daemon 行为: Docker Daemon 无法判断进程退出是正常退出还是异常退出。当容器关闭时，Docker Daemon 会尝试将容器从 Stopped 状态转为 Running 状态，但前提是容器设置了 --restart 参数。否则，容器将保持停止状态。

3.3 容器暂停

CPU 资源剥夺: 当容器被暂停时，Docker 会“剥夺”该容器的 CPU 资源。
其他资源保留: 其他资源如内存资源、网络资源等仍然保留。
状态: 由于失去了 CPU 资源，容器中的进程不会被主机内核系统调度，因此容器处于“冰封”状态。

容器命令清单

命令	别名	功能	备注
docker create	docker container create	创建容器
docker run	docker container run	运行容器	必须掌握
docker attach	docker container attach	连接到正在运行中的容器
docker commit	docker container commit	将容器提交为镜像	必须掌握
docker cp	docker container cp	在容器和宿主机之间拷贝文件	必须掌握
docker diff	docker container diff	检查容器文件结构的更改
docker exec	docker container exec	在运行的容器中执行命令	必须掌握
docker export	docker container export	将容器导出为 tar 文件
docker inspect	docker container inspect	查看容器详细信息	必须掌握
docker kill	docker container kill	强制退出容器	必须掌握
docker logs	docker container logs	查看容器日志	必须掌握
docker ps	docker container ls, list, ps	查看正在运行的容器	必须掌握
docker pause	docker container pause	暂停容器
docker port	docker container port	查看容器的端口映射
docker prune	docker container prune	删除停止的容器
docker rename	docker container rename	重命名容器
docker restart	docker container restart	重启容器	必须掌握
docker rm	docker container rm, remove	删除容器	必须掌握
docker start	docker container start	启动容器	必须掌握
docker stats	docker container stats	查看资源占用信息	必须掌握
docker stop	docker container stop	停止容器	必须掌握
docker top	docker container top	查看容器中运行的进程信息	必须掌握
docker unpause	docker container unpause	继续运行容器
docker update	docker container update	更新容器配置
docker wait	docker container wait	阻止容器停止，打印退出代码

Docker 容器常用命令

docker create

功能: 创建一个新的容器但不启动它
语法: docker create [OPTIONS] IMAGE [COMMAND] [ARG...]
关键参数:

- -i: 以交互模式运行容器
- -P: 随机端口映射
- -p: 指定端口映射
- -t: 分配一个伪输入终端
- --name="nginx-lb": 为容器指定一个名称
- --rm: 容器退出时自动删除
- --restart: 自动重启

样例: docker create --name mynginx nginx:latest

docker run

功能: 创建一个新的容器并运行一个命令
语法: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

关键参数

-d: 后台运行容器，并返回容器 ID；比 create 多了这个参数。
-i: 以交互模式运行容器，通常与 -t 同时使用。
-P: 随机端口映射，容器内部端口随机映射到主机的端口。
-p: 指定端口映射，格式为：主机(宿主)端口:容器端口。
-t: 为容器重新分配一个伪输入终端，通常与 -i 同时使用。
--name="nginx-lb": 为容器指定一个名称。
-h "mars": 指定容器的 hostname。
-e username="ritchie": 设置环境变量。
--cpuset-cpus="0-2" or --cpuset-cpus="0,1,2": 绑定容器到指定 CPU 运行。
-m: 设置容器使用内存最大值。
--network="bridge": 指定容器的网络连接类型。
--link=[]: 添加链接到另一个容器。
--volume , -v: 绑定一个卷。
--rm: shell 退出的时候自动删除容器。
--restart: 自动重启。

样例: docker run --name mynginx -d nginx:latest

docker ps

功能: 列出容器
语法: docker ps [OPTIONS]
关键参数:

- -a: 显示所有容器
- -f: 根据条件过滤
- --format: 指定返回值的模板文件
- -l: 显示最新的容器
- -n: 列出最近创建的 n 个容器
- --no-trunc: 不截断输出
- -q: 只显示容器编号
- -s: 显示总的文件大小

样例: docker ps -a

docker logs

功能: 查看容器日志
语法: docker logs [OPTIONS] CONTAINER
关键参数:

- -f: 跟踪日志输出
- --since: 显示某个开始时间的所有日志
- -t: 显示时间戳
- -n: 仅列出最新 N 条容器日志

样例: docker logs -f mynginx

docker exec

功能: 在容器中执行命令
语法: docker exec [OPTIONS] CONTAINER COMMAND [ARG...]
关键参数:

- -d: 分离模式
- -i: 保持 STDIN 打开
- -t: 分配一个伪终端
- -e: 设置环境变量
- -u: 指定用户
- -w: 指定工作目录

样例: docker exec -it mynginx bash

docker start

功能: 启动停止的容器
语法: docker start [OPTIONS] CONTAINER [CONTAINER...]
样例: docker start mynginx

docker stop

功能: 停止运行的容器
语法: docker stop [OPTIONS] CONTAINER [CONTAINER...]
关键参数:

- -s: 发送的信号

样例: docker stop mynginx

docker restart

功能: 重启容器
语法: docker restart [OPTIONS] CONTAINER [CONTAINER...]
关键参数:

- -s: 发送信号

样例: docker restart mynginx

docker kill

功能: 强制退出容器
语法: docker kill [OPTIONS] CONTAINER [CONTAINER...]
关键参数:

- -s: 发送的信号

注意事项: docker stop 发送的是 SIGTERM 信号，docker kill 发送的是 SIGKILL 信号
样例: docker kill mynginx

docker top

功能: 查看容器中运行的进程信息
语法: docker top CONTAINER [ps OPTIONS]
注意事项: 容器运行时不一定有 /bin/bash 终端来交互执行 top 命令，可以使用 docker top 查看
样例: docker top mynginx

docker stats

功能: 显示容器资源的使用情况
语法: docker stats [OPTIONS] [CONTAINER...]
关键参数:

- --all, -a: 显示所有容器
- --format: 指定返回值的模板文件
- --no-stream: 展示当前状态后退出
- --no-trunc: 不截断输出

返回报文:

- CONTAINER ID 与 NAME: 容器 ID 与名称
- CPU % 与 MEM %: 容器使用的 CPU 和内存的百分比
- MEM USAGE / LIMIT: 容器正在使用的总内存，以及允许使用的内存总量
- NET I/O: 容器通过其网络接口发送和接收的数据量
- BLOCK I/O: 容器从主机上的块设备读取和写入的数据量
- PIDs: 容器创建的进程或线程数

样例: docker stats mynginx

Docker 容器操作笔记

docker container inspect

功能: 查看容器详细信息
语法:

docker container inspect [OPTIONS] CONTAINER [CONTAINER...]

关键参数:

- -f: 指定返回值的模板文件，如 table、json
- -s: 显示总的文件大小

注意事项:

- docker inspect 会自动检查是镜像还是容器，然后显示相关信息

样例:

docker container inspect mynginx

docker port

功能: 用于列出指定的容器的端口映射，或者查找将 PRIVATE_PORT NAT 到面向公众的端口
语法:

docker port CONTAINER [PRIVATE_PORT[/PROTO]]

样例:

docker port mynginx

docker cp

功能: 在容器和宿主机之间拷贝文件
语法:

docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH

别名:

docker container cp

样例:

源文件-->目的地

# 将主机/www/目录拷贝到容器 mynginx 的/www 目录下
docker cp /www/ mynginx:/www/
# 将容器/www/目录拷贝到主机的/wwwbak 目录下
docker cp mynginx:/www/ /wwwbak/

docker diff

功能: 检查容器里文件结构的更改
语法:

docker diff CONTAINER

样例:

docker diff mynginx

docker commit

功能: 从容器创建一个新的镜像
语法:

docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

参数:

- -a: 提交的镜像作者
- -c: 使用 Dockerfile 指令来创建镜像；可以修改启动指令
- -m: 提交时的说明文字
- -p: 在 commit 时，将容器暂停

样例:

docker commit c3f279d17e0a maxhou/mynginx:v01

docker pause

功能: 暂停容器中所有的进程
语法:

docker pause CONTAINER [CONTAINER...]

样例:

docker pause mynginx

docker unpause

功能: 恢复容器中所有的进程
语法:

docker unpause CONTAINER [CONTAINER...]

样例:

docker unpause mynginx

docker rm

功能: 删除停止的容器
语法:

docker rm [OPTIONS] CONTAINER [CONTAINER...]

别名:

docker container rm

关键参数:

- -f: 通过 SIGKILL 信号强制删除一个运行中的容器

样例:

# 删除 mynginx 容器
docker stop mynginx
docker rm mynginx
# 删除所有停止的容器
docker rm $(docker ps -a -q)

docker export（-->tar）

功能: 导出容器内容为 tar 文件
语法:

docker export [OPTIONS] CONTAINER

别名:

docker container export

关键参数:

- -o: 写入到文件

样例:

# 导出 nginx 为 tar
docker export -o mynginx202203.tar mynginx

docker wait

功能: 阻塞运行直到容器停止，然后打印出它的退出代码
语法:

docker wait CONTAINER [CONTAINER...]

别名:

docker container wait

样例:

docker wait mynginx

docker rename

功能: 重命名容器
语法:

docker rename CONTAINER NEW_NAME

别名:

docker container rename

样例:

docker rename mynginx myweb

docker container prune（删除暂停）

功能: 删除所有停止的容器
语法:

docker container prune [OPTIONS]

关键参数:

- -f, --force: 不提示是否进行确认

样例:

docker container prune

docker update

功能: 更新容器配置
语法:

docker update [OPTIONS] CONTAINER [CONTAINER...]

别名:

docker container update

关键参数:

- --cpus: CPU 数量
- --cpuset-cpus: 使用哪些 CPU
- --memory: 内存限制
- --memory-swap: 交换内存
- --cpu-period: 用来指定容器对 CPU 的使用要在多长时间内做一次重新分配
- --cpu-quota: 用来指定在这个周期内，最多可以有多少时间用来跑这个容器

样例:

# 更新内存
docker update -m 400m myweb

通过以上命令和参数，可以有效地管理和操作 Docker 容器。

容器交互模式

Attach模式

描述：执行docker run命令时不添加-it或-d参数，容器将进入Attach模式。在此模式下，终端会持续阻塞并显示容器日志。
示例：启动nginx容器。

docker run nginx

特点：终端显示容器日志，ctrl + c可终止容器，但会导致容器退出。通常不推荐在开发环境中使用，日志查看可通过docker logs实现。

Detached模式

描述：通过添加-d或--detach参数运行容器，容器将在后台运行，即Detached模式。此模式下，容器不会因终端中断而退出。
示例：以Detached模式启动nginx容器。

docker run -d nginx

特点：容器后台运行，不受终端ctrl + c影响。若需在容器内执行命令，可使用docker exec。

Interactive模式

描述：容器运行后，如需进行复杂操作，可使用docker exec -it ... bash命令组合进入Interactive模式，通过bash终端操作容器。
示例：进入运行中的mynginx容器。

docker exec -it mynginx bash

特点：输入exit退出终端，避免使用ctrl + c以防容器退出。

实验

1. 容器基本操作

通过 nginx 镜像文件创建容器

docker container run nginx

容器的列举（包含正在运行的容器）

docker container ls

停止当前正在运行的容器

docker container stop 4c2

容器的列举（包含正在运行和退出的容器）

docker container ls -a

容器的删除

docker container rm 4c2
docker container ls -a

2. 容器状态迁移

创建容器

docker create --name mynginx1 -p 80:80 nginx:1.22.1

查看容器状态（已创建）

docker ps -a | grep mynginx1

启动容器

docker start mynginx1

查看容器状态（已运行）

docker ps

停止容器

docker stop mynginx1
docker ps -a | grep mynginx1

再次启动容器，然后 kill 容器

docker start mynginx1
docker kill mynginx1
docker ps -a | grep mynginx1

启动容器，然后暂停容器

docker start mynginx1
docker pause mynginx1
docker ps

恢复容器

docker unpause mynginx1
docker ps

重启容器

docker restart mynginx1
docker ps

删除容器

docker stop mynginx1
docker rm mynginx1
docker ps -a | grep mynginx1

容器批量处理技巧

命令	解释
`docker container ls -qf name=xxx`	根据名称过滤得到容器编号
`docker container ls --filter status=running`	根据状态过滤容器信息
`docker container ls -aq`	静默获取全部容器 ID
`docker container ls --filter ancestor=xxx`	过滤镜像名为 xxx 的容器信息
`docker container ls --filter ancestor=xxx`	过滤镜像 ID 为 xxx 的容器信息

-a：表示打印所有的容器信息，包括正在运行和已经退出的
-q：表示只返回容器 ID
-f：表示基于给定的条件过滤，等价于 --filter 选项

标签：容器,container,OOM,mynginx,--,常用命令,CONTAINER,Docker,docker
From： https://blog.csdn.net/2301_80171004/article/details/143752645

[Docker#7] 容器 | OOM | 常用命令 | 交互模式 | 批量处理

什么是容器

生活案例

为什么需要容器？

容器的生命周期

3 种特殊情况

3.1 容器 OOM