通过开源镜像站获取MRS样例工程

构建流程

样例工程构建流程包括三个主要步骤：

1. 下载样例工程的Maven工程源码和配置文件，请参见样例工程获取地址。
2. 配置华为镜像站中SDK的Maven镜像仓库，请参见华为开源镜像配置方式。
3. 根据用户自身需求，构建完整的Maven工程。

样例工程获取地址

MRS服务3.1.2-LTS.3版本的样例工程Git下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-3.1.2。

MRS服务3.2.0-LTS.1版本的样例工程Git下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-3.2.0.1。

MRS服务3.3.0-LTS版本的样例工程Git下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-3.3.0。

图1 样例代码下载

切换分支为与MRS集群相匹配的版本分支，例如“mrs-3.2.0.1”，然后下载压缩包到本地后解压，即可获取各组件对应的样例代码工程。

MRS服务普通版本获取样例工程请参考通过开源镜像站获取样例工程。

华为开源镜像配置方式

华为提供开源镜像站（网址为https://mirrors.huaweicloud.com/），各服务样例工程依赖的jar包都可在华为开源镜像站下载，剩余所依赖的开源jar包请直接从Maven中央库或者其他用户自定义的仓库地址下载。

本地环境使用开发工具下载依赖的jar包前，需要确认以下信息。

• 确认本地环境网络正常。

  打开浏览器访问：华为提供开源镜像站（https://mirrors.huaweicloud.com/repository/maven/huaweicloudsdk/），查看网站是否能正常访问。如果访问异常，请先开通本地网络。

• 确认当前开发工具是否开启代理。下载jar包前需要确保开发工具代理关闭。

  比如以2020.2版本的IntelliJ IDEA开发工具为例，单击“File > Settings > Appearance & Behavior > System Settings > HTTP Proxy”，选择“No proxy”，单击“OK”保存配置。

开源镜像配置方式如下所示：

1. 使用前请确保您已安装JDK 1.8及以上版本和Maven 3.0及以上版本。
2. 单击此处，下载华为开源镜像站提供的“settings.xml”文件，覆盖至“<本地Maven安装目录>/conf/settings.xml”文件即可。

   若无法直接下载，在华为开源镜像站（https://mirrors.huaweicloud.com/）搜索并单击名称为“HuaweiCloud SDK”的版块，按照页面弹出的设置方法进行操作。

3. 如果不想覆盖Maven配置文件，也可以参考以下方法手动修改“settings.xml”配置文件或者组件样例工程中的“pom.xml”文件，配置镜像仓地址。
   • 配置方法一：

     手动在“settings.xml”配置文件的“mirrors”节点中添加以下开源镜像仓地址：

     <mirror>
         <id>repo2</id>
         <mirrorOf>central</mirrorOf>
         <url>https://repo1.maven.org/maven2/</url>
     </mirror>

     在“settings.xml”配置文件的“profiles”节点中添加以下镜像仓地址：

     <profile>
         <id>huaweicloudsdk</id>
         <repositories>
             <repository>
                 <id>huaweicloudsdk</id>
                 <url>https://repo.huaweicloud.com/repository/maven/huaweicloudsdk/</url>
                 <releases><enabled>true</enabled></releases>
                 <snapshots><enabled>true</enabled></snapshots>
             </repository>
         </repositories>
     </profile>

     在“settings.xml”配置文件的“activeProfiles”节点中添加如下profile地址：

     <activeProfile>huaweicloudsdk</activeProfile>

     

     • 华为开源镜像站不提供第三方开源jar包下载，请配置开源镜像后，额外配置第三方Maven镜像仓库地址。
     • 使用IntelliJ IDEA开发工具时，可单击“File > Settings > Build, Execution, Deployment > Build Tools > Maven”查看当前“settings.xml”文件放置目录。

       

   • 配置方法二：

     请直接在二次开发工程样例工程中的“pom.xml”文件添加如下镜像仓地址：

         <repositories>
     
             <repository>
                 <id>huaweicloudsdk</id>
                 <url>https://mirrors.huaweicloud.com/repository/maven/huaweicloudsdk/</url>
                 <releases><enabled>true</enabled></releases>
                 <snapshots><enabled>true</enabled></snapshots>
             </repository>
     
             <repository>
                 <id>central</id>
                 <name>Maven Central</name>
                 <url>https://repo1.maven.org/maven2/</url>
             </repository>
     
         </repositories>

4. 配置Maven默认编码和JDK。在“settings.xml”配置文件的“profiles”节点中添加以下内容：

   <profile>
   <id>JDK1.8</id>
   <activation>
   <activeByDefault>true</activeByDefault>
   <jdk>1.8</jdk>
   </activation>
   <properties>
   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
   <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
   <maven.compiler.source>1.8</maven.compiler.source>
   <maven.compiler.target>1.8</maven.compiler.target>
   <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
   </properties>
   </profile>