/ home / f5networks / f5networks.f5_bigip / 3.4.0 / module / bigip_software_image

f5networks.f5_bigip.bigip_software_image (3.4.0) — module

Manage software images on a BIG-IP

| "added in version" 1.1.0 of f5networks.f5_bigip"

Authors: Wojciech Wypior (@wojtek0806)

Install collection

Install with ansible-galaxy collection install f5networks.f5_bigip:==3.4.0

Add to requirements.yml

  collections:
    - name: f5networks.f5_bigip
      version: 3.4.0

Description

Manages software images on a BIG-IP. These images may include both base images and hotfix images.

Usage examples

Scanned by Steampunk Spotter

- name: Upload relative image to the BIG-IP
  bigip_software_image:
    image: BIGIP-13.0.0.0.0.1645.iso

Scanned by Steampunk Spotter

- name: Upload absolute image to the BIG-IP
  bigip_software_image:
    image: /path/to/images/BIGIP-13.0.0.0.0.1645.iso

Scanned by Steampunk Spotter

- name: Upload image in a role to the BIG-IP
  bigip_software_image:
    image: "{{ role_path }}/files/BIGIP-13.0.0.0.0.1645.iso"

Inputs

    
force:
    default: false
    description:
    - When C(true), uploads the file every time and replaces the file on the device.
    - When C(false), the file is only uploaded if it does not already exist.
    - Generally should be C(true) only in cases where you have reason to believe the image
      was corrupted during upload.
    type: bool

image:
    description:
    - The image to put on the remote device.
    - This may be an absolute or relative location on the Ansible controller.
    - Image names, whether they are base ISOs or hotfix ISOs, B(must) be unique.
    required: true
    type: str

state:
    choices:
    - absent
    - present
    default: present
    description:
    - When C(present), ensures the image is uploaded.
    - When C(absent), ensures the image is removed.
    type: str

Outputs

build:
  description: Build version of the software contained in the image.
  returned: changed
  sample: 0.0.3
  type: str
checksum:
  description: MD5 checksum of the ISO.
  returned: changed
  sample: 8cdbd094195fab4b2b47ff4285577b70
  type: str
file_size:
  description: Size of the uploaded image in MB.
  returned: changed
  sample: 1948
  type: int
image_type:
  description: Whether the image is a release or hotfix image.
  returned: changed
  sample: release
  type: str
version:
  description: Version of the software contained in the image.
  returned: changed
  sample: 13.1.0.8
  type: str