Projekt teilen

Manchmal willst du einem Kunden oder einer Kollegin zeigen, woran du gerade arbeitest, und die sitzen nicht in deinem Netz. Ohne VPN, ohne Portweiterleitung, ohne irgendwo ein Konto anzulegen: Öffne im Kopf eines laufenden Projekts Weitere Aktionen (⋯) und wähl Öffentlich teilen, und es bekommt eine temporäre öffentliche https-Adresse.

Dahinter startet Envoryx neben dem Projekt einen Cloudflare Quick Tunnel (cloudflare/cloudflared) und zeigt dir die Adresse, die er bekommen hat, etwa https://<zufällige-wörter>.trycloudflare.com. Die Adresse ist zufällig und bei jeder Freigabe eine andere. Weil der Tunnel über den Proxy läuft, gelten auch hier die Regeln des Projekts - Passwort, Header und Weiterleitungen funktionieren also.

Der Teilen-Dialog eines laufenden Projekts mit der öffentlichen Adresse unter trycloudflare.com, wie lange sie gilt, einem Warnhinweis und dem Button „Freigabe beenden“

Wie lange eine Freigabe hält

Im Dialog wählst du 15 Minuten, 1, 4 oder 24 Stunden; wählst du nichts, ist es eine Stunde. Kommandozeile und API nehmen alles zwischen 5 Minuten und 24 Stunden. Früher zu Ende ist sie, wenn das Projekt stoppt, umbenannt oder gelöscht wird oder wenn du auf Freigabe beenden klickst. Solange sie läuft, steht im Kopf des Projekts ein grünes Abzeichen Geteilt; ein Klick darauf zeigt dir die Adresse wieder. Wird die Anwendung neu erstellt, etwa nach geänderten Variablen, bleibt die Freigabe bestehen.

Der Host braucht dafür nur ausgehende Verbindungen: Er muss Cloudflare auf Port 7844 erreichen.

Eine Sache noch: Baut deine Anwendung absolute Links aus APP_URL oder ENVORYX_URL, zeigen diese Links weiterhin auf die lokale Adresse.

Per Kommandozeile und API

envoryx project share shop --for 2h     # gibt die öffentliche Adresse aus
envoryx project share shop --status
envoryx project share shop --stop

Über die API sind es GET, POST ({"minutes": 60}) und DELETE auf /api/v1/projects/{id}/share. Zum Starten einer Freigabe braucht es einen admin-Token oder -Benutzer, zum Beenden reicht operate; beides landet im Audit-Log.