关于Skaffold使用skaffold.env传递Docker build-args的疑问

1. 关于skaffold.env功能的理解偏差 #

你的理解有误：Skaffold不会自动加载同目录下的skaffold.env文件。和docker-compose默认读取.env的机制不同，Skaffold默认只会读取当前系统的环境变量，不会主动识别命名为skaffold.env的文件——除非你明确配置让它加载。这是很多开发者容易踩的坑。

2. 正确通过skaffold.env传递变量给Docker build-args的方法 #

有三种可靠的实现方式，任选其一即可：

方式一：在skaffold.yaml中全局配置加载env文件 #

直接在配置文件的根节点添加env字段，指定要加载的skaffold.env路径，这样整个配置里的变量引用都会读取该文件：

apiVersion: skaffold/v4beta6
kind: Config
metadata:
  name: your-service
env:
  - file: ./skaffold.env  # 指定环境文件路径
build:
  artifacts:
    - image: your-target-image
      docker:
        dockerfile: Dockerfile
        buildArgs:
          DEPLOY_TOKEN: ${DEPLOY_TOKEN}
          DEPLOY_SECRET: ${DEPLOY_SECRET}

方式二：启动Skaffold时通过命令行参数指定env文件 #

不需要修改配置文件，启动时显式传入环境文件路径：

skaffold dev --env-file=./skaffold.env

方式三：结合Skaffold Profiles加载env文件 #

如果有多套环境配置（比如dev/prod），可以在profile里单独指定env文件：

apiVersion: skaffold/v4beta6
kind: Config
metadata:
  name: your-service
build:
  artifacts:
    - image: your-target-image
      docker:
        dockerfile: Dockerfile
        buildArgs:
          DEPLOY_TOKEN: ${DEPLOY_TOKEN}
          DEPLOY_SECRET: ${DEPLOY_SECRET}
profiles:
  - name: dev
    env:
      - file: ./skaffold.env  # 仅dev profile加载该文件

额外注意事项 #

• 确保skaffold.env的格式正确：变量名和值之间无多余空格，比如DEPLOY_TOKEN=abc123而非DEPLOY_TOKEN = abc123；
• 系统环境变量的优先级高于env文件中的变量，如果之前手动export过变量，需要先取消export（比如unset DEPLOY_TOKEN）才能让env文件的变量生效；
• 验证配置是否生效，可以用skaffold build --dry-run查看解析后的build args是否正确。

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