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

Примечание

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

Для его установки используйте: 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`, вместо стандартного HTTPS-соединения будет использоваться HTTP-соединение. Если значение не указано в задаче, используется значение переменной среды `MSO_USE_SSL`.
username строка		По умолчанию: "admin"	Имя пользователя для аутентификации. Если значение не указано в задаче, используется значение переменных среды `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs булево		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует устанавливать в `no` только при работе на контролируемых сайтах, использующих самозаверяющие сертификаты. Если значение не указано в задаче, используется значение переменной среды `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/mso/mso_site_module.html