Docker入门教程执行build命令时出现mkdocs build报错如何解决

你当前使用的docker build -t docker101tutorial命令缺少构建上下文参数，正确命令需要在末尾添加.表示使用当前目录作为构建上下文，完整命令为：

docker build -t docker101tutorial .

如果补全参数后仍报错，可按以下常见场景依次排查： #

常见报错原因及解决方法 #

• 依赖缺失
  mkdocs运行需要对应主题、插件依赖，若Dockerfile中未完整安装会导致构建失败。需修改Dockerfile中依赖安装步骤，补全所有需要的包，示例配置：

  RUN pip install --no-cache-dir mkdocs mkdocs-material mkdocs-git-revision-date-localized-plugin
  

  可根据你实际使用的mkdocs配置调整依赖列表。
• 构建上下文文件缺失
  执行构建命令的目录下必须存在mkdocs.yml配置文件和存放文档的docs文件夹，且需要和Dockerfile中指定的WORKDIR路径匹配。若文件放置在其他目录，需切换到对应目录执行构建命令，或调整上下文路径参数。
• 配置文件语法错误
  先在宿主机本地安装mkdocs环境，执行mkdocs build命令验证配置是否正常，若本地运行也报错，先修复mkdocs.yml的语法错误、不存在的插件/主题配置问题后再进行Docker构建。
• 容器网络不通
  若mkdocs构建过程需要拉取外部资源，容器内部网络受限会导致构建失败，可添加网络参数尝试解决：

  docker build --network=host -t docker101tutorial .
  

内容的提问来源于stack exchange，提问作者Vasko LoL