All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog. This project adheres to Semantic Versioning.
The new OCI Ansible collection, replaces legacy OCI Ansible modules. Please migrate to the new OCI Ansible collection for improved features and support. Refer to the Migration Guide for best migration practices. These legacy modules will be available only in the maintenance mode and only critical bugs will be fixed. They will be deprecated in mid-2021.
- Added new parameter
compartment_id
to theoci_user
andoci_group
modules. - Added an alternative
NewDBSystem
for parametercreation_type
inoci_data_guard_association
module to support creation of standby database for a VM-based DB System Open source PR & Github issue - Added a
primary-vnic-only
flag to theoci_inventory
module to ensure compute instances will be listed only once if this flag is set toyes
Open source PR
- Removed secure mongo DB deployment sample
- Made
admin_password
parameter as not_loggable in theoci_db_system
andoci_db_home
modules - Fixed the
db_backup_config
is None error faced while updating a database which is created during a db_system creation from the backup of another database Github issue
- In
instance_pool
module, added the feature to attach aload_balancer
attachment while creation of aninstance_pool
- In
oci_vnic_facts
module, added the parameter ofnsg_ids
. Github issue - In
oci_load_balancer
, added tagging feature - In
oci_bucket
, added tagging feature
- In
oci_db_system
module, the resource tag update process has been fixed - In
oci_image
module, the launch-options are consistent with provided image while creation of image with default options. Github issue
- Support for
delegation_token
to enable Ansible access over CloudShell. - Support for
is_shareable
parameter onvolume_attachment
- The environment variable name used for overriding user ocid in the documentation
- Minimum supported OCI Python SDK to 2.8.0
- Support for
is_pv_encryption_in_transit
parameter onoci_instance
- Support for
node_config_details
parameter onoci_node_pool
- Minimum supported OCI Python SDK to 2.6.0
- db_workload parameter to oci_autonomous_database module
- Allows specifying whether to create an Autonomous Transaction Processing database or an Autonomous Data Warehouse
- Support for Free Tier resources
- Support for associating Network Security Groups with vnics
oci_instance
oci_vnic
oci_vnic_attachment
- Support for associating Security Rules with Network Security Groups
oci_security_rule_actions
oci_security_rule_facts
- Support for specifying device path for volume attachments
oci_volume_attachment
- Minimum supported OCI Python SDK to 2.5.0
- Added OCI Inventory Plugin
- Added modules to manage Network Security Groups
- oci_network_security_group
- oci_network_security_group_facts
- Added modules to manage Budgets
- oci_budget
- oci_budget_facts
- oci_budget_alert_rule
- oci_budget_alert_rule_facts
- Added the following action modules
- oci_volume_backup_actions
- oci_object_storage_bucket_actions
- oci_image_actions
- oci_identity_identity_provider_actions
- Added modules to manage Exadata DB Systems
- oci_autonomous_exadata_infrastructure
- oci_autonomous_exadata_infrastructure_facts
- oci_autonomous_exadata_infrastructure_shape_facts
- Added modules to manage Tag Defaults
- oci_tag_default
- oci_tag_default_facts
- Added modules to manage Audit
- oci_audit_event_facts
- oci_configuration
- oci_configuration_facts
- Added Object Lifecycle Policy modules
- oci_object_storage_object_lifecycle_policy
- oci_object_storage_object_lifecycle_policy_facts
- Added Autoscaling modules
- oci_auto_scaling_configuration
- oci_auto_scaling_configuration_facts
- oci_auto_scaling_configuration_policy
- oci_auto_scaling_configuration_policy_facts
- Added
oci_image_actions
module to support exporting an image.
- Minimum supported OCI Python SDK to
2.2.21
- In
oci_instance
module, these options: exact_count, count_tag, max_thread_count and enable_parallel_requests are deprecated. Use oci_instance_pool module instead to create, update, terminate multiple instances. - The
oci_swift_password
andoci_swift_password_facts
modules have been removed. Useoci_auth_token
andoci_auth_token_facts
instead.
- In
oci_local_peering_gateway
module, the default value for skip_exhaustive_search_for_lpg_peerings is changed to True instead of False.
- Fact modules
oci_namespace_facts
andoci_namespace_metadata_facts
modules to fetch object storage namespace details. - Added the following features in existing modules:
- Add support for ObjectReadWithoutList access_type for buckets
oci_bucket
module.
- Add support for ObjectReadWithoutList access_type for buckets
- Minimum supported OCI Python SDK to
2.2.13
- In multiple volume modules, the type for the return value
attached_instance_information
is changed to a list instead of a dict. This will support returning multiple attached instances to a volume. - In
oci_local_peering_gateway
module, the default value forskip_exhaustive_search_for_lpg_peerings
is changed toTrue
instead ofFalse
.
- Added the following features in existing modules:
- Added
iscsi_attach_commands
andiscsi_detach_commands
return values tooci_volume_attachment
andoci_volume_attachment_facts
modules.
- Added
- Fix installation script for Ansible 2.8.0 issue
- Fix idempotency when updating a route table entry issue
- Fix invalid options error for FQDN generation in inventory script issue
- Fix error updating cross connects on a virtual circuit
- Added modules to manage:
- Added the following features in existing modules:
- New allowed values
approximateSize
andapproximateCount
for thefields
parameter ofoci_bucket_facts
module. These enable populatingapproximate_size
andapproximate_count
in the response. - Adding 'primary_private_ip' and 'primary_public_ip' addresses to instance module
- New allowed values
- Samples to demonstrate:
- how to a launch compute instance using an app catalog image
- Minimum supported OCI Python SDK to
2.1.7
- Download an object from a bucket fails if file destination does not exists issue
- OCI ansible module are not respecting LOG_PATH issue
- Update version of Python SDK issue
- 'oci_security_list' should handle int values for ports in playbook
- Added the following features in existing modules:
- Option to specify
boot_volume_size_in_gbs
with a create operation inoci_instance
module - Options to specify
launch_mode
andsource_image_type
inoci_image
module - Support for retrieving
primary_private_ip
andprimary_public_ip
inoci_instance_facts
module
- Option to specify
- Added the following features in OCI dynamic inventory script:
- Option to pass hostname format as command line parameter and environment variable
- Option to enable strict hostname checking
- Samples to demonstrate:
- how to list objects from all the buckets in a compartment
- Modules to manage
- AppCatalog Listings, Subscriptions, and Agreements to work with Oracle and Partner images published in the Partner Images Catalog.
- Added the following features in existing modules:
- Option to specify
route_table_id
with a create or an update operation inoci_local_peering_gateway
module - Option to create and download a database wallet from Autonomous Transaction Processing and Autonomous Data Warehouse databases in
oci_autonomous_database
andoci_autonomous_data_warehouse
modules - Option to create DB System from a source(backup) in
oci_db_system
module
- Option to specify
- Added the following features in OCI dynamic inventory script:
- Option to build inventory of a given compartment using its OCID
- Modules to manage
- FastConnect resources
- Added the following features in existing modules:
- Pre-Authenticated Requests in Object Storage Service.
force
option inoci_bucket
now also supports automatic deletion of bucket-level PARs- Support for listing multi-part uploads and multi-part upload parts, aborting a multi-part upload in
oci_object_facts
andoci_object
modules - In modules having a module option that supports a list of items, a
delete_*
option is now supported to delete specified list items. Seedelete_security_rules
inoci_security_list
for an example - Options in
oci_tag
module to apply tags - Option to filter by
display_name
inoci_instance_configuration_facts
module
- Added the following features in OCI dynamic inventory script:
- Option to build inventory from multiple regions
- Minimum supported OCI Python SDK to
2.1.3
- Modules to manage
- Added the following features in existing modules:
- Support for creating nested compartments and deleting compartments in
oci_compartment
module - Support for retrieving information of nested compartments in
oci_compartment_facts
module - Support specification of cost-tracking during tag definition creation in the
oci_tags
module - Support for multi-part uploads and parallel uploads in
oci_object
module
- Support for creating nested compartments and deleting compartments in
- Added the following features in OCI dynamic inventory script:
- Options to parallelise the inventory generation
- Options to build inventory of only specific tagged instances
- Option to build inventory of entire hierarchy under a given compartment
- Samples to demonstrate:
- how to give compute instances private access to OCI Object Storage using Service Gateway
- how to enable internet access to a private instance using NAT Gateway
- Modules to manage
- Support for the following services:
- Added the following features in existing modules:
- Options in
oci_boot_volume
module to support creating boot volumes - Option in
oci_volume
module to support assigning a backup policy while creating a volume - Enhanced wait support in
oci_node_pool
module - Provision and terminate
exact_count
instances in parallel in theoci_instance
module oci_route_table
andoci_security_list
supports the specification of a Service (via a Service Gateway) as a destination/source for route and security rules.- The
oci_inventory.py
dynamic inventory script supports Instance Principal authorization.
- Options in
- Samples to demonstrate:
- creating a File System and mounting it in a Compute instance and how to create a File system snapshot
- how a File System can be exported using two different export paths on two different mount targets
- how a Serial and VNC connection can be created for a compute instance
- how to create an instance pool to launch a set of compute instances based on an instance configuration
- Minimum supported OCI Python SDK to
2.1.0
- Type of module option
block_traffic
in oci_service_gateway module changed tobool
- The
oci_swift_password
andoci_swift_password_facts
modules have been deprecated. Useoci_auth_token
andoci_auth_token_facts
instead. - The
cidr_block
sub-option in theroute_rules
option ofoci_route_rules
is deprecated. Usedestination
anddestination_type
(equal toCIDR_BLOCK
) instead to specify a destination IP address in CIDR notation as the destination target for a route rule.
- Modules to manage
- Support for the following services:
- Samples to demonstrate:
- provisioning and managing an Oracle Cloud Infrastructure Autonomous Transaction Processing Database and an Autonomous Data Warehouse
- provisioning a virtual cloud network (VCN) with private subnets and an IPSec VPN(using a dynamic routing gateway, a customer premises equipment and an IPSec connection)
- Fact modules now support additional filter options (where applicable) for you to filter resources
- Support for following services:
- Modules to manage IAM dynamic groups
- Support for instance principal authorization
- Support wait options in load balancer service modules
- Support filtering of resources in facts modules using
display_name
orname
- Support to automatically redirect IAM operations to home region of tenancy
- Support for Fault Domains
- Added samples to demonstrate:
- the use of instance principal authorization
- setting up prerequisites for OKE, provisioning OKE cluster and deploying a sample application
- provisioning of a load balancer component in the Secure MongoDB deployment solution
- Minimum supported OCI Python SDK to 2.0.2
- In this first release of the OCI Ansible modules, the following Services are supported:
- Compute
- Block Storage
- Object Storage
- Networking
- Load Balancer
- Database Service
- Identity and Access Management
- Provides a dynamic inventory script
oci_inventory.py
that helps you fetch the latest set of OCI compute instances and make them available for your playbooks to be executed upon. - Includes a catalog of Oracle Cloud Infrastructure Ansible module samples, in the samples directory, that illustrate using the modules to carry out common infrastructure provisioning and configuration tasks.