--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ydb.tech/docs/en/devops/deployment-options/ansible/initial-deployment/deployment-configuration-v1.md?version=v26.1 - https://ydb.tech/docs/ru/devops/deployment-options/ansible/initial-deployment/deployment-configuration-v1.md?version=v26.1 - href: ru/devops/deployment-options/ansible/initial-deployment/deployment-configuration-v1.md type: text/markdown title: Markdown version - href: ../../../../llms.txt type: text/markdown title: llms.txt sourcePath: ru/core/devops/deployment-options/ansible/initial-deployment/deployment-configuration-v1.md --- > **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt # Развёртывание кластера с использованием конфигурации V1 ## Подготовьте окружение {# deployment-preparation} Перед развёртыванием системы обязательно выполните подготовительные действия. Ознакомьтесь с документом [Подготовка к развертыванию](https://ydb.tech/docs/ru/devops/deployment-options/ansible/initial-deployment/deployment-preparation.md?version=v26.1). ## Создайте директорию для работы {#prepare-directory} ```bash mkdir deployment cd deployment mkdir inventory mkdir files ``` ## Создайте конфигурационный файл Ansible {# ansible-creat-config} Создайте `ansible.cfg` с конфигурацией Ansible, подходящей для целевой среды развёртывания. Подробности в [справочнике по конфигурации Ansible](https://docs.ansible.com/ansible/latest/reference_appendices/config.html). Дальнейшее руководство предполагает, что поддиректория `./inventory` рабочей директории настроена для использования файлов инвентаризации. {% cut "Пример стартового ansible.cfg" %} {% note info %} Использование параметра `StrictHostKeyChecking=no` в `ssh_args` повышает удобство автоматизации, но снижает уровень безопасности SSH-соединения (отключает проверку подлинности хоста). Для production-окружений рекомендуется не указывать этот аргумент и настроить доверенные ключи вручную. Используйте этот параметр только для тестовых и временных установок. {% endnote %} ```ini [defaults] conditional_bare_variables = False force_handlers = True gathering = explicit interpreter_python = /usr/bin/python3 inventory = ./inventory pipelining = True private_role_vars = True timeout = 5 verbosity = 1 log_path = ./ydb.log vault_password_file = ./ansible_vault_password_file [ssh_connection] retries = 5 timeout = 60 ssh_args = -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -o ControlMaster=auto -o ControlPersist=60s -o ControlPath=/tmp/ssh-%h-%p-%r -o ServerAliveCountMax=3 -o ServerAliveInterval=10 ``` {% endcut %} ## Создайте основной файл инвентаризации {#inventory-create} Создайте файл `inventory/50-inventory.yaml` и заполните его в зависимости от выбранной топологии (подробнее: [выбор топологии](https://ydb.tech/docs/ru/devops/deployment-options/ansible/initial-deployment/deployment-preparation.md?version=v26.1#topology-select)). Примеры для каждой поддерживаемой топологии приведены ниже во вкладках — выберите подходящий. {% list tabs %} - mirror-3-dc-3nodes ```yaml all: children: ydb: #Серверы hosts: static-node-1.ydb-cluster.com: static-node-2.ydb-cluster.com: static-node-3.ydb-cluster.com: vars: # Ansible ansible_user: имя_пользователя ansible_ssh_private_key_file: "/путь/к/вашему/id_rsa" # Система system_timezone: UTC system_ntp_servers: [time.cloudflare.com, time.google.com, ntp.ripe.net, pool.ntp.org] # Узлы ydb_config: "{{ ansible_config_file | dirname }}/files/config.yaml" ydb_version: "версия_системы" # Хранилище ydb_cores_static: 8 ydb_disks: - name: /dev/vdb label: ydb_disk_1 - name: /dev/vdc label: ydb_disk_2 - name: /dev/vdd label: ydb_disk_3 ydb_allow_format_drives: true ydb_skip_data_loss_confirmation_prompt: false ydb_pool_kind: ssd ydb_database_groups: 8 ydb_cores_dynamic: 8 ydb_dynnodes: - { instance: 'a', offset: 1 } - { instance: 'b', offset: 2 } ydb_brokers: - static-node-1.ydb-cluster.com - static-node-2.ydb-cluster.com - static-node-3.ydb-cluster.com # База данных ydb_user: root ydb_domain: Root ydb_dbname: database #Настройки авторизации ydb_enforce_user_token_requirement: true ydb_request_client_certificate: true ``` - mirror-3-dc-9-nodes ```yaml all: children: ydb: #Серверы hosts: static-node-1.ydb-cluster.com: static-node-2.ydb-cluster.com: static-node-3.ydb-cluster.com: static-node-4.ydb-cluster.com: static-node-5.ydb-cluster.com: static-node-6.ydb-cluster.com: static-node-7.ydb-cluster.com: static-node-8.ydb-cluster.com: static-node-9.ydb-cluster.com: vars: # Ansible ansible_user: имя_пользователя ansible_ssh_private_key_file: "/путь/к/вашему/id_rsa" # Система system_timezone: UTC system_ntp_servers: [time.cloudflare.com, time.google.com, ntp.ripe.net, pool.ntp.org] # Узлы ydb_config: "{{ ansible_config_file | dirname }}/files/config.yaml" ydb_version: "версия_системы" # Хранилище ydb_cores_static: 8 ydb_disks: - name: /dev/vdb label: ydb_disk_1 ydb_allow_format_drives: true ydb_skip_data_loss_confirmation_prompt: false ydb_pool_kind: ssd ydb_database_groups: 8 ydb_cores_dynamic: 8 ydb_dynnodes: - { instance: 'a', offset: 1 } - { instance: 'b', offset: 2 } ydb_brokers: - static-node-1.ydb-cluster.com - static-node-2.ydb-cluster.com - static-node-3.ydb-cluster.com # База данных ydb_user: root ydb_domain: Root ydb_dbname: database #Настройки авторизации ydb_enforce_user_token_requirement: true ydb_request_client_certificate: true ``` - block-4-2 ```yaml all: children: ydb: #Серверы hosts: static-node-1.ydb-cluster.com: static-node-2.ydb-cluster.com: static-node-3.ydb-cluster.com: static-node-4.ydb-cluster.com: static-node-5.ydb-cluster.com: static-node-6.ydb-cluster.com: static-node-7.ydb-cluster.com: static-node-8.ydb-cluster.com: vars: # Ansible ansible_user: имя_пользователя ansible_ssh_private_key_file: "/путь/к/вашему/id_rsa" # Система system_timezone: UTC system_ntp_servers: [time.cloudflare.com, time.google.com, ntp.ripe.net, pool.ntp.org] # Узлы ydb_config: "{{ ansible_config_file | dirname }}/files/config.yaml" ydb_version: "версия_системы" # Хранилище ydb_cores_static: 8 ydb_disks: - name: /dev/vdb label: ydb_disk_1 ydb_allow_format_drives: true ydb_skip_data_loss_confirmation_prompt: false ydb_pool_kind: ssd ydb_database_groups: 7 ydb_cores_dynamic: 8 ydb_dynnodes: - { instance: 'a', offset: 1 } - { instance: 'b', offset: 2 } ydb_brokers: - static-node-1.ydb-cluster.com - static-node-2.ydb-cluster.com - static-node-3.ydb-cluster.com # База данных ydb_user: root ydb_domain: Root ydb_dbname: database #Настройки авторизации ydb_enforce_user_token_requirement: true ydb_request_client_certificate: true ``` {% endlist %} Обязательные настройки, которые нужно адаптировать под окружение в выбранном шаблоне: 1. **Имена серверов.** Замените `static-node-*.ydb-cluster.com` в `all.children.ydb.hosts` и `all.children.vars.ydb_brokers` на реальные [FQDN](https://ru.wikipedia.org/wiki/FQDN). 2. **Настройка SSH доступа.** Укажите пользователя `ansible_user` и путь к приватному ключу `ansible_ssh_private_key_file`, которые Ansible будет использовать для подключения к вашим серверам. 3. **Пути к блочным устройствам в файловой системе.** В секции `all.children.ydb.vars.ydb_disks` шаблон предполагает, что `/dev/vda` предназначен для операционной системы, а следующие диски, такие как `/dev/vdb`, — для слоя хранения YDB. Метки дисков создаются плейбуками автоматически, и их имена могут быть произвольными. 4. **Версия системы.** В параметре `ydb_version` укажите номер версии YDB, которую нужно установить. Список доступных версий вы найдёте на странице [загрузок](https://ydb.tech/docs/ru/downloads/ydb-open-source-database.md?version=v26.1). Рекомендуемые настройки для адаптации: - `ydb_domain`. Это будет первый компонент пути для всех [объектов схемы](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#scheme-object) в кластере. Например, можно поместить туда название своей компании, регион кластера и т.д. - `ydb_dbname`. Это будет второй компонент пути для всех [объектов схемы](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#scheme-object) в базе данных. Например, можно поместить туда название сценария использования или проекта. {% cut "Дополнительные настройки" %} Существует несколько вариантов указания того, какие именно исполняемые файлы YDB вы хотите использовать для кластера: - `ydb_version`: автоматически загрузить один из [официальных релизов YDB](https://ydb.tech/docs/ru/downloads/index.md?version=v26.1#ydb-server) по номеру версии. Например, `23.4.11`. - `ydb_archive`: локальный путь файловой системы к архиву дистрибутива YDB, [загруженному](https://ydb.tech/docs/ru/downloads/index.md?version=v26.1#ydb-server) или иным образом подготовленному заранее. Для использования [федеративных запросов](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/index.md?version=v26.1) может потребоваться установка [коннектора](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/architecture.md?version=v26.1#connectors). Плейбук может развернуть [fq-connector-go](https://ydb.tech/docs/ru/devops/deployment-options/manual/federated-queries/connector-deployment.md?version=v26.1#fq-connector-go) на хостах с динамическими узлами. Используйте следующие настройки: - `ydb_install_fq_connector` — установите в `true` для установки коннектора. - Выберите один из доступных вариантов развёртывания исполняемых файлов fq-connector-go: - `ydb_fq_connector_version`: автоматически загрузить один из [официальных релизов fq-connector-go](https://github.com/ydb-platform/fq-connector-go/releases) по номеру версии. Например, `v0.7.1`. - `ydb_fq_connector_git_version`: автоматически скомпилировать исполняемый файл fq-connector-go из исходного кода, загруженного из [официального репозитория GitHub](https://github.com/ydb-platform/fq-connector-go). Значение настройки — это имя ветки, тега или коммита. Например, `main`. - `ydb_fq_connector_archive`: локальный путь файловой системы к архиву дистрибутива fq-connector-go, [загруженному](https://github.com/ydb-platform/fq-connector-go/releases) или иным образом подготовленному заранее. - `ydb_fq_connector_binary`: локальные пути файловой системы к исполняемому файлу fq-connector-go, [загруженному](https://github.com/ydb-platform/fq-connector-go/releases) или иным образом подготовленному заранее. - `ydb_tls_dir` — укажите локальный путь к папке с TLS-сертификатами, подготовленными заранее. Она должна содержать файл `ca.crt` и подкаталоги с именами, соответствующими именам хостов узлов, содержащие сертификаты для данного узла. Если не указано, самоподписанные TLS-сертификаты будут сгенерированы автоматически для всего кластера YDB. - `ydb_brokers` — перечислите FQDN узлов брокеров. Например: ```yaml ydb_brokers: - static-node-1.ydb-cluster.com - static-node-2.ydb-cluster.com - static-node-3.ydb-cluster.com ``` Оптимальное значение настройки `ydb_database_groups` в разделе `vars` зависит от доступных дисков. Предполагая только одну базу данных в кластере, используйте следующую логику: - Для промышленных развёртываний используйте диски ёмкостью более 800 ГБ с высокой производительностью IOPS, затем выберите значение для этой настройки на основе топологии кластера: - Для `block-4-2` установите `ydb_database_groups` на 95% от общего количества дисков, округляя вниз. - Для `mirror-3-dc` установите `ydb_database_groups` на 84% от общего количества дисков, округляя вниз. - Для тестирования YDB на небольших дисках установите `ydb_database_groups` в 1 независимо от топологии кластера. Значения переменных `system_timezone` и `system_ntp_servers` зависят от свойств инфраструктуры, на которой развёртывается кластер YDB. По умолчанию `system_ntp_servers` включает набор NTP-серверов без учёта географического расположения инфраструктуры, на которой будет развёрнут кластер YDB. Мы настоятельно рекомендуем использовать локальный NTP-сервер для on-premise инфраструктуры и следующие NTP-серверы для облачных провайдеров: {% list tabs %} - AWS - `system_timezone`: USA/ - `system_ntp_servers`: [169.254.169.123, time.aws.com] [Подробнее](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html#configure-time-sync) о настройках NTP-серверов AWS. - Azure - О том, как настраивается синхронизация времени на виртуальных машинах Azure, можно прочитать в [этой](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/time-sync) статье. - Alibaba - Специфика подключения к NTP-серверам в Alibaba описана в [этой статье](https://www.alibabacloud.com/help/en/ecs/user-guide/alibaba-cloud-ntp-server). - Yandex Cloud - `system_timezone`: Europe/Moscow - `system_ntp_servers`: [0.ru.pool.ntp.org, 1.ru.pool.ntp.org, ntp0.NL.net, ntp2.vniiftri.ru, ntp.ix.ru, ntps1-1.cs.tu-berlin.de] [Подробнее](https://yandex.cloud/ru/docs/tutorials/infrastructure-management/ntp) о настройках NTP-серверов Yandex Cloud. {% endlist %} {% endcut %} ## Измените пароль пользователя root {#change-password} Создайте файл `ansible_vault_password_file` с содержимым: ```text password ``` Этот файл содержит пароль, который Ansible будет использовать для автоматического шифрования и расшифровки конфиденциальных данных, например, файлов с паролями пользователей. Благодаря этому пароли не хранятся в открытом виде в репозитории. Подробнее о работе механизма Ansible Vault можно прочитать в [официальной документации](https://docs.ansible.com/ansible/latest/vault_guide/index.html). Далее необходимо установить пароль для начального пользователя, указанного в настройке `ydb_user` (по умолчанию `root`). Этот пользователь изначально будет иметь полные права доступа в кластере, но при необходимости это можно изменить позже. Создайте `inventory/99-inventory-vault.yaml` со следующим содержимым (замените `` на фактический пароль): ```yaml all: children: ydb: vars: ydb_password: ``` Зашифруйте этот файл с помощью команды `ansible-vault encrypt inventory/99-inventory-vault.yaml`. ## Подготовьте конфигурационный файл YDB {#ydb-config-prepare} Создайте файл `files/config.yaml` и заполните его в зависимости от выбранной топологии (подробнее: [выбор топологии](https://ydb.tech/docs/ru/devops/deployment-options/ansible/initial-deployment/deployment-preparation.md?version=v26.1#topology-select)). Примеры для каждой поддерживаемой топологии приведены ниже во вкладках — выберите подходящий. {% list tabs %} - mirror-3-dc-3nodes ```yaml storage_config_generation: 0 static_erasure: mirror-3-dc host_configs: - drive: - path: /dev/disk/by-partlabel/ydb_disk_1 type: SSD - path: /dev/disk/by-partlabel/ydb_disk_2 type: SSD - path: /dev/disk/by-partlabel/ydb_disk_3 type: SSD host_config_id: 1 hosts: - host: static-node-1.ydb-cluster.com host_config_id: 1 walle_location: body: 1 data_center: 'zone-a' rack: '1' - host: static-node-2.ydb-cluster.com host_config_id: 1 walle_location: body: 2 data_center: 'zone-b' rack: '2' - host: static-node-3.ydb-cluster.com host_config_id: 1 walle_location: body: 3 data_center: 'zone-d' rack: '3' domains_config: domain: - name: Root storage_pool_types: - kind: ssd pool_config: box_id: 1 erasure_species: mirror-3-dc kind: ssd geometry: realm_level_begin: 10 realm_level_end: 20 domain_level_begin: 10 domain_level_end: 256 pdisk_filter: - property: - type: SSD vdisk_kind: Default state_storage: - ring: node: [1, 2, 3] nto_select: 3 ssid: 1 security_config: enforce_user_token_requirement: true monitoring_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" administration_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" viewer_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" register_dynamic_node_allowed_sids: - databaseNodes@cert - root@builtin blob_storage_config: service_set: groups: - erasure_species: mirror-3-dc rings: - fail_domains: - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_2 - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_3 - fail_domains: - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_2 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_3 - fail_domains: - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_2 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_3 channel_profile_config: profile: - channel: - erasure_species: mirror-3-dc pdisk_category: 1 # 0=ROT, 1=SSD, 2=NVME storage_pool_kind: ssd - erasure_species: mirror-3-dc pdisk_category: 1 storage_pool_kind: ssd - erasure_species: mirror-3-dc pdisk_category: 1 storage_pool_kind: ssd profile_id: 0 interconnect_config: start_tcp: true encryption_mode: OPTIONAL path_to_certificate_file: "/opt/ydb/certs/node.crt" path_to_private_key_file: "/opt/ydb/certs/node.key" path_to_ca_file: "/opt/ydb/certs/ca.crt" grpc_config: cert: "/opt/ydb/certs/node.crt" key: "/opt/ydb/certs/node.key" ca: "/opt/ydb/certs/ca.crt" services_enabled: - legacy - discovery auth_config: path_to_root_ca: /opt/ydb/certs/ca.crt client_certificate_authorization: request_client_certificate: true client_certificate_definitions: - member_groups: ["databaseNodes@cert"] subject_terms: - short_name: "O" values: ["YDB"] query_service_config: generic: connector: endpoint: host: localhost port: 19102 use_ssl: false default_settings: - name: DateTimeFormat value: string - name: UsePredicatePushdown value: "true" feature_flags: enable_external_data_sources: true enable_script_execution_operations: true ``` - mirror-3-dc-9-nodes ```yaml storage_config_generation: 0 static_erasure: mirror-3-dc host_configs: - drive: - path: /dev/disk/by-partlabel/ydb_disk_1 type: SSD host_config_id: 1 hosts: - host: static-node-1.ydb-cluster.com host_config_id: 1 walle_location: body: 1 data_center: 'zone-a' rack: '1' - host: static-node-2.ydb-cluster.com host_config_id: 1 walle_location: body: 2 data_center: 'zone-a' rack: '2' - host: static-node-3.ydb-cluster.com host_config_id: 1 walle_location: body: 3 data_center: 'zone-a' rack: '3' - host: static-node-4.ydb-cluster.com host_config_id: 1 walle_location: body: 4 data_center: 'zone-b' rack: '4' - host: static-node-5.ydb-cluster.com host_config_id: 1 walle_location: body: 5 data_center: 'zone-b' rack: '5' - host: static-node-6.ydb-cluster.com host_config_id: 1 walle_location: body: 6 data_center: 'zone-b' rack: '6' - host: static-node-7.ydb-cluster.com host_config_id: 1 walle_location: body: 7 data_center: 'zone-d' rack: '7' - host: static-node-8.ydb-cluster.com host_config_id: 1 walle_location: body: 8 data_center: 'zone-d' rack: '8' - host: static-node-9.ydb-cluster.com host_config_id: 1 walle_location: body: 9 data_center: 'zone-d' rack: '9' domains_config: domain: - name: Root storage_pool_types: - kind: ssd pool_config: box_id: 1 erasure_species: mirror-3-dc kind: ssd pdisk_filter: - property: - type: SSD vdisk_kind: Default state_storage: - ring: node: [1, 2, 3, 4, 5, 6, 7, 8, 9] nto_select: 9 ssid: 1 security_config: enforce_user_token_requirement: true monitoring_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" administration_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" viewer_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" register_dynamic_node_allowed_sids: - databaseNodes@cert - root@builtin blob_storage_config: service_set: groups: - erasure_species: mirror-3-dc rings: - fail_domains: - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - fail_domains: - vdisk_locations: - node_id: static-node-4.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-5.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-6.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - fail_domains: - vdisk_locations: - node_id: static-node-7.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-8.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-9.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 channel_profile_config: profile: - channel: - erasure_species: mirror-3-dc pdisk_category: 1 # 0=ROT, 1=SSD, 2=NVME storage_pool_kind: ssd - erasure_species: mirror-3-dc pdisk_category: 1 storage_pool_kind: ssd - erasure_species: mirror-3-dc pdisk_category: 1 storage_pool_kind: ssd profile_id: 0 interconnect_config: start_tcp: true encryption_mode: OPTIONAL path_to_certificate_file: "/opt/ydb/certs/node.crt" path_to_private_key_file: "/opt/ydb/certs/node.key" path_to_ca_file: "/opt/ydb/certs/ca.crt" grpc_config: cert: "/opt/ydb/certs/node.crt" key: "/opt/ydb/certs/node.key" ca: "/opt/ydb/certs/ca.crt" services_enabled: - legacy auth_config: path_to_root_ca: /opt/ydb/certs/ca.crt client_certificate_authorization: request_client_certificate: true client_certificate_definitions: - member_groups: ["databaseNodes@cert"] subject_terms: - short_name: "O" values: ["YDB"] query_service_config: generic: connector: endpoint: host: localhost port: 19102 use_ssl: false default_settings: - name: DateTimeFormat value: string - name: UsePredicatePushdown value: "true" feature_flags: enable_external_data_sources: true enable_script_execution_operations: true ``` - block-4-2 ```yaml storage_config_generation: 0 static_erasure: block-4-2 host_configs: - drive: - path: /dev/disk/by-partlabel/ydb_disk_1 type: SSD host_config_id: 1 hosts: - host: static-node-1.ydb-cluster.com host_config_id: 1 walle_location: body: 1 data_center: 'zone-a' rack: '1' - host: static-node-2.ydb-cluster.com host_config_id: 1 walle_location: body: 2 data_center: 'zone-a' rack: '2' - host: static-node-3.ydb-cluster.com host_config_id: 1 walle_location: body: 3 data_center: 'zone-a' rack: '3' - host: static-node-4.ydb-cluster.com host_config_id: 1 walle_location: body: 4 data_center: 'zone-a' rack: '4' - host: static-node-5.ydb-cluster.com host_config_id: 1 walle_location: body: 5 data_center: 'zone-a' rack: '5' - host: static-node-6.ydb-cluster.com host_config_id: 1 walle_location: body: 6 data_center: 'zone-a' rack: '6' - host: static-node-7.ydb-cluster.com host_config_id: 1 walle_location: body: 7 data_center: 'zone-a' rack: '7' - host: static-node-8.ydb-cluster.com host_config_id: 1 walle_location: body: 8 data_center: 'zone-a' rack: '8' domains_config: domain: - name: Root storage_pool_types: - kind: ssd pool_config: box_id: 1 erasure_species: block-4-2 kind: ssd pdisk_filter: - property: - type: SSD vdisk_kind: Default state_storage: - ring: node: - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 nto_select: 8 ssid: 1 security_config: enforce_user_token_requirement: true monitoring_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" administration_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" viewer_allowed_sids: - "root" - "ADMINS" - "DATABASE-ADMINS" register_dynamic_node_allowed_sids: - databaseNodes@cert - root@builtin blob_storage_config: service_set: groups: - erasure_species: block-4-2 rings: - fail_domains: - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-4.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-5.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-6.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-7.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 - vdisk_locations: - node_id: static-node-8.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 channel_profile_config: profile: - channel: - erasure_species: block-4-2 pdisk_category: 1 # 0=ROT, 1=SSD, 2=NVME storage_pool_kind: ssd - erasure_species: block-4-2 pdisk_category: 1 storage_pool_kind: ssd - erasure_species: block-4-2 pdisk_category: 1 storage_pool_kind: ssd profile_id: 0 interconnect_config: start_tcp: true encryption_mode: OPTIONAL path_to_certificate_file: "/opt/ydb/certs/node.crt" path_to_private_key_file: "/opt/ydb/certs/node.key" path_to_ca_file: "/opt/ydb/certs/ca.crt" grpc_config: cert: "/opt/ydb/certs/node.crt" key: "/opt/ydb/certs/node.key" ca: "/opt/ydb/certs/ca.crt" services_enabled: - legacy - discovery auth_config: path_to_root_ca: /opt/ydb/certs/ca.crt client_certificate_authorization: request_client_certificate: true client_certificate_definitions: - member_groups: ["databaseNodes@cert"] subject_terms: - short_name: "O" values: ["YDB"] query_service_config: generic: connector: endpoint: host: localhost port: 19102 use_ssl: false default_settings: - name: DateTimeFormat value: string - name: UsePredicatePushdown value: "true" feature_flags: enable_external_data_sources: true enable_script_execution_operations: true ``` {% endlist %} Для ускорения и упрощения первичного развёртывания YDB конфигурационный файл уже содержит большинство настроек для установки кластера. Достаточно заменить стандартные хосты FQDN на актуальные в разделах `hosts` и `blob_storage_config`. - Раздел `hosts`: ```yaml ... hosts: - host: static-node-1.ydb-cluster.com #FQDN ВМ host_config_id: 1 walle_location: body: 1 data_center: 'zone-a' rack: '1' ... ``` - Раздел `blob_storage_config`: ```yaml ... - fail_domains: - vdisk_locations: - node_id: static-node-1.ydb-cluster.com #FQDN ВМ pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_1 ... ``` Остальные секции и настройки конфигурационного файла остаются без изменений. ## Разверните кластер YDB {# cluster-deployment} После завершения всех описанных выше подготовительных действий фактическое первоначальное развёртывание кластера сводится к выполнению следующей команды из рабочей директории: ```bash ansible-playbook ydb_platform.ydb.initial_setup ``` Вскоре после начала будет необходимо подтвердить полную очистку настроенных дисков. Затем завершение развёртывания может занять десятки минут в зависимости от окружения и настроек. Этот плейбук выполняет примерно те же шаги, которые описаны в инструкциях для [ручного развёртывания кластера YDB](https://ydb.tech/docs/ru/devops/deployment-options/manual/initial-deployment/index.md?version=v26.1). ### Проверьте состояние кластера {#cluster-state} На последнем этапе плейбук выполнит несколько тестовых запросов с использованием настоящих временных таблиц для проверки корректной работы. При успешном выполнении для каждого сервера будут отображены статус ok, failed=0 и результаты тестовых запросов (3 и 6) при достаточно подробном выводе плейбука. {% cut "Пример вывода" %} ```txt ... TASK [ydb_platform.ydb.ydbd_dynamic : run test queries] ******************************************************************************************************************************************************* ok: [static-node-1.ydb-cluster.com] => (item={'instance': 'a'}) => {"ansible_loop_var": "item", "changed": false, "item": {"instance": "a"}, "msg": "all test queries were successful, details: {\"count\":3,\"sum\":6}\n"} ok: [static-node-1.ydb-cluster.com] => (item={'instance': 'b'}) => {"ansible_loop_var": "item", "changed": false, "item": {"instance": "b"}, "msg": "all test queries were successful, details: {\"count\":3,\"sum\":6}\n"} ok: [static-node-2.ydb-cluster.com] => (item={'instance': 'a'}) => {"ansible_loop_var": "item", "changed": false, "item": {"instance": "a"}, "msg": "all test queries were successful, details: {\"count\":3,\"sum\":6}\n"} ok: [static-node-2.ydb-cluster.com] => (item={'instance': 'b'}) => {"ansible_loop_var": "item", "changed": false, "item": {"instance": "b"}, "msg": "all test queries were successful, details: {\"count\":3,\"sum\":6}\n"} ok: [static-node-3.ydb-cluster.com] => (item={'instance': 'a'}) => {"ansible_loop_var": "item", "changed": false, "item": {"instance": "a"}, "msg": "all test queries were successful, details: {\"count\":3,\"sum\":6}\n"} ok: [static-node-3.ydb-cluster.com] => (item={'instance': 'b'}) => {"ansible_loop_var": "item", "changed": false, "item": {"instance": "b"}, "msg": "all test queries were successful, details: {\"count\":3,\"sum\":6}\n"} PLAY RECAP **************************************************************************************************************************************************************************************************** static-node-1.ydb-cluster.com : ok=167 changed=80 unreachable=0 failed=0 skipped=167 rescued=0 ignored=0 static-node-2.ydb-cluster.com : ok=136 changed=69 unreachable=0 failed=0 skipped=113 rescued=0 ignored=0 static-node-3.ydb-cluster.com : ok=136 changed=69 unreachable=0 failed=0 skipped=113 rescued=0 ignored=0 ``` {% endcut %} В результате выполнения плейбука `ydb_platform.ydb.initial_setup` будет создан кластер YDB. Он будет содержать [домен](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#domain) с именем из настройки `ydb_domain` (по умолчанию `Root`), [базу данных](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#database) с именем из настройки `ydb_dbname` (по умолчанию `database`) и начального [пользователя](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#access-user) с именем из настройки `ydb_user` (по умолчанию `root`). ## Дополнительные шаги {# additional-steps} Самый простой способ исследовать только что развёрнутый кластер — использовать [Embedded UI](https://ydb.tech/docs/ru/reference/embedded-ui/index.md?version=v26.1), работающий на порту 8765 каждого сервера. Если нет прямого доступа к порту из браузера, можно настроить SSH-туннелирование. Для этого выполните команду `ssh -L 8765:localhost:8765 -i @` на локальной машине (при необходимости добавьте дополнительные опции). После успешного установления соединения можно перейти по URL [localhost:8765](http://localhost:8765) через браузер. Браузер может попросить принять исключение безопасности. Пример того, как это может выглядеть: ![ydb-web-ui](../../../../_assets/ydb-web-console.png) После успешного создания кластера YDB проверьте его состояние, используя следующую страницу Embedded UI: [http://localhost:8765/monitoring/cluster/tenants](http://localhost:8765/monitoring/cluster/tenants). Это может выглядеть так: ![ydb-cluster-check](../../../../_assets/ydb-cluster-check.png) В этом разделе отображаются следующие параметры кластера YDB, отражающие его состояние: - `Tablets` — список запущенных [таблеток](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#tablet). Все индикаторы состояния таблеток должны быть зелёными. - `Nodes` — количество и состояние узлов хранения и узлов базы данных, запущенных в кластере. Индикатор состояния узлов должен быть зелёным, а количество созданных и запущенных узлов должно быть равным. Например, 18/18 для кластера из девяти узлов с одним узлом базы данных на сервер. Индикаторы `Load` (количество используемой RAM) и `Storage` (количество используемого дискового пространства) также должны быть зелёными. Проверить состояние группы хранения можно в разделе `storage` — [http://localhost:8765/monitoring/cluster/storage](http://localhost:8765/monitoring/cluster/storage): ![ydb-storage-gr-check](../../../../_assets/ydb-storage-gr-check.png) Индикаторы `VDisks` должны быть зелёными, а статус `state` (находится в подсказке при наведении на индикатор Vdisk) должен быть `Ok`. Больше об индикаторах состояния кластера и мониторинге можно прочитать в статье [YDB Monitoring](https://ydb.tech/docs/ru/reference/embedded-ui/ydb-monitoring.md?version=v26.1). ### Тестирование кластера {#testing} Протестировать кластер можно с помощью встроенных нагрузочных тестов в YDB CLI. Для этого [установите YDB CLI](https://ydb.tech/docs/ru/reference/ydb-cli/install.md?version=v26.1) и создайте профиль с параметрами подключения, заменив заполнители: ```shell ydb \ config profile create \ -d // \ -e grpcs://:2135 \ --ca-file $(pwd)/files/TLS/certs/ca.crt \ --user root \ --password-file ``` Параметры команды и их значения: - `config profile create` — эта команда используется для создания профиля подключения. Укажите имя профиля. Более подробную информацию о том, как создавать и изменять профили, можно найти в статье [Создание и изменение профиля](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=v26.1). - `-d` — [путь базы данных](https://ydb.tech/docs/ru/concepts/connect.md?version=v26.1#database) в виде `/<домен>/<имя_базы>`. Вместо `` укажите значение параметра `ydb_domain`, вместо `` — `ydb_dbname` из `inventory/50-inventory.yaml` (секция «База данных»). При настройках по умолчанию путь будет `/Root/database`. - `-e` — конечная точка, строка в формате `protocol://host:port`. Допускается указать FQDN любого узла кластера и опустить порт. По умолчанию используется порт 2135. - `--ca-file` — путь к корневому сертификату для подключений к базе данных по `grpcs`. - `--user` — пользователь для подключения к базе данных. - `--password-file` — путь к файлу с паролем. Опустите это, чтобы ввести пароль вручную. Проверить, создался ли профиль, можно с помощью команды `ydb config profile list`, которая отобразит список профилей. После создания профиля его нужно активировать командой `ydb config profile activate `. Чтобы убедиться, что профиль активирован, можно повторно выполнить команду `ydb config profile list` — активный профиль будет иметь отметку `(active)`. Для выполнения [YQL](https://ydb.tech/docs/ru/yql/reference/index.md?version=v26.1) запроса можно использовать команду `ydb sql -s 'SELECT 1;'`, которая вернёт результат запроса `SELECT 1` в табличной форме в терминал. После проверки соединения можно создать тестовую таблицу командой: `ydb workload kv init --init-upserts 1000 --cols 4`. Это создаст тестовую таблицу `kv_test`, состоящую из 4 столбцов и 1000 строк. Проверить, что таблица `kv_test` создалась и заполнилась тестовыми данными, можно с помощью команды `ydb sql -s 'select * from kv_test limit 10;'`. В терминал будет выведена таблица из 10 строк. Теперь можно выполнять тестирование производительности кластера. В статье [Key-Value нагрузка](https://ydb.tech/docs/ru/reference/ydb-cli/workload-kv.md?version=v26.1) описаны несколько типов рабочих нагрузок (`upsert`, `insert`, `select`, `read-rows`, `mixed`) и параметры их выполнения. Пример выполнения тестовой рабочей нагрузки `upsert` с параметром для вывода времени выполнения `--print-timestamp` и стандартными параметрами выполнения: `ydb workload kv run upsert --print-timestamp`: ```text Window Txs/Sec Retries Errors p50(ms) p95(ms) p99(ms) pMax(ms) Timestamp 1 727 0 0 11 27 71 116 2024-02-14T12:56:39Z 2 882 0 0 10 21 29 38 2024-02-14T12:56:40Z 3 848 0 0 10 22 30 105 2024-02-14T12:56:41Z 4 901 0 0 9 20 27 42 2024-02-14T12:56:42Z 5 879 0 0 10 22 31 59 2024-02-14T12:56:43Z ... ``` После завершения тестов таблицу `kv_test` можно удалить командой: `ydb workload kv clean`. Подробнее о параметрах создания тестовой таблицы и тестах можно прочитать в статье [Key-Value нагрузка](https://ydb.tech/docs/ru/reference/ydb-cli/workload-kv.md?version=v26.1). ## См. также - [Дополнительные примеры конфигурации Ansible](https://github.com/ydb-platform/ydb-ansible-examples) - [Перезапуск кластеров YDB, развёрнутых с помощью Ansible](https://ydb.tech/docs/ru/devops/deployment-options/ansible/restart.md?version=v26.1) - [Обновление конфигурации кластеров YDB, развёрнутых с Ansible](https://ydb.tech/docs/ru/devops/deployment-options/ansible/update-config.md?version=v26.1) - [Обновление версии YDB на кластерах, развёрнутых с помощью Ansible](https://ydb.tech/docs/ru/devops/deployment-options/ansible/update-executable.md?version=v26.1)