关于Ansible gce模块无法配置多SSH密钥至metadata的咨询

我来帮你梳理下这个问题——我之前在配置GCE实例多SSH密钥的时候也踩过类似的坑，咱们一步步拆解：

首先明确核心前提：GCE的ssh-keys元数据字段本质是单个字符串，要求每个密钥占一行，格式为用户名:ssh-rsa 公钥内容 备注。gce模块本身是支持多SSH密钥的，你的问题大概率出在配置格式的细节处理上。

1. 换行符格式部署失败的原因 #

你说用换行符格式时模块不接受，大概率是配置里的字符串转义出了问题。比如如果是用YAML（比如Ansible场景）编写配置，带换行的字符串不能直接硬写换行，需要用YAML的**字面块标记（|）**来保留换行格式，示例如下：

metadata:
  ssh-keys: |
    user1:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ... user1@example.com
    user2:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ... user2@example.com

如果是直接用字符串拼接，要确保换行符是真实的\n而非被转义成字面量的\n——很多配置工具会把未正确标记的换行符转义，导致gce模块收到的是带\n字符串而非真实换行的内容，自然会部署失败。

2. 数组格式只生效第一个的原因 #

GCE元数据的ssh-keys是单值字段，不支持数组类型。当你传入数组时，gce模块会默认只取数组的第一个元素赋值给ssh-keys，后续元素直接被忽略——这不是模块的bug，是完全符合GCE元数据规范的处理逻辑，因为该字段从设计上就不接受数组输入。

正确配置示例（以Ansible gce模块为例） #

- name: 部署带多SSH密钥的GCE实例
  gce:
    instance_names: my-test-instance
    zone: us-central1-a
    machine_type: n1-standard-1
    image: ubuntu-2204-lts
    metadata:
      ssh-keys: |
        alice:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQD... alice@local
        bob:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC... bob@local
    service_account_email: my-sa@my-gcp-project.iam.gserviceaccount.com
    credentials_file: ./gcp-credentials.json
    project_id: my-gcp-project

部署完成后，你可以通过gcloud compute instances describe my-test-instance --zone=us-central1-a命令查看元数据，确认ssh-keys字段是否包含所有密钥行。

总结来说：不是gce模块不支持多SSH密钥，而是你的配置格式不符合GCE元数据的字段要求——换行符格式要正确处理转义，数组格式本身就不符合该字段的类型定义，才会出现后续密钥被忽略的情况。

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