Ark Biz

本小节将介绍 Ark Biz 目录结构，以及如何使用官方插件 sofa-ark-maven-plugin 打包并发布 Ark Biz。

Ark Biz 包和 Ark 包 都是使用 Maven 插件 sofa-ark-maven-plugin 打包生成；工程应用在配置该插件时，默认情况下只会打包发布 Ark 包， 只有在配置参数 attach 为 true 时，才会打包发布 Ark Biz：

  1. <build>
  2.     <plugin>
  3.         <groupId>com.alipay.sofa</groupId>
  4.         <artifactId>sofa-ark-maven-plugin</artifactId>
  5.         <version>0.2.0</version>
  6.         <executions>
  7.             <execution>
  8.                 <id>default-cli</id>
  9.                 <goals>
  10.                     <goal>repackage</goal>
  11.                 </goals>
  12.             </excution>
  13.         </executions>
  14.         <configuration>
  15.             <attach>false</attach>
  16.         </configuration>
  17.     </plugin>
  18. </build>

那 Ark Biz 和 Ark 包 有什么区别呢？ 简单来说，Ark Biz 是工程应用所有资源的组织单元，它包含了应用启动所需的所有资源，详细可参考下文描述的 Ark Biz 目录格式；而工程应用打出来的 Ark 包，是一个通过 java -jar 启动，运行在 SOFAArk 容器的 Fat Jar，不仅包含应用工程对应的 Ark Biz，也包含 Ark Container，以及应用依赖的 Ark Plugin；

通常情况，只需要发布 Ark 包 即可，但是 SOFAArk 是支持运行多个 Ark Biz的，因此如果开发者希望自己应用的 Ark Biz 包能够被其他应用直接当成 Jar 包依赖，进而运行在同一个 SOFAArk 容器之上，那么就需要打包发布 Ark 包；

Ark-Biz 典型目录结构

  1. .
  2. ├── META-INF
  3. │   ├── MANIFEST.MF
  4. │   ├── maven
  5. │   │   └── me.qlong.tech
  6. │   │       └── sofa-boot-demo3-web
  7. │   │           ├── pom.properties
  8. │   │           └── pom.xml
  9. │   └── sofa-boot-demo3
  10. │       └── sofa-boot-demo3-web.xml
  11. ├── com
  12. │   └── alipay
  13. │       └── sofa
  14. │           └── ark
  15. │               └── biz
  16. │                   └── mark
  17. ├── config
  18. │   ├── application-dev.properties
  19. │   ├── application-test.properties
  20. │   └── application.properties
  21. ├── lib
  22. │   ├── spring-beans-4.3.4.RELEASE.jar
  23. │   ├── spring-boot-1.4.2.RELEASE.jar
  24. │   ├── spring-boot-autoconfigure-1.4.2.RELEASE.jar
  25. │   ├── spring-boot-devtools-1.4.2.RELEASE.jar
  26. │   ├── spring-boot-starter-1.4.2.RELEASE.jar
  27. │   ├── spring-boot-starter-logging-1.4.2.RELEASE.jar
  28. │   ├── spring-boot-starter-tomcat-1.4.2.RELEASE.jar
  29. │   ├── spring-boot-starter-web-1.4.2.RELEASE.jar
  30. │   ├── spring-context-4.3.4.RELEASE.jar
  31. │   ├── spring-core-4.3.4.RELEASE.jar
  32. │   ├── spring-expression-4.3.4.RELEASE.jar
  33. │   ├── spring-web-4.3.4.RELEASE.jar
  34. │   ├── ...
  35. │   ├── ...
  36. │   ├── ...
  37. │   └── velocity-1.7.jar
  38. ├── logback-spring.xml
  39. ├── me
  40. │   └── qlong
  41. │       └── tech
  42. │           └── SOFABootWebSpringApplication.class
  43. └── static
  44.     └── index.html

上述目录结构相关文件和目录说明如下：

普通的 Java 工程或者 Spring Boot Core/Web 工程都可以打包成 Ark Biz；Ark Biz 没有固定的目录格式，它只是在原来 Jar 包结构基础上新增两个目录文件：

  • com/alipay/sofa/ark/biz/mark : 标记文件，标记该 Jar 包是 sofa-ark-maven-plugin 打包生成的 Ark Biz 文件；

  • lib/ : lib 目录存放工程应用的三方依赖，

原文: https://alipay.github.io/sofastack.github.io/docs/ark-biz.html