如何从Cloud Run服务/作业内部获取自身名称与修订版本信息

Cloud Run 平台会在容器启动时自动注入当前运行实例的核心元数据到内置环境变量，无需额外调用接口、无需配置额外权限，直接读取环境变量填充配置是最优实现方案。

可用的内置环境变量 #

Cloud Run 服务、Cloud Run 作业两类运行环境都会自动注入以下环境变量：

• K_SERVICE：当前运行的Cloud Run服务/作业的名称
• K_REVISION：当前运行实例对应的修订版本唯一标识

实现代码 #

初始化Error Reporting客户端时直接读取环境变量填充serviceContext，同时增加本地开发场景的兜底逻辑：

const error_reporting = new ErrorReporting({
  logLevel: 2,
  reportMode: 'production',
  serviceContext: {
    service: process.env.K_SERVICE || 'local-dev',
    version: process.env.K_REVISION || 'local'
  }
})

原有手动构造错误事件、附加用户标识等上下文的逻辑不需要做任何修改：

const reportErrorAndExit = (err) => {
  const event = error_reporting.event()
  event.setMessage(err.message)
  event.setUser('the service account used by this Cloud Run service/job')

  error_reporting.report(event, () => {
    // 非0退出码标记Cloud Run作业任务执行失败
    process.exit(1)
  })
}

方案优势 #

• 零额外依赖：不需要引入额外SDK、不需要发起网络请求读取元数据服务
• 零权限成本：不需要为Cloud Run绑定的服务账号分配任何额外IAM权限
• 自动适配部署：每次发布新修订版本时会自动读取到准确的版本标识，无需在代码中硬编码版本号
• 全场景兼容：同一套代码同时适配Cloud Run服务、Cloud Run作业两类运行环境

补充说明 #

Error Reporting Node.js客户端为跨场景通用SDK，默认不会主动读取Cloud Run专属环境变量，因此未手动配置serviceContext时，上报的错误会显示通用的默认服务标识node，无法区分错误来源。配置完成后，错误事件会展示服务名:版本号格式的服务标识，和手动硬编码配置的效果完全一致。

注意：本地开发、本地调试场景下不存在Cloud Run注入的内置环境变量，必须配置兜底的service、version值，否则会导致上报的错误事件服务标识为空。

未配置serviceContext时的错误事件展示效果：

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