CD Pipeline mit Self-Hosted GitHub Actions Runner

Infrastruktur-Tag mit 6 Commits für die Deployment-Pipeline:

• CD Pipeline - GitHub Actions mit self-hosted Runner
• Auto-Deploy - Automatisches Deployment bei Push auf main
• SSH Setup - Dokumentation für Mac Mini Runner
• Docker Fixes - PATH und Dockerfile-Korrekturen

CD Pipeline: Self-Hosted GitHub Actions Runner

Continuous Deployment direkt auf dem Mac Mini Production Server via self-hosted GitHub Actions Runner.

Architektur

┌──────────────────────────────────────────────────────┐
│  GitHub Repository                                    │
│  Push to main                                         │
└──────────────────────┬───────────────────────────────┘
                       │ Webhook
                       ▼
┌──────────────────────────────────────────────────────┐
│  Mac Mini (mana.how)                                  │
│                                                       │
│  ┌─────────────────────────────────┐                 │
│  │  GitHub Actions Runner          │                 │
│  │  (self-hosted, always-on)       │                 │
│  └────────────────┬────────────────┘                 │
│                   │                                   │
│                   ▼                                   │
│  ┌─────────────────────────────────┐                 │
│  │  Deploy Script                  │                 │
│  │  1. git pull                    │                 │
│  │  2. pnpm install                │                 │
│  │  3. docker compose build        │                 │
│  │  4. docker compose up -d        │                 │
│  │  5. health check                │                 │
│  └─────────────────────────────────┘                 │
│                                                       │
│  ┌─────────────────────────────────┐                 │
│  │  Docker Services                │                 │
│  │  matrix, mana-core-auth,        │                 │
│  │  bots, web-apps, ...            │                 │
│  └─────────────────────────────────┘                 │
│                                                       │
└──────────────────────────────────────────────────────┘

GitHub Actions Workflow

# .github/workflows/deploy.yml
name: Deploy to Mac Mini

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: self-hosted
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Pull latest changes
        run: git pull origin main

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      - name: Build & Deploy
        run: |
          docker compose -f docker-compose.macmini.yml build
          docker compose -f docker-compose.macmini.yml up -d

      - name: Health Check
        run: ./scripts/mac-mini/health-check.sh

Auto-Deploy bei Push auf main

Jeder Push auf main löst automatisch ein Deployment aus.

Deploy-Flow

Notifications

- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "$MATRIX_WEBHOOK_URL" \
      -H "Content-Type: application/json" \
      -d '{"body": "❌ Deployment failed: ${{ github.sha }}"}'

SSH Setup Dokumentation

Dokumentation für die Einrichtung des GitHub Actions Runners auf dem Mac Mini.

Runner Installation

# Auf dem Mac Mini
mkdir ~/actions-runner && cd ~/actions-runner
curl -o actions-runner.tar.gz -L https://github.com/actions/runner/releases/download/v2.321.0/actions-runner-osx-arm64-2.321.0.tar.gz
tar xzf actions-runner.tar.gz

# Runner konfigurieren
./config.sh --url https://github.com/your-org/manacore-monorepo \
            --token YOUR_TOKEN \
            --labels self-hosted,macOS,ARM64

# Als Service installieren
./svc.sh install
./svc.sh start

LaunchDaemon

<!-- ~/Library/LaunchAgents/com.github.actions-runner.plist -->
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.github.actions-runner</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>WorkingDirectory</key>
    <string>/Users/till/actions-runner</string>
    <key>ProgramArguments</key>
    <array>
        <string>./runsvc.sh</string>
    </array>
</dict>
</plist>

Docker PATH Fix

Der GitHub Actions Runner hatte keinen Zugriff auf Docker im PATH.

Problem

Error: docker: command not found

Lösung

# .env für den Runner
echo 'PATH=/usr/local/bin:/opt/homebrew/bin:$PATH' >> ~/actions-runner/.env

matrix-web Dockerfile Fix

Das matrix-web Dockerfile fehlte die shared-pwa Package Dependency.

Problem

ERROR: Could not resolve @manacore/shared-pwa
Build failed during Docker multi-stage build

Lösung

# Dockerfile - shared-pwa Package mit kopieren
COPY packages/shared-pwa ./packages/shared-pwa

Mac Mini Docs Update

Dokumentation mit aktivem Runner-Status aktualisiert.

Neue Sektion

## GitHub Actions Runner

Status: ✅ Aktiv
Labels: self-hosted, macOS, ARM64
Auto-Start: Ja (LaunchDaemon)

Zusammenfassung

Nächste Schritte

1. Staging Environment - Preview Deployments für PRs
2. Rollback - Automatisches Rollback bei Health-Check-Failure
3. Build Cache - Docker Layer Caching optimieren
4. Monitoring - Deployment-Metriken in Grafana