lumina-nextjs-template/.claude/commands/deploy.md

Deployment Assistent

Du bist ein Experte für das Deployment von Next.js Anwendungen mit Docker und Kubernetes.

Deployment Optionen

1. Lokales Development

# Dependencies installieren
pnpm install

# Environment Variables
cp .env.example .env.local
# .env.local bearbeiten

# Development Server starten
pnpm dev

2. Docker Deployment

Docker Image bauen

# Production Image bauen
docker build -t lumina-app:latest .

# Mit spezifischem Tag
docker build -t lumina-app:v1.0.0 .

# Lokaler Test
docker run -p 3000:3000 --env-file .env.local lumina-app:latest

Docker Compose (empfohlen für lokales Testing)

# Alle Services starten
docker-compose up -d

# Logs ansehen
docker-compose logs -f app

# Services stoppen
docker-compose down

# Mit Volume Cleanup
docker-compose down -v

3. Harbor Registry

# Bei Harbor einloggen
docker login harbor.advisori.de

# Image taggen
docker tag lumina-app:latest harbor.advisori.de/lumina/PROJECT_ID:latest
docker tag lumina-app:latest harbor.advisori.de/lumina/PROJECT_ID:v1.0.0

# Pushen
docker push harbor.advisori.de/lumina/PROJECT_ID:latest
docker push harbor.advisori.de/lumina/PROJECT_ID:v1.0.0

4. Kubernetes Deployment

Voraussetzungen

# Namespace erstellen
kubectl create namespace lumina-apps

# Harbor Pull Secret
kubectl create secret docker-registry harbor-registry-secret \
  --docker-server=harbor.advisori.de \
  --docker-username=YOUR_USERNAME \
  --docker-password=YOUR_PASSWORD \
  --namespace=lumina-apps

# Application Secrets
kubectl create secret generic app-secrets \
  --from-literal=DATABASE_URL="postgresql://..." \
  --from-literal=SUPABASE_URL="https://..." \
  --from-literal=SUPABASE_ANON_KEY="..." \
  --from-literal=SUPABASE_SERVICE_ROLE_KEY="..." \
  --namespace=lumina-apps

Helm Deployment

# In das Helm Chart Verzeichnis wechseln
cd helm/lumina-app

# Dry-run zum Testen
helm upgrade --install app . \
  --namespace lumina-apps \
  --set image.repository=harbor.advisori.de/lumina/PROJECT_ID \
  --set image.tag=latest \
  --dry-run

# Tatsächliches Deployment
helm upgrade --install app . \
  --namespace lumina-apps \
  --set image.repository=harbor.advisori.de/lumina/PROJECT_ID \
  --set image.tag=v1.0.0 \
  --set ingress.hosts[0].host=app.advisori.de \
  --set ingress.tls[0].hosts[0]=app.advisori.de

# Status prüfen
helm status app -n lumina-apps

Kubectl Management

# Pods anzeigen
kubectl get pods -n lumina-apps

# Logs ansehen
kubectl logs -f deployment/app -n lumina-apps

# In Pod exec
kubectl exec -it deployment/app -n lumina-apps -- /bin/sh

# Restart Deployment
kubectl rollout restart deployment/app -n lumina-apps

# Rollback
helm rollback app -n lumina-apps

5. CI/CD Pipeline (Gitea Actions)

# .gitea/workflows/deploy.yml
name: Build and Deploy

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Login to Harbor
        uses: docker/login-action@v3
        with:
          registry: harbor.advisori.de
          username: ${{ secrets.HARBOR_USERNAME }}
          password: ${{ secrets.HARBOR_PASSWORD }}

      - name: Build and Push
        uses: docker/build-push-action@v5
        with:
          push: true
          tags: |
            harbor.advisori.de/lumina/${{ github.event.repository.name }}:latest
            harbor.advisori.de/lumina/${{ github.event.repository.name }}:${{ github.sha }}

  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to K8s
        uses: azure/k8s-deploy@v4
        with:
          namespace: lumina-apps
          manifests: helm/lumina-app
          images: harbor.advisori.de/lumina/${{ github.event.repository.name }}:${{ github.sha }}

Troubleshooting

Container startet nicht

# Pod Status
kubectl describe pod POD_NAME -n lumina-apps

# Container Logs
kubectl logs POD_NAME -n lumina-apps --previous

Ingress funktioniert nicht

# Ingress Status
kubectl get ingress -n lumina-apps

# Ingress Details
kubectl describe ingress app -n lumina-apps

Health Check Fehler

# Health Endpoint testen
kubectl port-forward svc/app 3000:80 -n lumina-apps
curl http://localhost:3000/api/health

Environment Variables Checkliste

Variable	Beschreibung	Erforderlich
NODE_ENV	production	Ja
NEXT_PUBLIC_SUPABASE_URL	Supabase URL	Ja
NEXT_PUBLIC_SUPABASE_ANON_KEY	Anon Key	Ja
SUPABASE_SERVICE_ROLE_KEY	Service Key	Ja
DATABASE_URL	PostgreSQL URL	Optional

---

Frage den Benutzer: Wie möchtest du deployen?

• Lokal mit Docker Compose
• Auf Kubernetes Cluster
• CI/CD Pipeline einrichten