Skip to content

v1.2.27

Choose a tag to compare

View all tags
@volc-engine volc-engine released this 07 May 12:19
· 697 commits to master since this release
v1.2.27
835fdc0

Volcengine SDK 凭证体系统升级公告

  1. 新增完整的 CredentialProvider 体系
    覆盖六类典型场景：StaticCredentialProvider（静态 AK/SK/Token）、StsAssumeRoleProvider（STS AssumeRole）、OidcCredentialProvider（AssumeRoleWithOIDC）、SamlCredentialProvider（AssumeRoleWithSAML）、EnvironmentVariableCre
    dentialProvider、CLIConfigCredentialProvider、EcsRoleCredentialProvider。

  2. 引入 DefaultCredentialProvider 默认凭证链
    未显式配置 ak/sk 或 credentialProvider 时，SDK 自动按以下顺序解析：环境变量 → OIDC → CLI 配置文件（~/.volcengine/config.json）→ ECS IMDS。默认开启 reuseLastProviderEnabled，复用上次成功的 Provider，避免重复探测。

  3. EcsRoleCredentialProvider 暂不支持自动探测角色名
    当前版本必须通过构造参数或 VOLCENGINE_ECS_METADATA 环境变量显式指定角色名，后续版本将支持从 IMDS 自动探测，敬请关注版本发布通知。

⚠️ 不兼容变更提醒

  • 未显式传入凭证时，SDK 将自动走默认链解析；如旧逻辑依赖"未配置即报错"行为，升级后可能在 CI/容器环境下静默命中环境变量或 IMDS 凭证，请确认运行环境凭证来源。

升级前请审查凭证来源与默认链顺序，避免上线后凭证解析路径变化。

Assets 2
Loading