Zum Hauptinhalt springen

Tenant-Datenbank-Präfix

Zwei OctoMesh-Instanzen können einen MongoDB-Server gemeinsam nutzen. Jede Instanz hat ihre eigene Systemdatenbank (System:SystemDatabaseName, zum Beispiel OctoSystem und OctoSystemDev), die Tenant-Datenbanken liegen aber nebeneinander auf demselben Server. Ein Datenbankname kann auf dem Server nur einmal vorkommen. Ohne weitere Einstellung können zwei Instanzen deshalb nicht beide einen Tenant meshtest mit dem Standard-Datenbanknamen anlegen: Das zweite Anlegen wird mit Database name 'meshtest' is not available. abgelehnt.

Das Tenant-Datenbank-Präfix gibt jeder Instanz einen eigenen Namensraum: Jede neue Tenant-Datenbank der Instanz beginnt mit dem Präfix. Getrennt sind die Namensräume nur, wenn sich die Präfixe nicht überschneiden: Eine Instanz ohne Präfix kann weiterhin einen Tenant dev_meshtest anlegen, dessen Datenbank der Name ist, den die dev_-Instanz für meshtest ableitet. Geben Sie jeder Instanz auf dem Server ein eigenes Präfix, oder reservieren Sie die Tenant-Namen, die sich überschneiden.

Die Einstellung​

KonfigurationsschlüsselSystem:TenantDatabasePrefix
UmgebungsvariableOCTO_SYSTEM__TENANTDATABASEPREFIX
Helm (Chart octo-mesh)clusterDependencies.tenantDatabasePrefix
Helm (Chart octo-mesh-communication-operator)operator.clusterDependencies.tenantDatabasePrefix
Standardleer: kein Präfix, alle Namen wie bisher
Formathöchstens 30 Zeichen, ASCII-Buchstaben, Ziffern, - und _; wird in Kleinbuchstaben gespeichert

Ein ungültiger Wert hält den Service beim Start mit einem Fehler an, der TenantDatabasePrefix nennt.

Setzen Sie denselben Wert für jeden Prozess einer Instanz: für die Core-Services (ein Chart-Wert für alle) und für den Communication Operator, der ihn an die Adapter und Workloads weitergibt, die er ausrollt. Beenden Sie das Präfix mit einem Trennzeichen (dev_), damit die Namen lesbar bleiben: dev_meshtest.

Was sich mit einem Präfix ändert​

  • Anlegen ohne Datenbanknamen: Ein Tenant, der ohne expliziten Datenbanknamen angelegt wird, bekommt die Datenbank <Präfix><TenantId> in Kleinbuchstaben. octo-cli -c Create -tid meshtest legt auf einer Instanz mit dem Präfix dev_ die Datenbank dev_meshtest an. Ohne Präfix heißt die Datenbank wie bisher nach der Tenant-ID.
  • Anlegen oder Anhängen mit explizitem Namen: Der Name muss mit dem Präfix beginnen. Jeder andere Name wird mit derselben Antwort wie jeder andere nicht verfügbare Name abgelehnt, Database name '<name>' is not available. (HTTP 409). Der Grund steht nur im Service-Log.
  • Bestehende Tenants behalten ihre Namen. Tenants, die vor dem Setzen des Präfixes registriert wurden, behalten ihre Datenbank und funktionieren wie bisher; es gibt keine Umbenennung und keine Migration. Wird ein solcher Tenant geleert (Clear), wird er unter seinem alten Namen neu angelegt; eine Wiederherstellung (Restore) über ihn behält seinen Namen.
  • Wiederherstellung (Restore): Eine Wiederherstellung in einen Datenbanknamen ohne Präfix wird abgelehnt, bevor etwas geschrieben wird, außer es ist die aktuelle Datenbank desselben Tenants. Die Ablehnung gibt dieselbe Antwort, Database name '<name>' is not available.; der Grund steht nur im Service-Log.
  • Anlegen (Create) lehnt einen Namen, der auf dem Server schon existiert, weiterhin ab, auch wenn er das Präfix trägt. Attach registriert eine bestehende Datenbank, und eine Wiederherstellung kann die eigene Datenbank des Tenants überschreiben; beide durchlaufen die Eigentumsprüfungen (Tenant-Datenbank-Ownership). Das Präfix verhindert Kollisionen zwischen Instanzen; es erlaubt keiner Instanz, eine fremde Datenbank zu übernehmen.

Beziehung zum CrateDB-Schema-Präfix​

StreamData:SchemaInstancePrefix (clusterDependencies.streamDataSchemaInstancePrefix) macht dasselbe für die CrateDB-Schemas der Stream-Daten: Das Schema eines Tenants heißt dann <Präfix>_<TenantId>. Die beiden Einstellungen sind bewusst unabhängig. Eine Instanz, die schon mit CrateDB-Schemas ohne Präfix läuft, kann das Tenant-Datenbank-Präfix setzen, ohne ihre Stream-Daten zu verschieben, und umgekehrt. Eine zweite Instanz auf gemeinsamer MongoDB und gemeinsamer CrateDB setzt beide.

Beispiel: zwei Instanzen auf einer MongoDB​

Eine Installation betreibt eine Hauptinstanz und eine Entwicklungsinstanz auf derselben MongoDB und CrateDB:

HauptinstanzEntwicklungsinstanz
serviceDefaults.systemDatabaseNameOctoSystemOctoSystemDev
clusterDependencies.tenantDatabasePrefixleerdev_
clusterDependencies.streamDataSchemaInstancePrefixleerdev
Tenant meshtest, ohne Datenbanknamen angelegtDatenbank meshtestDatenbank dev_meshtest

Die Hauptinstanz behält ihre Namen, dort verschiebt sich nichts. Die Entwicklungsinstanz setzt die Werte im Core-Chart und im Chart ihres Communication Operators. Tenants, die sie vor dem Setzen des Präfixes angelegt hat, behalten ihre Namen; neue Tenants bekommen das Präfix. Ein Test oder Blueprint mit fester Tenant-ID läuft damit auf beiden Instanzen.

Lokale Entwicklung​

Start-Octo -SystemDatabase OctoSystem_s2 -TenantDatabasePrefix s2_ startet eine zweite lokale Instanz mit eigener Systemdatenbank und eigenem Präfix. Der lokale octo-devstack-Daemon gibt jedem Stack-Slot außer dem Standard-Slot ein eigenes Präfix (<Slot-Präfix>_, zum Beispiel s2_) zusammen mit einer eigenen Systemdatenbank.