Spring Cloud ACM SDK 的使用步骤

  1. 增加 Maven 依赖。
    <dependency>
         <groupId>com.alibaba.cloud</groupId>
         <artifactId>spring-cloud-starter-acm</artifactId>
         <version>1.0.7</version>
     </dependency>
    
  2. 配置应用名和应用组。

    在 Spring Boot 应用中编辑 application.properties 文件,配置 spring.application.groupspring.application.name

    spring.application.group=com.alibaba.cloud.acm
    spring.application.name=sample-app
  3. 配置 ACM 环境和认证信息。

    在 Spring Boot 应用中编辑 application.properties 文件,配置 alibaba.acm.endpointalibaba.acm.namespacealibaba.acm.accessKeyalibaba.acm.secretKey

    spring.application.group=com.alibaba.cloud.acm
    spring.application.name=sample-app
    alibaba.acm.endpoint=xxx
    
    # 命名空间 ID
    alibaba.acm.namespace=xxx
    
    # 通过 ECS 实例 RAM 角色访问 ACM
    # alibaba.acm.ramRoleName=xxx
    
    alibaba.acm.accessKey=xxx
    alibaba.acm.secretKey=xxx
    
    # 如果是加密配置,则添加下面两行进行自动解密
    # alibaba.acm.openKMSFilter=true
    # regionId 可以通过命名空间详情中的区域 ID 获取
    # alibaba.acm.regionId=xxx
    
    # 如果 Group 不是 DEFAULT_GROUP,则需设置 alibaba.acm.group
    # alibaba.acm.group=xxx
  4. 在 ACM 控制台添加应用配置。

    前往 ACM 控制台,在相应的空间(namespace)下新建配置。

    • Data ID 按照以下约定格式编写:

      ${spring.application.group}:${spring.application.name}.properties

      例如:com.alibaba.cloud.acm:sample-app.properties

    • 配置格式选择 TEXT,配置内容即为想要注入到应用中的具体 key-value:

      user.id = 001
      user.name = juven2
      user.age = 88

备注

  • spring-cloud-starter-acm 1.0.7 及更高版本已支持 Spring Boot 2.x
  • 推荐使用 2.0.1.RELEASE 及更高版本的 Spring Boot 2.x2.0.0.RELEASE 版本有读取旧数据的 Bug
  • 如需下载完整示例代码,请单击:spring-cloud-acm-sample.zip

相关文档