操作步驟

1. 在本地應用工程的pom.xml文件中，添加toolkit-maven-plugin插件的依賴。

   <build>
       <plugins>
           <plugin>
               <groupId>com.alibaba.cloud</groupId>
               <artifactId>toolkit-maven-plugin</artifactId>
               <version>1.1.5</version>
           </plugin>
       </plugins>
   </build>                      

   說明

   version的值建議設置為1.1.5，最新版本可能存在不適用情況。

2. 在工程的根目錄下，創建配置文件.edas_config.yaml，在文件中配置部署參數。

   • 以.開頭的文件為IDE的默認配置文件。在未指定其它配置文件時，插件會默認使用根目錄下的.edas_config.yaml文件。

   • 如果創建了非.開頭的配置文件，也可以在打包工程時，通過設置參數-Dedas_config=xxx來指定該配置文件。

   • 如果存在默認配置文件，也通過參數指定了其它配置文件，那么插件會使用參數指定的配置文件。

   說明

   如果當前工程為一個Maven工程的子模塊，那么默認配置文件應該存放在當前工程目錄下，而不是整個Maven工程的根目錄下。關于多模塊工程部署更多方式，請參見部署多模塊工程。

   典型升級場景的配置示例如下：

   • 升級應用所有分組。

     例如，在華北2（北京）地域有一個ID為eb20****-e6ee-4f6d-a36f-5f6a5455****的應用，需要升級該應用的所有分組。配置示例如下：

     env:
          region_id: cn-beijing
     app:
          app_id: eb20****-e6ee-4f6d-a36f-5f6a5455****                        

     配置參數的值請以應用相關的實際信息為準。

   • 升級應用指定分組并標識部署包版本。

     例如，在華北2（北京）地域有一個ID為eb20dc8a-e6ee-4f6d-a36f-5f6a545****的應用，需要升級的應用分組ID為06923bb9-8c5f-4508-94d8-517b692f****，部署包版本為1.2。配置示例如下：

     env:
       region_id: cn-beijing
     app:
       app_id: eb20dc8a-e6ee-4f6d-a36f-5f6a5455****
       package_version: 1.2
       group_id: 06923bb9-8c5f-4508-94d8-517b692f****            

   實際使用時，可能會有更復雜的場景，需要配置更多參數，請參見部署應用配置參數說明。

3. 在本地新建一個YAML賬號文件，在文件中配置AccessKey ID和AccessKey Secret。

   推薦使用RAM用戶（需已授予應用管理權限）的AccessKey ID和AccessKey Secret，以便控制應用權限來提高應用的安全性。RAM用戶的AccessKey ID和AccessKey Secret可以在阿里云AccessKey管理頁面查看。

   賬號文件示例如下：

   access_key_id:yourAccessKeyId
   access_key_secret:yourAccessKeySecret

   說明

   代碼中的yourAccessKeyId和yourAccessKeySecret請替換成您實際的AccessKey ID和AccessKey Secret。該配置中AccessKey ID和AccessKey Secret只會用來生成請求簽名，不用于網絡傳輸等其他用途。

4. 在本地工程目錄（如果為Maven多模塊則進入子模塊目錄），執行以下命令，將應用打包并部署到EDAS。

   mvn clean package toolkit:deploy -Daccess_key_file={賬號文件路徑}                        

   命令參數說明：

   • toolkit:deploy： 使用toolkit-maven-plugin插件部署應用的參數。只有添加此參數，才會在應用打包成功后進行部署。

   • access_key_file：賬號文件路徑參數。

     說明

     更多指定密鑰對的方式，請參見賬號配置及賬號優先級說明。

   • -Djar_path：通過設置該參數指定部署包文件路徑，跳過打包步驟而直接使用已有的部署包進行部署。部署包路徑支持絕對路徑和相對路徑。

     mvn toolkit:deploy -Daccess_key_file={賬號文件路徑} -Djar_path=target/demo.jar                        

     重要

     您還可以在env中配置賬號文件路徑，請參見部署應用配置參數說明，上述-D方式優先級大于env中的配置。

結果驗證

1. 執行應用打包、部署命令后，在IDE的Terminal中查看輸出日志。

   • 顯示以下信息，并提示BUILD SUCCESS，表示應用部署成功。

   • 如果輸出日志中包含ERROR相關信息，請根據日志排查失敗原因。解決后再重新部署。

2. 登錄EDAS控制臺，查看變更記錄和應用詳情，檢查應用是否升級（部署）成功。更多操作，請參見結果驗證。

專有云支持

toolkit-maven-plugin插件可以在專有云企業版V3.8.0及以上版本使用，在使用前需要在插件中配置EDAS Endpoint。相關配置，請參見部署應用配置參數說明。請聯系EDAS技術支持獲取Endpoint。

問題反饋

如果您在使用工具部署應用的過程中有任何疑問，請加入釘群（釘群號：34556175）聯系產品技術專家咨詢處理。