cisco.mso.mso_site – Управление сайтами

Примечание

Этот плагин входит в коллекцию cisco.mso (версия 1.0.1).

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

Чтобы использовать его в книге задач, укажите: cisco.mso.mso_site.

Описание
Требования
Параметры
Примечания
Примеры

Описание

Управление сайтами в Cisco ACI Multi-Site.

Требования

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

Multi Site Orchestrator v2.1 или более поздней версии

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
apic_login_domain строка			Домен входа AAA для имени пользователя для APIC.
apic_password строка			Пароль для APIC.
apic_site_id строка			ID сайта APIC.
apic_username строка		По умолчанию: "admin"	Имя пользователя для APIC.
host строка / обязательно			IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_HOST`. псевдонимы: имя_хоста
labels список / элементы=строка			Метки для этого сайта. Метки, которых еще нет, будут автоматически созданы.
location словарь			Расположение сайта.
	latitude вещественное число		Широта расположения сайта.
	longitude вещественное число		Долгота расположения сайта.
login_domain строка			Имя домена входа для аутентификации. Значение по умолчанию - Local. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`.
output_level строка		Варианты: debug info normal ←	Влияет на вывод этого модуля ACI. `normal` означает стандартный вывод, включая `current` словарь. `info` добавляет информативный вывод, включая `previous`, `proposed` и `sent` словари. `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_OUTPUT_LEVEL`.
password строка / обязательно			Пароль для аутентификации. Если значение не указано в задаче, будут использованы переменные среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
port целое число			Номер порта для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_PORT`.
site строка			Имя сайта. псевдонимы: имя
state строка		Варианты: absent present ← query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов.
timeout целое число		По умолчанию: 30	Тайм-аут уровня сокета в секундах. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_TIMEOUT`.
urls список / элементы=строка			Список URL-адресов для ссылки на APIC.
use_proxy логическое значение		Варианты: no yes ←	Если `no`, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_USE_PROXY`.
use_ssl логическое значение		Варианты: no yes ←	Если `no`, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_USE_SSL`.
username строка		По умолчанию: "admin"	Имя пользователя для аутентификации. Если значение не указано в задаче, будут использованы переменные среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логическое значение		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует установить только на сайтах с самоподписанными сертификатами, контролируемых вручную. Если значение не указано в задаче, будет использовано значение переменной среды `MSO_VALIDATE_CERTS`.

Примечания

Примечание

Для получения более подробной информации об управлении инфраструктурой ACI с помощью Ansible, обратитесь к Руководству по Cisco ACI.
Этот модуль был разработан для поддержки ACI Multi Site Orchestrator v2.1 или более поздних версий. Некоторые или все функции могут не работать в более ранних версиях.

Примеры

- name: Add a new site
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    site: north_europe
    description: North European Datacenter
    apic_username: mso_admin
    apic_password: AnotherSecretPassword
    apic_site_id: 12
    urls:
    - 10.2.3.4
    - 10.2.4.5
    - 10.3.5.6
    labels:
    - NEDC
    - Europe
    - Diegem
    location:
      latitude: 50.887318
      longitude: 4.447084
    state: present
  delegate_to: localhost

- name: Remove a site
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    site: north_europe
    state: absent
  delegate_to: localhost

- name: Query a site
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    site: north_europe
    state: query
  delegate_to: localhost
  register: query_result

- name: Query all sites
  cisco.mso.mso_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    state: query
  delegate_to: localhost
  register: query_result

Авторы

Dag Wieers (@dagwieers)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/mso/mso_site_module.html