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

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

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
client_cert -	Значение по умолчанию: "\"{}/.config/lxc/client.crt\" .format(os.environ[\"HOME\"])"	Путь к файлу сертификата клиента. Псевдонимы: cert_file
client_key -	Значение по умолчанию: "\"{}/.config/lxc/client.key\" .format(os.environ[\"HOME\"])"	Путь к файлу ключа сертификата клиента. Псевдонимы: key_file
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
name - / обязательно		Имя профиля.
new_name -		Новое имя профиля. Если этот параметр указан, профиль будет переименован в это имя. См. https://github.com/lxc/lxd/blob/master/doc/rest-api.md#post-11
snap_url - добавлен в 2.8	Значение по умолчанию: "unix:/var/snap/lxd/common/lxd/unix.socket"	Путь к сокету Unix-домена, когда LXD установлен менеджером пакетов snap.
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 client_cert and client_key values are equal to the default values.
      #client_cert: "{{ lookup('env', 'HOME') }}/.config/lxc/client.crt"
      #client_key: "{{ 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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом 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.8/modules/lxd_profile_module.html