一旦你准备好了应用程序,可能会想部署到容器。
打包
在部署时,通常您需要生成一个包含所有类,依赖项和资源的归档文件:在单个JAR归档文件(也称为Fat JAR)或WAR文件(Web应用程序资源)中。
Fat JAR
fat-jar(或uber-jar)归档文件是一个普通的jar文件单个归档文件,它将所有依赖项打包在一起,因此可以使用Java直接运行独立的应用程序:
java -jar yourapplication.jar
复制代码
在部署到heroku或使用nginx进行反向代理时,是在docker等容器中运行它的首选方法。
使用Gradle时,您可以使用shadow gradle插件生成它。 例如,要使用netty作为引擎生成Fat JAR:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.github.jengelman.gradle.plugins:shadow:2.0.4'
}
}
apply plugin: 'com.github.johnrengelman.shadow'
apply plugin: 'kotlin'
apply plugin: 'application'
//mainClassName = 'io.ktor.server.netty.DevelopmentEngine' // For versions < 1.0.0-beta-3
mainClassName = 'io.ktor.server.netty.EngineMain' // Starting with 1.0.0-beta-3
// 这个task会生成fat JAR 并会将其放在 ./build/libs/ directory目录下
shadowJar {
manifest {
attributes 'Main-Class': mainClassName
}
}
复制代码
WAR(Servlet容器)
WAR允许您轻松地将应用程序部署到Web容器/ servlet容器中,只需将其复制到其webapps文件夹即可。 Ktor支持两个流行的servlet容器:Jetty和Tomcat。 它也适用于部署到google app engine。
要生成war文件,可以使用gretty gradle插件。 您还需要一个WEB-INF/web.xml,如下所示:
webapp/WEB-INF/web.xml:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">
<!-- path to application.conf file, required -->
<!-- note that this file is always loaded as an absolute path from the classpath -->
<context-param>
<param-name>io.ktor.ktor.config</param-name>
<param-value>application.conf</param-value>
</context-param>
<servlet>
<display-name>KtorServlet</display-name>
<servlet-name>KtorServlet</servlet-name>
<servlet-class>io.ktor.server.servlet.ServletApplicationEngine</servlet-class>
<!-- required! -->
<async-supported>true</async-supported>
<!-- 100mb max file upload, optional -->
<multipart-config>
<max-file-size>304857600</max-file-size>
<max-request-size>304857600</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
</servlet>
<servlet-mapping>
<servlet-name>KtorServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
复制代码
build.gradle:
buildscript {
ext.gretty_version = '2.0.0'
repositories {
jcenter()
}
dependencies {
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
classpath "org.akhikhl.gretty:gretty:$gretty_version"
}
}
apply plugin: 'kotlin'
apply plugin: 'war'
apply plugin: 'org.akhikhl.gretty'
webAppDirName = 'webapp'
gretty {
contextPath = '/'
logbackConfigFile = 'resources/logback.xml'
}
sourceSets {
main.kotlin.srcDirs = [ 'src' ]
main.resources.srcDirs = [ 'resources' ]
}
repositories {
jcenter()
}
dependencies {
compile "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
compile "io.ktor:ktor-server-servlet:$ktor_version"
compile "io.ktor:ktor-html-builder:$ktor_version"
compile "ch.qos.logback:logback-classic:$logback_version"
}
kotlin.experimental.coroutines = 'enable'
task run
afterEvaluate {
run.dependsOn(tasks.findByName("appRun"))
}
复制代码
Proguard
如果您对JAR大小有一些限制(例如,将应用程序部署到heroku时),则可以使用proguard来缩小它。 如果您使用的是gradle,那么使用proguard-gradle插件非常简单。 您只需要记住:主模块方法,EngineMain类和Kotlin反射类。 然后,您可以根据需要对其进行微调:
buildscript {
ext.proguard_version = '6.0.1'
dependencies {
classpath "net.sf.proguard:proguard-gradle:$proguard_version"
}
}
task minimizedJar(type: proguard.gradle.ProGuardTask, dependsOn: shadowJar) {
injars "build/libs/my-application.jar"
outjars "build/libs/my-application.min.jar"
libraryjars System.properties.'java.home' + "/lib/rt.jar"
printmapping "build/libs/my-application.map"
ignorewarnings
dontobfuscate
dontoptimize
dontwarn
def keepClasses = [
'io.ktor.server.netty.EngineMain', // The EngineMain you use, netty in this case.
'kotlin.reflect.jvm.internal.**',
'io.ktor.samples.hello.HelloApplicationKt', // The class containing your module defined in the application.conf
'kotlin.text.RegexOption'
]
for (keepClass in keepClasses) {
keep access: 'public', name: keepClass, {
method access: 'public'
method access: 'private'
}
}
}
复制代码