community.network.nuage_vspk – Управление средами Nuage VSP
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Чтобы использовать его в книге задач, укажите: community.network.nuage_vspk.
Краткое описание
- Управление или поиск сущностей Nuage VSP, включая создание, обновление, удаление, назначение, отмену назначения и поиск со всеми поддерживаемыми свойствами.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Python 2.7
- Поддержка Nuage VSP 4.0Rx и 5.x.y
- Правильно установленный VSPK-Python для вашей версии Nuage
- Тестировался с NuageX https://nuagex.io
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth строка / обязательный | Словарь с информацией об аутентификации, необходимой для подключения к среде Nuage VSP. Требуется параметр api_username (например, csproot). Требуется либо параметр api_password (например, csproot), либо параметры api_certificate и api_key, которые указывают на файлы сертификата и ключа для аутентификации по сертификату. Требуется параметр api_enterprise (например, csp). Требуется параметр api_url (например, https://10.0.0.10:8443). Требуется параметр api_version (например, v4_0). | |
| children строка | Может использоваться для указания набора дочерних сущностей. Обязательным свойством каждой дочерней сущности является type. Поддерживаемые необязательные свойства каждой дочерней сущности — id, properties и match_filter. Функция каждого из этих свойств такая же, как и в общем определении задачи. Это можно использовать рекурсивно. Используется только в случае state=present. | |
| command строка |
| Указывает команду для выполнения. При command=find, если parent_id и parent_type определены, поиск выполняется только в родительской сущности. В противном случае, если разрешено, поиск выполняется в корневом объекте. При command=find, если id указан, возвращается единственная сущность, соответствующая этому идентификатору. При command=find, в противном случае, если определен match_filter, используется этот фильтр для поиска. При command=find, в противном случае, если определены properties, выполняется поиск с использованием всех свойств в качестве условия AND. При command=change_password, пароль пользователя может быть изменен. Предупреждение: в случае, если новый пароль совпадает со старым, будет выброшено исключение. При command=wait_for_job, модуль ожидает завершения задачи со статусом SUCCESS или ERROR. В случае обнаружения статуса ERROR модуль завершится с ошибкой. При command=wait_for_job, задача всегда возвращается, даже если состояние ERROR. Нужно определить либо state, либо command, оба нельзя определить одновременно. |
| id строка | Идентификатор сущности, с которой необходимо работать. В сочетании с command=find возвращается единственная сущность. В сочетании с state выполняется обновление или удаление этой сущности. Предпочтительнее match_filter и properties при поиске сущности по id. | |
| match_filter строка | Фильтр, используемый при поиске (в command и state сущностей) в формате, ожидаемом API Nuage VSP. Если определен match_filter, он имеет приоритет перед properties, но не перед id | |
| parent_id строка | Идентификатор родительской сущности, с которой необходимо работать. При state сущность берется из родителя, если он существует, за исключением случаев, когда указан id. При command=find сущность ищется в этом родителе, если не указан id. При указании необходимо указать и parent_type. | |
| parent_type строка | Тип родителя, для которого указан идентификатор (например, Enterprise). Должен соответствовать имени класса CamelCase в VSPK-Python. Это имя класса можно найти на https://nuagenetworks.github.io/vspkdoc/index.html. При указании необходимо указать и parent_id. | |
| properties строка | Свойства — пары ключ-значение различных свойств сущности. Если не указан id и match_filter, используются для поиска или определения существования сущности. | |
| state строка |
| Указывает желаемое состояние сущности. Если state=present, в случае существования сущности, она будет обновлена, если это необходимо. Если state=present, если отношение с родителем является отношением «член», сущность будет назначена в качестве члена родителя. Если state=absent, если отношение с родителем является отношением «член», сущность будет удалена из числа членов родителя. Нужно определить либо state, либо command, оба нельзя определить одновременно. |
| type строка / обязательный | Тип сущности, с которой необходимо работать (например, Enterprise). Должен соответствовать имени класса CamelCase в VSPK-Python. Это имя класса можно найти на https://nuagenetworks.github.io/vspkdoc/index.html. |
Примечания
Примечание
- Режим проверки поддерживается, но с некоторыми оговорками. Изменений не будет, а если возможно, будет определено, может ли быть выполнено то, что запрошено.
- В случае, если идентификатор родителя предоставлен из предыдущей задачи, он может быть пустым, и если поиск возможен в корневом объекте, он будет выполнен, что может повлиять на производительность.
Примеры
# This can be executed as a single role, with the following vars
# vars:
# auth:
# api_username: csproot
# api_password: csproot
# api_enterprise: csp
# api_url: https://10.0.0.10:8443
# api_version: v5_0
# enterprise_name: Ansible-Enterprise
# enterprise_new_name: Ansible-Updated-Enterprise
#
# or, for certificate based authentication
# vars:
# auth:
# api_username: csproot
# api_certificate: /path/to/user-certificate.pem
# api_key: /path/to/user-Key.pem
# api_enterprise: csp
# api_url: https://10.0.0.10:8443
# api_version: v5_0
# enterprise_name: Ansible-Enterprise
# enterprise_new_name: Ansible-Updated-Enterprise
# Creating a new enterprise
- name: Create Enterprise
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: Enterprise
state: present
properties:
name: "{{ enterprise_name }}-basic"
register: nuage_enterprise
# Checking if an Enterprise with the new name already exists
- name: Check if an Enterprise exists with the new name
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: Enterprise
command: find
properties:
name: "{{ enterprise_new_name }}-basic"
ignore_errors: yes
register: nuage_check_enterprise
# Updating an enterprise's name
- name: Update Enterprise name
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: Enterprise
id: "{{ nuage_enterprise.id }}"
state: present
properties:
name: "{{ enterprise_new_name }}-basic"
when: nuage_check_enterprise is failed
# Creating a User in an Enterprise
- name: Create admin user
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: User
parent_id: "{{ nuage_enterprise.id }}"
parent_type: Enterprise
state: present
match_filter: "userName == 'ansible-admin'"
properties:
email: "ansible@localhost.local"
first_name: "Ansible"
last_name: "Admin"
password: "ansible-password"
user_name: "ansible-admin"
register: nuage_user
# Updating password for User
- name: Update admin password
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: User
id: "{{ nuage_user.id }}"
command: change_password
properties:
password: "ansible-new-password"
ignore_errors: yes
# Finding a group in an enterprise
- name: Find Administrators group in Enterprise
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: Group
parent_id: "{{ nuage_enterprise.id }}"
parent_type: Enterprise
command: find
properties:
name: "Administrators"
register: nuage_group
# Assign the user to the group
- name: Assign admin user to administrators
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: User
id: "{{ nuage_user.id }}"
parent_id: "{{ nuage_group.id }}"
parent_type: Group
state: present
# Creating multiple DomainTemplates
- name: Create multiple DomainTemplates
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: DomainTemplate
parent_id: "{{ nuage_enterprise.id }}"
parent_type: Enterprise
state: present
properties:
name: "{{ item }}"
description: "Created by Ansible"
with_items:
- "Template-1"
- "Template-2"
# Finding all DomainTemplates
- name: Fetching all DomainTemplates
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: DomainTemplate
parent_id: "{{ nuage_enterprise.id }}"
parent_type: Enterprise
command: find
register: nuage_domain_templates
# Deleting all DomainTemplates
- name: Deleting all found DomainTemplates
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: DomainTemplate
state: absent
id: "{{ item.ID }}"
with_items: "{{ nuage_domain_templates.entities }}"
when: nuage_domain_templates.entities is defined
# Unassign user from group
- name: Unassign admin user to administrators
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: User
id: "{{ nuage_user.id }}"
parent_id: "{{ nuage_group.id }}"
parent_type: Group
state: absent
# Deleting an enterprise
- name: Delete Enterprise
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: Enterprise
id: "{{ nuage_enterprise.id }}"
state: absent
# Setup an enterprise with Children
- name: Setup Enterprise and domain structure
connection: local
community.network.nuage_vspk:
auth: "{{ nuage_auth }}"
type: Enterprise
state: present
properties:
name: "Child-based-Enterprise"
children:
- type: L2DomainTemplate
properties:
name: "Unmanaged-Template"
children:
- type: EgressACLTemplate
match_filter: "name == 'Allow All'"
properties:
name: "Allow All"
active: true
default_allow_ip: true
default_allow_non_ip: true
default_install_acl_implicit_rules: true
description: "Created by Ansible"
priority_type: "TOP"
- type: IngressACLTemplate
match_filter: "name == 'Allow All'"
properties:
name: "Allow All"
active: true
default_allow_ip: true
default_allow_non_ip: true
description: "Created by Ansible"
priority_type: "TOP"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| entities список / элементы=строка | При state=present и find, с одним элементом в случае state=present или find=one. | Список обработанных сущностей. Каждый элемент — это to_dict() сущности. Пример: [{'ID': 'acabc435-3946-4117-a719-b8895a335830"', 'assocEntityType': 'DOMAIN', 'command': 'BEGIN_POLICY_CHANGES', 'creationDate': 1487515656000, 'entityScope': 'ENTERPRISE', 'externalID': None, 'lastUpdatedBy': '8a6f0e20-a4db-4878-ad84-9cc61756cd5e', 'lastUpdatedDate': 1487515656000, 'owner': '8a6f0e20-a4db-4878-ad84-9cc61756cd5e', 'parameters': None, 'parentID': 'a22fddb9-3da4-4945-bd2e-9d27fe3d62e0', 'parentType': 'domain', 'progress': 0.0, 'result': None, 'status': 'RUNNING'}] |
| id строка | При state=present и command=find в случае одной найденной сущности. | Идентификатор найденной, созданной, обновленной или назначенной сущности. Пример: bae07d8d-d29c-4e2b-b6ba-621b4807a333 |
Авторы
- Philippe Dellaert (@pdellaert)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/nuage_vspk_module.html