lxd_profile - Управление профилями LXD

Новое в версии 2.2.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Управление профилями LXD

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cert_file	Значение по умолчанию: "\"{}/.config/lxc/client.crt\" .format(os.environ[\"HOME\"])"	Путь к файлу клиентского сертификата.
config		Настройки контейнера (например, {"limits.memory": "4GB"}). См. https://github.com/lxc/lxd/blob/master/doc/rest-api.md#patch-3 Если профиль уже существует, и его значение "config" в метаданных, полученных из GET /1.0/profiles/<name> https://github.com/lxc/lxd/blob/master/doc/rest-api.md#get-19, отличается, этот модуль пытается применить настройки. Не все значения настроек поддерживаются для применения существующего профиля. Возможно, вам потребуется удалить и создать профиль заново.
description (добавлено в 2.5)		Описание профиля.
devices		Устройства для профиля (например, {"rootfs": {"path": "/dev/kvm", "type": "unix-char"}}). См. https://github.com/lxc/lxd/blob/master/doc/rest-api.md#patch-3
key_file	Значение по умолчанию: "\"{}/.config/lxc/client.key\" .format(os.environ[\"HOME\"])"	Путь к файлу ключа клиентского сертификата.
name обязательно		Имя профиля.
new_name		Новое имя профиля. Если этот параметр указан, профиль будет переименован в это имя. См. https://github.com/lxc/lxd/blob/master/doc/rest-api.md#post-11
state	Варианты: present ← absent	Определяет состояние профиля.
trust_password		Защищённый пароль клиента. Вам нужно установить этот пароль на сервере LXD перед запуском этого модуля, используя следующую команду: lxc config set core.trust_password <some random password> См. https://www.stgraber.org/2016/04/18/lxd-api-direct-interaction/ Если trust_password установлен, этот модуль отправляет запрос для аутентификации перед отправкой любых запросов.
url	Значение по умолчанию: "unix:/var/lib/lxd/unix.socket"	Путь к сокету доменной адресации Unix или HTTPS-адрес сервера LXD.

Примечания

Примечание

Профили должны иметь уникальное имя. Если вы пытаетесь создать профиль с именем, которое уже существует в пространстве имен пользователя, модуль просто вернёт «без изменений».

Примеры

# An example for creating a profile
- hosts: localhost
  connection: local
  tasks:
    - name: Create a profile
      lxd_profile:
        name: macvlan
        state: present
        config: {}
        description: my macvlan profile
        devices:
          eth0:
            nictype: macvlan
            parent: br0
            type: nic

# An example for creating a profile via http connection
- hosts: localhost
  connection: local
  tasks:
  - name: create macvlan profile
    lxd_profile:
      url: https://127.0.0.1:8443
      # These cert_file and key_file values are equal to the default values.
      #cert_file: "{{ lookup('env', 'HOME') }}/.config/lxc/client.crt"
      #key_file: "{{ lookup('env', 'HOME') }}/.config/lxc/client.key"
      trust_password: mypassword
      name: macvlan
      state: present
      config: {}
      description: my macvlan profile
      devices:
        eth0:
          nictype: macvlan
          parent: br0
          type: nic

# An example for deleting a profile
- hosts: localhost
  connection: local
  tasks:
    - name: Delete a profile
      lxd_profile:
        name: macvlan
        state: absent

# An example for renaming a profile
- hosts: localhost
  connection: local
  tasks:
    - name: Rename a profile
      lxd_profile:
        name: macvlan
        new_name: macvlan2
        state: present

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

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

Ключ	Возвращаемое значение	Описание
actions список	успех	Список выполненных действий для профиля. Пример: ["create"]
logs список	при вызове ansible-playbook с -vvvv.	Логи запросов и ответов. Пример: (слишком длинно для размещения здесь)
old_state строка	успех	Предыдущее состояние профиля Пример: absent

Статус

Этот модуль помечен как preview, что означает, что его интерфейс не гарантированно будет обратной совместимым.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробнее см. Поддержка модулей и техническое обслуживание.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

Hiroaki Nakamura (@hnakamur)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/lxd_profile_module.html