Releases: fortinet-ansible-dev/ansible-galaxy-fortios-collection
pre-release fortios galaxy 2.0.0
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
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
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
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
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
In hardware platform, schema retrieval is prohibited
Release galaxy v1.0.7
https://galaxy.ansible.com/fortinet/fortios
- Support FOS 6.0
- Basic modules.