New release v1.8.0 of OCI Ansible Modules

Added - Added modules to manage: - [Web Application Firewall Service](https://docs.cloud.oracle.com/iaas/Content/WAF/Concepts/overview.htm) - [Federating with Identity Providers](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/federation.htm) - [Oracle Identity Cloud Service Group Mapping](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/addingidcsusersandgroups.htm) - Added the following features in existing modules: - New allowed values `approximateSize` and `approximateCount` for the `fields` parameter of `oci_bucket_facts` module. These enable populating `approximate_size` and `approximate_count` in the response. - Adding 'primary_private_ip' and 'primary_public_ip' addresses to instance module - Samples to demonstrate: - how to a launch compute instance using an app catalog image Changed - Minimum supported OCI Python SDK to `2.1.7` Fixed - Download an object from a bucket fails if file destination does not exists [issue](#46) - OCI ansible module are not respecting LOG_PATH [issue](#43) - Update version of Python SDK [issue](#42) - 'oci_security_list' should handle int values for ports in playbook Co-authored-by: Nabeel Al Saber <[email protected]> Co-authored-by: Mike Ross <[email protected]>
oracle · May 1, 2019 · 8f6de2a · 8f6de2a
1 parent 44d284c
commit 8f6de2a
Show file tree

Hide file tree

Showing 93 changed files with 13,738 additions and 481 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [1.8.0] - 2019-05-01
+
+### Added
+- Added modules to manage:
+    - [Web Application Firewall Service](https://docs.cloud.oracle.com/iaas/Content/WAF/Concepts/overview.htm)
+    - [Federating with Identity Providers](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/federation.htm)
+    - [Oracle Identity Cloud Service Group Mapping](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/addingidcsusersandgroups.htm)
+- Added the following features in existing modules:
+    - New allowed values `approximateSize` and `approximateCount` for the `fields` parameter of `oci_bucket_facts` module.  These enable populating `approximate_size` and `approximate_count` in the response.
+    - Adding 'primary_private_ip' and 'primary_public_ip' addresses to instance module
+- Samples to demonstrate:
+  - how to a launch compute instance using an app catalog image
+
+### Changed
+- Minimum supported OCI Python SDK to `2.1.7`
+
+### Fixed
+- Download an object from a bucket fails if file destination does not exists [issue](https://github.com/oracle/oci-ansible-modules/issues/46)
+- OCI ansible module are not respecting LOG_PATH [issue](https://github.com/oracle/oci-ansible-modules/issues/43)
+- Update version of Python SDK [issue](https://github.com/oracle/oci-ansible-modules/issues/42)
+- 'oci_security_list' should handle int values for ports in playbook
+
 ## [1.7.0] - 2019-04-01
 
 ### Added

diff --git a/README.md b/README.md
@@ -9,7 +9,7 @@ Oracle Cloud Infrastructure Ansible Modules provide an easy way to create and pr
 - Compute
 - Container Engine for Kubernetes Service (OKE)
 - Database (including support for Autonomous Transaction Processing and Autonomous Data Warehouse Services)
-- Domain Name System (DNS)
+- Edge Services (DNS, WAF)
 - IAM
 - Load Balancing
 - Networking
@@ -33,7 +33,7 @@ This project includes a catalog of Oracle Cloud Infrastructure Ansible module sa
 - Compute
 - Container Engine for Kubernetes Service (OKE)
 - Database (including support for Autonomous Transaction Processing and Autonomous Data Warehouse Services)
-- Domain Name System (DNS)
+- Edge Services (DNS)
 - IAM
 - Load Balancing
 - Networking

diff --git a/docs/modules/list_of_cloud_modules.rst b/docs/modules/list_of_cloud_modules.rst
@@ -96,6 +96,10 @@ Oracle
   * :ref:`oci_file_system_facts_module` 
   * :ref:`oci_group_module` 
   * :ref:`oci_group_facts_module` 
+  * :ref:`oci_identity_provider_module` 
+  * :ref:`oci_identity_provider_facts_module` 
+  * :ref:`oci_idp_group_mapping_module` 
+  * :ref:`oci_idp_group_mapping_facts_module` 
   * :ref:`oci_image_module` 
   * :ref:`oci_image_facts_module` 
   * :ref:`oci_instance_module` 
@@ -222,6 +226,14 @@ Oracle
   * :ref:`oci_volume_group_backup_module` 
   * :ref:`oci_volume_group_backup_facts_module` 
   * :ref:`oci_volume_group_facts_module` 
+  * :ref:`oci_waas_certificate_module` 
+  * :ref:`oci_waas_certificate_facts_module` 
+  * :ref:`oci_waas_edge_subnet_facts_module` 
+  * :ref:`oci_waas_policy_module` 
+  * :ref:`oci_waas_policy_facts_module` 
+  * :ref:`oci_waas_recommendation_facts_module` 
+  * :ref:`oci_waas_work_request_module` 
+  * :ref:`oci_waas_work_request_facts_module` 
   * :ref:`oci_zone_module` 
   * :ref:`oci_zone_facts_module` 
   * :ref:`oci_zone_records_module` 

diff --git a/docs/modules/oci_app_catalog_listing_resource_version_facts_module.rst b/docs/modules/oci_app_catalog_listing_resource_version_facts_module.rst
@@ -206,7 +206,7 @@ Common return values are documented :ref:`here <common_return_values>`, the foll
                                             <div>List of resource versions for a particular listing</div>
                                         <br/>
                                             <div style="font-size: smaller"><b>Sample:</b></div>
-                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">[{'available_regions': ['us-ashburn-1', 'us-phoenix-1'], 'listing_resource_version': '1.0.0', 'allowed_actions': [], 'listing_id': 'ocid1.appcataloglisting.oc1..xxxxxEXAMPLExxxxx', 'accessible_ports': [], 'compatible_shapes': ['VM.Standard1.1', 'VM.Standard1.2'], 'listing_resource_id': 'ocid1.image.oc1..xxxxxEXAMPLExxxxx', 'time_published': '2019-02-14T19:53:30.878000+00:00'}]</div>
+                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">[{'available_regions': ['us-ashburn-1', 'us-phoenix-1'], 'listing_resource_version': '1.0.0', 'allowed_actions': [], 'listing_id': 'ocid1.appcataloglisting.oc1..xxxxxEXAMPLExxxxx', 'accessible_ports': [], 'compatible_shapes': ['VM.Standard2.1', 'VM.Standard2.2'], 'listing_resource_id': 'ocid1.image.oc1..xxxxxEXAMPLExxxxx', 'time_published': '2019-02-14T19:53:30.878000+00:00'}]</div>
                                     </td>
             </tr>
                                                             <tr>
@@ -286,7 +286,7 @@ Common return values are documented :ref:`here <common_return_values>`, the foll
                                             <div>List of shapes compatible with this resource.</div>
                                         <br/>
                                             <div style="font-size: smaller"><b>Sample:</b></div>
-                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">['VM.Standard1.1', 'VM.Standard1.2']</div>
+                                                <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">['VM.Standard2.1', 'VM.Standard2.2']</div>
                                     </td>
             </tr>
                                 <tr>

diff --git a/docs/modules/oci_bucket_facts_module.rst b/docs/modules/oci_bucket_facts_module.rst
@@ -101,7 +101,7 @@ Parameters
                                 <td>
                                                                                                                                                             </td>
                                                                 <td>
-                                                                        <div>Identifier of the compartment from which facts of constituent buckets needs to be fetched.                     Required to get details of all buckets in a specified namespace and compartment.</div>
+                                                                        <div>Identifier of the compartment from which facts of constituent buckets needs to be fetched. Required to get details of all buckets in a specified namespace and compartment.</div>
                                                                                 </td>
             </tr>
                                 <tr>
@@ -131,10 +131,12 @@ Parameters
                                 <td>
                                                                                                                             <ul><b>Choices:</b>
                                                                                                                                                                 <li>tags</li>
+                                                                                                                                                                                                <li>approximateCount</li>
+                                                                                                                                                                                                <li>approximateSize</li>
                                                                                     </ul>
                                                                             </td>
                                                                 <td>
-                                                                        <div>Bucket summary in list of buckets includes the 'namespace', 'name', 'compartmentId', 'createdBy', 'timeCreated', and 'etag' fields. This parameter can also include 'tags' (freeformTags and definedTags). The only supported value of this parameter is 'tags' for now.</div>
+                                                                        <div>Specifies additional fields to be returned in the response.  By default a response includes the 'namespace', 'name', 'compartment_id', 'created_by', 'time_created', and 'etag' fields. Specifying &quot;tags&quot; will populate the fields &quot;freeform_tags&quot; and &quot;defined_tags&quot;.  Specifying &quot;approximateSize&quot; will populate the field &quot;approximate_size&quot;.  Specifying &quot;approximateCount&quot; will populate the field &quot;approximate_size&quot;.  Any combination of the values may be provided.</div>
                                                                                 </td>
             </tr>
                                 <tr>
@@ -204,12 +206,25 @@ Examples
         namespace_name: 'mynamespace'
         compartment_id: 'ocid1.compartment.oc1..xxxxxEXAMPLExxxxx'
 
-    #Fetch facts of a specific bucket
+    - name: List bucket facts (including tags)
+      oci_bucket_facts:
+        namespace_name: 'mynamespace'
+        compartment_id: 'ocid1.compartment.oc1..xxxxxEXAMPLExxxxx'
+        fields: ["tags"]
+
+    # Fetch facts of a specific bucket
     - name: Fetch a bucket
       oci_bucket_facts:
         namespace_name: 'mynamespace'
         name: 'Bucket1'
 
+    # Fetch facts of a specific bucket (including approximate size and count)
+    - name: Fetch a bucket
+      oci_bucket_facts:
+        namespace_name: 'mynamespace'
+        name: 'Bucket1'
+        fields: ["approximateSize", "approximateCount"]
+
 
 
 
@@ -265,6 +280,18 @@ Common return values are documented :ref:`here <common_return_values>`, the foll
                                             <div style="font-size: smaller"><b>Sample:</b></div>
                                                 <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">ocid1.compartment.oc1..xxxxxEXAMPLExxxxx</div>
                                     </td>
+            </tr>
+                                <tr>
+                                    <td class="elbow-placeholder">&nbsp;</td>
+                                <td colspan="1">
+                    <b>approximate_count</b>
+                    <br/><div style="font-size: small; color: red">int</div>
+                                    </td>
+                <td>only when 'approximateCount' is specified in the 'fields' input option</td>
+                <td>
+                                            <div>The approximate number of objects in the bucket.                           Count statistics are reported periodically. You will see a lag between what is displayed                          and the actual object count.</div>
+                                        <br/>
+                                    </td>
             </tr>
                                 <tr>
                                     <td class="elbow-placeholder">&nbsp;</td>
@@ -335,6 +362,18 @@ Common return values are documented :ref:`here <common_return_values>`, the foll
                                             <div style="font-size: smaller"><b>Sample:</b></div>
                                                 <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">NoPublicAccess</div>
                                     </td>
+            </tr>
+                                <tr>
+                                    <td class="elbow-placeholder">&nbsp;</td>
+                                <td colspan="1">
+                    <b>approximate_size</b>
+                    <br/><div style="font-size: small; color: red">int</div>
+                                    </td>
+                <td>only when 'approximateSize' is specified in the 'fields' input option</td>
+                <td>
+                                            <div>The approximate total size of all objects in the bucket.                          Size statistics are reported periodically. You will see a lag between what is displayed and                          the actual size of the bucket.</div>
+                                        <br/>
+                                    </td>
             </tr>
                                 <tr>
                                     <td class="elbow-placeholder">&nbsp;</td>