Работоспособность модуля гарантируется только для стоковых ядер, поставляемых вместе с дистрибутивами перечисленными в списке поддерживаемых ОС. Работоспособность модуля на других ядрах возможна, но не гарантируется.

The functionality of the module is guaranteed only for stock kernels for distributions listed in the list of supported OS. The functionality of the module with other kernels is possible but not guaranteed.

После включения модуля кластер автоматически настраивается на использование LINSTOR и остается только сконфигурировать хранилище.

After enabling the module, the cluster is automatically configured to use LINSTOR, and all that remains is to configure the storage.

Сам модуль не требует настройки и не имеет параметров. Однако отдельные его функции могут потребовать указания мастер-пароля.
Для того чтобы задать мастер-пароль, создайте Secret в пространстве имен d8-system:

The module requires no configuration and has no parameters. However, some functions may require a master passphrase.
To set a master passphrase, create a Secret in the d8-system namespace:

yaml apiVersion: v1 kind: Secret metadata: name: linstor-passphrase namespace: d8-system immutable: true stringData: MASTER_PASSPHRASE: !пароль # Мастер-пароль для LINSTOR

yaml apiVersion: v1 kind: Secret metadata: name: linstor-passphrase namespace: d8-system immutable: true stringData: MASTER_PASSPHRASE: !passphrase # Master passphrase for LINSTOR

Внимание! Подойдите ответственно к выбору мастер-пароля для LINSTOR. При его потере зашифрованные данные окажутся недоступными.

Caution! Choose a strong passphrase and store it securely. If it get lost, the encrypted data will be inaccessible.

Конфигурация хранилища LINSTOR

LINSTOR storage configuration

Конфигурация LINSTOR в Deckhouse осуществляется посредством назначения специального тега linstor-<имя_пула> на LVM-группу томов или LVMThin-пул.

LINSTOR in Deckhouse can be configured by assigning special tag linstor-<pool_name> to an LVM volume group or LVMThin pool.

1. Выберите имя тега.

1. Choose the tag name.

Имя тега должно быть уникальным в пределах одного узла. Поэтому каждый раз, прежде чем назначить новый тег, убедитесь в отсутствии этого тега у других групп томов и пулов.

The tag name must be unique within the same node. Therefore, before assigning a new tag, make sure that other volume groups and thin pools do not have this tag already.

Выполните следующие команды, чтобы вывести список групп томов и пулов:

Execute the following commands to get list volume groups and pools:

shell LVM пулы vgs -o+tags | awk ‘NR==1;$NF~/linstor-/’ LVMThin пулы lvs -o+tags | awk ‘NR==1;$NF~/linstor-/’

shell LVM pools vgs -o+tags | awk ‘NR==1;$NF~/linstor-/’ LVMThin pools lvs -o+tags | awk ‘NR==1;$NF~/linstor-/’

1. Добавьте пулы.

1. Add pools.

Создайте пулы хранения на всех узлах, где вы планируете хранить ваши данные. Используйте одинаковые имена пулов хранения на разных узлах, если хотите иметь для них общий StorageClass.

Add pools on all nodes where you plan to store your data. Use the same names for the storage pools on the different nodes if you want to achieve a general StorageClasses created for all of them.

• Чтобы добавить пул LVM создайте группу томов с тегом linstor-<имя_пула>, либо добавьте тег linstor-<имя_пула> существующей группе.

• To add an LVM pool, create a volume group with the linstor-<pool_name> tag, or the linstor-<pool_name> tag to an existing volume group.

Пример команды создания группы томов vg0 с тегом linstor-data:

Example of command to create a volume group vg0 with the linstor-data tag :

Пример команды добавления тега linstor-data существующей группе томов vg0:

Example of command to add the linstor-data tag to an existing volume group vg0:

• Чтобы добавить пул LVMThin создайте LVMThin-пул с тегом linstor-<имя_пула>.

• To add an LVMThin pool, create a LVM thin pool with the linstor-<pool_name> tag.

Пример команды создания LVMThin-пула vg0/thindata с тегом linstor-data:

Example of command to create the LVMThin pool vg0/thindata with the linstor-data tag:

Обратите внимание, что сама группа томов не обязана содержать какой-либо тег.

Note! The group itself should not have this tag configured.

1. Проверьте создание StorageClass.

1. Check the creation of StorageClass.

Когда все пулы хранения будут созданы, появятся три новых StorageClass’а. Проверьте что они создались, выполнив в кластере Kubernetes команду:

Three new StorageClasses will appear when all the storage pools have been created. Check that they were created by running the following command in the Kubernetes cluster:

Пример вывода списка StorageClass:

Example of the output:

Каждый StorageClass можно использовать для создания томов соответственно с одной, двумя или тремя репликами в ваших пулах хранения.

Each StorageClass can be used to create volumes with one, two, or three replicas in your storage pools, respectively.

При необходимости изучите пример расширенной конфигурации LINSTOR, но мы рекомендуем придерживаться приведенного выше упрощённого руководства.

You can always refer to Advanced LINSTOR Configuration if needed, but we strongly recommend sticking to this simplified guide.