minikube本地运行K8s时构建Docker镜像报DNS lookup error如何解决

错误根因说明 #

该错误通常出现在RUN apk update、RUN pip install等需要拉取外部资源的步骤，是minikube节点/内置容器运行时的DNS配置异常，无法解析公网域名导致。

排查步骤 #

• 先验证宿主网络DNS是否正常：在宿主机器执行nslookup alpinelinux.org，如果能正常返回IP，说明问题出在minikube内部
• 验证minikube节点DNS配置：执行minikube ssh进入minikube节点，执行cat /etc/resolv.conf查看DNS地址，再执行nslookup alpinelinux.org，如果返回解析失败即可确认是minikube节点DNS配置错误

解决方法 #

方案1：构建时临时指定DNS（最快生效） #

执行构建命令时手动指定公共DNS即可：
如果你是通过minikube docker-env调用内置Docker构建：

eval $(minikube docker-env)
docker build --dns 8.8.8.8 --dns 114.114.114.114 -t <你的镜像名> .

如果你使用minikube image build直接构建：

minikube image build --dns 8.8.8.8 -t <你的镜像名> .

方案2：永久修改minikube默认DNS #

适合经常构建镜像的场景，启动minikube时指定DNS参数即可永久生效：

minikube stop
minikube start --dns 8.8.8.8 --dns 114.114.114.114

启动完成后进入minikube节点查看/etc/resolv.conf即可确认配置生效。

方案3：替换软件源为国内镜像（国内用户优先推荐） #

如果是国内网络环境，直接修改Dockerfile替换公网源为国内镜像，从根源避免解析国外域名失败：
在RUN apk update步骤前新增替换alpine源的命令，pip安装时指定国内PyPI源即可：

FROM python:3.7-alpine

LABEL maintainer="r.ofc@hotmail.com"

# 新增：替换为阿里云alpine源
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories

ENV PROJECT_ROOT /app
WORKDIR $PROJECT_ROOT

RUN apk update \
    && apk add mariadb-dev \
        gcc\
        python3-dev \
        pango-dev \
        cairo-dev \
        libtool \
        linux-headers \
        musl-dev \
        libffi-dev \
        openssl-dev \
        jpeg-dev \
        zlib-dev
# 替换为清华PyPI源
RUN pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
COPY . .

CMD python manage.py runserver 0.0.0.0:8000

方案4：重置minikube环境 #

如果以上方法都无效，大概率是minikube的网络插件配置冲突，重置即可解决：

minikube delete
minikube start

内容的提问来源于stack exchange，提问作者Romulo Ferreira Mesquita