使用 toolkit-maven-plugin 部署應用到 EDAS

鏡像下載下傳、域名解析、時間同步請點選

阿裡巴巴開源鏡像站

Cloud Toolkit 支援使用 Maven 部署應用到 EDAS，優化了傳統部署方式（先将應用打包成 WAR 包或 JAR 包再到控制台部署應用），使用指令行即可快速部署。本文将以部署應用到 EDAS 的 ECS 叢集為例介紹如何使用 toolkit-maven-plugin。

一、前提條件

• 已下載下傳并安裝 Maven 。
• 已在 EDAS 控制台 上建立應用并完成首次部署。
  • 在 ECS 叢集中建立應用請參見 在 ECS 叢集中部署 Java Web 應用
  • 在容器服務 K8S 叢集中建立應用請參見 在容器服務 K8s 叢集中部署應用（鏡像）

二、自動化部署應用

1、在您的打包工程的 pom.xml 檔案中增加如下的插件依賴。

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

說明： 您還可以從 Maven 官方中央倉庫 中擷取該插件最新版本。

2、在工程目錄下建立一個檔案格式為 yaml 的

.edas_config.yaml

檔案。

說明：

• 如果部署的工程為 Maven 的子子產品，那麼請在子子產品的目錄下建立該檔案。
• 以下配置參數為示例參數，請替換成您的實際的應用參數。例如部署分批等更多配置參數請參見 配置項
• 關于多子產品工程部署更多方式，請參考 部署多子產品工程

env:
     region_id: cn-beijing  # 應用執行個體所在的區域 ID
app:
     app_id: eb20****-e6ee-4f6d-a36f-5f6a5455****  # 您想部署應用的 ID           

若您不知如何設定以上參數值，請參照以下步驟擷取：

1. 登入 ，在頁面左上角選擇所需地域。
2. 在左側導航欄中選擇應用管理 > 應用清單，在應用清單頁面單擊待部署應用的應用名稱。
3. 在基本資訊頁面右上角單擊部署應用。
4. 在部署模式選擇頁面選擇正常釋出（單批/多批）開始部署卡片右上角的開始部署。
5. 單擊展開生成Maven插件配置，擷取參數資訊。

   

3、在任意目錄下建立一個 YAML 類的賬号檔案，并添加 AccessKey ID 和 AccessKey Secret 賬号資訊。

access_key_id:<yourAccessKeyId>
access_key_secret:<yourAccessKeySecret>           

• 該配置中 Access Key ID 和 Access Key Secret 隻會用來生成請求簽名，不會用于網絡傳輸等其他用途。
• AccessKey ID 和 AccessKey Secret 可登入阿裡雲 使用者資訊管理 檢視，推薦使用 RAM 子賬号 （需已授予應用管理權限）來控制應用權限以提高應用安全。

4、進入您的工程目錄，執行以下打包指令。

說明：如果為 Maven 多子產品則進入子子產品目錄。

mvn clean package toolkit:deploy -Daccess_key_file={賬号檔案路徑}           

• toolkit:deploy： 使用 toolkit-maven-plugin 在打包成功後進行應用部署。隻有添加此參數才會進行應用部署。
• access_key_file：阿裡雲賬号檔案。更多指定密鑰對的方式請參考 賬号配置及優先級

三、結果驗證

執行指令後，終端開始輸出日志。若輸出以下日志則說明部署成功。

四、部署多子產品工程

多子產品工程是常見的項目組織形式，此 Maven 插件支援以下兩種方式來部署您的多子產品工程。

• 在父工程中執行打包及部署指令：在父工程中執行

  toolkit:deploy

  指令時，增加

  -Ddeploy_artifacts

  參數來指定需要部署的子子產品Artifact ID。如果希望部署多個子子產品，以半形逗號分隔。例如：一個 CarShop 工程存在以下示例的子子產品：

carshop
   itemcenter-api
   itemcenter
   detail           

如果想同時部署 itemcenter 和 detail 子子產品，您可以在 carshop 目錄下，執行以下指令：

mvn clean package toolkit:deploy -Ddeploy_artifacts=itemcenter,detail           

預設情況下，此插件會根據 itemcenter 和 detail 子產品下的

.edas_config.yaml

檔案來分别部署對應的應用。您也可以通過增加

-Dedas_config

參數來指定配置檔案，相關操作請詳見

指定配置檔案

注意： 此方式要求 toolkit-maven-plugin 版本為1.0.3及以上。

• 在子子產品中執行打包及部署指令：
  1. 在父工程中執行

     install

     指令，将子子產品依賴安裝到本地的 Maven 倉庫。
  2. 進入到需要部署的子子產品目錄下執行

     toolkit:deploy

     指令。

說明： 此方式支援toolkit-maven-plugin所有版本。

五、更多資訊

更多配置項說明、指定配置檔案說明和賬号配置及優先級說明資訊請參見

Maven 部署說明

“ 提供全面，高效和穩定的鏡像下載下傳服務。釘釘搜尋 21746399 加入鏡像站官方使用者交流群。”