Модуль dellemc.enterprise_sonic.sonic_ptp_default_ds — управление глобальными конфигурациями PTP на SONiC

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

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

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

Чтобы использовать коллекцию в плейбуке, укажите: dellemc.enterprise_sonic.sonic_ptp_default_ds.

Добавлено в dellemc.enterprise_sonic 3.1.0

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

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

Этот модуль обеспечивает управление конфигурацией глобальных параметров PTP для устройств под управлением SONiC.
Устройство должно поддерживать микросхему синхронизации.

Параметры

Параметр	Комментарии
config словарь	Задает конфигурацию глобальных часов PTP.
announce_receipt_timeout целое число	Количество интервалов announceInterval, которые должны пройти без получения сообщения Announce до возникновения события ANNOUNCE_RECEIPT_TIMEOUT_EXPIRES.
clock_type строка	Задает тип часов, настроенных в домене PTP. Варианты: `"BC"` `"E2E_TC"` `"P2P_TC"` `"disable"`
domain_number целое число	Номер текущего домена синхронизации частоты. Диапазон — от 0 до 127.
domain_profile строка	Метод, используемый для сравнения наборов данных во время работы алгоритма выбора наилучших главных часов (Best Master Clock Algorithm). Варианты: `"ieee1588"` `"G.8275.1"` `"G.8275.2"`
log_announce_interval целое число	Двоичный логарифм среднего значения announceInterval (среднего интервала времени между последовательными сообщениями Announce).
log_min_delay_req_interval целое число	Двоичный логарифм minDelayReqInterval. Минимально допустимый средний интервал времени между последовательными сообщениями Delay_Req.
log_sync_interval целое число	Двоичный логарифм среднего значения SyncInterval для многоадресных сообщений.
network_transport строка	Сетевой транспорт, используемый для обмена данными. Варианты: `"L2"` `"UDPv4"` `"UDPv6"`
priority1 целое число	Атрибут priority1 локальных часов. Диапазон — от 0 до 255.
priority2 целое число	Атрибут priority2 локальных часов. Диапазон — от 0 до 255.
source_interface строка	Исходный интерфейс, IP-адрес которого используется в качестве исходного IP-адреса для режима многоадресной передачи PTP по IPv4 и IPv6.
two_step_flag целое число	Параметр clockAccuracy указывает ожидаемую точность часов.
unicast_multicast строка	Указывает, использует ли сетевой транспорт одноадресную или многоадресную связь. Варианты: `"unicast"` `"multicast"`
state строка	Состояние конфигурации после выполнения модуля. `merged` — объединяет предоставленную конфигурацию PTP с конфигурацией устройства. `replaced` — заменяет конфигурацию PTP устройства предоставленной конфигурацией. `overridden` — переопределяет все конфигурации PTP устройства предоставленной конфигурацией. `deleted` — удаляет конфигурацию PTP устройства. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примеры

# Using deleted
#
# Before State:
# -------------
#
# sonic# show running-configuration ptp
# ptp network-transport l2 multicast
# ptp domain 25
# ptp domain-profile default
# ptp priority1 101
# ptp priority2 91
# ptp log-announce-interval 1
# ptp log-sync-interval -3
# sonic#

- name: Delete specified PTP configurations
  dellemc.enterprise_sonic.sonic_ptp:
    config:
      log-sync-interval: -3
      log-announce-interval: 1
      network-transport: 'L2'
      unicast-multicast: 'multicast'
      priority1: 101
      priority2: 91
      domain-number: 25
    state: deleted

# After State:
# ------------
#
# sonic# show running-configuration ptp
# ptp domain-profile default
# sonic#


# Using deleted
#
# Before State:
# -------------
#
# sonic# show running-configuration ptp
# ptp mode boundary-clock
# ptp network-transport ipv6 unicast
# ptp domain 45
# ptp domain-profile g8275.2
# ptp announce-timeout 3
# sonic#

- name: Delete all PTP configurations
  dellemc.enterprise_sonic.sonic_ptp:
    config:
    state: deleted

# After State:
# ------------
#
# sonic# show running-configuration ptp
# sonic#


# Using merged
#
# Before State:
# -------------
#
# sonic# show running-configuration ptp
# ptp domain 35
# ptp domain-profile default
# ptp priority2 100
# sonic#

- name: Merge provided global PTP configurations
  dellemc.enterprise_sonic.sonic_ptp:
    config:
      domain-profile: 'G.8275.1'
      log-sync-interval: -4
      log-announce-interval: -3
      announce-receipt-timeout: 5
      log-min-delay-req-interval: -4
      clock-type: 'BC'
      network-transport: 'L2'
      unicast-multicast: 'multicast'
    state: merged

# After State:
# ------------
#
# sonic# show running-configuration ptp
# ptp mode boundary-clock
# ptp network-transport l2 multicast
# ptp domain 35
# ptp domain-profile g8275.1
# ptp priority2 100
# ptp log-announce-interval -3
# ptp announce-timeout 5
# ptp log-sync-interval -4
# ptp log-min-delay-req-interval -4
# sonic#


# Using replaced
#
# Before State:
# -------------
#
# sonic# show running-configuration ptp
# ptp network-transport ipv4 unicast
# ptp domain 44
# ptp domain-profile default
# ptp priority1 100
# ptp priority2 90
# ptp log-announce-interval -2
# ptp log-sync-interval -4
# sonic#

- name: Replace global PTP configurations
  dellemc.enterprise_sonic.sonic_ptp:
    config:
      log-sync-interval: -3
      log-announce-interval: 1
      network-transport: 'L2'
      unicast-multicast: 'multicast'
      priority1: 101
      priority2: 91
      domain-number: 25
    state: replaced

# After State:
# ------------
#
# sonic# show running-configuration ptp
# ptp network-transport l2 multicast
# ptp domain 25
# ptp domain-profile default
# ptp priority1 101
# ptp priority2 91
# ptp log-announce-interval 1
# ptp log-sync-interval -3
# sonic#


# Using overridden
#
# Before State:
# -------------
#
# sonic# show running-configuration ptp
# ptp mode boundary-clock
# ptp network-transport l2 multicast
# ptp domain 35
# ptp domain-profile g8275.1
# ptp priority2 100
# ptp log-announce-interval -3
# ptp announce-timeout 5
# ptp log-sync-interval -4
# ptp log-min-delay-req-interval -4
# sonic#

- name: Override device configuration of ptp with provided configuration
  dellemc.enterprise_sonic.sonic_ptp:
    config:
      domain-number: 44
      domain-profile: 'G.8275.2'
      network-transport: 'ipv4'
      unicast-multicast: 'unicast'
    state: overridden

# After State:
# ------------
#
# sonic# show running-configuration ptp
# ptp network-transport ipv4 unicast
# ptp domain 44
# ptp domain-profile g8275.2
# sonic#

Возвращаемые значения

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

Ключ	Описание
after словарь	Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении
after(generated) словарь	Конфигурация, которая была бы сформирована при вызове модуля без режима проверки. Возвращается: при `check_mode` Пример: `"The configuration returned will always be in the same format as the parameters above.\n"`
before словарь	Конфигурация до вызова модели. Возвращается: всегда
commands список / элементы=строка	Набор команд, отправленных на удаленное устройство. Возвращается: всегда

Авторы

Pranesh Raagav S (@PraneshRaagavS)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_ptp_default_ds_module.html