通过 Maven 插件自动部署应用-阿里云开发者社区

开发者社区> 镜像站> 正文

通过 Maven 插件自动部署应用

简介: 除了通过控制台方式将应用部署在SAE上外,还有一种方式是通过 Maven 的 toolkit-maven-plugin 插件进行自动化部署,本文将为大家详细讲解如何通过 Maven 插件自动部署应用。

37.jpeg
镜像下载、域名解析、时间同步请点击 阿里巴巴开源镜像站

一、自动化部署流程

通过toolkit-maven-plugin插件自动化部署应用的流程:首先添加插件依赖,接下来配置插件,最后构建部署。

1. 添加插件依赖

在pom.xml文件中增加如下所示的插件依赖。

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

说明 toolkit-maven-plugin建议使用最近版本。

2. 配置插件

配置插件主要包括账号配置、打包配置和部署配置。如果需要更多自定义配置项,请参见打包参数部署参数
  a. 账号配置 
在打包工程的根目录下创建文件格式为 YAML 的账号配置文件,命名为toolkit_profile.yaml并填入如下信息:

regionId:        #应用所在区域,如北京为`cn-beijing`,上海为`cn-shanghai`,杭州为`cn-hangzhou`。
accessKeyId:     #访问阿里云资源的AK,建议使用子账号的AK降低安全风险
accessKeySecret: #访问阿里云资源的SK,建议使用子账号的SK降低安全风险

  b. 打包配置
在打包工程的根目录下创建文件格式为 YAML 的打包配置文件。如果打包工程为Maven的子模块,则需要在子模块的目录下创建该文件,并命名为toolkit_package.yaml,填入如下信息:

apiVersion: V1
kind: AppPackage
spec:
 packageType: #应用部署包类型,支持WAR、FatJar、Image三种格式。
 packageUrl:  #如果应用部署包类型为WAR或FatJar,可填入此字段,不填则使用当前maven构建的包进行部署。
 imageUrl:    #如果部署包类型为Image,可填入此字段;Image类型也可以在本地构建Docker镜像进行部署,请参考打包文件参数章节设置相关参数。

  c. 部署配置
在打包工程的根目录下创建文件格式为 YAML 的部署文件,命名为toolkit_deploy.yaml,并填入如下信息:

apiVersion: V1
kind: AppDeployment
spec:
 type: serverless
 target:
  appId:        #部署应用的ID,如果配置了appId则无需配置namespaceId和appName
  namespaceId:  #所属区域,如不清楚appId,可使用此所属区域及应用名称进行部署
  appName:      #应用名称,如不清楚appId,可使用此应用名称及命名空间进行部署

3. 构建部署

进入pom.xml所在的目录(如果部署Maven子模块,则进入子模块pom.xml所在的目录),执行如下命令:

mvn clean package toolkit:deploy -Dtoolkit_profile=toolkit_profile.yaml -Dtoolkit_package=toolkit_package.yaml -Dtoolkit_deploy=toolkit_deploy.yaml

命令参数含义为:

  • toolkit:deploy:打包完成后进行应用部署。
  • -Dtoolkit_profile:指定账号配置文件。如果账号文件与pom.xml在同一个目录下,且名字为.toolkit_profile.yaml,其为可选参数,插件会自动获取。
    注意 文件名最前面有小数点。
  • -Dtoolkit_package:指定打包文件。如果打包文件与pom.xml在同一个目录下,且名字为.toolkit_package.yaml,其为可选参数,插件会自动获取。
    注意 文件名最前面有小数点。
  • -Dtoolkit_deploy:指定部署文件。如果部署文件与pom.xml在同一个目录下,且名字为.toolkit_deploy.yaml,其为可选参数,插件会自动获取。
  • -Ddeploy version:指定部署的版本号,优先级高于部署配置文件中的version配置。
    说明 toolkit-maven-plugin插件1.0.6及以后版本支持该配置参数。

执行该打包命令后,系统显示如下结果,当回显信息中显示“BUDILD SUCCESS”表示部署成功。1.jpeg

二、更多配置项

  • 打包参数打包文件支持的参数如下所示:
apiVersion: V1
kind: AppPackage
spec:
  packageType:  #应用部署包类型,支持WAR、FatJar、Image。
  imageUrl:     #镜像地址,Image包类型应用可填入。
  packageUrl:   #包地址,WAR、FatJar类型应用可填入。
  build:
    docker:
       dockerfile:        #Docker镜像构建文件。如您希望在本地构建镜像部署,需填入此字段,例如:Dockerfile。
       imageRepoAddress:  #阿里云镜像仓库地址。如您希望在本地构建镜像部署,需填入此字段,例如:registry.cn-beijing.aliyuncs.com/edas_demo/demo。
       imageTag:          #镜像Tag。如您希望在本地构建镜像部署,需填入此字段,例如:test。
       imageRepoUser:     #阿里云镜像仓库用户名。如您希望在本地构建镜像部署,需填入此字段,例如:***@***。
       imageRepoPassword: #阿里云镜像仓库密码。如您希望在本地构建镜像部署,需填入此字段,例如:password。
    oss:
       bucket:      #目标存储桶名称。如您希望使用自定义的oss仓库存储部署包,需填入此字段,例如:bucket-name01。
       key:         #oss自定义路径。如您希望使用自定义的oss仓库存储部署包,需填入此字段,例如:test1/test.jpg。
       accessKeyId: #oss账号。如您希望使用自定义的oss仓库存储包,需填入此字段。
       accessKeySecret: #oss密码。如您希望使用自定义的oss仓库存储包,可填入此字段。
  • 部署参数部署文件支持的参数如下所示:
apiVersion: V1
kind: AppDeployment
spec:
  type: serverless
  target:
    appName:     #应用名称
    namespaceId: #应用所在命名空间
    appId:       #应用ID。插件会使用此应用进行部署,如未填入则使用namespaceId和appName来查找应用进行部署。
  version: #部署版本号,默认使用日时分秒格式
  jdk:     #部署的包依赖的JDK版本,JDK支持版本为Open JDK 7和Open JDK 8。镜像不支持。
  webContainer:  #部署的包依赖的Tomcat版本,WebContainer支持apache-tomcat-7.0.91。镜像不支持。
  batchWaitTime: #分批等待时间。
  command:       #镜像启动命令。该命令必须为容器内存在的可执行的对象。例如:sleep。设置该命令将导致镜像原本的启动命令失效。
  commandArgs: #镜像启动命令参数。上述启动命令所需参数。
    - 1d
  envs:    #容器环境变量参数
    - name: envtmp0
      value: '0'
    - name: envtmp1
      value: '1'
  customHostAlias:  #容器内自定义host映射
    - hostName: 'samplehost1'
      ip: '127.0.0.1'
    - hostName: 'samplehost2'
      ip: '127.0.0.1'
  jarStartOptions:  #JAR包启动应用选项
  jarStartArgs:     #JAR包启动应用参数
  liveness:   #容器健康检查,健康检查失败的容器将被杀死并恢复。
    exec:
      command:
        - sleep
        - 1s
    initialDelaySeconds: 5
    timeoutSeconds: 11
  readiness:  #应用启动状态检查,多次健康检查失败的容器将被杀死并重启。不通过健康检查的容器将不会有 SLB 流量进入。
    exec:
      command:
        - sleep
        - 1s
    initialDelaySeconds: 5
    timeoutSeconds: 11
  minReadyInstances: 1  #最小存活实例数。在滚动升级过程中或者滚动升级失败,可用实例数都将尽可能不小于该值,为 0 则不限制。弹性扩缩容的范围不应该小于该值,否则将触发异常。

三、典型场景示例

场景一:本地构建WAR或FatJar包并部署在SAE
假设您在北京环境有WAR或FatJar类型应用,期望本地构建WAR或FatJar部署在SAE。打包配置和部署配置如下所示。

  • 打包文件:
apiVersion: V1
kind: AppPackage
spec:
  packageType: War
  • 部署文件:
apiVersion: V1
kind: AppDeployment
spec:
  type: serverless
  target:
    appId:  #应用ID。插件会使用此应用进行部署,如未填入则使用namespaceId和appName来查找应用进行部署。
    namespaceId:  #【可选】命名空间,如不清楚appId,可使用此命名空间及应用名称进行部署。
    appName:      #【可选】应用名称,如不清楚appId,可使用此命名空间及应用名称进行部署。

场景二:使用已有镜像地址部署镜像类型应用
假设您在北京环境有一个镜像类型应用,期望使用已有的镜像(registry.cn-beijing.aliyuncs.com/test/gateway:latest )部署应用。打包配置和部署配置如下所示。

  • 打包文件:
apiVersion: V1
kind: AppPackage
spec:
  packageType: Image
  imageUrl: registry.cn-beijing.aliyuncs.com/test/gateway:latest
  • 部署文件:
apiVersion: V1
kind: AppDeployment
spec:
  type: serverless
  target:
    appId:  #应用ID。插件会使用此应用进行部署,如未填入则使用namespaceId和appName来查找应用进行部署。
    namespaceId:  #【可选】命名空间,如不清楚appId,可使用此命名空间及应用名称进行部署。
    appName:      #【可选】应用名称,如不清楚appId,可使用此命名空间及应用名称进行部署。

场景三:本地构建镜像上传至仓库并部署应用
假设您在北京环境有镜像类型应用,期望在本地编译并构建为镜像,并上传到阿里云镜像仓库进行部署,打包配置和部署配置如下所示。

  • 打包文件:
apiVersion: V1
kind: AppPackage
spec:
  packageType: Image
  build:
    docker:
       dockerfile: Dockerfile #指定Dockerfile
       imageRepoAddress:      #镜像仓库地址
       imageTag:              #镜像Tag
       imageRepoUser:         #镜像仓库用户名
       imageRepoPassword:     #镜像仓库密码
  • 部署文件:
apiVersion: V1
kind: AppDeployment
spec:
  type: serverless
  target:
    appId:  #应用ID。插件会使用此应用进行部署,如未填入则使用namespaceId和appName来查找应用进行部署。
    namespaceId:  #【可选】命名空间,如不清楚appId,可使用此命名空间及应用名称进行部署
    appName:      #【可选】应用名称,如不清楚appId,可使用此命名空间及应用名称进行部署

阿里巴巴开源镜像站 提供全面,高效和稳定的系统镜像、应用软件下载、域名解析和时间同步服务。”

版权声明:如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件至:developerteam@list.alibaba-inc.com 进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
+ 订阅

阿里巴巴镜像站技术社区

官方博客
相关链接