---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/configuration/hosts.md?version=v25.4
  - https://ydb.tech/docs/ru/reference/configuration/hosts.md?version=v25.4
  - href: ru/reference/configuration/hosts.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/reference/configuration/hosts.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# hosts

В данной группе перечисляются статические узлы кластера, на которых запускаются процессы работы со Storage, и задаются их основные характеристики:

- Числовой идентификатор узла
- DNS-имя хоста и порт, по которым может быть установлено соединение с узлом в IP network
- Идентификатор [типовой конфигурации хоста](https://ydb.tech/docs/ru/reference/configuration/host_configs.md?version=v25.4)
- Размещение в определенной зоне доступности, стойке
- Инвентарный номер сервера (опционально)

## Синтаксис

``` yaml
hosts:
- host: <DNS-имя хоста>
  host_config_id: <числовой идентификатор типовой конфигурации хоста>
  port: <порт> # 19001 по умолчанию
  location:
    unit: <строка с инвентарным номером сервера>
    data_center: <строка с идентификатором зоны доступности>
    rack: <строка с идентификатором стойки>
- host: <DNS-имя хоста>
  # ...
```

## Примеры

``` yaml
hosts:
- host: hostname1
  host_config_id: 1
  node_id: 1
  port: 19001
  location:
    unit: '1'
    data_center: '1'
    rack: '1'
- host: hostname2
  host_config_id: 1
  node_id: 2
  port: 19001
  location:
    unit: '1'
    data_center: '1'
    rack: '1'
```

### Особенности режима bridge {#hosts-bridge}

В [режиме bridge](https://ydb.tech/docs/ru/concepts/bridge.md?version=v25.4) каждый хост должен быть привязан к одному из pile, объявленных в [`bridge_config`](https://ydb.tech/docs/ru/reference/configuration/bridge_config.md?version=v25.4). Для этого в разделе `location` укажите поле `bridge_pile_name` с именем pile. Пример:

```yaml
hosts:
- host: hostname1
  host_config_id: 1
  location:
    ...
    bridge_pile_name: 'pile_1'
```

## Особенности Kubernetes {#hosts-k8s}

При развертывании YDB с помощью оператора Kubernetes секция `hosts` полностью генерируется автоматически, заменяя любой указанный пользователем контент в передаваемой оператору конфигурации. Все Storage узлы используют `host_config_id` = `1`, для которого должна быть задана [корректная конфигурация](https://ydb.tech/docs/ru/reference/configuration/host_configs.md?version=v25.4#host-configs-k8s).