Перейти до основного вмісту

Конфігурація

Налаштування модулів ядра обчислень відбувається шляхом створення конфігурацій. Конфігурація дозволяти змінювати параметри роботи ряду зʼєднувачів, адаптерів, інтеграцій та сервісів. Деталі про роботу відповідних модулів дивись

Зʼєднувачі

MongoDB

Конфігурація налаштування зʼєднання з базою даних MongoDB за рахунок ORM - mongoose:

ШляхТипЗнач. за
замовч.
Опис
connectors.mongodb.enablebooleanfalseОзнака підключення зʼєднувача з MongoDB NoSQL базою даних.
connectors.mongodb.databasestringdefaultНазва бази даних.
connectors.mongodb.connect.protocolstringmongodbТип протоколу url шляху до бази даних.
connectors.mongodb.connect.hoststring0.0.0.0Хост url шляху до бази даних.
connectors.mongodb.connect.portnumber27017Порт url шляху до бази даних.
connectors.mongodb.auth.usernamestring' 'Імʼя користувача, під яким будет відбуватись авторизація в базі даних.
connectors.mongodb.auth.passwordstring' 'Пароль користувача, під яким будет відбуватись авторизація в базі даних.
connectors.mongodb.options.bufferCommandsbooleanundefinedЧи слід використовувати буферизацію команд для всіх моделей, пов'язаних з цим підключенням. Якщо встановлено в false, Mongoose не буде буферизувати команди і може виникнути ситуація, коли колбеки не виконуються.
connectors.mongodb.options.autoIndexbooleanundefinedЧи слід автоматично створювати індекси для всіх моделей, пов'язаних з цим підключенням. Якщо встановлено в false, автоматичне створення індексів буде вимкнено.
connectors.mongodb.options.autoCreatebooleanundefinedЧи має Mongoose автоматично викликати createCollection() для кожної моделі, створеної на цьому з'єднанні. Якщо встановлено в true, Mongoose автоматично створюватиме колекції для моделей .
connectors.mongodb.options.tls.enablebooleanundefinedВказує, чи слід використовувати TLS для з'єднання з базою даних MongoDB.
connectors.mongodb.options.tls.tlsCertificateFilestringundefinedШлях до файлу сертифіката TLS.
connectors.mongodb.options.tls.tlsCertificateKeyFilestringundefinedШлях до файлу ключа сертифіката TLS.
connectors.mongodb.options.tls.tlsCertificateKeyFilePasswordstringundefinedПароль для розшифрування файлу ключа сертифіката TLS.
connectors.mongodb.options.tls.tlsCAFilestringundefinedШлях до файлу довірених сертифікатів Certificate Authority для перевірки сертифікатів сервера MongoDB
connectors.mongodb.options.tls.tlsAllowInvalidCertificatesbooleanundefinedЯкщо встановлено в true, то Mongoose дозволить недійсні сертифікати TLS.
connectors.mongodb.options.tls.tlsInsecurebooleanundefinedЯкщо встановлено в true, то Mongoose використовуватиме ненадійний режим TLS.
connectors.mongodb.options.replicaSetstringundefinedНазва групи реплік replicas.
connectors.mongodb.options.replicatesArray<{
host: string, number: string}>
[]Масив обʼєктів з хостом та портом підключення до replicas.
connectors.mongodb.options.connectTimeoutMSnumberundefinedТаймаут з'єднання в мілісекундах. Це час, після якого з'єднання буде визнано недійсним, якщо база даних не відповідає.
connectors.mongodb.options.socketTimeoutMSnumberundefinedТаймаут сокету в мілісекундах. Це час, після якого операції на сокеті будуть припинені, якщо вони не завершаться.
connectors.mongodb.options.zlibCompressionLevelenumundefinedРівень компресії zlib, який використовується для стиснення повідомлень, відправлених між Mongoose та MongoDB. Чим вище рівень, тим сильніша компресія, але це може призвести до більшої затрати CPU. Можливі рівні налаштування 0 / 1 / 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / undefined
connectors.mongodb.options.maxPoolSizenumberundefinedМаксимальна кількість з'єднань у пулі. Це обмеження на кількість одночасних активних з'єднань.
connectors.mongodb.options.minPoolSizenumberundefinedМінімальна кількість з'єднань у пулі. Mongoose намагатиметься підтримувати це мінімальне значення активних з'єднань у пулі.
connectors.mongodb.options.maxConnectingnumberundefinedМаксимальна кількість спроб створення нових з'єднань з базою даних. Це обмеження на кількість одночасних спроб підключення.
connectors.mongodb.options.maxIdleTimeMSnumberundefinedМаксимальний час простою для з'єднань у пулі перед їх закриттям.
connectors.mongodb.options.waitQueueTimeoutMSnumberundefinedТаймаут для очікування в черзі, який визначає, скільки часу Mongoose буде чекати на доступне з'єднання у пулі перед поверненням помилки черги.
connectors.mongodb.options.serverSelectionTimeoutMSnumberundefinedТаймаут для вибору сервера. Це обмеження на час, після якого вибір сервера буде визнаний як неуспішний.
connectors.mongodb.options.heartbeatFrequencyMSnumberundefinedЧастота надсилання heartbeat запитів (запитів для перевірки здоров'я) до сервера MongoDB в мілісекундах.
connectors.mongodb.options.minHeartbeatFrequencyMSnumberundefinedМінімальна частота відправлення запитів "heartbeat" до сервера MongoDB в мілісекундах.
connectors.mongodb.options.retryReadsbooleanundefinedПоказує, чи слід автоматично повторювати зчитування в разі виникнення помилки читання.
connectors.mongodb.options.retryWritesbooleanundefinedПоказує, чи слід автоматично повторювати записи в разі виникнення помилки запису.
connectors.mongodb.options.readConcernLevelenumundefinedВказує, як сервер MongoDB повинен гарантувати консистентність даних для операцій читання. Можуть бути наступні варіанти: 'local' / 'majority' / 'linearizable' / 'available' / 'snapshot'.
connectors.mongodb.options.readPreferenceenumundefinedВизначає, який сервер MongoDB слід використовувати для зчитування даних. Можуть бути наступні варіанти: 'primary' / 'primaryPreferred' / 'secondary' / 'secondaryPreferred' / 'nearest'.

Redis

Конфігурація налаштування зʼєднання з Redis, за основу роботи з яким виступає бібліотека ioredis та опис конфігурації підключення до Redis через неї:

ШляхТипЗнач. за
замовч.
Опис
connectors.redis.enablebooleanfalseОзнака підключення зʼєднувача з MongoDB NoSQL базою даних.
connectors.redis.connect.protocolstringredisТип протоколу url шляху до Redis.
connectors.redis.connect.hoststring0.0.0.0Хост url шляху до Redis.
connectors.redis.connect.portnumber6379Порт url шляху до Redis.
connectors.redis.options.keyPrefixstring' 'Дозволяє задати префікс для всіх ключів, які зберігаються в Redis.
connectors.redis.options.showFriendlyErrorStackbooleanfalseОзнака потреби виводити дружелюбні помилки повʼязаних з Redis.
connectors.redis.options.common.commandTimeoutnumberundefinedВизначає час у мілісекундах, протягом якого клієнт чекатиме на виконання команди перед тим, як заявити про тайм-аут.
connectors.redis.options.common.keepAlivenumberundefinedВстановлює час у мілісекундах для періодичних Keep-Alive повідомлень між клієнтом і сервером, що допомагає підтримувати активне з'єднання.
connectors.redis.options.common.noDelaybooleanundefinedВказує, чи слід вимкнути алгоритм затримки (Nagle's algorithm), який може зменшити затримку відправки даних, але при цьому збільшує кількість пакетів на мережі.
connectors.redis.options.common.connectionNameconnectionNameundefinedДозволяє встановити ім'я підключення до Redis-сервера.
connectors.redis.options.common.usernamestringundefinedВказує ім'я користувача, якщо Redis-сервер налаштований на вимагання аутентифікації.
connectors.redis.options.common.passwordstringundefinedВказує пароль для аутентифікації на Redis-сервері, якщо вона вимагається.
connectors.redis.options.common.autoResendUnfulfilledCommandsbooleanundefinedВказує, чи слід автоматично повторно відправляти невиконані команди під час перепідключення до Redis-сервера.
connectors.redis.options.common.connectTimeoutnumberundefinedВстановлює тайм-аут у мілісекундах для встановлення з'єднання з Redis-сервером.
connectors.redis.options.common.maxRetriesPerRequestnumber / nullundefinedВказує максимальну кількість спроб перепідключення до Redis-сервера для кожного запиту. Якщо значення встановлене на null, то спроби перепідключення необмежені.
connectors.redis.options.common.maxLoadingRetryTimenumberundefinedВстановлює тайм-аут у мілісекундах для спроби перепідключення до Redis-сервера, коли Redis-сервер повідомляє про те, що він знаходиться у режимі перезавантаження loading.
connectors.redis.options.common.enableAutoPipeliningbooleanundefinedВказує, чи слід увімкнути автоматичне пакетування команд pipelining. Піпелінінг дозволяє відправляти кілька команд одночасно без очікування відповіді на кожну з них, що може покращити продуктивність в деяких сценаріях використання.
connectors.redis.options.common.autoPipeliningIgnoredCommandsstring[]undefinedПараметр дозволяє вказати список команд, які будуть проігноровані при використанні автоматичного пакетування команд pipelining. Тобто, для цих команд підключення будуть очікувати відповідь перед надсиланням наступної команди, незважаючи на включений режим піпелінінг.
connectors.redis.options.common.enableOfflineQueuebooleanundefinedПараметр вказує, чи слід увімкнути локальну чергу (offline queue) для невідправлених команд в разі відключення від Redis-сервера. Це дозволяє зберегти команди, які не вдалося відправити через недоступність сервера, і відправити їх після відновлення з'єднання.
connectors.redis.options.common.enableReadyCheckbooleanundefinedПараметр вказує, чи слід перевіряти готовність Redis-сервера до обробки команд після підключення. Це може бути корисно в ситуаціях, коли Redis-сервер потребує деякого часу для ініціалізації після підключення, і ви хочете впевнитися, що він готовий до обробки команд, перш ніж надсилати їх.
connectors.redis.options.sentinel.namestringundefinedІм'я групи майстрів, до якої належить цей клієнт. Кожен майстер може мати свою власну ідентифікаційну мітку для відслідковування.
connectors.redis.options.sentinel.rolestringundefinedРоль клієнта у відношенні до Redis Sentinel, в якому він може бути master або slave.
connectors.redis.options.sentinel.sentinelUsernamestringundefinedІм'я користувача для аутентифікації на Redis Sentinel, якщо така аутентифікація вимагається.
connectors.redis.options.sentinel.sentinelPasswordstringundefinedПароль для аутентифікації на Redis Sentinel, якщо така аутентифікація вимагається.
connectors.redis.options.sentinel.sentinelsArray<{ port: number;host: string;family?: number;}>undefinedМасив об'єктів SentinelAddress, який містить адреси серверів Redis Sentinel, до яких клієнт буде підключатися для отримання інформації про конфігурацію Redis.
connectors.redis.options.sentinel.connectTimeoutnumberundefinedПараметр встановлює тайм-аут у мілісекундах для встановлення з'єднання з Redis Sentinel.
connectors.redis.options.sentinel.disconnectTimeoutnumberundefinedПараметр встановлює тайм-аут у мілісекундах для відключення з Redis Sentinel. Якщо клієнт не отримує відповіді від Redis Sentinel протягом цього тайм-ауту, він вважається відключеним.
connectors.redis.options.sentinel.sentinelCommandTimeoutnumberundefinedПараметр встановлює тайм-аут у мілісекундах для виконання команд до Redis Sentinel.
connectors.redis.options.sentinel.enableTLSForSentinelModebooleanundefinedПараметр вказує, чи слід використовувати TLS (Transport Layer Security) для забезпечення безпеки з'єднання з Redis Sentinel у режимі TLS.
connectors.redis.options.sentinel.updateSentinelsbooleanundefinedПараметр вказує, чи слід автоматично оновлювати список серверів Redis Sentinel під час роботи клієнта.
connectors.redis.options.sentinel.sentinelMaxConnectionsnumberundefinedПараметр встановлює максимальну кількість одночасних з'єднань до серверів Redis Sentinel.
connectors.redis.options.sentinel.failoverDetectorbooleanundefinedПараметр вказує, чи слід увімкнути виявлення аварійного переключення (failover detection) для автоматичного виявлення перебудови конфігурації Redis при відмові майстра.

TypeORM

Конфігурація налаштування зʼєднання з SQL базою даних, завдяки ORM - TypeORM, базовим конфігураційним типом є CredentialsOptions, який описує загальні параметри зʼєднання з базою даних:

export type CredentialsOptions = {
host: string // Хост `url` шляху до бази даних.
port: number // Порт `url` шляху до бази даних.
username: string // Імʼя користувача, під яким будет відбуватись авторизація в базі даних.
password: string // Пароль користувача, під яким будет відбуватись авторизація в базі даних.
database: string // Назва бази даних.
}

Та повний опис створення конфігурації через TypeORM:

ШляхТипЗнач. за
замовч.
Опис
connectors.typeorm.enablebooleanfalseОзнака підключення зʼєднувача TypeORM з базою даних.
connectors.typeorm.mysql.type'mysql' / 'mariadb'undefinedПідтип бази даних 'mysql' / 'mariadb'.
connectors.typeorm.mysql.credentialsCredentialsOptionsundefinedОпції зʼєднання з базою даних.
connectors.typeorm.mysql.options.timezonestringundefinedЧасовий пояс, налаштований на сервері MySQL. Це використовується для введення значень дати/часу сервера трансляції в об’єкт JavaScript Date і навпаки. Це може бути «локальний», «Z» або зсув у формі +ГГ:ХМ або -ГГ:ХХ. (За замовчуванням: "локальний")
connectors.typeorm.mysql.options.connectTimeoutnumberundefinedТаймаут з'єднання з базою даних MySQL в мілісекундах. Це обмеження на час очікування встановлення з'єднання
connectors.typeorm.mysql.options.acquireTimeoutnumberundefinedТаймаут отримання з'єднання з пулу з'єднань. Вказує, скільки часу має пройти, перш ніж відбудеться помилка при отриманні з'єднання з пулу.
connectors.typeorm.mysql.options.insecureAuthbooleanundefinedВказує, чи слід використовувати небезпечний метод автентифікації. Зазвичай не рекомендується використовувати небезпечні методи автентифікації.
connectors.typeorm.mysql.options.supportBigNumbersbooleanundefinedПоказує, чи слід підтримувати великі числа з бази даних MySQL.
connectors.typeorm.mysql.options.bigNumberStringsbooleanundefinedПоказує, чи мають великі числа представляти рядок у відповідях бази даних MySQL.
connectors.typeorm.mysql.options.dateStringsboolean / string[]undefinedВказує, як повинні представлятися дати у відповідях бази даних MySQL (як рядок або як об'єкт).
connectors.typeorm.mysql.options.debugboolean / string[]undefinedВмикає відладку SQL-запитів. Можна передати масив рядків, щоб обмежити типи запитів, які виводяться у відладкових повідомленнях.
connectors.typeorm.mysql.options.tracebooleanundefinedВмикає відстеження. Відстеження зазвичай виводить додаткову інформацію про виконані запити.
connectors.typeorm.mysql.options.multipleStatementsbooleanundefinedДозволяє виконувати кілька SQL-запитів у одному запиті до бази даних.
connectors.typeorm.mysql.options.legacySpatialSupportbooleanundefinedВмикає підтримку спадкових методів обробки геопросторових даних у MySQL.
connectors.typeorm.mysql.options.connectorPackageenumundefinedВказує, який пакет коннектора MySQL використовувати для взаємодії з базою даних MySQL. 'mysql' / 'mysql'.
connectors.typeorm.mysql.options.replication.masterCredentialsOptionsundefinedОпції зʼєднання з базою даних master сервера.
connectors.typeorm.mysql.options.replication.slavesArray<CredentialsOptions>undefinedОпції зʼєднання з базою даних масиву slave серверів.
connectors.typeorm.mysql.options.replication.canRetrybooleanundefinedВказує, чи може TypeORM спробувати повторити запит у випадку виникнення помилки.
connectors.typeorm.mysql.options.replication.removeNodeErrorCountnumberundefinedКількість помилок, після яких вузол (наприклад, сервер бази даних) буде видалено з активного списку. Це може бути корисно для видалення непрацездатних вузлів.
connectors.typeorm.mysql.options.replication.restoreNodeTimeoutnumberundefinedЧас у мілісекундах, після якого вузол буде відновлено після вилучення через removeNodeErrorCount.
connectors.typeorm.mysql.options.replication.selectorenumundefinedМетод вибору вузла з групи реплік. Варіанти включають RR (Round Robin - почерговий вибір), RANDOM (випадковий вибір) та ORDER (вибір за порядком).
connectors.typeorm.postgres.credentialsCredentialsOptionsundefinedОпції зʼєднання з базою даних.
connectors.typeorm.postgres.options.schemastringundefinedВказує схему бази даних PostgreSQL, з якою буде працювати TypeORM.
connectors.typeorm.postgres.options.useUTCbooleanundefinedПоказує, чи слід використовувати UTC для збереження та отримання дат та часів в базі даних.
connectors.typeorm.postgres.options.connectTimeoutMSnumberundefinedТаймаут з'єднання з базою даних PostgreSQL в мілісекундах. Це обмеження на час очікування встановлення з'єднання.
connectors.typeorm.postgres.options.uuidExtension'pgcrypto' / 'uuid-ossp'undefinedВибір розширення для генерації UUID. pgcrypto - використовує функції PostgreSQL для генерації UUID, uuid-ossp - використовує розширення uuid-ossp для цього.
connectors.typeorm.postgres.options.logNotificationsbooleanundefinedПоказує, чи слід виводити сповіщення (notifications) у консоль.
connectors.typeorm.postgres.options.installExtensionsbooleanundefinedПоказує, чи слід автоматично встановлювати необхідні розширення для PostgreSQL.
connectors.typeorm.postgres.options.applicationNamestringundefinedНазва додатку, яка буде відображатися у списку активних з'єднань PostgreSQL.
connectors.typeorm.postgres.options.parseInt8booleanundefinedПоказує, чи слід конвертувати значення INT8 PostgreSQL в JavaScript тип Number.
connectors.typeorm.postgres.options.replication.masterCredentialsOptionsundefinedОпції зʼєднання з базою даних master сервера.
connectors.typeorm.postgres.options.replication.slavesArray<CredentialsOptions>undefinedОпції зʼєднання з базою даних масиву slave серверів.
connectors.typeorm.sqlite.databasestringundefinedНазва бази даних.
connectors.typeorm.sqlite.keystringundefinedКлюч шифрування бази даних SQLite. Вказується, якщо база даних зашифрована.
connectors.typeorm.sqlite.busyErrorRetrynumberundefinedКількість спроб звернення до бази даних у випадку отримання помилки зайнятості. Це може бути корисно в умовах великої конкуренції за доступ до бази даних.
connectors.typeorm.sqlite.enableWALbooleanundefinedВказує, чи слід увімкнути режим Write-Ahead Logging (WAL) для бази даних SQLite. Цей режим може покращити швидкодію та надійність взаємодії з базою даних.
connectors.typeorm.sqlite.flagsnumberundefinedФлаги відкриття бази даних SQLite. Використовуються для передачі додаткових параметрів при відкритті бази даних.
connectors.typeorm.sqlite.busyTimeoutnumberundefinedТаймаут очікування вільності бази даних SQLite в мілісекундах. Вказує, скільки часу буде очікувати TypeORM, перш ніж повернути помилку в разі зайнятості бази даних.

Адаптери

Ядро обчислень дозволяє конфігурувати наступні види адаптерів:

HTTP Adapter

ШляхТипЗнач. за
замовч.
Опис
adapters.http.enablebooleantrueОзнака підключення http адаптера ядра обчислень.
adapters.http.kindenumfastifyТип http фреймворку, який буде задіяний в роботі ядра обчислень, наразі доступний лише fastify, в послідуючому будуть доступні express, hapi.
adapters.http.serverTagstringANONYMOUS_01Унікальна назва ядра обчислень, яке повинно бути унікальним при використанні групи ядер обчислень, оскільки воно використовується в логувані та трейсінгу.
adapters.http.protocolstringhttpТип протоколу, може бути http або https
adapters.http.hoststring0.0.0.0Хост url шляху доступу до http веб-сервера.
adapters.http.portnumber11010Порт url шляху доступу до http веб-сервера.
adapters.http.https.keystring' 'Шлях до файлу закритого ключа.
adapters.http.https.certstring' 'Шлях до сертифікату.
adapters.http.fastify.connectionTimeoutnumberundefinedЧас очікування (в мілісекундах), після якого Fastify розірве зʼєднання з клієнтом, якщо клієнт не відповів.
adapters.http.fastify.keepAliveTimeoutnumberundefinedЧас очікування (в мілісекундах), між запитами на цьому ж сокеті. Це час, напротязі якого Fastify очікує, наступного запиту від клієнта на цьому ж зʼєднанні.
adapters.http.fastify.maxRequestsPerSocketnumberundefinedМаксимальна кількість запитів, які Fastify дозволить обробляти на одному сокеті до його закриття.
adapters.http.fastify.forceCloseConnectionsbooleanundefinedЯкщо встановлено в true, Fastify закриє з'єднання відразу після завершення обробки запиту. Якщо встановлено значення idle, Fastify буде закривати неактивні з'єднання після keepAliveTimeout
adapters.http.fastify.requestTimeoutnumberundefinedМаксимальний час виконання запиту (в мілісекундах). Якщо запит не завершиться протягом цього часу, Fastify його перерве.
adapters.http.fastify.bodyLimitnumberundefinedМаксимальний розмір тіла запиту (в байтах). Якщо розмір тіла запиту перевищує це значення, Fastify відхилить запит з помилкою 413 Payload Too Large.
adapters.http.urls.apistring/v1/call/apiБазовий маршрут REST API.

WS Adapter

ШляхТипЗнач. за
замовч.
Опис
adapters.ws.enablebooleanfalseОзнака підключення ws адаптера ядра обчислень.
adapters.ws.kindstringwsТип ws фреймворку, який буде задіяний в роботі ядра обчислень, наразі доступний лише ws, в послідуючому буде доступний ще й socketIO
adapters.ws.protocolstringwsТип протоколу, може бути ws або wss.
adapters.ws.hoststring0.0.0.0Хост url шляху доступу до ws веб-сервера.
adapters.ws.portnumber11011Хост url шляху доступу до ws веб-сервера.
adapters.ws.wss.keystring' 'Шлях до файлу закритого ключа.
adapters.ws.wss.certstring' 'Шлях до сертифікату.
adapters.ws.ws.backlognumberundefinedМаксимальна довжина черги з'єднань TCP, яка буде використана при відкритті серверного сокету.
adapters.ws.ws.maxPayloadnumberundefinedМаксимальний розмір повідомлення (в байтах), яке сервер WebSocket приймає.
adapters.ws.ws.skipUTF8ValidationbooleanundefinedЯкщо цей параметр встановлено в true, ws server пропустить перевірку правильності кодування UTF-8 для отриманих повідомлень
adapters.ws.ws.perMessageDeflatebooleanundefinedСтискання повідомлень (per-message compression), яке дозволяє стискати дані перед їх відправленням через WebSocket з'єднання. Це може бути корисно для зменшення обсягу даних, які передаються між клієнтом і сервером, що в свою чергу може поліпшити швидкодію та знизити використання мережевого трафіку.
adapters.ws.ws.perMessageDeflate.serverNoContextTakeoverbooleanundefinedВказує, чи повинен ws адаптер зберігати стан стискання між повідомленнями.
adapters.ws.ws.perMessageDeflate.serverMaxWindowBitsnumberundefinedВизначає максимальний розмір вікна стискання для сервера та клієнта.
adapters.ws.ws.perMessageDeflate.thresholdnumberundefinedМінімальний розмір повідомлення, який потрібно стискати.
adapters.ws.ws.perMessageDeflate.concurrencyLimitnumberundefinedСМаксимальна кількість одночасних компресій або декомпресій, які дозволені одночасно.

Інтеграції

Конфігурація сервісу локалізації ядра обчислень:

ШляхТипЗнач. за
замовч.
Опис
integrations.mail.enablebooleanfalseОзнака підключення mail інтеграції ядра обчислень.
integrations.mail.hoststring' 'Вказує DNS-ім'я або IP-адресу поштового сервера (SMTP-сервера), з яким буде встановлено з'єднання. Це може бути адреса власного SMTP-сервера, який ви керуєте або використовуєте сторонній поштовий сервіс, такий як Gmail або Outlook.
integrations.mail.portnumber587Вказує порт, за яким відбуватиметься спроба з'єднання з поштовим сервером. Для серверів SMTP за звичайним портом зазвичай використовується порт 587 для зв'язку через звичайне з'єднання або порт 465 для зв'язку через SSL (Secure Sockets Layer) / TLS (Transport Layer Security).
integrations.mail.securebooleanfalseЯкщо істина, з’єднання використовуватиме протокол TLS під час підключення до сервера. Якщо false (за замовчуванням), то TLS використовується, якщо сервер підтримує розширення STARTTLS. У більшості випадків встановіть для цього значення значення true, якщо ви підключаєтесь до порту 465. Для порту 587 або 25 залиште значення false.
integrations.mail.secure.auth.userstring' 'Ім'я користувача.
integrations.mail.secure.auth.passstring' 'Пароль для користувача, якщо використовується звичайний вхід.
integrations.mail.contact.fromstring' 'Адреса електронної пошти відправника. Усі адреси електронної пошти можуть бути звичайними «sender@server.com» або у форматі ««Ім’я відправника» sender@server.com».
integrations.mail.withMessageIdbooleantrueЧи слід додавати унікальний ідентифікатор повідомлення Message-ID під час відправлення електронної пошти. Кожне повідомлення електронної пошти повинно мати унікальний ідентифікатор, який використовується для відстеження і визначення повідомлення. Це особливо корисно при веденні журналу відправлених повідомлень, відстеженні доставки або використанні в системах антиспаму для ідентифікації повідомлень.

Сервіси

LocalizationService

Конфігурація сервісу локалізації ядра обчислень:

ШляхТипЗнач. за
замовч.
Опис
services.localization.enablebooleantrueОзнака підключення сервісу локалізації ядра обчислень.
services.localization.supportedLanguagesstring[]['en']Перелік підтримуваних мов перекладу, які використовуються в бізнес-схемі.
services.localization.defaultLanguagesstringenМова перекладу за замовчуванням, якщо відсутній переклад потрібного ключа.

LoggerService

Конфігурація сервісу логування:

ШляхТипЗнач. за
замовч.
Опис
services.logger.enablebooleantrueОзнака підключення сервісу логування ядра обчислень.
services.logger.loggers.corebooleantrueОзнака підключення логування роботи ядра обчислень.
services.logger.loggers.schemabooleantrueОзнака підключення логування роботи бізнес-схеми.
services.logger.transports.console.core.enablebooleantrueОзнака підключення логування роботи ядра обчислень в консоль.
services.logger.transports.console.core.levelstringverboseРівень логування роботи ядра обчислень, кожний нижчий рівень включає в собі всі верхні рівні, які також будуть логуватись
services.logger.transports.console.schema.enablestringdebugОзнака підключення логування роботи ядра обчислень в консоль.
services.logger.transports.console.schema.levelstringdebugРівень логування роботи бізнес-схеми, кожний нижчий рівень включає в собі всі верхні рівні, які також будуть логуватись

Рівні логування ядра обчислень

 const levels = {
error: 0, // Помилки та виключення
warn: 1, // Попередження
system: 2, // Вивід роботи системи
api: 3, // API запити через http та ws
database: 4, // Запити до бази даних
storage: 5, // Запити до Redis та хмарних сховищ по типу S3 чи інші.
info: 6, // Логування загальної інформації
schema: 7, // Логування обробки бізнес-схеми
verbose: 8, // Опис розгорнутих структур
};

Рівні логування бізнес-схеми

const levels = {
error: 0, // Помилки
exception: 1, // Виключення
warn: 2, // Попередження
api: 3, // API запити через http та ws
info: 4, // Логування загальної інформації
debug: 5, // Режим відлажування кодової бази
};
примітка

Передбачається в цьому ж релізі, але в наступній версії, додати підтримку Elasticsearch стеку та логування в файли з відповідними конфігураційними параметрами.

ScramblerService

Конфігурація сервісу шифрування:

ШляхТипЗнач. за
замовч.
Опис
services.scrambler.enablebooleantrueОзнака підключення сервісу шифрування ядра обчислень.
services.scrambler.saltnumber5Кількість солі, яка буде додана до строки хешування.
services.scrambler.secretstringdefaultСтрока з секретом, який буде включений при шифруванні чи дешифруванні.
services.scrambler.randomBytesnumber10Кількість випадкових байтів, які в послідуючому будуть перетворені у рядок шістнадцяткового представлення, що зручно для багатьох використань, наприклад, для генерації випадкових кодів, створення токенів, ключів, та інших криптографічних цілей.
services.scrambler.accessExpiredAtnumber10Кількість хвилин терміну дії access токену доступу.
services.scrambler.refreshExpiredAtnumber30Кількість днів терміну дії refresh токену доступу.
services.scrambler.defaultAlgorithmstringMD5Тип алгоритму шифрування, підтримуються наступні типи шифрування export type Algorithm = 'HS256' / 'HS384 / 'HS512' / 'RS256' / 'RS384' / 'RS512' / 'ES256' / 'ES384' / 'ES512' / 'PS256' / 'PS384' / 'PS512'

SpecificationService

Конфігурація сервісу специфікації:

ШляхТипЗнач. за
замовч.
Опис
services.specification.enablebooleanfalseОзнака підключення сервісу специфікації ядра обчислень.
services.specification.liveReloadbooleanfalseОзнака перезавантаження сервіса специфікації при зміні сертифікації.