您可以使用toolkit-maven-plugin插件分批發布已經部署在EDAS的Spring Cloud、Dubbo和HSF應用。
背景信息
toolkit-maven-plugin是一個開源工具,幫助您構建一個完整的生命周期框架,完成項目的基礎工具建設。更多信息,請參見toolkit-maven-plugin概述。
toolkit-maven-plugin也支持升級EDAS K8s集群中的應用。具體操作,請參見使用Cloud Toolkit插件單批發布應用(K8s)。
操作步驟
在本地應用工程的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>
在工程的根目錄下創建配置文件
.edas_config.yaml
,在文件中配置部署參數。以
.
開頭的文件為IDE的默認配置文件。在未指定其它配置文件時,插件會默認使用根目錄下的.edas_config.yaml
文件。如果創建了其它非以
.
開頭的配置文件,也可以在打包工程時,通過設置參數-Dedas_config=xxx
來指定該配置文件。如果既存在默認配置文件,也通過參數指定了其他配置文件,那么插件會使用參數指定的配置文件。
說明如果當前工程為一個Maven工程的子模塊,那么默認配置文件應該存放在當前工程目錄下,而不是整個Maven工程的根目錄下。關于多模塊工程部署更多方式,請參見部署多模塊工程。
典型升級場景的配置示例如下:
例如在杭州地域有一個ID為
eb20****-e6ee-4f6d-a36f-5f6a5455****
的應用,包含多個應用分組。需要升級其中ID為62fe****-d931-4446-a30a-f396a6da****
的分組,分為2
批發布,每批間的等待時間間隔為2分鐘
,配置示例如下:env: region_id: cn-hangzhou app: app_id: e130****-75d7-471e-9e31-95145701**** group_id: 62fe****-d931-4446-a30a-f396a6da**** batch: 2 batch_wait_time: 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只會用來生成請求簽名,不會用于網絡傳輸等其他用途。在本地工程目錄(如果為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中的配置。
結果驗證
執行應用打包、部署命令后,在IDE的Terminal中查看輸出日志。
顯示以下信息,并提示BUILD SUCCESS,表示應用部署成功。
如果輸出日志中包含ERROR相關信息,請根據日志排查失敗原因。解決后再重新部署。
登錄EDAS控制臺,查看變更記錄和應用詳情,檢查應用是否升級(部署)成功。更多操作,請參見結果驗證。
專有云支持
toolkit-maven-plugin插件可以在專有云曙光V3.8.0及以上版本使用,在使用前需要按照以下步驟在插件中配置EDAS Endpoint。相關配置,請參見部署應用配置參數說明。請聯系EDAS技術支持獲取Endpoint。
問題反饋
如果您在使用工具部署應用的過程中有任何疑問,請加入釘群(釘群號:34556175)聯系產品技術專家咨詢處理。