Generalize Jira start API

CHANGELOG.md

@@ -30,8 +30,8 @@ Dropping a requirement of a major version of a dependency is a new contract.
 - Point to remote files on SSH hosts via `RemotePath`.
 
 Progress on [JPERF-273]:
-- Allow multiple ways of installing Jira via `JiraInstallation`.
-- Represent the information required to use an already installed Jira via `InstalledJira`.
+- Allow multiple ways of installing Jira via `JiraInstallation` or starting it via `JiraStart`.
+- Represent the information required to use an already installed Jira via `InstalledJira` or `JiraStart` if started.
 - Represent a brand-new Jira instance via `EmptyJiraHome`.
 
 ### Fixed

src/main/kotlin/com/atlassian/performance/tools/infrastructure/api/jira/start/JiraLaunchScript.kt

@@ -0,0 +1,26 @@
+package com.atlassian.performance.tools.infrastructure.api.jira.start
+
+import com.atlassian.performance.tools.infrastructure.api.jira.install.InstalledJira
+import com.atlassian.performance.tools.ssh.api.Ssh
+import java.time.Duration
+
+class JiraLaunchScript : JiraStart {
+
+    override fun start(
+        installed: InstalledJira
+    ): StartedJira {
+        val installation = installed.installation
+        Ssh(installation.host).newConnection().use { ssh ->
+            ssh.execute(
+                "${installed.jdk.use()}; ${installation.path}/bin/start-jira.sh",
+                Duration.ofMinutes(1)
+            )
+            val pid = ssh
+                .execute("cat ${installation.path}/work/catalina.pid")
+                .output
+                .trim()
+                .toInt()
+            return StartedJira(installed, pid)
+        }
+    }
+}

src/main/kotlin/com/atlassian/performance/tools/infrastructure/api/jira/start/JiraStart.kt

@@ -0,0 +1,12 @@
+package com.atlassian.performance.tools.infrastructure.api.jira.start
+
+import com.atlassian.performance.tools.infrastructure.api.jira.install.InstalledJira
+import net.jcip.annotations.ThreadSafe
+
+@ThreadSafe
+interface JiraStart {
+
+    fun start(
+        installed: InstalledJira
+    ): StartedJira
+}

src/main/kotlin/com/atlassian/performance/tools/infrastructure/api/jira/start/StartedJira.kt

@@ -0,0 +1,8 @@
+package com.atlassian.performance.tools.infrastructure.api.jira.start
+
+import com.atlassian.performance.tools.infrastructure.api.jira.install.InstalledJira
+
+class StartedJira(
+    val installed: InstalledJira,
+    val pid: Int
+)

src/test/kotlin/com/atlassian/performance/tools/infrastructure/api/jira/install/ParallelInstallationIT.kt → src/test/kotlin/com/atlassian/performance/tools/infrastructure/api/jira/install/JiraLaunchScriptIT.kt

@@ -2,35 +2,39 @@ package com.atlassian.performance.tools.infrastructure.api.jira.install
 
 import com.atlassian.performance.tools.infrastructure.api.distribution.PublicJiraSoftwareDistribution
 import com.atlassian.performance.tools.infrastructure.api.jira.EmptyJiraHome
-import com.atlassian.performance.tools.infrastructure.api.jvm.AdoptOpenJDK11
+import com.atlassian.performance.tools.infrastructure.api.jira.start.JiraLaunchScript
+import com.atlassian.performance.tools.infrastructure.api.jvm.AdoptOpenJDK
 import com.atlassian.performance.tools.infrastructure.toSsh
 import com.atlassian.performance.tools.sshubuntu.api.SshUbuntuContainer
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.Test
 import java.nio.file.Files
 import java.util.function.Consumer
 
-class ParallelInstallationIT {
+class JiraLaunchScriptIT {
 
     @Test
     fun shouldInstallJira() {
         // given
         val installation = ParallelInstallation(
             jiraHomeSource = EmptyJiraHome(),
             productDistribution = PublicJiraSoftwareDistribution("7.13.0"),
-            jdk = AdoptOpenJDK11()
+            jdk = AdoptOpenJDK()
         )
+        val start = JiraLaunchScript()
 
         testOnServer { server ->
             // when
             val installed = installation.install(server)
+            val started = start.start(installed)
 
             // then
             val serverXml = installed
                 .installation
                 .resolve("conf/server.xml")
                 .download(Files.createTempFile("downloaded-config", ".xml"))
             assertThat(serverXml.readText()).contains("<Connector port=\"${server.privatePort}\"")
+            assertThat(started.pid).isPositive()
         }
     }