Spring Cloud 使用 SOFARegistry

前置条件

在进行开发前，首先需要完成本地 Maven settings 中对 JAR 包仓库的配置，工程才可以通过 Maven 获取仓库里注册中心的 JAR 包。配置说明如下：

• 配置路径：

  • Windows 系统：C:\Users\userName_XXX\.m2\settings.xml

  • Mac or Linux 系统：/Users/userName_XXX/.m2/settings.xml

    重要

    Linux 和 Mac OS 系统上，.m2 目录可能被隐藏。Mac OS 可以通过 Command + Shift + . 进行查看；Linux 可以通过 Ctrl + H 进行查看。

• 配置内容：

  1. 配置 mvn.cloud.alipay.com 仓库的地址及用户名密码。

     配置示例如下：

     <servers>
         <server>
             <id>nexus-server@public</id>
             <username>${username}</username>
             <password>${password}</password>
         </server>
         <server>
             <id>nexus-server@public-snapshots</id>
             <username>${username}</username>
             <password>${password}</password>
         </server>
         <server>
             <id>mirror-all</id>
             <username>${username}</username>
             <password>${password}</password>
         </server>
     </servers>

  2. 更新开发环境 mirror 配置（可选，本地不能正常下载 JAR 包时进行配置）。

     如果本地 maven settings.xml（默认路径~/.m2/settings.xml ）配置 mirror 为* , 需要排除alipay-cloud-server@public 仓库托管，示例如下：

     <mirror>
         <id>nexus-aliyun</id>
         <!-- <mirrorOf>*</mirrorOf> -->
        <mirrorOf>*,!alipay-cloud-server@public</mirrorOf>
         <name>Nexus aliyun</name>
         <url>http://maven.aliyun.com/nexus/content/groups/public</url>
     </mirror>

     mirrorOf 的配置 * 改成 *,!alipay-cloud-server@public, 代表不需要托管仓库 alipay-cloud-server@public 。

操作步骤

1. 在本地开发应用。

   1. 添加仓库地址。

      为保证 SDK 和对应 tracer 包能下载到，请在项目根 pom.xml 添加仓库地址：

      <repositories>
        <repository>
          <id>alipay-cloud-server@public</id>
          <url>http://mvn.cloud.alipay.com/nexus/content/groups/open</url>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>

   2. 在工程根目录下的 pom.xml 中，引入 sofa-registry-cloud-all SDK 依赖。

      版本信息，请参见 SDK 版本说明。

      <dependency>
          <groupId>com.alipay.sofa</groupId>
          <artifactId>sofa-registry-cloud-all</artifactId>
          <!-- 替换 x.x.x 为该 SDK 最新版本号 -->
          <version>x.x.x</version>
      </dependency>

      说明

      sofa-registry-cloud-all SDK 1.2.8 版本同时兼容 Spring Boot 1.x 和 Spring Boot 2.x。

   3. 根据您的 Spring Cloud 版本信息，引入对应的 Tracer 依赖。

      • Camden、Dalston 和 Edgware 版本（对应 Spring Boot 1.x 版本）

        <!-- 支持服务调用tracer日志记录能力 -->
        <!-- for Spring Boot 1.X -->
        <dependency>
        <groupId>com.alipay.sofa</groupId>
        <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
        <version>2.3.7.JST.1</version>
        <exclusions>
        <exclusion>
        <groupId>com.alipay.sofa.common</groupId>
        <artifactId>sofa-common-tools</artifactId>
        </exclusion>
        <exclusion>
        <groupId>com.alipay.sofa</groupId>
        <artifactId>tracer-enterprise-dst-plugin</artifactId>
        </exclusion>
        </exclusions>
        </dependency>
        <dependency>
        <groupId>com.alipay.sofa.common</groupId>
        <artifactId>sofa-common-tools</artifactId>
        <version>1.0.17</version>
        </dependency>

      • Finchley、Greenwich 版本（对应 Spring Boot 2.x 版本）

        <!-- 接入tracer -->
        <!-- for Spring Boot 2.X -->
        <dependency>
        <groupId>com.alipay.sofa</groupId>
        <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
        <version>3.2.3.JST.1</version>
        <exclusions>
        <exclusion>
        <groupId>com.alipay.sofa.common</groupId>
        <artifactId>sofa-common-tools</artifactId>
        </exclusion>
        <exclusion>
        <groupId>com.alipay.sofa</groupId>
        <artifactId>tracer-enterprise-dst-plugin</artifactId>
        </exclusion>
        </exclusions>
        </dependency>
        <dependency>
        <groupId>com.alipay.sofa.common</groupId>
        <artifactId>sofa-common-tools</artifactId>
        <version>1.0.17</version>
        </dependency>

   4. 通过以下任一方式，添加应用启动参数。

      重要

      如您即将使用的应用服务发布平台不是 SOFAStack 自提供的容器应用服务或经典应用服务，则无需添加以下参数配置。

      • 在应用 yml 文件中指定参数：

        sofa:
          registry:
            discovery:
                instanceId:          //当前登录账号的实例 ID。
                antcloudVip:       //当前地域的 ACVIP 地址值。
                accessKey:           //当前登录账号的 AccessKey ID。
                secretKey:           //当前登录账号的 AccessKey Secret。

      • 指定 JVM 启动参数值：

        -Dcom.alipay.instanceid=                  //当前登录账号的实例 ID。
        -Dcom.antcloud.antvip.endpoint=    //当前地域的 ACVIP 地址值。
        -Dcom.antcloud.mw.access=             //当前登录账号的 AccessKey ID。
        -Dcom.antcloud.mw.secret=             //当前登录账号的 AccessKey Secret。

      • 指定系统环境变量：

        SOFA_INSTANCE_ID=                    //当前登录账号的实例 ID。
        SOFA_ANTVIP_ENDPOINT=          //当前地域的 ACVIP 地址值。
        SOFA_ACCESS_KEY=                      //当前登录账号的 AccessKey ID。
        SOFA_SECRET_KEY=                     //当前登录账号的 AccessKey Secret。

      说明

      以上参数值是中间件的全局配置项，可在 脚手架控制台 获取。详情请参见 引入 SOFA 中间件。

   5. 编写业务代码。

2. 发布应用。

   1. 登录 SOFAStack 控制台。

   2. 在左侧导航栏选择 运维管理 > 经典应用服务 > 应用发布 > 发布单，然后创建并执行发布单。

      具体操作，请参见 新建并执行发布单。应用发布后，您可以在左侧导航栏选择 中间件 > 微服务平台 > 微服务 > 服务管控，然后在 服务管控 页面查看发布的服务。

   说明

   如您需要在其他发布平台（非 SOFAStack 容器应用服务或经典应用服务）发布部署应用，请参考对应发布平台的帮助文档。

查看日志

您可以在 /home/admin/logs/registry 中查看注册中心的日志。