使用 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. 登錄 EDAS 控制檯，在頁面左上角選擇所需地域。
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 加入鏡像站官方用戶交流群。”