--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ydb.tech/docs/en/devops/deployment-options/manual/initial-deployment/deployment-configuration-v1.md - https://ydb.tech/docs/ru/devops/deployment-options/manual/initial-deployment/deployment-configuration-v1.md - href: ru/devops/deployment-options/manual/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/manual/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/manual/initial-deployment/deployment-preparation.md). ## Подготовьте конфигурационные файлы {#config} Подготовьте конфигурационный файл YDB в зависимости от выбранной вами топологии (см. [выбор топологии](https://ydb.tech/docs/ru/devops/deployment-options/ansible/initial-deployment/deployment-preparation.md#topology-select)). Примеры для каждой поддерживаемой топологии приведены ниже во вкладках — выберите и используйте подходящий для вашего случая. {% list tabs %} - mirror-3-dc-3nodes ```yaml static_erasure: mirror-3-dc host_configs: - drive: - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD - path: /dev/disk/by-partlabel/ydb_disk_ssd_02 type: SSD - path: /dev/disk/by-partlabel/ydb_disk_ssd_03 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-c' rack: '3' domains_config: 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 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 table_service_config: sql_version: 1 actor_system_config: executor: - name: System threads: 2 type: BASIC - name: User threads: 3 type: BASIC - name: Batch threads: 2 type: BASIC - name: IO threads: 1 time_per_mailbox_micro_secs: 100 type: IO - name: IC spin_threshold: 10 threads: 1 time_per_mailbox_micro_secs: 100 type: BASIC scheduler: progress_threshold: 10000 resolution: 256 spin_threshold: 0 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_ssd_01 - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_02 - vdisk_locations: - node_id: static-node-1.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_03 - fail_domains: - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_02 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_03 - fail_domains: - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_02 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_03 channel_profile_config: profile: - channel: - erasure_species: mirror-3-dc pdisk_category: 0 storage_pool_kind: ssd - erasure_species: mirror-3-dc pdisk_category: 0 storage_pool_kind: ssd - erasure_species: mirror-3-dc pdisk_category: 0 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 client_certificate_authorization: request_client_certificate: true client_certificate_definitions: - member_groups: ["databaseNodes@cert"] subject_terms: - short_name: "O" values: ["YDB"] ``` - mirror-3-dc-9nodes ```yaml static_erasure: mirror-3-dc host_configs: - drive: - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 type: SSD - path: /dev/disk/by-partlabel/ydb_disk_ssd_02 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-c' rack: '7' - host: static-node-8.ydb-cluster.com host_config_id: 1 walle_location: body: 8 data_center: 'zone-c' rack: '8' - host: static-node-9.ydb-cluster.com host_config_id: 1 walle_location: body: 9 data_center: 'zone-c' rack: '9' domains_config: 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 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 table_service_config: sql_version: 1 actor_system_config: executor: - name: System spin_threshold: 0 threads: 2 type: BASIC - name: User spin_threshold: 0 threads: 3 type: BASIC - name: Batch spin_threshold: 0 threads: 2 type: BASIC - name: IO threads: 1 time_per_mailbox_micro_secs: 100 type: IO - name: IC spin_threshold: 10 threads: 1 time_per_mailbox_micro_secs: 100 type: BASIC scheduler: progress_threshold: 10000 resolution: 256 spin_threshold: 0 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_ssd_01 - vdisk_locations: - node_id: static-node-2.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-3.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: static-node-4.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-5.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-6.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: static-node-7.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-8.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - vdisk_locations: - node_id: static-node-9.ydb-cluster.com pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 channel_profile_config: profile: - channel: - erasure_species: mirror-3-dc pdisk_category: 1 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 client_certificate_authorization: request_client_certificate: true client_certificate_definitions: - member_groups: ["databaseNodes@cert"] subject_terms: - short_name: "O" values: ["YDB"] ``` - block-4-2 ```yaml static_erasure: block-4-2 host_configs: - drive: - path: /dev/disk/by-partlabel/ydb_disk_ssd_01 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: 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 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: 5 ssid: 1 table_service_config: sql_version: 1 actor_system_config: executor: - name: System threads: 2 type: BASIC - name: User threads: 3 type: BASIC - name: Batch threads: 2 type: BASIC - name: IO threads: 1 time_per_mailbox_micro_secs: 100 type: IO - name: IC spin_threshold: 10 threads: 1 time_per_mailbox_micro_secs: 100 type: BASIC scheduler: progress_threshold: 10000 resolution: 256 spin_threshold: 0 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_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-2.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-3.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-4.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-5.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-6.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-7.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 - fail_domains: - vdisk_locations: - node_id: "static-node-8.ydb-cluster.com" pdisk_category: SSD path: /dev/disk/by-partlabel/ydb_disk_ssd_01 channel_profile_config: profile: - channel: - erasure_species: block-4-2 pdisk_category: 0 storage_pool_kind: ssd - erasure_species: block-4-2 pdisk_category: 0 storage_pool_kind: ssd - erasure_species: block-4-2 pdisk_category: 0 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 client_certificate_authorization: request_client_certificate: true client_certificate_definitions: - member_groups: ["databaseNodes@cert"] subject_terms: - short_name: "O" values: ["YDB"] ``` {% 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 под именем `/opt/ydb/cfg/config.yaml` на каждом сервере кластера. Более подробная информация по созданию файла конфигурации приведена в разделе [Параметры конфигурации кластера](https://ydb.tech/docs/ru/reference/configuration/index.md). ## Скопируйте ключи и сертификаты TLS на каждый сервер {#tls-copy-cert} Подготовленные ключи и сертификаты TLS необходимо скопировать в защищённый каталог на каждом из узлов кластера YDB. Подробности подготовки — в разделе [Подготовка ключей и сертификатов TLS](https://ydb.tech/docs/ru/devops/deployment-options/manual/initial-deployment/deployment-preparation.md#tls-certificates). Если сертификаты сгенерированы скриптом `tls_cert_gen`, возьмите `ca.crt` из каталога `CA/certs/YYYY-MM-DD_hh-mi-ss` (подставьте метку времени из вывода скрипта или выберите нужный каталог в `CA/certs/`), а `node.crt`, `node.key` и `web.pem` — из подкаталога с именем FQDN этого сервера в `ydb-ca-nodes.txt`. Перенесите эти четыре файла на соответствующий сервер кластера (например, через `scp`) в один локальный каталог. Для административных команд в разделах [Инициализируйте кластер](#initialize-cluster), [Создайте базу данных](#create-db), [Настройка учётных записей](#security-setup) и [Протестируйте работу с созданной базой](#try-first-db) в примерах используется путь `~/CA/certs/`. Чтобы не менять пути в командах, на каждом сервере создайте каталог `~/CA/certs/` в домашнем каталоге того пользователя, от имени которого вы выполняете эти команды, и поместите в него четыре файла: `ca.crt`, `node.crt`, `node.key` и `web.pem`. Каталог `/opt/ydb/certs/` (см. ниже) нужен для запуска `ydbd` от пользователя `ydb`; `~/CA/certs/` — для административных команд из последующих разделов. На каждом сервере выполните команды ниже: сначала разместите файлы в `~/CA/certs/`, затем скопируйте их в `/opt/ydb/certs/`. ```bash mkdir -p ~/CA/certs cp -v ca.crt ~/CA/certs/ cp -v node.crt ~/CA/certs/ cp -v node.key ~/CA/certs/ cp -v web.pem ~/CA/certs/ sudo mkdir -p /opt/ydb/certs sudo cp -v ~/CA/certs/ca.crt /opt/ydb/certs/ sudo cp -v ~/CA/certs/node.crt /opt/ydb/certs/ sudo cp -v ~/CA/certs/node.key /opt/ydb/certs/ sudo cp -v ~/CA/certs/web.pem /opt/ydb/certs/ sudo chown -R ydb:ydb /opt/ydb/certs sudo chmod 700 /opt/ydb/certs ``` Перед запуском `ydbd` убедитесь, что процессы от пользователя `ydb` смогут прочитать сертификат мониторинга (иначе при `--mon-cert /opt/ydb/certs/web.pem` будет ошибка `Permission denied`): ```bash sudo -u ydb test -r /opt/ydb/certs/web.pem ``` При успешной проверке команда завершается **без вывода**, код возврата `0` (проверить: `echo $?` → `0`). Если файл отсутствует или права настроены неверно — код `1`; повторите `chown`/`chmod` из блока выше и убедитесь, что на этот узел скопирован `web.pem` этого хоста. ## Запустите статические узлы {#start-storage} {% list tabs group=manual-systemd %} - Вручную Запустите сервис хранения данных YDB на каждом статическом узле кластера. Поочередно выполните команды ниже. Не вставляйте все строки разом вместе с `sudo su - ydb` — иначе следующие команды могут выполниться не от пользователя `ydb`. После шага 1 дождитесь приглашения `ydb@...$`. На шаге 4 дождитесь вывода `ydbd` в этом же терминале. 1. Переключитесь на пользователя `ydb`: ```bash sudo su - ydb ``` 2. Перейдите в каталог установки: ```bash cd /opt/ydb ``` 3. Укажите путь к библиотекам: ```bash export LD_LIBRARY_PATH=/opt/ydb/lib ``` 4. Запустите статический узел: ```bash /opt/ydb/bin/ydbd server --log-level 3 --syslog --tcp --yaml-config /opt/ydb/cfg/config.yaml --grpcs-port 2135 --ic-port 19001 --mon-port 8765 --mon-cert /opt/ydb/certs/web.pem --node static ``` При успешном старте в выводе появится, в частности, `Determined node ID: ...`. Если [проверка `web.pem`](#tls-copy-cert) не пройдена, здесь будет ошибка `Permission denied` для `/opt/ydb/certs/web.pem`. - С использованием systemd Создайте на каждом сервере, где будет размещен статический узел кластера, конфигурационный файл systemd `/etc/systemd/system/ydbd-storage.service` по приведенному ниже образцу. Образец файла также можно [скачать из репозитория](https://github.com/ydb-platform/ydb/blob/main/ydb/deploy/systemd_services/ydbd-storage.service). ```ini [Unit] Description=YDB storage node After=network-online.target rc-local.service Wants=network-online.target StartLimitInterval=10 StartLimitBurst=15 [Service] Restart=always RestartSec=1 User=ydb PermissionsStartOnly=true StandardOutput=syslog StandardError=syslog SyslogIdentifier=ydbd SyslogFacility=daemon SyslogLevel=err Environment=LD_LIBRARY_PATH=/opt/ydb/lib ExecStart=/opt/ydb/bin/ydbd server --log-level 3 --syslog --tcp \ --yaml-config /opt/ydb/cfg/config.yaml \ --grpcs-port 2135 --ic-port 19001 --mon-port 8765 \ --mon-cert /opt/ydb/certs/web.pem --node static LimitNOFILE=65536 LimitCORE=0 LimitMEMLOCK=3221225472 [Install] WantedBy=multi-user.target ``` Запустите сервис на каждом статическом узле YDB: ```bash sudo systemctl start ydbd-storage ``` {% endlist %} После запуска статических узлов проверьте их работоспособность через встроенный веб-интерфейс YDB (Embedded UI): 1. Откройте в браузере адрес `https://:8765`, где `` — FQDN сервера, на котором запущен любой статический узел; 2. Если браузер запросит логин и пароль, войдите под учётной записью `root` с пустым паролем — на этом этапе развёртывания пароль для `root` ещё не задан; 3. Перейдите на вкладку **Nodes**; 4. Убедитесь, что в списке отображаются все 3 статических узла. ![Ручная установка, запущенные статические узлы](../../_assets/manual_installation_1.png) ## Инициализируйте кластер {#initialize-cluster} Операция инициализации кластера осуществляет настройку набора статических узлов, перечисленных в конфигурационном файле кластера, для хранения данных YDB. Для инициализации кластера потребуется файл сертификата центра регистрации `ca.crt` из каталога `~/CA/certs/` (см. раздел [Скопируйте ключи и сертификаты TLS на каждый сервер](#tls-copy-cert)). На одном из серверов хранения в составе кластера выполните команды: Сначала получите авторизационный токен для регистрации запросов. Для этого выполните приведённую ниже команду. ```bash /opt/ydb/bin/ydb --ca-file ~/CA/certs/ca.crt -e grpcs://`hostname -f`:2135 -d /Root --user root --no-password auth get-token -f > auth_token ``` Инициализируйте кластер, используя полученный токен ```bash export LD_LIBRARY_PATH=/opt/ydb/lib /opt/ydb/bin/ydbd --ca-file ~/CA/certs/ca.crt -s grpcs://`hostname -f`:2135 -f auth_token \ admin blobstorage config init --yaml-file /opt/ydb/cfg/config.yaml echo $? ``` При успешном выполнении инициализации кластера выведенный на экран код завершения команды инициализации кластера должен быть нулевым. ## Создайте базу данных {#create-db} Для работы со строковыми или колоночными таблицами необходимо создать как минимум одну базу данных и запустить процесс или процессы, обслуживающие эту базу данных (динамические узлы). Для выполнения административной команды создания базы данных потребуется файл `ca.crt` из каталога `~/CA/certs/` (см. раздел [Скопируйте ключи и сертификаты TLS на каждый сервер](#tls-copy-cert)). При создании базы данных устанавливается первоначальное количество используемых групп хранения, определяющее доступную пропускную способность ввода-вывода и максимальную емкость хранения. Количество групп хранения может быть при необходимости увеличено после создания базы данных. На одном из серверов хранения в составе кластера выполните команды: ```bash export LD_LIBRARY_PATH=/opt/ydb/lib /opt/ydb/bin/ydbd --ca-file ~/CA/certs/ca.crt -s grpcs://`hostname -f`:2135 -f auth_token \ admin database /Root/testdb create ssd:8 echo $? ``` При успешном создании базы данных, выведенный на экран код завершения команды должен быть нулевым. В приведенном выше примере команд используются следующие параметры: - `/Root` - имя корневого домена, сгенерированного автоматически при инициализации кластера; - `testdb` - имя создаваемой базы данных; - `ssd:8` - задает пул хранения для базы данных и количество групп в нем. Имя пула (`ssd`) должно соответствовать типу диска, указанному в конфигурации кластера (например, в `default_disk_type`), и является регистронезависимым. Число после двоеточия — это количество выделяемых групп хранения. ## Запустите динамические узлы {#start-dynnode} Первый динамический узел запустите на одном из серверов кластера, где уже подготовлены каталоги `/opt/ydb/certs` и `/opt/ydb/cfg` и работает статический узел. Совмещение статического и динамического узла на одном сервере допустимо (см. [Требования](https://ydb.tech/docs/ru/devops/deployment-options/manual/initial-deployment/deployment-preparation.md#requirements)). Для топологий из примера (`mirror-3-dc-3nodes` — три сервера, `mirror-3-dc-9nodes` — девять) для отказоустойчивости и масштабирования запустите дополнительные динамические узлы на тех же серверах, что и статические — по одному на каждом из оставшихся хостов. {% list tabs group=manual-systemd %} - Вручную Запустите динамический узел YDB для базы `/Root/testdb`. Поочередно выполните команды ниже. Не вставляйте все строки разом вместе с `sudo su - ydb` — иначе следующие команды могут выполниться не от пользователя `ydb`. После шага 1 дождитесь приглашения `ydb@...$`. На шаге 4 дождитесь вывода `ydbd` в этом же терминале. В команде ниже замените ``, ``, `` на FQDN трёх любых серверов со статическими узлами. 1. Переключитесь на пользователя `ydb`: ```bash sudo su - ydb ``` 2. Перейдите в каталог установки: ```bash cd /opt/ydb ``` 3. Укажите путь к библиотекам: ```bash export LD_LIBRARY_PATH=/opt/ydb/lib ``` 4. Запустите динамический узел: ```bash /opt/ydb/bin/ydbd server --grpcs-port 2136 --grpc-ca /opt/ydb/certs/ca.crt --ic-port 19002 --ca /opt/ydb/certs/ca.crt --mon-port 8766 --mon-cert /opt/ydb/certs/web.pem --yaml-config /opt/ydb/cfg/config.yaml --tenant /Root/testdb --grpc-cert /opt/ydb/certs/node.crt --grpc-key /opt/ydb/certs/node.key --node-broker grpcs://:2135 --node-broker grpcs://:2135 --node-broker grpcs://:2135 ``` Если [проверка `web.pem`](#tls-copy-cert) не пройдена, будет ошибка `Permission denied` для `/opt/ydb/certs/web.pem`. - С использованием systemd Создайте конфигурационный файл systemd `/etc/systemd/system/ydbd-testdb.service` по приведенному ниже образцу. Образец файла также можно [скачать из репозитория](https://github.com/ydb-platform/ydb/blob/main/ydb/deploy/systemd_services/ydbd-testdb.service). ```ini [Unit] Description=YDB testdb dynamic node After=network-online.target rc-local.service Wants=network-online.target StartLimitInterval=10 StartLimitBurst=15 [Service] Restart=always RestartSec=1 User=ydb PermissionsStartOnly=true StandardOutput=syslog StandardError=syslog SyslogIdentifier=ydbd SyslogFacility=daemon SyslogLevel=err Environment=LD_LIBRARY_PATH=/opt/ydb/lib ExecStart=/opt/ydb/bin/ydbd server \ --grpcs-port 2136 --grpc-ca /opt/ydb/certs/ca.crt \ --ic-port 19002 --ca /opt/ydb/certs/ca.crt \ --mon-port 8766 --mon-cert /opt/ydb/certs/web.pem \ --yaml-config /opt/ydb/cfg/config.yaml \ --tenant /Root/testdb \ --grpc-cert /opt/ydb/certs/node.crt \ --grpc-key /opt/ydb/certs/node.key \ --node-broker grpcs://:2135 \ --node-broker grpcs://:2135 \ --node-broker grpcs://:2135 LimitNOFILE=65536 LimitCORE=0 LimitMEMLOCK=32212254720 [Install] WantedBy=multi-user.target ``` В примере команды выше ``, ``, `` — FQDN трех любых серверов, на которых запущены статические узлы кластера. Запустите динамический узел YDB для базы `/Root/testdb`: ```bash sudo systemctl start ydbd-testdb ``` {% endlist %} ## Настройка учетных записей {#security-setup} 1. Установите YDB CLI, как описано в [документации](https://ydb.tech/docs/ru/reference/ydb-cli/install.md). В командах ниже `` — FQDN сервера с запущенным динамическим узлом базы `/Root/testdb` (порт gRPC `2136`). При выполнении команд по SSH на этом сервере можно указать endpoint: `grpcs://$(hostname -f):2136`. 1. Установите пароль для учетной записи `root`, используя полученный ранее токен: ```bash ydb --ca-file ~/CA/certs/ca.crt -e grpcs://:2136 -d /Root/testdb --token-file auth_token \ yql -s 'ALTER USER root PASSWORD "passw0rd"' ``` Вместо значения `passw0rd` подставьте необходимый пароль. Сохраните пароль в отдельный файл. Последующие команды от имени пользователя `root` будут выполняться с использованием пароля, передаваемого с помощью ключа `--password-file `. Также пароль можно сохранить в профиле подключения, как описано в [документации YDB CLI](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md). 1. Создайте дополнительные учетные записи: ```bash ydb --ca-file ~/CA/certs/ca.crt -e grpcs://:2136 -d /Root/testdb --user root --password-file \ yql -s 'CREATE USER user1 PASSWORD "passw0rd"' ``` 1. Установите права учетных записей, включив их во встроенные группы: ```bash ydb --ca-file ~/CA/certs/ca.crt -e grpcs://:2136 -d /Root/testdb --user root --password-file \ yql -s 'ALTER GROUP `ADMINS` ADD USER user1' ``` При выполнении команд создания учётных записей и присвоения групп клиент YDB CLI будет запрашивать ввод пароля пользователя `root`. Избежать многократного ввода пароля можно, создав профиль подключения, как описано в [документации YDB CLI](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md). ## Протестируйте работу с созданной базой {#try-first-db} 1. Установите YDB CLI, как описано в [документации](https://ydb.tech/docs/ru/reference/ydb-cli/install.md). В командах ниже `` — тот же FQDN динамического узла базы `/Root/testdb`, что в разделе [Настройка учетных записей](#security-setup). 1. Создайте тестовую строковую (`test_row_table`) или колоночную таблицу (`test_column_table`): {% list tabs %} - Создание строковой таблицы ```bash ydb --ca-file ~/CA/certs/ca.crt -e grpcs://:2136 -d /Root/testdb --user root \ yql -s 'CREATE TABLE `testdir/test_row_table` (id Uint64, title Utf8, PRIMARY KEY (id));' ``` - Создание колоночной таблицы ```bash ydb --ca-file ~/CA/certs/ca.crt -e grpcs://:2136 -d /Root/testdb --user root \ yql -s 'CREATE TABLE `testdir/test_column_table` (id Uint64 NOT NULL, title Utf8, PRIMARY KEY (id)) WITH (STORE = COLUMN);' ``` {% endlist %} ## Проверка доступа ко встроенному web-интерфейсу Для проверки доступа ко встроенному web-интерфейсу YDB достаточно открыть в Web-браузере страницу с адресом `https://:8765`, где `` — FQDN сервера, на котором запущен любой статический узел YDB. В Web-браузере должно быть настроено доверие в отношении центра регистрации, выпустившего сертификаты для кластера YDB, в противном случае будет отображено предупреждение об использовании недоверенного сертификата. Если в кластере включена аутентификация, в Web-браузере должен отобразиться запрос логина и пароля. После ввода верных данных аутентификации должна отобразиться начальная страница встроенного web-интерфейса. Описание доступных функций и пользовательского интерфейса приведено в разделе [Использование встроенного web-интерфейса](https://ydb.tech/docs/ru/reference/embedded-ui/index.md). {% note info %} Обычно для обеспечения доступа ко встроенному web-интерфейсу YDB настраивают отказоустойчивый HTTP-балансировщик на базе программного обеспечения `haproxy`, `nginx` или аналогов. Детали настройки HTTP-балансировщика выходят за рамки стандартной инструкции по установке YDB. {% endnote %} ## Особенности установки YDB в незащищенном режиме {% note warning %} Мы не рекомендуем использовать незащищенный режим работы YDB ни при эксплуатации, ни при разработке приложений. {% endnote %} Описанная выше процедура установки предусматривает развёртывание YDB в стандартном защищенном режиме. Незащищённый режим работы YDB предназначен для решения тестовых задач, преимущественно связанных с разработкой и тестированием программного обеспечения YDB. В незащищенном режиме: - трафик между узлами кластера, а также между приложениями и кластером использует незашифрованные соединения; - не используется аутентификация пользователей (включение аутентификации при отсутствии шифрования трафика не имеет смысла, поскольку логин и пароль в такой конфигурации передавались бы через сеть в открытом виде). Установка YDB для работы в незащищенном режиме производится в порядке, описанном выше, со следующими исключениями: 1. При подготовке к установке не требуется формировать сертификаты и ключи TLS, и не выполняется копирование сертификатов и ключей на узлы кластера. 1. Из конфигурационных файлов кластерных узлов исключаются секции `security_config`, `interconnect_config` и `grpc_config`. 1. Используются упрощенный вариант команд запуска статических и динамических узлов кластера: исключаются опции с именами файлов сертификатов и ключей, используется протокол `grpc` вместо `grpcs` при указании точек подключения. 1. Пропускается ненужный в незащищенном режиме шаг по получению токена аутентификации перед выполнением инициализации кластера и созданием базы данных. 1. Команда инициализации кластера выполняется в следующей форме: ```bash export LD_LIBRARY_PATH=/opt/ydb/lib /opt/ydb/bin/ydbd admin blobstorage config init --yaml-file /opt/ydb/cfg/config.yaml echo $? ``` 6. Команда создания базы данных выполняется в следующей форме: ```bash export LD_LIBRARY_PATH=/opt/ydb/lib /opt/ydb/bin/ydbd admin database /Root/testdb create ssd:1 ``` 7. При обращении к базе данных из YDB CLI и приложений используется протокол grpc вместо grpcs, и не используется аутентификация.