Модуль community.general.lxd_project – Управление проектами LXD

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

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

Для установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: community.general.lxd_project.

Новое в community.general 4.8.0

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

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

Управление проектами LXD.

Параметры

Параметр	Комментарии
client_cert псевдонимы: cert_file путь	Путь к файлу клиентского сертификата. Если не указан, по умолчанию используется `$HOME/.config/lxc/client.crt`.
client_key псевдонимы: key_file путь	Путь к файлу ключа клиентского сертификата. Если не указан, по умолчанию используется `$HOME/.config/lxc/client.key`.
config словарь	Конфигурация проекта (например, `{"features.profiles": "true"}`). См. https://documentation.ubuntu.com/lxd/en/latest/api/#/projects/project_get. Если проект уже существует и его значение «config» в метаданных, полученных из `GET /1.0/projects/<name>` https://documentation.ubuntu.com/lxd/en/latest/api/#/projects/project_get, отличаются, то этот модуль пытается применить конфигурации https://documentation.ubuntu.com/lxd/en/latest/api/#/projects/project_put.
description строка	Описание проекта.
merge_project булево	Объединить конфигурацию текущего проекта с новой желаемой конфигурацией, вместо того, чтобы заменять её. Если конфигурация одинакова после объединения, никаких изменений не будет внесено. Варианты: `false` ← (по умолчанию) `true`
name строка / обязательно	Имя проекта.
new_name строка	Новое имя проекта. Если этот параметр указан, проект будет переименован в это имя. См. https://documentation.ubuntu.com/lxd/en/latest/api/#/projects/project_post.
snap_url строка	Путь к сокету Unix domain, когда LXD установлен с помощью менеджера пакетов snap. По умолчанию: `"unix:/var/snap/lxd/common/lxd/unix.socket"`
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 domain или URL https для сервера LXD. По умолчанию: `"unix:/var/lib/lxd/unix.socket"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Может работать в режиме `check_mode` и возвращать прогноз состояния «изменено» без изменения цели.
diff_mode	Поддержка: отсутствует	Возвращает подробную информацию о том, что изменилось (или, возможно, что нужно изменить в режиме `check_mode`), в режиме diff.

Примечания

Примечание

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

Примеры

# An example for creating a project
- hosts: localhost
  connection: local
  tasks:
    - name: Create a project
      community.general.lxd_project:
        name: ansible-test-project
        state: present
        config: {}
        description: my new project

# An example for renaming a project
- hosts: localhost
  connection: local
  tasks:
    - name: Rename ansible-test-project to ansible-test-project-new-name
      community.general.lxd_project:
        name: ansible-test-project
        new_name: ansible-test-project-new-name
        state: present
        config: {}
        description: my new project

Значения возврата

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

Ключ	Описание
actions список / элементы=строка	Список выполненных действий для проекта. Возвращается: успех Пример: `["create"]`
logs список / элементы=словарь	Журналы запросов и ответов. Возвращается: при вызове ansible-playbook с -vvvv.
request словарь	HTTP-запрос, отправленный на сервер LXD. Возвращается: успех
json строка	JSON-тело HTTP-запроса. Возвращается: успех Пример: `"(too long to be placed here)"`
method строка	Метод HTTP-запроса. Возвращается: успех Пример: `"GET"`
timeout целое число	Таймаут HTTP-запроса, `null` если не задан. Возвращается: успех
url строка	Путь URL HTTP-запроса. Возвращается: успех Пример: `"/1.0/projects/test-project"`
response словарь	HTTP-ответ, полученный от сервера LXD. Возвращается: успех
json строка	JSON HTTP-ответа. Возвращается: успех Пример: `"(too long to be placed here)"`
type строка	Тип выполненных действий, в настоящее время только `sent request`. Возвращается: успех Пример: `"sent request"`
old_state строка	Прежнее состояние проекта. Возвращается: успех Пример: `"absent"`

Авторы

Raymond Chang (@we10710aa)

Ссылки на сборки

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