presseportale/dev/git-deploy-monitoring/vorlagen/deploy.sh

#!/usr/bin/env bash
#
# Deploy eines Git-Tags auf Live — Vorlage aus dev/git-deploy-monitoring
# (Anleitung: 01-git-deploy.md). Im Projekt z. B. als dev/betrieb/deploy.sh
# ablegen; Pfad und Einstellungen im Block „Projekt-Einstellungen“ anpassen.
#
# Aufruf im App-Verzeichnis auf dem Server:
#
#   cd ~/meine-app.de
#   bash dev/betrieb/deploy.sh v1.2.0                  # ohne neue Migrationen
#   bash dev/betrieb/deploy.sh v1.2.0 --migrations     # mit Migrationen, DB-Backup vorher!
#
# Optionen:
#   --migrations       Neue Migrationen ausführen. Ohne diese Option bricht das
#                      Skript ab, sobald der Tag neue Migrationen mitbringt.
#   --clear-schedule   php artisan schedule:clear-cache (alte withoutOverlapping-Sperren).
#
# Umgebung (optional):
#   DEPLOY_FPM_RELOAD  Befehl zum Neuladen von PHP-FPM (Standard siehe unten).
#                      Leer setzen, wenn FPM von Hand im Server-Panel neu geladen
#                      wird — dann wartet das Skript auf Enter. Nie „Restart“:
#                      der entfernt kurz den Socket, Nginx liefert 502.
#
# Exit-Codes: 0 fertig, 1 abgebrochen (siehe Ausgabe), 2 falscher Aufruf,
# 3 live, aber kein Queue-Worker hat den Test-Job abgeholt.
#
# Rollback: dasselbe Skript mit dem vorherigen Tag.

set -euo pipefail

# ---- Projekt-Einstellungen --------------------------------------------------
DEPLOY_SCRIPT="dev/betrieb/deploy.sh"   # Pfad dieses Skripts im Repository
PHP_FPM_SERVICE="php8.4-fpm"            # systemd-Name des FPM-Dienstes
ABOUT_SECTION=""                        # z. B. "meineapp" (AboutCommand::add), leer = RELEASE ausgeben
QUEUE_PROBE=1                           # 1 = monitoring:queue-probe am Ende, 0 = Projekt ohne Queue
# -----------------------------------------------------------------------------

# Git ersetzt diese Datei beim Checkout. Bash liest Skripte stückweise, deshalb
# läuft der Deploy aus einer Kopie.
if [[ -z "${DEPLOY_COPY:-}" ]]; then
    copy="$(mktemp)"
    cp "$0" "$copy"
    DEPLOY_COPY="$copy" exec bash "$copy" "$@"
fi
trap 'rm -f "$DEPLOY_COPY"' EXIT

tag="${1:-}"
shift || true
run_migrations=0
clear_schedule=0

for option in "$@"; do
    case "$option" in
        --migrations) run_migrations=1 ;;
        --clear-schedule) clear_schedule=1 ;;
        *) echo "Unbekannte Option: $option" >&2; exit 2 ;;
    esac
done

if [[ ! "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
    echo "Aufruf: bash $DEPLOY_SCRIPT vX.Y.Z [--migrations] [--clear-schedule]" >&2
    exit 2
fi

if [[ ! -f artisan || ! -d .git ]]; then
    echo "Im App-Verzeichnis aufrufen (artisan und .git fehlen hier)." >&2
    exit 2
fi

step() { printf '\n==> %s\n' "$*"; }

step "Arbeitsverzeichnis prüfen"
drift="$(git status --porcelain)"
if [[ -n "$drift" ]]; then
    echo "Das Arbeitsverzeichnis weicht vom ausgecheckten Stand ab:" >&2
    echo "$drift" >&2
    echo "Erst klären (git diff), dann deployen. Nichts wurde verändert." >&2
    exit 1
fi

step "Tags von origin holen"
git fetch --quiet --tags origin

if ! git rev-parse --quiet --verify "refs/tags/$tag^{commit}" > /dev/null; then
    echo "Tag $tag gibt es auf origin nicht." >&2
    exit 1
fi

previous="$(cat RELEASE 2>/dev/null || git describe --tags --always)"
echo "Live: $previous  →  Ziel: $tag"

if [[ "$(git rev-parse HEAD)" == "$(git rev-parse "$tag^{commit}")" ]]; then
    echo "$tag ist bereits ausgecheckt. Nichts zu tun."
    exit 0
fi

new_migrations="$(git diff --name-only --diff-filter=A HEAD "$tag" -- database/migrations)"
if [[ -n "$new_migrations" ]]; then
    echo "Neue Migrationen:"
    echo "$new_migrations" | sed 's/^/  /'
    if [[ "$run_migrations" -ne 1 ]]; then
        echo "Abbruch: DB-Backup ziehen und mit --migrations erneut aufrufen. Nichts wurde verändert." >&2
        exit 1
    fi
fi

trap 'echo; echo "!! Deploy abgebrochen. Die Seite bleibt im Wartungsmodus." >&2; echo "!! Rollback: bash $DEPLOY_SCRIPT $previous" >&2; rm -f "$DEPLOY_COPY"' ERR

step "Wartungsmodus"
php artisan down --retry=60

step "Checkout $tag"
git checkout --quiet --detach "$tag"
echo "$tag" > RELEASE

step "Composer"
composer install --no-dev --optimize-autoloader --no-interaction

if [[ -n "$new_migrations" ]]; then
    step "Migrationen"
    php artisan migrate --force
fi

if [[ -d public/vendor/livewire ]]; then
    php artisan vendor:publish --tag=livewire:assets --force
fi

step "Caches"
php artisan config:cache
php artisan route:cache
php artisan view:clear
php artisan view:cache
php artisan event:cache

if [[ "$clear_schedule" -eq 1 ]]; then
    php artisan schedule:clear-cache
fi

step "Worker und PHP-FPM"
php artisan queue:restart
default_fpm_reload="echo '' | sudo -S service $PHP_FPM_SERVICE reload"
fpm_reload="${DEPLOY_FPM_RELOAD-$default_fpm_reload}"
if [[ -n "$fpm_reload" ]]; then
    bash -c "$fpm_reload"
else
    echo "PHP-FPM jetzt im Server-Panel neu laden (Reload, nicht Restart), danach Enter."
    read -r
fi

step "Wartungsmodus aus"
php artisan up

step "Version"
if [[ -n "$ABOUT_SECTION" ]]; then
    php artisan about --only="$ABOUT_SECTION"
else
    cat RELEASE
fi

trap - ERR

# Läuft ein Worker? `queue:restart` oben beendet ihn; neu starten muss ihn
# Supervisor. Läuft Supervisor nicht, steht die Queue still, ohne dass es
# jemand merkt.
if [[ "$QUEUE_PROBE" -eq 1 ]]; then
    step "Queue-Worker"
    if ! php artisan monitoring:queue-probe --wait=60; then
        echo
        echo "!! Deploy $tag ist live, aber KEIN Queue-Worker läuft." >&2
        echo "!! Jetzt Supervisor und den Worker im Server-Panel prüfen — sonst bleiben Jobs und Mails liegen." >&2
        exit 3
    fi
fi

echo
echo "Deploy $tag fertig (vorher $previous). Weiter mit den Prüfungen aus der Deploy-Anleitung."