odyssey

Objetivos de design e principais recursos

Processamento multithread

O Odyssey pode dimensionar significativamente o desempenho do processamento especificando vários threads de trabalho adicionais. Cada thread de trabalho é responsável pela autenticação e proxy de solicitações de cliente para servidor e de servidor para cliente. Todos os threads de trabalho estão compartilhando pools de conexões de servidores globais. O design multithread desempenha um papel importante no desempenho SSL/TLS .

Pool transacional avançado

Odyssey rastreia o estado atual da transação e, em caso de desconexão inesperada do cliente, pode emitir Cancel automático de conexão e Rollback a transação abandonada, antes de colocar a conexão do servidor de volta no pool de servidores para reutilização. Além disso, o último cliente proprietário da conexão do servidor é lembrado para reduzir a necessidade de configuração de opções de cliente em cada atribuição de cliente para servidor.

Melhor controle de pooling

Odyssey permite definir pools de conexões como um par de Database e User . Cada pool definido pode ter configurações separadas de autenticação, modo de pooling e limites.

Autenticação

Odyssey tem suporte SSL/TLS completo e métodos de autenticação comuns como: md5 e clear text para autenticação de cliente e servidor. Odyssey suporta autenticação PAM e LDAP, este método opera de forma semelhante à autenticação clear text , exceto que usa PAM/LDAP para validar pares de nome de usuário/senha. O PAM verifica opcionalmente o nome do host remoto conectado ou endereço IP. Além disso, permite bloquear cada usuário do pool separadamente.

Registro

Odyssey gera identificadores uuid universalmente exclusivos para conexões de cliente e servidor. Quaisquer eventos de log e respostas de erro do cliente incluem o ID, que pode ser usado para identificar exclusivamente o cliente e rastrear ações. Odyssey pode salvar eventos de log em um arquivo de log e usar o registrador do sistema.

CLI

Odyssey oferece suporte a várias opções de linha de comando. Use /path/to/odyssey --help para ver mais

Arquitetura e interiores

Odyssey possui uma arquitetura multithread assíncrona sofisticada que é impulsionada por um mecanismo de rotina personalizado: machinarium. A ideia principal por trás do design de corrotinas é fazer com que os aplicativos assíncronos orientados a eventos pareçam ter sido escritos de maneira processual síncrona, em vez de usar a abordagem tradicional de retorno de chamada.

Um dos principais objetivos era tornar a base de código compreensível para novos desenvolvedores e tornar uma arquitetura facilmente extensível para desenvolvimento futuro.

Mais informações: Arquitetura e interiores.

Instruções de construção

Atualmente o Odyssey roda apenas em Linux. As plataformas suportadas são x86/x86_64.

Para construir você precisará de:

• cmake >= 3.12.4
• gcc >= 4,6
• abressl
• postgresql-server-dev-13
• O utilitário pg_config está no PATH

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

Adapte odyssey-dev.conf então:

make local_run

Alternativamente:

make console_run

Use o ambiente docker para desenvolvimento (útil para usuários de Mac)

make start-dev-env

Configure seu CLion para construir projeto em container, manual.

Referência de configuração

Serviço

• incluir
• demonizar
• roteamento_sequencial
• prioridade
• arquivo_pid
• unix_socket_dir
• unix_socket_mode

Registro

• arquivo_de_log
• formato_de_log
• log_to_stdout
• log_syslog
• log_syslog_ident
• log_syslog_facility
• log_debug
• log_config
• sessão_de_log
• log_query
• log_stats
• intervalo_de_estatísticas

Desempenho

• trabalhadores
• resolvedores
• leitura antecipada
• cache_coroutine
• atraso no nó
• manutenção de atividade
• group_checker_interval

Sistema

• coroutine_stack_size

Limites globais

• cliente_max

Ouvir

• hospedar
• porta
• pendências
• tls
• tls_ca_file
• tls_key_file
• tls_cert_file
• protocolos_tls
• exemplo

Roteamento

• visão geral

Armazenar

• visão geral
• tipo
• hospedar
• porta
• tls
• tls_ca_file
• tls_key_file
• tls_cert_file
• protocolos_tls
• exemplo

Banco de dados e usuário

• visão geral
• autenticação
• senha
• auth_common_name
• auth_query
• auth_query_db
• auth_query_user
• auth_pam_service
• cliente_max
• armazenar
• armazenamento_db
• usuário_de_armazenamento
• senha_de_armazenamento
• senha_passthrough
• ldap_storage_credentials
• ldap_storage_credentials_attr
• ldap_endpoint
• ldap_endpoint_name
• ldap_pool_ttl
• piscina
• tamanho_da_piscina
• pool_timeout
• piscina_ttl
• pool_discard
• piscina_cancelar
• pool_rollback
• cliente_fwd_error
• log_debug
• exemplo
• console de exemplo

Arquitetura e Interiores

• visão geral
• códigos de erro