New Configuration Pages

codeSnippets/snippets/embedded-server/build.gradle.kts

@@ -29,6 +29,9 @@ dependencies {
     implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version")
     implementation("io.ktor:ktor-server-core:$ktor_version")
     implementation("io.ktor:ktor-server-netty:$ktor_version")
+    implementation("io.ktor:ktor-server-jetty-jakarta:$ktor_version")
+    implementation("io.ktor:ktor-server-cio:$ktor_version")
+    implementation("io.ktor:ktor-server-tomcat-jakarta:$ktor_version")
     implementation("ch.qos.logback:logback-classic:$logback_version")
 
     testImplementation("junit:junit:$junit_version")

codeSnippets/snippets/embedded-server/src/main/kotlin/com/example/Application.kt

@@ -69,4 +69,49 @@ fun runServerWithCommandLineConfig(args: Array<String>) {
             }
         }
     }.start(wait = true)
-}
+}
+
+fun runConfiguredCommonProperties() {
+    embeddedServer(Netty, configure = {
+        connector {
+            host = "0.0.0.0"
+            port = 8080
+        }
+        connectionGroupSize = 2
+        workerGroupSize = 5
+        callGroupSize = 10
+        shutdownGracePeriod = 2000
+        shutdownTimeout = 3000
+    }) {
+        module()
+    }.start(wait = true)
+}
+
+fun io.ktor.server.application.Application.module() {
+    routing {
+        get("/") {
+            call.respondText("Hello, world!")
+        }
+    }
+}
+
+fun runConfiguredNettyProperties() {
+    embeddedServer(Netty, configure = {
+        runningLimit = 16
+        shareWorkGroup = false
+        configureBootstrap = {
+            // ...
+        }
+        channelPipelineConfig = {
+            //
+        }
+        responseWriteTimeoutSeconds = 10
+        requestReadTimeoutSeconds = 0 // infinite
+        tcpKeepAlive = false
+        maxInitialLineLength = 4096
+        maxHeaderSize = 8192
+        maxChunkSize = 8192
+    }) {
+        module()
+    }.start(true)
+}

codeSnippets/snippets/embedded-server/src/main/kotlin/com/example/CIO.kt

@@ -0,0 +1,13 @@
+package com.example
+
+import io.ktor.server.cio.CIO
+import io.ktor.server.engine.embeddedServer
+
+fun runConfiguredCIOProperties() {
+    embeddedServer(CIO, configure = {
+        connectionIdleTimeoutSeconds = 45
+        reuseAddress = false
+    }) {
+        module()
+    }.start(true)
+}

codeSnippets/snippets/embedded-server/src/main/kotlin/com/example/Jetty.kt

@@ -0,0 +1,19 @@
+package com.example
+
+import io.ktor.server.engine.embeddedServer
+import io.ktor.server.jetty.jakarta.Jetty
+import org.eclipse.jetty.server.handler.ErrorHandler
+import kotlin.time.Duration.Companion.seconds
+
+fun runConfiguredJettyProperties() {
+    embeddedServer(Jetty, configure = {
+        configureServer = {
+            errorHandler = MyErrorHandler()
+        }
+        idleTimeout = 30.seconds
+    }) {
+        module()
+    }.start(true)
+}
+
+class MyErrorHandler : ErrorHandler()

codeSnippets/snippets/embedded-server/src/main/kotlin/com/example/Tomcat.kt

@@ -0,0 +1,17 @@
+package com.example
+
+import io.ktor.server.engine.embeddedServer
+import io.ktor.server.tomcat.jakarta.Tomcat
+
+fun runConfiguredTomcatProperties() {
+    embeddedServer(Tomcat, configure = {
+        configureTomcat = {
+            with(connector) {
+                enableLookups = false
+                setProperty("maxThreads", "150")
+            }
+        }
+    }) {
+        module()
+    }.start(true)
+}

ktor.tree

@@ -47,10 +47,9 @@
                 <toc-element topic="server-engines.md"
                              toc-title="Engines"
                              accepts-web-file-names="custom-engines.html,engines.html"/>
-                <toc-element topic="server-configuration-code.topic"
-                             accepts-web-file-names="configuration-code.html"/>
-                <toc-element topic="server-configuration-file.topic"
-                             accepts-web-file-names="configuration.html,configurations.html,environments.html,configuration-file.html"/>
+                <toc-element topic="server-configuration.md"
+                             toc-title="Server Configuration"
+                             accepts-web-file-names="configuration.html,configurations.html,environments.html,configuration-file.html, configuration-code.html" />
                 <toc-element topic="server-modules.md"
                              accepts-web-file-names="modules.html"/>
                 <toc-element topic="server-plugins.md"

topics/lib.topic

@@ -357,8 +357,8 @@
             <control>Configuration</control>
             :
             Choose whether
-            to specify server parameters <a href="server-configuration-file.topic">in a YAML or HOCON file</a>, or
-            <a href="server-configuration-code.topic">in code</a>.
+            to specify server parameters <a href="server-configuration.md">in a YAML or HOCON file</a>, or
+            <a href="server-configuration.md">in code</a>.
         </p>
     </snippet>
 

topics/migrating-3.md

@@ -139,7 +139,7 @@ fun main(args: Array<String>) {
 </compare>
 
 For more information on command-line configuration with `embeddedServer`, see the
-[Configuration in code](server-configuration-code.topic#command-line) topic.
+[Configuration in code](server-engines.md#configure-engine) topic.
 
 #### Introduction of `ServerConfigBuilder` {id="ServerConfigBuilder"}