Docker - 故障排查指南
这阵子开始捣鼓 Docker,遇到过不少问题,下面记录下问题以及解决方案
一、Docker 报 Failed to start Docker Application Container Engine 错误。
问题说明:Docker安装完成后启动,报 Failed to start Docker Application Container Engine 错误,安装教程参考文章末尾的 “附录”
解决方案1:
检查下如下目录是否存在docker.sock文件,/var/run/docker.sock,若存在的话则删除重新启动 docker
解决方案2:
检查 /etc/docker/daemon.json 这个文件是否存在,若存在的话检查文件的 JSON 代码格式,格式不正确的话无法正常启动 docker;若不存在则创建 /etc/docker/daemon.json 并输入以下内容(或者用花括号 "{}" 代替)
{ "storage-driver": "devicemapper" }
解决方案3:
检查方案2所述的文件中是否包含有中文的符号,有的话换成英文符号并重启 docker
解决方案4:
上面几个尝试之后都无法解决问题,只能卸载重装喽
4.1:卸载 docker
$ yum remove docker-*
删除 /lib 和 /run 文件夹下的docker文件夹;再删除所有docker的包,在删除的过程中,建议重启服务器(或者杀掉所有docker进程),期间可能还有docker进程在占用文件夹的情况,导致服务删除失败的问题。(这个非必要操作)
4.2:更新 Linux 内核(笔者就是这个原因导致启动不了),这个可能需要消耗不少时间,耐心等待吧
$ yum update
4.3:参考附录的内容重新安装 docker
4.4:启动 docker 后,输入指令检查 docker 运行状态
$ systemctl status docker #查看docker运行状态
$ docker info #查看容器信息
运行中的 docker 如下图所示:
二、登录私有镜像的时候提示权限不足
解决方案:由于笔者使用其他账号组进行操作,前后检查了登录的账号密码,确保没问题后检查下权限,由于笔者这个用户没有权限执行 docker.sock 文件,把当前的用户添加到对应的用户组即可
$ gpasswd -a XXX XXX
三、Jenkins 执行 docker build 打包镜像的时候报错
分析:这个或许有多个原因,可能是执行 build 的命令出错了,也可能是上下文关系没对应好,也可能是 Dockerfile 文件编写有问题
解决方案1:检查 build 命令语法有没有错误
解决方案2:检查 build 命令后面对应的目录结构是否正确
解决方案3:检查 build 打包项目的 Dockerfile 文件是否存在一些语法错误
附录:
Docker 安装简易教程:(以 centos 安装 docker ce 社区版本为例)
//先安装一些依赖的驱动和配置yum $ yum install -y yum-utils \ device-mapper-persistent-data \ lvm2 $ yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo //安装docker $ yum install docker-ce docker-ce-cli containerd.io //启动docker $ systemctl start docker //测试下是否安装成功, 这里运行一个hello-world镜像,正常的话会输出 Hello from Docker! $ docker run hello-world
docker 常用命令:
$ systemctl status docker #检查docker的状态 $ systemctl start docker #启动docker $ systemctl stop docker #关闭docker $ systemctl restart docker #重启docker $ docker run --rm -it XXXX bash #启动一个XXXX容器,并以bash方式运行,XXXX是镜像ID(通过docker image ls查看) $ docker image ls #列出当前所有的镜像
$ docker image prune #清除没用的镜像,按y确认删除