Skip to content

Commit

Permalink
Fixes links
Browse files Browse the repository at this point in the history
Signed-off-by: Aleksandr Zimin <[email protected]>
  • Loading branch information
AleksZimin committed Jan 11, 2024
1 parent 65277a8 commit 4a2879a
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 14 deletions.
13 changes: 7 additions & 6 deletions docs/FAQ_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -332,11 +332,11 @@ dmesg | grep 'Remote failed to finish a request within'

## Миграция на DRBDStorageClass

StorageClasses в данном модуле управляются через ресурс DRBDStorageClass. Вручную StorageClasses создаваться не должны.
StorageClass'ы в данном модуле управляются через ресурс DRBDStorageClass. Вручную StorageClass'ы создаваться не должны.

При миграции с модуля Linstor необходимо удалить старые StorageClass'ы и создать новые через ресурс DRBDStorageClass в соответствии с таблицей.

При миграции с модуля Linstor необходимо создать ресурсы DRBDStorageClass в соответствии с таблицей.
Обратите внимание, что в старых storage class нужно смотреть опцию из секции parameter, а в новом классе нужно использовать опцию самого DRBDStorageClass
Обратите внимание, что в старых StorageClass нужно смотреть опцию из секции parameter самого StorageClass, а указывать соответствующую опцию при создании нового необходимо в DRBDStorageClass.

| параметр StorageClass | DRBDStorageClass | Параметр по умолчанию | Примечания |
|-------------------------------------------|-----------------------|-|----------------------------------------------------------------|
Expand All @@ -353,7 +353,7 @@ StorageClasses в данном модуле управляются через р
- volumeAccess может принимать значения "Local" (доступ строго в пределах Node), "EventuallyLocal" (реплика данных будет синхронизироваться на Node с запущенным Pod спустя некоторое время после запуска), "PreferablyLocal" (удаленный доступ Pod к тому с данными разрешен, volumeBindingMode: WaitForFirstConsumer), "Any" (удаленный доступ Pod к тому с данными разрешен, volumeBindingMode: Immediate)
- При необходимости использовать volumeBindingMode: Immediate нужно выставлять параметр DRBDStorageClass volumeAccess равным Any

Пример DRBDStorageClass только с использованием локальных томов и высокой степенью резервирования
Пример DRBDStorageClass с использованием только локальных томов и высокой степенью резервирования в кластере, состоящем из трех зон:

```
apiVersion: storage.deckhouse.io/v1alpha1
Expand All @@ -365,13 +365,14 @@ spec:
storagePool: storagePoolName
volumeAccess: Local
reclaimPolicy: Delete
topology: TransZonal
zones:
- zone-a
- zone-b
- zone-c
```

Пример DRBDStorageClass с возможностью использования удаленных реплик и без резервирования (например, для тестовых окружений)
Пример DRBDStorageClass с возможностью использования удаленных реплик и без резервирования в кластере без зон(например, для тестовых окружений)

```
apiVersion: storage.deckhouse.io/v1alpha1
Expand All @@ -381,6 +382,6 @@ metadata:
spec:
replication: None
storagePool: storagePoolName
volumeAccess: Any
reclaimPolicy: Delete
topology: Ignored
```
6 changes: 3 additions & 3 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The module is guaranteed to work only in the following cases:
As for any other configurations, the module may work, but its smooth operation is not guaranteed.
{% endalert %}

This module manages replicated block storage based on `LINSTOR` and the `DRBD` kernel module and allows to create a `Storage Pool` in `Linstor` and a `Storage Class` in `Kubernetes` by creating [Kubernetes custom resources](resources).
This module manages replicated block storage based on `LINSTOR` and the `DRBD` kernel module and allows to create a `Storage Pool` in `Linstor` and a `Storage Class` in `Kubernetes` by creating [Kubernetes custom resources](./CR.md).
`LINSTOR` is an orchestrator that acts as an abstraction layer. It:
- automates volume creation using well-known and proven technologies such as `LVM` and `ZFS`;
- configures volume replication using `DRBD`.
Expand All @@ -21,6 +21,6 @@ The SDS-DRBD module makes it easy to use LINSTOR-based storage in your cluster.

Two modes are supported: LVM and LVMThin.

Each mode has its advantages and disadvantages. Read [FAQ](faq) to learn more and compare them.
Each mode has its advantages and disadvantages. Read [FAQ](./FAQ.md#what-is-difference-between-lvm-and-lvmthin) to learn more and compare them.

Note that the module's [Kubernetes custom resources](resources) are Cluster-scoped.
Note that the module's [Kubernetes custom resources](./CR.md) are Cluster-scoped.
12 changes: 7 additions & 5 deletions docs/README_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,22 @@ moduleStatus: experimental

{% alert level="warning" %}
Работоспособность модуля гарантируется только в следующих случаях:
- при использовании стоковых ядер, поставляемых вместе с [поддерживаемыми дистрибутивами](../../supported_versions.html#linux);
- при использовании стоковых ядер, поставляемых вместе с [поддерживаемыми дистрибутивами](../../../documentation/v1/supported_versions.html#linux);
- при использовании сети 10Gbps.

Работоспособность модуля в других условиях возможна, но не гарантируется.
{% endalert %}

Модуль управляет в кластере реплицируемым блочным хранилищем на базе `LINSTOR` и модуля ядра `DRBD` и позволяет создавать `Storage Pool` в `LINSTOR` и `StorageClass` в `Kubernetes` через создание [пользовательских ресурсов Kubernetes](ссылка на ресурсы).
Модуль управляет в кластере реплицируемым блочным хранилищем на базе `LINSTOR` и модуля ядра `DRBD` и позволяет создавать `Storage Pool` в `LINSTOR` и `StorageClass` в `Kubernetes` через создание [пользовательских ресурсов Kubernetes](./CR_RU.md).
Для создания `Storage Pool` потребуются настроенные на узлах кластера `LVM Volume Group` и `LVM Thin-pool`. Настройка LVM осуществляется модулем [SDS-Node-Configurator](../../sds-node-configurator/README_RU.md).
> **Внимание!** Перед включением модуля `SDS-DRDB` необходимо включить модуль `SDS-Node-Configurator`.
`LINSTOR` — это оркестратор, выступающий слоем абстракции, который:
- автоматизирует создание томов с помощью знакомой и проверенной технологии `LVM`;
- настраивает репликацию создаваемых томов с помощью `DRBD`.
Модуль `SDS-DRBD` упрощает использование хранилищ на базе `LINSTOR` в кластере. После включения модуля `SDS-DRBD` в конфигурации Deckhouse ваш кластер будет автоматически настроен на использование `LINSTOR`. Останется только создать [пулы хранения](ссылка на usage/#Конфигурация хранилища LINSTOR).
Модуль `SDS-DRBD` упрощает использование хранилищ на базе `LINSTOR` в кластере. После включения модуля `SDS-DRBD` в конфигурации Deckhouse ваш кластер будет автоматически настроен на использование `LINSTOR`. Останется только создать [пулы хранения и StorageClass'ы](./USAGE_RU.md/#конфигурация-хранилища-linstor).

Поддерживаются два режима — LVM и LVMThin.
Каждый из них имеет свои достоинства и недостатки, подробнее о различиях читайте в [FAQ](ссылка).
Каждый из них имеет свои достоинства и недостатки, подробнее о различиях читайте в [FAQ](./FAQ_RU.md#когда-следует-использовать-lvm-а-когда-lvmthin).

Обратите внимание, что [пользовательские ресурсы Kubernetes](ссылка на ресурсы) модуля находятся в скоупе целого кластера.
Обратите внимание, что [пользовательских ресурсов Kubernetes](./CR_RU.md) модуля находятся в скоупе целого кластера.

0 comments on commit 4a2879a

Please sign in to comment.