UserSpace¶
Der UserSpace ermöglicht es Benutzern, Container auf dem rc_visard NG bereitzustellen und zu verwalten. Es werden Standalone-Container und docker-compose Stacks unterstützt.
Bemerkung
Kenntnisse von Docker-Containern werden vorausgesetzt.
Falls der UserSpace verfügbar und aktiviert ist, kann er durch Klicken des Menüeintrags UserSpace in der Web GUI angesteuert werden. Diese Seite zeigt die laufenden Apps und Container mit ihrem aktuellen Status und, falls verfügbar, einem Health-Check. Jeder Container listet die veröffentlichten Ports. Falls deren Protokoll http oder https ist, können diese Container direkt in der Web GUI erreicht werden.
Konfiguration¶
Wenn der UserSpace zum ersten Mal aktiviert wird, muss ein Benutzer für Portainer erstellt werden: Navigieren Sie in der Web GUI zu UserSpace und klicken Sie auf UserSpace Apps verwalten. Anschließend registrieren Sie das Benutzerkonto des Administrators. Dieser Schritt muss innerhalb von fünf Minuten abgeschlossen werden, nachdem der rc_visard NG hochgefahren wurde.
Bemerkung
Der UserSpace ist standardmäßig nicht aktiviert und kann aus Sicherheitsgründen über die Web GUI ausschließlich dann aktiviert, deaktiviert oder zurückgesetzt werden, wenn der Roboception UserSpace Key QR Code vor der Kamera der platziert wird.
Konfiguration des UserSpace über die Web GUI¶
Um den UserSpace über die Web GUI zu konfigurieren, navigieren Sie zu UserSpace und klicken auf UserSpace konfigurieren.
Drucken Sie den Roboception UserSpace Key von hier
oder https://roboception.com/roboception-userspace-key/ aus und platzieren Sie ihn so vor der Kamera dass er vollständig im linken und rechten Kamerabild sichtbar ist.
Nutzen Sie die Buttons zum Aktivieren/Deaktivieren oder Zurücksetzen des UserSpace. Beim Zurücksetzen werden alle Container, Datenspeicher und die Portainer-Konfiguration gelöscht, einschließlich Secrets und Benutzerkonten.
Anzeige laufender Apps¶
UserSpace Informationen einschließlich laufender Apps und ihre veröffentlichten Ports können über den REST-API userspace Endpunkt abgefragt werden, oder in der Web GUI im Menü unter UserSpace angezeigt werden.
Containerbezeichnungen (Labels ) org.opencontainers.image.XXX
können genutzt werden um der API zusätzliche Informationen zu liefern, die auch in der Web GUI angezeigt werden, siehe REST-API UserSpaceContainer Definition.
Netzwerkzugriff auf die UserSpace Anwendungen¶
Um die Container über Netzwerk zu erreichen, müssen die Container-Ports für den Host veröffentlicht sein.
Wenn ein Container eine Webschnittstelle über http oder https bereitstellt, können Sie Containerbezeichnungen (Labels) verwenden, um einen Button in der Web GUI anzuzeigen, über den sie direkt geöffnet werden kann:
com.roboception.app.http
: alle öffentlichen TCP-Ports nutzen httpcom.roboception.app.https.port=1234,5678
: Komma-separierte Liste mit https-Ports
Schnittstellen¶
Im UserSpace verwaltete Container können auf öffentliche Schnittstellen des rc_visard NG zugreifen. Insbesondere können die Container über gRPC auf die Bilddaten zugreifen und die REST-API-Schnittstelle aufrufen. Auf den rc_visard NG (den Host) kann durch die Docker-Bridge-IP zugegriffen werden (im Standard-Docker-Bridge-Netzwerk 172.17.0.1).
Einschränkungen¶
Container unterliegen bestimmten Einschränkungen:
- Container können nicht privilegiert ausgeführt werden.
- Keinen Zugriff auf das Host-Netzwerk (das Docker Bridge-Netzwerk wird benutzt).
- Nur Pfade innerhalb geklonter git Repositories mit einem docker-compose Stack können eingebunden werden, alle anderen Hostpfade nicht.
- Auf Hostgeräte kann nicht zugegriffen werden. Dazu gehören z.B USB- und GPU-Geräte.
- System Ports und intern verwendete Ports des Hosts können nicht gebunden werden. Dazu gehören Ports unter 1024, Ports von 4200 bis 4299 und die Ports 2342, 2343, 2344, 2345, 3956, 4840, 5353, 6379, 7000, 7001, 7002, 7003, 9100, 9118, 9256, 9445, 9446, 11311, 22350, 22352, 50010, 50051, 50052, 50053 und 50054.