Ergänze Deploy-Gerüst und verweise die Agentenregeln auf CLAUDE.md.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
ec009a187b
commit
89b35ac480
18 files changed
+880
No files matched your search
@@ -0,0 +1,153 @@
|
||||
#!/usr/bin/env bash
|
||||
# LUF-Deploy. Wird vom Gitea-Workflow aufgerufen, nachdem APP_DIR auf den getesteten Commit steht.
|
||||
# Ablauf: Konfiguration prüfen -> Portprüfung -> Build -> DB starten -> Migration -> Start -> Health.
|
||||
# Schlägt ein Schritt fehl, wird auf den zuletzt erfolgreichen Image-Tag zurückgesetzt (Code, nicht Migrationen).
|
||||
#
|
||||
# Erwartete Variablen (setzt der Workflow):
|
||||
# LUF_ENV test | prod
|
||||
# APP_DIR Deploy-Verzeichnis (Git-Checkout)
|
||||
# ENV_FILE Env-Datei außerhalb des Repos (/etc/luf/<env>.env)
|
||||
# COMPOSE_PROJECT Compose-Projektname (luf-test | luf-prod)
|
||||
# WEB_PORT Host-Port des Web-Containers
|
||||
set -euo pipefail
|
||||
|
||||
: "${LUF_ENV:?LUF_ENV fehlt}" "${APP_DIR:?APP_DIR fehlt}" "${ENV_FILE:?ENV_FILE fehlt}"
|
||||
: "${COMPOSE_PROJECT:?COMPOSE_PROJECT fehlt}" "${WEB_PORT:?WEB_PORT fehlt}"
|
||||
|
||||
case "$LUF_ENV" in
|
||||
test|prod) ;;
|
||||
*) echo "✗ LUF_ENV=$LUF_ENV, erlaubt: test | prod"; exit 1 ;;
|
||||
esac
|
||||
|
||||
# Ein Deploy gleichzeitig pro Host (Build braucht RAM, Ports und Images werden gemeinsam genutzt).
|
||||
exec 9>/tmp/luf-deploy.lock
|
||||
flock -w 1200 9 || { echo "✗ Deploy-Sperre nach 20 min nicht erhalten"; exit 1; }
|
||||
|
||||
cd "$APP_DIR"
|
||||
LUF_TAG="$(git rev-parse --short=12 HEAD)"
|
||||
PREV_TAG="$(cat .last_good_tag 2>/dev/null || true)"
|
||||
export LUF_ENV LUF_TAG LUF_ENV_FILE="$ENV_FILE" LUF_WEB_PORT="$WEB_PORT"
|
||||
|
||||
dc() {
|
||||
docker compose -p "$COMPOSE_PROJECT" -f docker-compose.yml --env-file "$ENV_FILE" "$@"
|
||||
}
|
||||
|
||||
env_value() {
|
||||
grep -E "^$1=" "$ENV_FILE" | tail -1 | cut -d= -f2- | tr -d "\"'" || true
|
||||
}
|
||||
|
||||
# --- 1. Konfiguration prüfen (keine Werte ausgeben) --------------------------------------------
|
||||
if [ ! -r "$ENV_FILE" ]; then
|
||||
echo "✗ $ENV_FILE fehlt oder ist nicht lesbar."; exit 1
|
||||
fi
|
||||
for var in APP_KEY APP_URL DB_DATABASE DB_USERNAME DB_PASSWORD; do
|
||||
if [ -z "$(env_value "$var")" ]; then
|
||||
echo "✗ $var ist in $ENV_FILE nicht gesetzt."; exit 1
|
||||
fi
|
||||
done
|
||||
app_env="$(env_value APP_ENV)"
|
||||
if [ "$LUF_ENV" = prod ]; then
|
||||
[ "$app_env" = production ] || { echo "✗ Prod braucht APP_ENV=production."; exit 1; }
|
||||
[ "$(env_value APP_DEBUG)" = false ] || { echo "✗ Prod braucht APP_DEBUG=false."; exit 1; }
|
||||
else
|
||||
[ "$app_env" != production ] || { echo "✗ Test darf nicht APP_ENV=production haben."; exit 1; }
|
||||
fi
|
||||
echo "✓ $ENV_FILE geprüft ($LUF_ENV, Tag $LUF_TAG, vorheriger Tag ${PREV_TAG:-keiner})"
|
||||
|
||||
# --- 1b. Medien-Ablage (NFS-Mount vom NAS) -----------------------------------------------------
|
||||
# Pfad ist fest an die Umgebung gebunden: Test kann nie auf den Prod-Bestand zeigen.
|
||||
MEDIA_HOST="/srv/luf/$LUF_ENV/media"
|
||||
media_env="$(env_value LUF_MEDIA_HOST)"
|
||||
if [ -n "$media_env" ] && [ "$media_env" != "$MEDIA_HOST" ]; then
|
||||
echo "✗ LUF_MEDIA_HOST in $ENV_FILE weicht von $MEDIA_HOST ab."; exit 1
|
||||
fi
|
||||
export LUF_MEDIA_HOST="$MEDIA_HOST"
|
||||
# Zugriff löst den automount aus; timeout, weil der Mount hart ist und bei NAS-Ausfall hängen würde.
|
||||
timeout 30 ls "$MEDIA_HOST" >/dev/null 2>&1 || { echo "✗ $MEDIA_HOST nicht erreichbar (NAS/NFS-Mount prüfen)."; exit 1; }
|
||||
if ! findmnt -n -t nfs4 -M "$MEDIA_HOST" >/dev/null; then
|
||||
echo "✗ $MEDIA_HOST ist kein NFS-Mount. Es werden keine Medien auf die lokale Platte geschrieben."; exit 1
|
||||
fi
|
||||
for d in originals derived public; do
|
||||
[ -d "$MEDIA_HOST/$d" ] || timeout 30 mkdir -p "$MEDIA_HOST/$d" || { echo "✗ $MEDIA_HOST/$d fehlt und lässt sich nicht anlegen."; exit 1; }
|
||||
done
|
||||
echo "✓ Medien: $MEDIA_HOST (NFS), originals/derived/public vorhanden"
|
||||
|
||||
# --- 2. Portkonflikt: Port darf nur von diesem Projekt belegt sein -----------------------------
|
||||
if ss -ltnH "sport = :$WEB_PORT" | grep -q .; then
|
||||
if [ -z "$(dc ps -q web 2>/dev/null)" ]; then
|
||||
echo "✗ Host-Port $WEB_PORT ist von einem fremden Dienst belegt. Abbruch."; exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
wait_for_db() {
|
||||
local i status
|
||||
for i in $(seq 1 40); do
|
||||
status="$(docker inspect -f '{{.State.Health.Status}}' "$(dc ps -q db)" 2>/dev/null || true)"
|
||||
[ "$status" = healthy ] && return 0
|
||||
sleep 3
|
||||
done
|
||||
echo "✗ Datenbank nicht healthy"; return 1
|
||||
}
|
||||
|
||||
wait_for_web() {
|
||||
local i
|
||||
for i in $(seq 1 60); do
|
||||
if curl -sf -o /dev/null "http://127.0.0.1:$WEB_PORT/up"; then
|
||||
echo "✓ /up antwortet (http://127.0.0.1:$WEB_PORT/up)"; return 0
|
||||
fi
|
||||
sleep 3
|
||||
done
|
||||
echo "✗ /up nicht erreichbar"; return 1
|
||||
}
|
||||
|
||||
deploy() {
|
||||
echo "=== LUF $LUF_ENV: Build $LUF_TAG ==="
|
||||
dc build app web || return 1
|
||||
# Schreibprobe als www-data (echte UID im Container) auf den Medienordnern der Hintergrundverarbeitung.
|
||||
dc run --rm --no-deps -T queue sh -c 'for d in originals derived public; do f=/media/$d/.write-test-$$; touch "$f" && rm "$f" || exit 1; done' || { echo "✗ Schreibprobe auf /media fehlgeschlagen (NFS-Rechte/Squash auf dem NAS prüfen)"; return 1; }
|
||||
echo "✓ Schreibprobe auf /media bestanden"
|
||||
dc up -d db || return 1
|
||||
wait_for_db || return 1
|
||||
echo "=== Migrationen ==="
|
||||
dc run --rm --no-deps -T app php artisan migrate --force || return 1
|
||||
echo "=== Start ==="
|
||||
dc up -d --remove-orphans || return 1
|
||||
wait_for_web || return 1
|
||||
# Die App muss die Datenbank wirklich erreichen, nicht nur Nginx antworten lassen.
|
||||
dc exec -T app php artisan migrate:status >/dev/null || { echo "✗ App erreicht die Datenbank nicht"; return 1; }
|
||||
echo "✓ App erreicht die Datenbank"
|
||||
}
|
||||
|
||||
rollback() {
|
||||
if [ -z "$PREV_TAG" ] || [ "$PREV_TAG" = "$LUF_TAG" ]; then
|
||||
echo "✗ Kein Rollback möglich (kein früherer Stand bekannt)."; return 1
|
||||
fi
|
||||
for img in "luf-app-$LUF_ENV:$PREV_TAG" "luf-web-$LUF_ENV:$PREV_TAG"; do
|
||||
docker image inspect "$img" >/dev/null 2>&1 || { echo "✗ Rollback-Image $img fehlt."; return 1; }
|
||||
done
|
||||
echo "=== Rollback auf $PREV_TAG (Datenbank-Migrationen werden nicht zurückgenommen) ==="
|
||||
export LUF_TAG="$PREV_TAG"
|
||||
dc up -d --no-build --remove-orphans || return 1
|
||||
wait_for_web
|
||||
}
|
||||
|
||||
prune_images() {
|
||||
local repo
|
||||
for repo in "luf-app-$LUF_ENV" "luf-web-$LUF_ENV"; do
|
||||
docker image ls "$repo" --format '{{.Tag}}' \
|
||||
| grep -v -x -e "$LUF_TAG" -e "${PREV_TAG:-none}" | tail -n +3 \
|
||||
| xargs -r -I{} docker rmi "$repo:{}" >/dev/null 2>&1 || true
|
||||
done
|
||||
}
|
||||
|
||||
if deploy; then
|
||||
echo "$LUF_TAG" > .last_good_tag
|
||||
prune_images
|
||||
echo "=== LUF $LUF_ENV Deploy abgeschlossen ($LUF_TAG) ==="
|
||||
else
|
||||
echo "✗ Deploy fehlgeschlagen. Zustand:"
|
||||
dc ps || true
|
||||
dc logs --tail 80 app web || true
|
||||
rollback || true
|
||||
exit 1
|
||||
fi
|
||||
Reference in new issue
Block a user