feat(git): git-backed stacks, core and command line (#138, part 1)

docs/README.md

@@ -8,6 +8,7 @@ Documentation for the Compose Manager plugin for Unraid.
 - [User Guide](user-guide.md) - How to use Compose Manager
 - [Configuration](configuration.md) - Settings and options
 - [Profiles](profiles.md) - Docker Compose profiles support
+- [Git Stacks](git-stacks.md) - Deploy stacks from a git repository
 
 ## Screenshots
 

source/compose.manager/include/Defines.php

@@ -36,6 +36,17 @@ function locate_compose_root($name)
 defined('COMPOSE_CREDENTIAL_KEY_FILE') || define('COMPOSE_CREDENTIAL_KEY_FILE', '/boot/config/plugins/compose.manager/credentials.key');
 defined('COMPOSE_DOCKER_CONFIG_DIR') || define('COMPOSE_DOCKER_CONFIG_DIR', '/var/tmp/compose-manager-docker-config');
 defined('COMPOSE_GITHUB_DEVICE_DIR') || define('COMPOSE_GITHUB_DEVICE_DIR', '/var/tmp/compose-manager-github-device');
+// Git-backed stacks: where Unraid reports the array state and the live mounts,
+// and the folder under which disks, pools and shares are mounted.
+defined('COMPOSE_UNRAID_VAR_INI') || define('COMPOSE_UNRAID_VAR_INI', '/var/local/emhttp/var.ini');
+defined('COMPOSE_MOUNTS_FILE') || define('COMPOSE_MOUNTS_FILE', '/proc/self/mounts');
+defined('COMPOSE_GIT_MNT_DIR') || define('COMPOSE_GIT_MNT_DIR', '/mnt');
+defined('COMPOSE_GIT_HOME_DIR') || define('COMPOSE_GIT_HOME_DIR', '/var/tmp/compose-manager-git-home');
+defined('COMPOSE_GIT_DEFAULT_CLONES_ROOT') || define('COMPOSE_GIT_DEFAULT_CLONES_ROOT', '/mnt/user/appdata/compose.manager/git');
+// The docker CLI (the git deploy checks run it; tests point this at a scripted stand-in).
+defined('COMPOSE_DOCKER_BIN') || define('COMPOSE_DOCKER_BIN', 'docker');
+// compose.sh's per-stack lock files (its LOCK_DIR), which compose-git takes too.
+defined('COMPOSE_LOCK_DIR') || define('COMPOSE_LOCK_DIR', '/var/run/compose.manager');
 
 /**
  * Reserved filename at the compose root level used by the plugin installer

source/compose.manager/include/DockerCommand.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+require_once '/usr/local/emhttp/plugins/compose.manager/include/Defines.php';
+require_once '/usr/local/emhttp/plugins/compose.manager/include/ProcessRunner.php';
+
+/**
+ * Runs the docker CLI without a shell, with a time limit.
+ */
+final class DockerCommand
+{
+    public const DEFAULT_TIMEOUT_SECONDS = 120;
+
+    /**
+     * @param string[] $args Arguments after "docker"
+     */
+    public static function run(array $args, ?string $workingDirectory = null, int $timeoutSeconds = self::DEFAULT_TIMEOUT_SECONDS): ProcessResult
+    {
+        $environment = [
+            'PATH' => '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin',
+            'HOME' => getenv('HOME') ?: '/root',
+            'LC_ALL' => 'C',
+        ];
+        // Keep the registry credential compose.sh selected for this run, if any.
+        $dockerConfig = getenv('DOCKER_CONFIG');
+        if (is_string($dockerConfig) && $dockerConfig !== '') {
+            $environment['DOCKER_CONFIG'] = $dockerConfig;
+        }
+
+        return ProcessRunner::run(
+            array_merge([COMPOSE_DOCKER_BIN], $args),
+            $workingDirectory ?? '/',
+            $environment,
+            $timeoutSeconds
+        );
+    }
+}