如何通过自定义配置文件一键部署Spinnaker到K8s集群

核心误区 #

你遇到的两个问题本质都是对Halyard配置逻辑的误解：

1. profiles目录下的自定义配置是增量覆盖，而非替代Halyard的核心配置文件（halconfig）；
2. 持久化存储是Spinnaker的全局配置项，必须在halconfig中定义，仅在front50-local.yml中配置无法通过Halyard的前置检查。

问题1：自定义Profiles文件不生效 #

原因 #

Halyard的profiles/*.yml文件是用来微调单个服务的配置（比如Gate的OAuth2设置），但它的生效依赖于Halyard已经通过halconfig完成了基础的部署配置（比如集群、环境、全局存储等）。你直接放置profiles文件但缺少合法的halconfig，Halyard只会复制文件但不会将其纳入部署逻辑。

解决方法 #

先导出你之前通过hal命令配置成功的halconfig作为基础模板：

# 在之前配置成功的环境中执行
hal config export --output ~/.hal/${DEPLOYMENT}/halconfig

将这个halconfig文件和你的profiles目录放在同一个本地目录下，后续挂载到Halyard容器中。

问题2：Persistant storage type is not configured!报错 #

原因 #

Spinnaker的持久化存储是全局配置，Halyard在执行hal deploy apply前会强制检查halconfig中的persistentStorage节点，仅在front50-local.yml中配置S3参数无法满足这个检查要求。

解决方法 #

将S3存储的核心配置写入halconfig文件中，示例：

# 在halconfig的对应位置添加
persistentStorage:
  persistentStoreType: s3
  s3:
    bucket: XXXXXXXXXXXXXX
    rootFolder: front50
    pathStyleAccess: true
    endpoint: https://XXXXXXXXXXXXXX
    accessKeyId: XXXXXXXXXXXXXX
    secretAccessKey: XXXXXXXXXXXXXX

你的front50-local.yml可以保留（如果有front50专属的额外配置），但全局存储类型必须在halconfig中声明。

完整一键部署流程 #

1. 本地准备配置目录
   创建本地目录（比如./spinnaker-hal-config），包含：

   • ./spinnaker-hal-config/${DEPLOYMENT}/halconfig：导出的合法配置文件
   • ./spinnaker-hal-config/${DEPLOYMENT}/profiles/gate-local.yml：你的OAuth2配置
   • ./spinnaker-hal-config/${DEPLOYMENT}/profiles/front50-local.yml（可选）：front50专属配置

2. 启动Halyard容器并挂载配置

docker run -it \
  -v $(pwd)/spinnaker-hal-config:/home/spinnaker/.hal \
  gcr.io/spinnaker-marketplace/halyard:latest

3. 执行部署
   进入容器后直接执行：

hal deploy apply --deployment ${DEPLOYMENT}

验证步骤 #

部署前可以先执行配置验证，提前排查问题：

hal config validate --deployment ${DEPLOYMENT}

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