Offenes AAS-Ökosystem
Anleitung

Erste Schritte

Setup, Konfiguration und die ersten Schritte nach dem Start des Stacks.

1

Voraussetzungen

  • Docker und Docker Compose (Version 2 oder neuer)
  • Freie Ports auf dem lokalen Rechner: 80 (AAS-Suite), 4000 (Sample App), 8088 (Keycloak-Admin-Konsole), 8090 (AAS Twin Engine)
  • Ein Eintrag in der lokalen hosts-Datei, der aas-ecosystem.local (der Standard-Hostname, über LOCAL_HOSTNAME änderbar) auf 127.0.0.1 zeigt (siehe Konfiguration)
2

Setup

Im heruntergeladenen Projektordner genügt der folgende Befehl, um den gesamten Stack zu starten: 

docker compose up -d

Der erste Start dauert etwas länger, da Datenbank-Migrationen und die Keycloak-Realm-Konfiguration automatisch eingespielt werden.

3

Konfiguration

Alle Zugangsdaten und Ports werden über die .env-Datei im Projektordner gesteuert, u. a.:

  • Postgres-Zugangsdaten (POSTGRES_USER, POSTGRES_PASSWORD)
  • Keycloak-Admin-Zugang (KEYCLOAK_ADMIN_USERNAME, KEYCLOAK_ADMIN_PASSWORD)
  • Initiales Organisations-Admin-Konto für die AAS-Suite (INITIAL_ORGANISATION_ADMIN_EMAIL, INITIAL_ORGANISATION_ADMIN_PASSWORD)
  • Lokaler Hostname der Anwendung (LOCAL_HOSTNAME, Standard: aas-ecosystem.local) – steuert zentral alle URLs (Login, API, Keycloak)

Damit http://aas-ecosystem.local im Browser funktioniert, muss dieser Hostname lokal auf 127.0.0.1 aufgelöst werden, z. B. durch einen Eintrag in der hosts-Datei (/etc/hosts unter macOS/Linux, C:\Windows\System32\drivers\etc\hosts unter Windows): 

127.0.0.1 aas-ecosystem.local

Die mitgelieferten Standardwerte für die lokale Demo-Umgebung:

  • Postgres: aas_user / admin-pass
  • Keycloak-Admin-Konsole (:8088): admin / admin
  • Organisations-Admin-Login in der AAS-Suite: admin@initial.orga / secret-pass

Diese Zugangsdaten sind ausschließlich für die lokale Demo-Umgebung gedacht und müssen für jede produktive oder öffentlich erreichbare Umgebung geändert werden.

Erste Schritte nach dem Start

  1. Im Browser http://aas-ecosystem.local öffnen (bzw. den eigenen, über LOCAL_HOSTNAME konfigurierten Hostnamen).
  2. Mit dem initialen Organisations-Admin-Konto anmelden.
  3. In der AAS-Suite ein Template für den Digital Product Passport anlegen oder das mitgelieferte Beispiel-Template öffnen.
  4. Produktdaten in die Datenbank der AAS Twin Engine eintragen, z. B. über die im Stack enthaltene Sample App unter http://localhost:4000.
  5. Die daraus erzeugte AAS über die IDTA-konforme BaSyx-API abrufen oder direkt im Viewer der AAS-Suite ansehen.
← Zurück zu "Was bekomme ich?" Wie geht's weiter? →