Add ephemeral Hypernode server support

Author: tdgroot

src/Server.php

@@ -7,6 +7,9 @@
  */
 class Server
 {
+    public const OPTION_HN_EPHEMERAL = 'hn_ephemeral';
+    public const OPTION_HN_PARENT_APP = 'hn_parent_app';
+
     /**
      * @var string
      */
@@ -46,6 +49,11 @@ public function getHostname(): string
         return $this->hostname;
     }
 
+    public function setHostname(string $hostname): void
+    {
+        $this->hostname = $hostname;
+    }
+
     /**
      * @return string[]
      */

src/Stage.php

@@ -48,10 +48,11 @@ public function getUsername(): string
     }
 
     /**
-     * @param string     $hostname
-     * @param array      $roles
-     * @param array      $options Extra host options
-     * @param array      $sshOptions
+     * @param string $hostname Hostname of the server
+     * @param array|null $roles Roles for the server to be applied
+     * @param array $options Extra host options
+     * @param array $sshOptions
+     * @see ServerRole
      * @return Server
      */
     public function addServer(
@@ -66,6 +67,28 @@ public function addServer(
         return $server;
     }
 
+    /**
+     * Create a temporary (ephemeral) Hypernode instance based on given Hypernode.
+     * The hostname will be defined during the deployment.
+     *
+     * @param string $appName Name of the Hypernode to base the ephemeral server on
+     * @param array|null $roles Roles for the server to be applied
+     * @param array $options Extra host options for Deployer
+     * @see ServerRole
+     * @return Server
+     */
+    public function addEphemeralServer(string $appName, array $roles = null, array $options = []): Server
+    {
+        $ephemeralOptions = [
+            Server::OPTION_HN_EPHEMERAL => true,
+            Server::OPTION_HN_PARENT_APP => $appName,
+        ];
+        $options = array_merge($ephemeralOptions, $options);
+        $server = new Server('', $roles, $options);
+        $this->servers[] = $server;
+        return $server;
+    }
+
     /**
      * @return Server[]
      */