Google Cloud Compute VM实例设置Metadata未在Cloud Console显示问题咨询

查看Google Cloud API请求记录 #

• 打开Google Cloud Console进入对应项目
• 导航至「API和服务」→「仪表盘」，选择进入「云审计日志」页面
• 在日志过滤器中筛选服务为Compute Engine API，方法为compute.instances.insert，即可看到你发起的实例创建请求完整Payload，可直接校验你提交的Metadata字段是否正常上报

Metadata设置失效原因与修复方案 #

你当前的代码存在三处核心问题：

1. 同时指定实例模板与自定义实例属性时，没有显式声明覆盖模板配置，默认会优先使用实例模板中的属性，覆盖你单独设置的Metadata
2. Metadata构造方式不符合Java Compute Client的接口要求，键值对需要封装为Metadata.Items对象存入列表
3. 实例创建接口要求传入可用区（Zone）参数，你错误传入了区域（Region）参数，会导致实例属性解析异常

修复后的可运行代码如下：

Instance instance = new Instance();
log.debug(gsi.getInstanceId()+" is being created");
instance.setName(gsi.getInstanceId());
// 机器类型参数需要带上可用区路径
instance.setMachineType(String.format("zones/%s/machineTypes/%s", ZONE, MACHINE_TYPE));

// 正确构造Metadata对象
Metadata metaData = new Metadata();
List<Metadata.Items> items = new ArrayList<>();
items.add(new Metadata.Items().setKey("gslt").setValue(gsi.getGameServerLoginToken()));
items.add(new Metadata.Items().setKey("rcon").setValue(gsi.getRcon()));
metaData.setItems(items);
instance.setMetadata(metaData);

try {
    Compute.Instances.Insert insert = compute
            .instances()
            .insert(PROJECT_ID, ZONE, instance) // 此处传入可用区参数，不是区域参数
            .setSourceInstanceTemplate(INSTANCE_TEMPLATE)
            // 显式声明覆盖实例模板的配置，使自定义Metadata、机器类型生效
            .setOverrideSourceInstanceTemplate(true);
    Operation op = insert.execute();

    var context = this;
    Thread thread = new Thread(() -> {
        try {
            blockUntilComplete(compute,op,300*1000);
            instanceEventPublisher.publishInstanceCreatedEvent(context, instance.getName());
        } catch (Exception e) {
            e.printStackTrace();
        }
    });
    thread.start();
} catch (IOException e) {
    e.printStackTrace();
} catch (Exception e) {
    e.printStackTrace();
    e.getLocalizedMessage();
}

额外校验建议 #

• 确认你使用的服务账号拥有compute.instances.setMetadata权限，权限不足会导致Metadata静默设置失败
• 实例创建完成后可直接调用compute.instances.get()接口拉取实例详情，确认Metadata是否写入，可排除Cloud Console展示延迟的干扰

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