如何配置Knative Serving使用本地Docker镜像？解决镜像拉取失败问题

问题原因分析 #

Kubernetes Deployment能直接用hello:latest是因为它允许省略默认仓库前缀，但Knative Serving对镜像名格式要求更严格——哪怕设置了imagePullPolicy: Never，它仍会尝试解析镜像的仓库归属，无前缀的镜像名会被默认当作远程仓库镜像处理，最终导致拉取失败。

解决方法 #

1. 官方本地镜像（如hello、nginx）

给镜像名添加docker.io/library/前缀，这是Docker官方镜像的默认仓库路径。修改后的Knative Service配置示例：

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: hello
spec:
  template:
    spec:
      containers:
        - image: docker.io/library/hello:latest
          imagePullPolicy: Never

2. 自定义本地镜像

如果是自行构建的镜像，有两种处理方式：

• 方式一：借助本地Docker Registry
  1. 启动本地Registry容器：

     docker run -d -p 5000:5000 --name registry registry:2
     

  2. 给本地镜像打标签并推送到本地Registry：

     docker tag your-image:latest localhost:5000/your-image:latest
     docker push localhost:5000/your-image:latest
     

  3. Knative Service配置中使用带localhost:5000/前缀的镜像名：

     apiVersion: serving.knative.dev/v1
     kind: Service
     metadata:
       name: your-service
     spec:
       template:
         spec:
           containers:
             - image: localhost:5000/your-image:latest
               imagePullPolicy: IfNotPresent
     

• 方式二：直接使用本地镜像（无需Registry）
  确保所有Knative节点上都存在该镜像，给镜像名添加localhost/前缀（多数Kubernetes环境支持），同时搭配imagePullPolicy: Never：

  apiVersion: serving.knative.dev/v1
  kind: Service
  metadata:
    name: your-service
  spec:
    template:
      spec:
        containers:
          - image: localhost/your-image:latest
            imagePullPolicy: Never
  

针对你的错误修复 #

把hello:latest替换为docker.io/library/hello:latest，保留imagePullPolicy: Never，Knative就能正确识别并使用本地的hello镜像。

内容的提问来源于stack exchange，提问作者Vinay Cheguri