Skip to content

Releases: fortinet-ansible-dev/ansible-galaxy-fortios-collection

pre-release fortios galaxy 2.0.0

05 Mar 10:31
Compare
Choose a tag to compare
Pre-release

document: https://ansible-galaxy-fortios-docs.readthedocs.io/en/galaxy-2.0.0/index.html
collection:

  • install collection from git repository, available for ansible >= 2.10.0:
$ ansible-galaxy collection install git+https://github.com/fortinet-ansible-dev/ansible-galaxy-fortios-collection.git,fos_v6.0.0/galaxy_2.0.0 -f
  • install collection from binary tarball:
$ #download attached fortinet-fortios-2.0.0.tar.gz
$ ansible-galaxy collection install -f fortinet-fortios-2.0.0.tar.gz

release notes: https://ansible-galaxy-fortios-docs.readthedocs.io/en/galaxy-2.0.0/release.html#release-galaxy-2-0-0

Preview Unified Collection

13 Jan 14:31
Compare
Choose a tag to compare
Pre-release

install collection:

$ ansible-galaxy collection install git+https://github.com/fortinet-ansible-dev/ansible-galaxy-fortios-collection.git,fos_v6.0.0/galaxy_2.0.0 -f

https://ansible-galaxy-fortios-docs.readthedocs.io/en/galaxy-2.0.0/gen/fortios_system_global.html
url_filter_affinity and url_filter_count are only available since v6.2.0.

now we are going to run it for a v6.0.0 host:


$cat global_attribute.yml
- hosts: fortigates
  connection: httpapi
  collections:
  - fortinet.fortios
  vars:
   vdom: "root"
   ansible_httpapi_use_ssl: yes
   ansible_httpapi_validate_certs: no
   ansible_httpapi_port: 443
  tasks:
   - name: Configure global attributes.
     fortios_system_global:
        vdom:  "{{ vdom }}"
        access_token: "{{ fortios_access_token }}"
        system_global:
            url_filter_affinity: 32
            url_filter_count: 16

the result:

....
[WARNING]: Ansible has detected version mismatch between FortOS system and your playbook, see more details by specifying option -vvv
....
    "meta": {
        "build": 866,
        "http_method": "PUT",
        "http_status": 200,
        "name": "global",
        "path": "system",
        "revision": "4.0.0.9541577349506570699.1610337577",
        "serial": "FGVM02TM20012347",
        "status": "success",
        "vdom": "root",
        "version": "v6.0.0"
    },
    "version_check_warning": {
        "matched": false,
        "mismatches": [
            "option url_filter_affinity(32) not supported until in v6.2.0",
            "option url_filter_count(16) not supported until in v6.2.0"
        ],
        "system_version": "v6.0.0"
    }
}

Hotbuild of SDWAN for 6.4.1

11 Nov 02:56
Compare
Choose a tag to compare

This is a hot build for issue #59! since 6.4.1, SDWAN has broken backward compatibility, we have this build to address that feature.
To install.

since 6.4.1, the API changed, so does module name: fortios_system_virtual_wan_link --->fortios_system_sdwan.

To use this collection,
You have to install Ansible 2.9.x(don't install Ansible 2.10.x, because it doesn't allow non-semantic versioning);
You also have to install this collection and install it.
Possible commands:

$pip3 uninstall ansible;pip3 install ansiblle==2.9.10
$wget https://github.com/fortinet-ansible-dev/ansible-galaxy-fortios-collection/releases/download/Hotbuild%2F6.4.1%2Fsdwan/fortinet-fortios-sdwan-preview.tar.gz
$ansible-galaxy collection install -fn fortinet-fortios-sdwan-preview.tar.gz
Process install dependency map
Starting collection install process
Installing 'fortinet.fortios:sdwan-preview' to '/home/linky/.ansible/collections/ansible_collections/fortinet/fortios'

$ansible-doc --module-path ~/.ansible/collections/ansible_collections/fortinet/fortios/plugins/modules/ fortios_system_sdwan
....
        members:
         -
            comment: "Comments."
            cost: "49"
            gateway: "<your_own_value>"
            gateway6: "<your_own_value>"
            ingress_spillover_threshold: "52"
            interface: "<your_own_value> (source system.interface.name)"
            priority: "54"
            seq_num: "55"
            source: "<your_own_value>"
            source6: "<your_own_value>"
            spillover_threshold: "58"
            status: "disable"
            volume_ratio: "60"
            weight: "61"
            zone: "<your_own_value> (source system.sdwan.zone.name)"
....

Releases with versioning check warning

26 May 14:49
d706ee3
Compare
Choose a tag to compare

Warning in non-verbose output:


PLAY [fortigate01] *****************************************************************************************************************************************************************************************************************

TASK [Gathering Facts] *************************************************************************************************************************************************************************************************************
ok: [fortigate01]

TASK [Configure global attributes.] ************************************************************************************************************************************************************************************************
[WARNING]: Ansible has detected version mismatch between FortOS system and galaxy, see more details by specifying option -vvv

changed: [fortigate01]

PLAY RECAP *************************************************************************************************************************************************************************************************************************
fortigate01                : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

In verbose output:

    ......
    "meta": {
        "build": 866,
        "http_method": "PUT",
        "http_status": 200,
        "name": "global",
        "path": "system",
        "revision": "30.0.0.9544640476480832764.1589939173",
        "serial": "FGVM04TM19006963",
        "status": "success",
        "vdom": "root",
        "version": "v6.2.0"
    },
    "version_check_warning": {
        "ansible_collection_version": "v6.0.0 (galaxy: 1.0.13)",
        "matched": false,
        "message": "Please follow steps in FortiOS versioning notes: https://ansible-galaxy-fortios-docs.readthedocs.io/en/latest/version.html",
        "system_version": "v6.2.0"
    }
}
META: ran handlers
META: ran handlers

PLAY RECAP *************************************************************************************************************************************************************************************************************************
fortigate01                : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Release Galaxy 1.0.8 -- 1.0.9

15 May 03:14
d706ee3
Compare
Choose a tag to compare
1	Support special identifier validation and repair
2	Update valid_identifiers.lst
3	Fix fgd_alert_subscription multiple choices problem
4	Add vpn_ipsec_phase2_interface.proposal into exceptional multilist
5	support revision_change in response since fortigate 6.2.3
6	Fix issue #26 of ansible_fgt_modules
7	fix issue #24 of ansible_fgt_modules for generator
8	minor fix for feild:required to be consistent with schema definition
9	Update underscore_to_hyphen function and supported version file
10	Add events param to special attributes file
11	Fix py2/py3 compability issue for httpapi plugin fortios
12	fix the mkey encoding in fortios api URL
13	Module fortios_vpn_ssl_settings: banned_cipher doesn't work
14	vmlicence
15	jsonraw

Bypass schema retrieval in modules

06 Jul 03:04
d706ee3
Compare
Choose a tag to compare
Pre-release

In hardware platform, schema retrieval is prohibited

Release galaxy v1.0.7

26 Mar 07:28
Compare
Choose a tag to compare