Ubuntu环境下运行skaffold dev报错求助

问题现象 #

在Ubuntu 20.04系统中使用Skaffold运行应用时，出现报错：

Deployment "auth-deployment" is invalid: spec.template.spec.containers[0].image: Required value

同一项目在MacOS可正常运行，单独执行kubectl apply -f <YAML文件路径>也能正常部署。

相关配置文件 #

部署与服务YAML（./k8s/auth.yaml）

apiVersion: apps/v1
kind: Deployment
metadata:
  name: auth-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: auth
  template:
    metadata:
      labels:
        app: auth
    spec:
      containers:
        - name: auth
          image: smelkonian/auth
---
apiVersion: v1
kind: Service
metadata:
  name: auth-service
spec:
  selector:
    app: auth
  ports:
    - name: auth
      protocol: TCP
      port: 3000
      targetPort: 3000

Skaffold配置文件（skaffold.yaml）

apiVersion: skaffold/v2beta29
kind: Config
deploy:
  kubectl:
    manifests:
      - ./k8s/*
build:
  local:
    push: false
  artifacts:
    - image: smelkonian/auth
      context: auth
      docker:
        dockerfile: Dockerfile
      sync:
        manual:
          - src: 'src/**/*.ts'
            dest: .

解决步骤 #

1. 检查并统一Skaffold版本 #

Mac和Ubuntu上的Skaffold版本可能存在差异，v2beta29属于旧版本，Ubuntu环境下可能存在兼容性问题：

• 查看当前版本：skaffold version
• 升级到稳定版：skaffold update，或从官方渠道重新下载安装最新版

2. 修复Docker权限问题 #

Ubuntu上Docker默认需要root权限，若Skaffold无法正常构建镜像，会导致部署时镜像字段为空：

• 将当前用户加入docker组（无需每次sudo）：

  sudo usermod -aG docker $USER
  

  执行后需重新登录系统生效
• 临时解决方案：运行Skaffold时加sudo：sudo skaffold dev

3. 验证构建上下文与路径 #

Ubuntu文件系统大小写敏感，需确认：

• auth目录存在，且路径大小写与Skaffold配置一致
• auth/Dockerfile文件存在，无拼写错误

4. 强制清理缓存并重新构建 #

缓存可能导致镜像未正常生成，执行以下命令：

skaffold delete
skaffold dev --cache-artifacts=false

5. 验证镜像是否生成 #

执行命令检查本地是否存在目标镜像：

docker images | grep smelkonian/auth

若未找到镜像，说明构建环节失败，需排查Dockerfile或构建上下文问题。

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