AFC-Demo/terraform/DEPLOYMENT_CHECKLIST.md

✅ Deployment Checklist

Diese Checkliste führt dich Schritt-für-Schritt durch das erste Deployment.

📋 Pre-Deployment

1. Lokale Umgebung

• Terraform >= 1.9.0 installiert
• Azure CLI >= 2.0 installiert
• kubectl >= 1.28 installiert
• Docker >= 20.10 installiert
• PHP >= 8.2 installiert (für Laravel-Befehle)

Prüfen:

terraform version
az version
kubectl version
docker version
php -v

2. Azure Zugriff

• Azure Account vorhanden
• Subscription ID bekannt: 77677a80-2dea-493d-9867-f1c961b80fb3
• Zugriff auf Resource Group: trusted_ai_demo_rg
• Zugriff auf AKS Cluster: trai_k8s_cluster

Prüfen:

az login
az account set --subscription "77677a80-2dea-493d-9867-f1c961b80fb3"
az account show
az aks show --resource-group trusted_ai_demo_rg --name trai_k8s_cluster

🔧 Setup

3. Azure Container Registry

• ACR erstellt oder vorhanden
• ACR Name: mylaravelregistry (oder eigener Name)
• AKS hat Pull-Berechtigung für ACR

Erstellen:

# ACR erstellen (falls noch nicht vorhanden)
az acr create \
  --resource-group trusted_ai_demo_rg \
  --name mylaravelregistry \
  --sku Basic \
  --location germanywestcentral

# AKS Zugriff geben
az aks update \
  --resource-group trusted_ai_demo_rg \
  --name trai_k8s_cluster \
  --attach-acr mylaravelregistry

# Login
az acr login --name mylaravelregistry

4. Docker Image

• Docker Image gebaut
• Docker Image zu ACR gepusht
• Image Tag notiert

Bauen & Pushen:

cd /Users/sebastianfrohlich/Herd/frontend

# Bauen
docker build -t mylaravelregistry.azurecr.io/laravel-app:v1.0.0 .

# Pushen
docker push mylaravelregistry.azurecr.io/laravel-app:v1.0.0

# Image Tag notieren:
IMAGE_TAG="mylaravelregistry.azurecr.io/laravel-app:v1.0.0"

5. Laravel Konfiguration

• APP_KEY generiert
• APP_KEY notiert

Generieren:

cd /Users/sebastianfrohlich/Herd/frontend
php artisan key:generate --show

# Output: base64:xyz...
# Notieren für terraform.tfvars

6. Backup-Dateien

• Database Backup vorhanden
• Backup-Pfad notiert

Prüfen:

ls -lh /Users/sebastianfrohlich/Herd/frontend/backups/

# Wähle ein Backup, z.B.:
BACKUP_FILE="../backups/backup_backend_20251203_101741.dump"

⚙️ Terraform Konfiguration

7. terraform.tfvars erstellen

• terraform.tfvars aus Example kopiert
• Alle erforderlichen Werte eingetragen

Erstellen:

cd /Users/sebastianfrohlich/Herd/frontend/terraform
cp terraform.tfvars.example terraform.tfvars
nano terraform.tfvars

Erforderliche Werte:

# ✅ Docker Image
docker_image = "mylaravelregistry.azurecr.io/laravel-app:v1.0.0"

# ✅ Laravel APP_KEY
app_key = "base64:YOUR_GENERATED_KEY_HERE"

# ✅ PostgreSQL Admin Password (sicher wählen!)
postgresql_admin_password = "YourVerySecurePassword123!"

# ✅ Alert Email
alert_email_address = "your-email@example.com"

# ✅ Database Restore (beim ersten Deployment)
db_restore_enabled = true
db_backup_file_path = "../backups/backup_backend_20251203_101741.dump"

Optionale Werte:

# Für Custom Domain
ingress_host = "app.yourdomain.com"

# Für SSL/TLS (benötigt Domain)
ssl_enabled = true
ssl_issuer_email = "admin@yourdomain.com"

# Ressourcen anpassen
app_replicas = 2
postgresql_sku_name = "B_Standard_B1ms"

8. Konfiguration validieren

• terraform.tfvars Syntax korrekt
• Alle Secrets/Passwörter sicher
• Backup-Pfad korrekt

Prüfen:

cd terraform

# Terraform init
terraform init

# Validate
terraform validate

# Sollte ausgeben: Success! The configuration is valid.

🚀 Deployment

9. Deployment ausführen

Option A: Automatisches Script (Empfohlen)

• Deploy-Script ausgeführt

cd /Users/sebastianfrohlich/Herd/frontend/terraform
./scripts/deploy.sh

Das Script führt automatisch aus:

1. ✅ Prerequisite Check
2. ✅ Azure Login Status
3. ✅ terraform.tfvars Check
4. ✅ Docker Image Check
5. ✅ APP_KEY Check
6. ✅ terraform init
7. ✅ terraform validate
8. ✅ terraform plan
9. ✅ terraform apply (nach Bestätigung)
10. ✅ kubectl konfigurieren
11. ✅ Pod Status prüfen

Option B: Manuell

• Terraform Plan erstellt
• Plan überprüft
• Terraform Apply ausgeführt

cd terraform

# Plan
terraform plan -out=tfplan

# Plan überprüfen
# Sollte Resources anzeigen: +XX to add, ~0 to change, -0 to destroy

# Apply
terraform apply tfplan

# Outputs anzeigen
terraform output
terraform output deployment_instructions

10. kubectl konfigurieren

• kubectl Credentials abgerufen
• Cluster-Zugriff getestet

az aks get-credentials \
  --resource-group trusted_ai_demo_rg \
  --name trai_k8s_cluster \
  --overwrite-existing

# Testen
kubectl get nodes
kubectl get namespaces

🔄 Database Restore

11. Datenbank wiederherstellen

Option A: Automatisches Script (Empfohlen)

• Restore-Script ausgeführt
• Job Status geprüft

cd /Users/sebastianfrohlich/Herd/frontend/terraform
./scripts/restore-db.sh

# Script fragt nach:
# - Welches Backup-File?
# - Bestätigung: yes
# Zeigt dann Logs und Status

Option B: Via Terraform

• db_restore_enabled = true in terraform.tfvars
• terraform apply ausgeführt

# In terraform.tfvars:
db_restore_enabled = true
db_backup_file_path = "../backups/backup_backend_20251203_101741.dump"

# Apply
terraform apply

# Job Status prüfen
kubectl get jobs -n laravel-app
kubectl logs -n laravel-app -l job-type=database-restore -f

✅ Post-Deployment Checks

12. Infrastruktur Status

• Pods sind running
• Service ist erreichbar
• Ingress hat External IP
• Database ist connected

Prüfen:

# Pods
kubectl get pods -n laravel-app
# Sollte: 2/2 Running anzeigen

# Service
kubectl get svc -n laravel-app

# Ingress
kubectl get svc ingress-nginx-controller -n ingress-nginx
# Sollte: EXTERNAL-IP anzeigen (dauert 5-10 Min)

# Database
kubectl get secret laravel-app-db-credentials -n laravel-app

13. Application Health

• Application ist erreichbar
• HTTP Status 200 oder 302
• Keine Fehler in Logs

Prüfen:

# URL abrufen
terraform output app_url

# Beispiel Output: http://20.79.123.456

# Im Browser öffnen oder:
curl -I http://20.79.123.456

# Sollte: HTTP/1.1 200 OK oder 302 Found

# Logs prüfen
kubectl logs -n laravel-app -l app=laravel-app -f

# Sollte: Keine Errors zeigen

14. Database Connectivity

• Database Restore Job completed
• Laravel kann auf DB zugreifen

Prüfen:

# Restore Job Status
kubectl get jobs -n laravel-app
# Sollte: db-restore-* mit COMPLETIONS 1/1

# Job Logs
kubectl logs -n laravel-app -l job-type=database-restore

# Sollte: "Database restore completed successfully!" enthalten

# Laravel Migrations Status (in Pod)
POD_NAME=$(kubectl get pods -n laravel-app -l app=laravel-app -o jsonpath='{.items[0].metadata.name}')
kubectl exec -it -n laravel-app $POD_NAME -- php artisan migrate:status

# Sollte: Migration table anzeigen

🎯 Finalisierung

15. Monitoring Setup

• Azure Monitor funktioniert
• Alert Rules aktiv
• Email Alerts konfiguriert

Prüfen:

# Azure Portal öffnen
open https://portal.azure.com

# Gehe zu:
# 1. Resource Group: trusted_ai_demo_rg
# 2. AKS Cluster: trai_k8s_cluster
# 3. Monitoring > Insights

# Alert Rules prüfen:
az monitor metrics alert list \
  --resource-group trusted_ai_demo_rg

16. Dokumentation

• LoadBalancer IP notiert
• Database Connection String notiert
• Terraform Outputs gespeichert

Notieren:

# Alle Outputs anzeigen
terraform output

# Spezifische Outputs
terraform output app_url
terraform output postgresql_server_fqdn
terraform output postgresql_connection_string

# In Passwort-Manager oder sicheren Ort speichern!

17. Cleanup & Security

• Sensitive Dateien nicht committed (terraform.tfvars)
• Passwörter sicher gespeichert
• .gitignore überprüft

Prüfen:

# Git Status
git status

# Sollte NICHT enthalten:
# - terraform.tfvars
# - *.tfstate
# - kubeconfig

# Falls vorhanden:
git rm --cached terraform/terraform.tfvars
git rm --cached terraform/*.tfstate

🚦 Success Criteria

Deployment ist erfolgreich wenn:

• ✅ kubectl get pods -n laravel-app zeigt 2/2 Running
• ✅ terraform output app_url zeigt eine URL
• ✅ URL im Browser ist erreichbar
• ✅ Database Restore Job ist completed
• ✅ Keine Fehler in Pod Logs
• ✅ Ingress hat External IP

🎉 Fertig!

Deine Laravel-Anwendung läuft jetzt auf Azure Kubernetes Service!

Nächste Schritte:

1. Testen: Funktionalität der Anwendung testen
2. Monitoring: Azure Monitor regelmäßig prüfen
3. Backups: PostgreSQL Backup-Strategy überprüfen
4. Domain: Custom Domain konfigurieren (optional)
5. SSL: Let's Encrypt aktivieren (optional)
6. CI/CD: GitHub Actions einrichten (optional)

Wichtige Commands:

# Status prüfen
kubectl get all -n laravel-app

# Logs anzeigen
kubectl logs -n laravel-app -l app=laravel-app -f

# Shell in Pod
kubectl exec -it -n laravel-app <pod-name> -- /bin/sh

# Port-forward für lokalen Zugriff
kubectl port-forward -n laravel-app svc/laravel-app 8080:80

# Terraform Outputs
terraform output deployment_instructions

📞 Support

Bei Problemen:

1. Troubleshooting Guide: README.md#troubleshooting
2. Kubernetes Events: kubectl get events -n laravel-app --sort-by='.lastTimestamp'
3. Pod Logs: kubectl logs -n laravel-app <pod-name>
4. Terraform State: terraform show

---

Deployment Time: ~30 Minuten Status: ✅ Ready for Production