Porting Guides - Breaking Changes

These porting guides are meant for modules where deprecations caused breaking changes. The guides are in the form of playbook examples to allow for users to adjust their playbooks accordingly.

Module: bigip_log_destination

Removed Parameters:
  • syslog_settings
  • pool_settings

Old Style Playbook:

---

- name: Create a remote high speed logging destination
  bigip_log_destination:
    name: hsl1
    type: remote-high-speed-log
    pool_settings:
      pool: pool1

- name: Create a remote syslog destination
  bigip_log_destination:
    name: log1
    type: remote-syslog
    syslog_settings:
      syslog_format: syslog
      forward_to: hsl1

- name: Change protocol, udp
  bigip_log_destination:
    name: hsl1
    type: remote-high-speed-log
    pool_settings:
      protocol: udp

- name: Change distribution, balanced
  bigip_log_destination:
    name: hsl1
    type: remote-high-speed-log
    pool_settings:
      distribution: balanced

New Style Playbook:

---

- name: Create a remote high speed logging destination
  bigip_log_destination:
    name: hsl1
    type: remote-high-speed-log
    pool: pool1

- name: Create a remote syslog destination
  bigip_log_destination:
    name: log1
    type: remote-syslog
    syslog_format: syslog
    forward_to: hsl1

- name: Change protocol, udp
  bigip_log_destination:
    name: hsl1
    type: remote-high-speed-log
    protocol: udp

- name: Change distribution, balanced
  bigip_log_destination:
    name: hsl1
    type: remote-high-speed-log
    distribution: balanced

Module: bigip_node

Removed Parameters:
  • quorum
  • monitor_type

Old Style Playbook:

---

- name: Create node with multiple monitors
  bigip_node:
    state: present
    name: test_node
    fqdn: foo.monitor.com
    monitors:
      - icmp
      - tcp_echo
    monitor_type: m_of_n
    quorum: 1

- name: Modify node with multiple monitors
  bigip_node:
    state: present
    name: test_node
    fqdn: foo.monitor.com
    monitors:
      - icmp
      - tcp_echo
    monitor_type: and_list

- name: Change node to single monitor
  bigip_node:
    state: present
    name: test_node
    monitors:
      - icmp
    monitor_type: single

New Style Playbook:

---

- name: Create node with multiple monitors
  bigip_node:
    state: present
    name: test_node
    fqdn: foo.monitor.com
    monitors:
      - icmp
      - tcp_echo
    availability_requirements:
      type: at_least
      at_least: 1

- name: Modify node with multiple monitors
  bigip_node:
    state: present
    name: test_node
    monitors:
      - icmp
      - tcp_echo
    availability_requirements:
      type: all

- name: Change node to single monitor
  bigip_node:
    state: present
    name: test_node
    monitors:
      - icmp

Module: bigip_ucs_fetch

This module has been changed in f5_bigip collection to work asynchronously.

Old Style Playbook:

---

- name: Download a new UCS
  bigip_ucs_fetch:
    src: cs_backup.ucs
    dest: /tmp/cs_backup.ucs

New Style Playbook:

---

- name: Create a new UCS
  bigip_ucs_fetch:
    dest: /tmp/cs_backup.ucs
  register: task

- name: Check for task completion and download created UCS
  bigip_ucs_fetch:
    dest: /tmp/cs_backup.ucs
    src: "{{ task.src }}"
    task_id: "{{ task.task_id }}"
    timeout: 300