Spec-Zone.ru › Ansible

Модуль community.proxmox.proxmox_ceph_osd — управление OSD.

Примечание

Этот модуль входит в коллекцию community.proxmox (версия 1.6.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.proxmox. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.proxmox.proxmox_ceph_osd.

Добавлено в community.proxmox 1.5.0

  • Краткое описание
  • Требования
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль позволяет добавлять или удалять OSD.
  • Также можно переводить OSD в состояние in или out либо выполнять для него scrub.

Требования

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

  • proxmoxer >= 2.0
  • requests

Параметры

Параметр

Комментарии

api_host

string / обязательный

Укажите целевой узел кластера Proxmox VE.

Если параметр не указан, используется переменная окружения PROXMOX_HOST.

api_password

string

Укажите пароль для аутентификации.

Если параметр не указан, используется переменная окружения PROXMOX_PASSWORD.

api_port

integer

Укажите целевой порт кластера Proxmox VE.

Если параметр не указан, используется переменная окружения PROXMOX_PORT.

api_timeout

integer

Ограничение времени для запросов к API Proxmox VE.

По умолчанию: 5

api_token_id

string

Укажите ID токена.

Если параметр не указан, используется переменная окружения PROXMOX_TOKEN_ID.

api_token_secret

string

Укажите секрет токена.

Если параметр не указан, используется переменная окружения PROXMOX_TOKEN_SECRET.

api_user

string / обязательный

Укажите пользователя для аутентификации.

Если параметр не указан, используется переменная окружения PROXMOX_USER.

ca_path

path

Путь к локальному сертификату, который будет использоваться для проверки TLS-соединений.

Игнорируется, если validate_certs=false.

cleanup

boolean

Если параметр включен, удаляются записи таблицы разделов.

Используется с state=absent.

Варианты:

  • false ← (по умолчанию)
  • true

crush_device_class

string

Задайте класс устройства OSD в CRUSH.

Используется с state=present.

db_dev

string

Имя блочного устройства для block.db.

Используется с state=present.

db_dev_size

integer

Если запрошен block.db, но размер не указан, он будет выбран автоматически на основе

bluestore_block_db_size из базы данных Ceph (раздел osd или global) либо из конфигурации (раздел osd или global) в указанном порядке.

Если это значение недоступно, размер будет равен 10% от размера устройства OSD.

Возникает ошибка, если доступного размера недостаточно.

Используется с state=present.

deep

boolean

Если параметр включен, вместо обычной проверки выполняется глубокая проверка scrub.

Используется с state=scrub.

Варианты:

  • false ← (по умолчанию)
  • true

dev

string

Имя блочного устройства.

Обязателен, если state=present.

encrypted

boolean

Включает шифрование OSD.

Используется с state=present.

Варианты:

  • false ← (по умолчанию)
  • true

node

string / обязательный

Имя узла кластера.

osdid

integer

ID OSD.

Обязателен для state=absent, state=in, state=out, state=scrub, state=start, state=stop или O-state=restart).

osds_per_device

integer

Количество служб OSD на физическое устройство.

Используется с state=present.

state

string / обязательный

Создать, удалить, перевести в состояние in или out либо выполнить scrub

Варианты:

  • "present"
  • "absent"
  • "in"
  • "out"
  • "scrub"
  • "start"
  • "stop"
  • "restart"

validate_certs

boolean

Проверять TLS-сертификаты, используемые для подключения к API Proxmox VE.

В настоящее время значение по умолчанию — false; в community.proxmox 2.0.0 значение по умолчанию изменится на true.

Если параметр не указан, используется переменная окружения PROXMOX_VALIDATE_CERTS.

Варианты:

  • false
  • true

wal_dev

string

Имя блочного устройства для block.wal.

Используется с state=present.

wal_dev_size

integer

Если запрошен block.wal, но размер не указан, он будет выбран автоматически на основе

bluestore_block_wal_size из базы данных Ceph (раздел osd или global) либо из конфигурации (раздел osd или global) в указанном порядке.

Если это значение недоступно, размер будет равен 1% от размера устройства OSD.

Возникает ошибка, если доступного размера недостаточно.

Используется с state=present.

Атрибуты

Атрибут

Поддержка

Описание

action_group

Группа действий: community.proxmox.proxmox

Используйте group/community.proxmox.proxmox в module_defaults, чтобы задать значения по умолчанию для этого модуля.

check_mode

Поддержка: полная

Это действие не изменяет состояние.

Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект.

diff_mode

Поддержка: нет

Это действие не изменяет состояние.

В режиме diff будут возвращены сведения об изменениях (или о возможных изменениях в check_mode).

Примеры

- name: Add an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    dev: /dev/sdb
    state: present

- name: Delete an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    cleanup: true
    state: absent

- name: Scrub an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    deep: true
    state: scrub

- name: Out an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    state: out

- name: In an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    state: in

- name: Start an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    state: start

- name: Stop an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    state: stop

- name: Restart an osd
  community.proxmox.proxmox_ceph_osd:
    api_host: proxmox-01.example.com
    api_user: root@pam
    api_password: secret
    node: proxmox-01
    osdid: 2
    state: restart

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

msg

string

Сообщение, сформированное модулем.

Возвращается: всегда

Авторы

  • Vial Nicolas (@teslamania)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Сообщить о проблеме
  • Связь

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/proxmox/proxmox_ceph_osd_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API