Versioning, déploiement et mise à jour automatique

Gestion des versions :
- Fichier VERSION (1.0.0) comme source de vérité
- config/update.php : URL Gitea, AUTO_UPDATE (false par défaut), rétention des sauvegardes

Artisan commands :
- app:check-update  : interroge l'API Gitea, cache Redis 1h, déclenche app:update si AUTO_UPDATE=true
- app:update        : télécharge l'archive, sauvegarde pg_dump, rsync, composer install, migrate, reload php-fpm
- app:rollback      : liste les sauvegardes et restaure via psql

UpdateService :
- Téléchargement via Http::sink() (streaming, pas de charge mémoire)
- Sauvegarde pg_dump dans storage/app/backups/ avant chaque mise à jour
- Rechargement php-fpm gracieux (kill -USR2 1) sans downtime
- Purge automatique des anciennes sauvegardes (configurable)

Docker (refactor pour volume-mount) :
- Dockerfile : runtime seulement (PHP + extensions + composer + rsync + pg_client)
  Le code n'est plus copié dans l'image → les mises à jour ne nécessitent pas de rebuild
- entrypoint.sh : composer install + key:generate + caches au démarrage du container
- docker-compose.prod.yml : montage du code comme volume (.:/var/www/html)

Scripts de déploiement :
- bin/build-release.sh : rsync + tar.gz + sha256, exclut vendor/node_modules/tests
- install.sh : guide d'installation Docker complète (première mise en service)

Interface admin :
- Bandeau "mise à jour disponible" dans le dashboard admin (version courante + cible)
- Badge version + icône "à jour" en pied de tableau de bord
- Commande à copier-coller pour appliquer depuis le container

Planification :
- routes/console.php : Schedule::command('app:check-update')->daily()
- .env.example : variables GITEA_*, AUTO_UPDATE, UPDATE_BACKUPS_TO_KEEP

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-06-04 17:38:39 +02:00
parent c790691200
commit ba7fe10329
15 changed files with 756 additions and 23 deletions
@@ -0,0 +1,60 @@
<?php
namespace App\Console\Commands;
use App\Services\UpdateService;
use Illuminate\Console\Command;
class ApplyUpdateCommand extends Command
{
protected $signature = 'app:update
{--force : Pas de confirmation interactive}
{--check : Vérifie uniquement, sans appliquer}';
protected $description = 'Télécharge et applique la dernière mise à jour disponible';
public function handle(UpdateService $updates): int
{
$installed = $updates->getInstalledVersion();
$this->line("Version installée : <info>v{$installed}</info>");
$this->line("Vérification des mises à jour...");
$latest = $updates->fetchLatestRelease(useCache: false);
if (! $latest) {
$this->error("Impossible de contacter le serveur de mises à jour.");
return self::FAILURE;
}
if (! version_compare($latest['version'], $installed, '>')) {
$this->info("L'application est déjà à jour (v{$installed}).");
return self::SUCCESS;
}
$this->info("Mise à jour disponible : v{$installed} → <comment>v{$latest['version']}</comment>");
if ($latest['body']) {
$this->line($latest['body']);
}
if ($this->option('check')) {
return self::SUCCESS;
}
if (! $this->option('force') && ! $this->confirm('Procéder à la mise à jour ?', true)) {
return self::SUCCESS;
}
$this->line("");
try {
$updates->applyUpdate($latest, fn ($msg) => $this->line($msg));
} catch (\Exception $e) {
$this->error("La mise à jour a échoué : " . $e->getMessage());
$this->warn("Vérifiez les sauvegardes dans storage/app/backups/ pour une restauration manuelle.");
return self::FAILURE;
}
return self::SUCCESS;
}
}