storage

<p align="center">
  <img src ="./docs/_static/ansible_role_storage.png" />
</p>

Роль хранения Ansible
====================

[![Документация](https://readthedocs.org/projects/ansible-storage/badge/?version=master)](https://ansible-storage.readthedocs.io)
[![Galaxy](https://img.shields.io/badge/galaxy-Akrog.storage-blue.svg?style=flat-square)](https://galaxy.ansible.com/Akrog/storage/)

Роль хранения Ansible является независимой от вендора абстракцией, которая обеспечивает
администраторов инфраструктуры автоматизацией для решений по хранению данных и 
доступом к предоставленным ресурсам.

Роль хранения поддерживает более 80 драйверов блочного хранения "из коробки", но 
может быть расширена для поддержки дополнительных поставщиков хранения.

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

Это позволяет управлять и использовать объемы хранения напрямую на любой инфраструктуре 
разработчиком или владельцем приложения с любой Linux-инстанции.

Роль предлагает абстракцию для нескольких типов хранения:

- Блочное хранилище.
- Общие файловые системы.
- Объектное хранилище.

Сценарии использования:

- Автоматизация предоставления объемов для:
  - Физических хостов.
  - Виртуальных машин, управляемых через [модуль virt Ansible](
    https://docs.ansible.com/ansible/latest/modules/virt_module.html).
  - Виртуальных машин, управляемых на oVirt, OpenStack и VMWare.
  - Облачных провайдеров.
- Создание периодических снимков предоставленных объемов.
- Использование золотого объема для предоставления (клонирование объема).
- Изменение размера предоставленных объемов.
- Определение QoS для предоставленных объемов.
- Выполнение миграции объемов между бэкендами.

Функции
--------

Роль хранения в настоящее время поддерживает блочное хранилище и абстрагировала 
следующие операции.

- Получать статистику *бэкенда*
- Создавать объемы
- Удалять объемы
- Увеличивать объемы
- Присоединять объемы
- Откреплять объемы

Начало работы
---------------

Давайте начнем с того, как запустить ваш первый плейбук хранения.

Запуск примерного плейбука установит пакеты в систему и предоставит
VG системе. Мы рекомендуем запускать эти команды внутри ВМ или
изменить значение переменной IP на IP виртуальной машины.

После настройки LVM VG плейбук создаст объем, присоединит его к 
узлу через iSCSI, отобразит сообщение с устройством, к которому он был присоединен,
открепит его и, наконец, удалит объем.

Чтобы запустить плейбук, сначала нужно установить роль.

``` bash
$ ansible-galaxy install Akrog.storage

После установки роли мы можем приступить к ее запуску.

Существует множество способов запуска плейбука, для простоты мы здесь только проиллюстрируем, как запустить его на локальном хосте, используя нашего пользователя и предполагая, что у нас включен sshd, наш собственный ~/.ssh/id_rsa в файле ~/.ssh/authorized_keys, и нашему пользователю разрешено выполнять команды sudo без пароля.

$ IP=127.0.0.1
$ cd ~/.ansible/roles/Akrog.storage/example
$ ansible-playbook -i $IP, lvm-backend.yml

В отличие от большинства реальных сценариев, наш пример не использует реальную систему хранения. Плейбук сначала создает группу объемов LVM (VG), поддерживаемую устройством в цикле. Используя этот VG, мы можем создавать объемы и экспортировать их через iSCSI, используя целевой LIO.

Концепции

Поставщик — это модуль Ansible, ответственный за выполнение операций на аппаратном обеспечении хранения. Каждый поставщик должен поддерживать как минимум одно конкретное оборудование от вендора, но также может поддерживать больше, как это делает стандартный поставщик.

Чтобы открыть функциональность этих поставщиков, Роль хранения вводит концепцию бэкендов. Бэкенд создается, передавая конкретную конфигурацию поставщику для управления определенным аппаратным обеспечением хранения.

В Роли хранения есть два типа узлов: контроллеры и потребители.

Контроллеры имеют доступ к сети управления хранилищем и знают, как подключаться к интерфейсу управления аппаратным обеспечением хранения и контролировать его. Например, для создания и экспорта объема.

Потребители нуждаются только в доступе к сети данных хранения, чтобы подключиться к ресурсам, которые мы предоставили. Например, чтобы подключить объем через iSCSI.

Получите больше информации о использовании и настройке в документации: https://ansible-storage.readthedocs.io/en/docs/ ```