odyssey

Tujuan desain dan fitur utama

Pemrosesan multi-utas

Odyssey dapat meningkatkan kinerja pemrosesan secara signifikan dengan menentukan sejumlah thread pekerja tambahan. Setiap thread pekerja bertanggung jawab untuk otentikasi dan proksi permintaan klien-ke-server dan server-ke-klien. Semua thread pekerja berbagi kumpulan koneksi server global. Desain multi-thread memainkan peran penting dalam kinerja SSL/TLS .

Pengumpulan transaksi tingkat lanjut

Odyssey melacak status transaksi saat ini dan jika terjadi pemutusan klien yang tidak terduga dapat mengeluarkan koneksi Cancel otomatis dan melakukan Rollback transaksi yang ditinggalkan, sebelum mengembalikan koneksi server ke kumpulan server untuk digunakan kembali. Selain itu, klien pemilik koneksi server terakhir diingat untuk mengurangi kebutuhan untuk menyiapkan opsi klien pada setiap penugasan klien-ke-server.

Kontrol pengumpulan yang lebih baik

Odyssey memungkinkan untuk mendefinisikan kumpulan koneksi sebagai pasangan Database dan User . Setiap kumpulan yang ditentukan dapat memiliki autentikasi terpisah, mode pengumpulan, dan pengaturan batas.

Otentikasi

Odyssey memiliki dukungan SSL/TLS berfitur lengkap dan metode otentikasi umum seperti: md5 dan clear text untuk otentikasi klien dan server. Odyssey mendukung otentikasi PAM & LDAP, metode ini beroperasi serupa dengan autentikasi clear text kecuali bahwa ia menggunakan PAM/LDAP untuk memvalidasi pasangan nama pengguna/kata sandi. PAM secara opsional memeriksa nama host jarak jauh atau alamat IP yang terhubung. Selain itu memungkinkan untuk memblokir setiap pengguna kumpulan secara terpisah.

Pencatatan

Odyssey menghasilkan pengidentifikasi unik universal uuid untuk koneksi klien dan server. Setiap peristiwa log dan respons kesalahan klien menyertakan id, yang kemudian dapat digunakan untuk mengidentifikasi klien secara unik dan melacak tindakan. Odyssey dapat menyimpan peristiwa log ke dalam file log dan menggunakan logger sistem.

CLI

Odyssey mendukung beberapa opsi baris perintah. Gunakan /path/to/odyssey --help untuk melihat lebih lanjut

Arsitektur dan internal

Odyssey memiliki arsitektur multi-utas asinkron canggih yang digerakkan oleh mesin coroutine yang dibuat khusus: machinarium. Ide utama di balik desain coroutine adalah membuat aplikasi asinkron berbasis peristiwa agar terlihat dan terasa seperti ditulis dengan cara prosedural sinkron alih-alih menggunakan pendekatan panggilan balik tradisional.

Salah satu tujuan utamanya adalah membuat basis kode dapat dimengerti oleh pengembang baru dan membuat arsitektur mudah diperluas untuk pengembangan di masa depan.

Informasi lebih lanjut: Arsitektur dan internal.

Membangun instruksi

Saat ini Odyssey hanya berjalan di Linux. Platform yang didukung adalah x86/x86_64.

Untuk membangun Anda membutuhkan:

• buat >= 3.12.4
• gcc >= 4.6
• opensl
• postgresql-server-dev-13
• utilitas pg_config ada di PATH

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

Sesuaikan odyssey-dev.conf lalu:

make local_run

Alternatifnya:

make console_run

Gunakan lingkungan buruh pelabuhan untuk pengembangan (bermanfaat bagi pengguna Mac)

make start-dev-env

Siapkan CLion Anda untuk membangun proyek dalam wadah, secara manual.

Referensi konfigurasi

Melayani

• termasuk
• melakukan daemonisasi
• sekuensial_routing
• prioritas
• pid_file
• unix_socket_dir
• unix_socket_mode

Pencatatan

• log_file
• log_format
• log_to_stdout
• log_syslog
• log_syslog_ident
• log_syslog_facility
• log_debug
• log_config
• log_sesi
• log_query
• log_stats
• statistik_interval

Pertunjukan

• pekerja
• pemecah masalah
• baca ke depan
• cache_coroutine
• nodelay
• tetap hidup
• grup_checker_interval

Sistem

• coroutine_stack_size

Batasan global

• klien_maks

Mendengarkan

• tuan rumah
• pelabuhan
• jaminan simpanan
• tl
• tls_ca_file
• tls_key_file
• tls_cert_file
• tls_protocols
• contoh

Rute

• ringkasan

Penyimpanan

• ringkasan
• jenis
• tuan rumah
• pelabuhan
• tl
• tls_ca_file
• tls_key_file
• tls_cert_file
• tls_protocols
• contoh

Basis data dan pengguna

• ringkasan
• otentikasi
• kata sandi
• auth_common_name
• auth_query
• auth_query_db
• auth_query_user
• auth_pam_service
• klien_maks
• penyimpanan
• penyimpanan_db
• penyimpanan_pengguna
• penyimpanan_kata sandi
• kata sandi_passthrough
• ldap_storage_credentials
• ldap_storage_credentials_attr
• ldap_endpoint
• ldap_endpoint_name
• ldap_pool_ttl
• kolam
• ukuran_kolam
• pool_timeout
• kolam_ttl
• pool_discard
• pool_cancel
• pool_rollback
• klien_fwd_error
• log_debug
• contoh
• contoh konsol

Arsitektur dan Internal

• ringkasan
• kode kesalahan