odyssey

Designziele und Hauptmerkmale

Multithread-Verarbeitung

Odyssey kann die Verarbeitungsleistung durch die Angabe einer Reihe zusätzlicher Arbeitsthreads erheblich skalieren. Jeder Arbeitsthread ist für die Authentifizierung und Weiterleitung von Client-zu-Server- und Server-zu-Client-Anfragen verantwortlich. Alle Arbeitsthreads teilen sich globale Serververbindungspools. Das Multithread-Design spielt eine wichtige Rolle für SSL/TLS -Leistung.

Erweitertes Transaktions-Pooling

Odyssey verfolgt den aktuellen Transaktionsstatus und kann im Falle einer unerwarteten Client-Verbindungstrennung automatisch die Verbindung Cancel und Rollback der abgebrochenen Transaktion durchführen, bevor die Serververbindung zur Wiederverwendung wieder in den Server-Pool zurückgeführt wird. Darüber hinaus wird der Client des letzten Serververbindungseigentümers berücksichtigt, um die Notwendigkeit zum Einrichten von Clientoptionen für jede Client-zu-Server-Zuweisung zu reduzieren.

Bessere Pooling-Kontrolle

Odyssey ermöglicht die Definition von Verbindungspools als Paar aus Database und User . Jeder definierte Pool kann über separate Authentifizierungs-, Pooling-Modus- und Grenzwerteinstellungen verfügen.

Authentifizierung

Odyssey bietet umfassende SSL/TLS Unterstützung und gängige Authentifizierungsmethoden wie md5 und clear text sowohl für die Client- als auch für die Serverauthentifizierung. Odyssey unterstützt PAM- und LDAP-Authentifizierung. Diese Methode funktioniert ähnlich wie clear text , außer dass sie PAM/LDAP zur Validierung von Benutzernamen-/Passwortpaaren verwendet. PAM überprüft optional den Namen oder die IP-Adresse des verbundenen Remote-Hosts. Darüber hinaus ist es möglich, jeden Poolbenutzer separat zu sperren.

Protokollierung

Odyssey generiert universell eindeutige uuid -Identifikatoren für Client- und Serververbindungen. Alle Protokollereignisse und Client-Fehlerantworten enthalten die ID, die dann zur eindeutigen Identifizierung des Clients und zur Nachverfolgung von Aktionen verwendet werden kann. Odyssey kann Protokollereignisse in einer Protokolldatei speichern und den Systemlogger verwenden.

CLI

Odyssey unterstützt mehrere Befehlszeilenoptionen. Verwenden Sie /path/to/odyssey --help, um mehr zu sehen

Architektur und Innenleben

Odyssey verfügt über eine ausgefeilte asynchrone Multithread-Architektur, die von einer maßgeschneiderten Coroutine-Engine angetrieben wird: Machinarium. Die Hauptidee des Coroutine-Designs besteht darin, ereignisgesteuerte asynchrone Anwendungen so aussehen und anfühlen zu lassen, als wären sie auf synchron-prozedurale Weise geschrieben worden, anstatt den traditionellen Callback-Ansatz zu verwenden.

Eines der Hauptziele bestand darin, die Codebasis für neue Entwickler verständlich zu machen und eine Architektur für zukünftige Entwicklungen leicht erweiterbar zu machen.

Weitere Informationen: Architektur und Interna.

Bauanleitung

Derzeit läuft Odyssey nur unter Linux. Unterstützte Plattformen sind x86/x86_64.

Zum Bauen benötigen Sie:

• cmake >= 3.12.4
• gcc >= 4,6
• openSL
• postgresql-server-dev-13
• Das Dienstprogramm pg_config befindet sich im PATH

git clone git://github.com/yandex/odyssey.git
cd odyssey
make local_build

Passen Sie dann odyssey-dev.conf an:

make local_run

Alternativ:

make console_run

Verwenden Sie die Docker-Umgebung für die Entwicklung (hilfreich für Mac-Benutzer)

make start-dev-env

Richten Sie Ihr CLion-to-Build-Projekt im Container manuell ein.

Konfigurationsreferenz

Service

• enthalten
• dämonisieren
• sequentielles_routing
• Priorität
• pid_file
• unix_socket_dir
• unix_socket_mode

Protokollierung

• log_file
• log_format
• log_to_stdout
• log_syslog
• log_syslog_ident
• log_syslog_facility
• log_debug
• log_config
• log_session
• log_query
• log_stats
• stats_interval

Leistung

• Arbeiter
• Resolver
• vorausschauend
• Cache_coroutine
• Nodelay
• Keepalive
• group_checker_interval

System

• coroutine_stack_size

Globale Grenzen

• client_max

Hören

• Gastgeber
• Hafen
• Rückstand
• TLS
• tls_ca_file
• tls_key_file
• tls_cert_file
• tls_protocols
• Beispiel

Routenführung

• Überblick

Lagerung

• Überblick
• Typ
• Gastgeber
• Hafen
• TLS
• tls_ca_file
• tls_key_file
• tls_cert_file
• tls_protocols
• Beispiel

Datenbank und Benutzer

• Überblick
• Authentifizierung
• Passwort
• auth_common_name
• auth_query
• auth_query_db
• auth_query_user
• auth_pam_service
• client_max
• Lagerung
• storage_db
• storage_user
• storage_password
• passwort_passthrough
• ldap_storage_credentials
• ldap_storage_credentials_attr
• ldap_endpoint
• ldap_endpoint_name
• ldap_pool_ttl
• Pool
• pool_size
• pool_timeout
• pool_ttl
• pool_discard
• pool_cancel
• pool_rollback
• client_fwd_error
• log_debug
• Beispiel
• Beispielkonsole

Architektur und Interna

• Überblick
• Fehlercodes