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.
- 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.