Mangarr/deploy.php

<?php

namespace Deployer;

require 'recipe/symfony.php';

// GITEA_TOKEN injecté depuis le secret Gitea (scope: read:repository)
$giteaToken = getenv('GITEA_TOKEN') ?: throw new \RuntimeException('GITEA_TOKEN secret is required');
set('repository', "https://{$giteaToken}@git.homelab.nestor-server.fr/colgora/Mangarr.git");
set('keep_releases', 3);
set('composer_options', '--no-dev --optimize-autoloader --no-interaction --prefer-dist --ignore-platform-reqs --no-scripts');

// Copier vendor/ depuis la release précédente (hard links, quasi instantané)
// node_modules est géré par le shared mount /srv/mangarr/shared/node_modules
set('copy_dirs', ['vendor']);

// Pas de shared_files ni shared_dirs : tout est géré par les volumes Docker
set('shared_files', []);
set('shared_dirs', []);
set('writable_dirs', []);

host('production')
    ->set('hostname', getenv('DEPLOY_HOST'))  // Injecté depuis le secret Gitea
    ->set('remote_user', 'deploy')            // User avec accès docker group
    ->set('deploy_path', '/srv/mangarr')
    ->set('branch', 'main');

// Créer les dossiers que Docker doit monter comme volumes (gitignorés, absents de la release)
task('deploy:prepare_dirs', function () {
    run('mkdir -p {{release_path}}/var {{release_path}}/public/images {{release_path}}/public/cbz {{release_path}}/public/tmp');
});

// composer install via container éphémère (pas de PHP sur l'hôte requis)
// --user assure que vendor/ appartient au user deploy et non root
// Skip si composer.lock inchangé et vendor/ déjà populé (hard-linké depuis la release précédente)
task('deploy:vendors', function () {
    $releaseDir = get('release_path');
    $previousDir = get('previous_release');

    if (null !== $previousDir) {
        $lockUnchanged = test("diff -q $previousDir/composer.lock $releaseDir/composer.lock > /dev/null 2>&1");
        $vendorPopulated = test("[ -d $releaseDir/vendor/composer ]");

        if ($lockUnchanged && $vendorPopulated) {
            writeln('<info>deploy:vendors skipped — composer.lock unchanged</info>');

            return;
        }
    }

    run('docker run --rm --user $(id -u):$(id -g) -v {{release_path}}:/app -w /app composer:2 install {{composer_options}}');
});

// Build assets via container node éphémère
// 3 couches d'optimisation :
//   1. Skip total si aucun fichier front-end n'a changé (hard-link public/build/)
//   2. Skip npm install si package-lock.json inchangé (node_modules partagé persistant)
//   3. Cache npm et webpack persistants entre les releases
desc('Build Webpack Encore assets');
task('webpack_encore:build', function () {
    $sharedDir = '/srv/mangarr/shared';
    $sharedWebpackCache = "$sharedDir/webpack_cache";
    $sharedNodeModules = "$sharedDir/node_modules";
    $sharedNpmCache = "$sharedDir/npm_cache";

    run("mkdir -p $sharedWebpackCache $sharedNodeModules $sharedNpmCache");

    $releaseDir = get('release_path');
    $previousDir = get('previous_release'); // null au 1er déploiement

    // --- COUCHE 1 : skip total si aucun fichier front-end n'a changé ---
    if (null !== $previousDir) {
        $watchList = ['assets', 'templates', 'package.json', 'package-lock.json',
            'webpack.config.js', 'postcss.config.js', 'tailwind.config.js'];

        $diffChecks = implode(' && ', array_map(
            fn ($p) => "diff -rq --no-dereference $previousDir/$p $releaseDir/$p > /dev/null 2>&1",
            $watchList
        ));

        $hasPreviousBuild = test("[ -d $previousDir/public/build ] && [ -f $previousDir/public/build/manifest.json ]");

        if ($hasPreviousBuild && test("($diffChecks)")) {
            run("cp -al $previousDir/public/build $releaseDir/public/build");
            writeln('<info>webpack_encore:build skipped — no front-end files changed</info>');

            return;
        }
    }

    // --- COUCHE 2 : skip npm install si package-lock.json inchangé ---
    $needsNpmInstall = true;
    if (null !== $previousDir) {
        $lockUnchanged = test("diff -q $previousDir/package-lock.json $releaseDir/package-lock.json > /dev/null 2>&1");
        $nmPopulated = test("[ -d $sharedNodeModules/.bin ]");
        if ($lockUnchanged && $nmPopulated) {
            $needsNpmInstall = false;
        }
    }

    // --- COUCHE 3 : build docker avec caches persistants ---
    $installCmd = $needsNpmInstall
        ? 'npm install --prefer-offline && npm run build'
        : 'npm run build';

    run("docker run --rm \
        --user \$(id -u):\$(id -g) \
        -v $releaseDir:/app \
        -v $sharedNodeModules:/app/node_modules \
        -v $sharedWebpackCache:/app/node_modules/.cache \
        -v $sharedNpmCache:/npm_cache \
        -e npm_config_cache=/npm_cache \
        -e PUPPETEER_SKIP_DOWNLOAD=1 \
        -w /app \
        node:22-alpine \
        sh -c '$installCmd'");
});

// Restart Docker containers (entrypoint gère migrations + cache:warmup automatiquement)
// Le cache est regénéré par l'entrypoint AVANT que FrankenPHP ne démarre,
// ce qui évite la race condition entre FrankenPHP et un docker exec concurrent.
desc('Restart Docker containers');
task('docker:restart', function () {
    run('docker restart mangarr-worker-commands mangarr-worker-events mangarr-worker-scheduler');
    run('docker restart mangarr');
});

// Pas de PHP sur l'hôte : désactiver les tâches Symfony qui en ont besoin
// Le cache et les migrations sont gérés par l'entrypoint.sh au démarrage du container
task('deploy:cache:clear', function () {});
task('deploy:cache:warmup', function () {});

// Hooks
after('deploy:update_code', 'deploy:prepare_dirs');
after('deploy:prepare_dirs', 'deploy:copy_dirs');
after('deploy:vendors', 'webpack_encore:build');
after('deploy:symlink', 'docker:restart');
after('deploy:failed', 'deploy:unlock');