Mercure-Hub: 1. Access Token erstellen und als CI-Secret speichern

Diese Dokumentation ist Teil des GitHub Actions & GitLab CI-Leitfadens. Den vollständigen Leitfaden finden Sie hier: Starten Sie einen echten Mercure Hub-Service direkt aus Ihrer GitHub Actions- oder GitLab CI-Pipeline, führen Sie Ihre Tests dagegen aus und fahren Sie ihn anschließend automatisch wieder herunter.

👋 Willkommen in der Stackhero-Dokumentation!

Stackhero bietet einen vollständig verwalteten Mercure-Hub Cloud Service, der darauf ausgelegt ist, die Bereitstellung von Echtzeitdaten einfach und zuverlässig zu gestalten. Sie profitieren von:

  • Unbegrenzten Anfragen und Nachrichten­größen für maximale Flexibilität.
  • Einer individuellen Domain mit integrierter HTTPS-Sicherheit (zum Beispiel https://real-time.ihr-unternehmen.com).
  • Ein-Klick-Updates, um Ihren Hub mühelos immer auf dem neuesten Stand zu halten.
  • Hoher Performance und starker Sicherheit auf einer privaten, dedizierten Infrastruktur.
  • Mehrere Regionen: 🇪🇺 Europa und 🇺🇸 USA für eine latenzarme Bereitstellung.

Schnell startklar: In nur 5 Minuten können Sie Ihre Mercure-Hub Cloud Hosting Umgebung bereitstellen und Echtzeit-Updates an Ihre Anwendungen senden.

Damit das CLI nicht-interaktiv arbeiten kann, benötigen Sie ein Access Token (Format: usr-xxxxxx:tokenId). Dieses Token müssen Sie nur einmalig erstellen und dann als sicheres, verschlüsseltes Secret in Ihrer CI-Pipeline hinterlegen.

  1. Token erstellen: Öffnen Sie Ihr Stackhero Dashboard, klicken Sie oben rechts auf Ihr Profilbild, gehen Sie zu Ihr Konto, dann Access Tokens und klicken Sie auf Token erstellen.
  2. Für GitHub Actions: Gehen Sie in Ihrem Repository zu Settings > Secrets and variables > Actions > New repository secret und tragen Sie das Token als STACKHERO_TOKEN ein.
  3. Für GitLab CI: Gehen Sie in Ihrem Projekt zu Settings > CI/CD > Variables > Add variable, setzen Sie den Schlüssel auf STACKHERO_TOKEN und aktivieren Sie Masked (und Protected, falls Ihre CI nur auf geschützten Branches läuft).

Platzieren Sie Ihr Access Token niemals direkt in der Pipeline-YAML-Datei. Ist es dort enthalten, kann es für alle mit Repository-Zugriff sichtbar sein und möglicherweise in Build-Logs auftauchen. Die Speicherung als CI-Secret sorgt dafür, dass Ihr Token verschlüsselt und maskiert bleibt und somit sicher ist.