Documentation Edit this page

Build Test

Remote build testing infrastructure used by CI to execute builds on isolated DigitalOcean droplets. Provides build isolation, parallel execution, and a web dashboard for monitoring test runs.

Build Test is an internal service — the remote build-execution layer (a droplet pool) that callers like Kotlin Build CI, kompile-cli --remote, and BuildTestCli drive. Its buildtest.kotlin.build dashboard is an internal monitoring/diagnostic view of individual build & test runs, not an end-user destination. End users (developers) instead use the user-facing kotlin.build website — the CI dashboard — to follow their builds, while Build Test executes those builds behind the scenes.

Architecture

     +---------------------------+
     |      Build Test WUI       |
     |  buildtest.kotlin.build   |
     |    buildtest-wui.jar      |
     |     (ContainerNursery)    |
     +-------------+-------------+
                   |
     +-------------v-------------+
     |  Build Test Service Server |
     |     url://buildtest/       |
     | buildtest-server-service.jar|
     |     (ContainerNursery)     |
     +-------------+-------------+
                   |
     +-------------v-------------+
     |   DigitalOcean Droplets   |
     |   (Ephemeral Build VMs)   |
     +---------------------------+

Deployment

• buildtest-wui.jar is deployed to ContainerNursery, serving the dashboard at buildtest.kotlin.build.
• buildtest-server-service.jar is deployed to ContainerNursery, accessible via the internal url://buildtest/ route.

Health Checks

• https://buildtest.kotlin.build - WUI availability
• url://buildtest/ - Internal service server availability

Notes

• Build Test provisions ephemeral DigitalOcean droplets for each build, providing full isolation between CI runs.
• DigitalOcean droplets created by Build Test belong to CI runs and should never be manually destroyed, as they may be actively running builds for other users.
• If CI fails with "droplet limit exceeded", wait for existing builds to complete and retry rather than deleting droplets.
• The url://buildtest/ internal route is used by Kotlin Build CI to communicate with the service server directly within ContainerNursery.