Release 1.8.0 - NDB modules (#332)

* New modules related to NDB databases (#326)

* SLA module for create, update and delete

* Fix update flow. Add validation to check if sla with name exists or not

* Base design for profiles creation

* Spec changes

* Patch for scaling database storage

* create seperate module for scaling

* 1. Design spec for snapshots 2. Minor fixes to database scaling

* database restore spec design

* Minor changes

* Spec design changes for restore and scaling

* Spec design changes and relevant backened changes

* Profiles spec design changes

* Update database scaling backened as per spec changes

* Module for database restore and log catcup. Add snapshot create code

* formatting

* Add update snapshot code

* Added logic for delete of snapshots

* Logic for compute profile creation

* Network profile create for multi clusters

* Database parameter type profile creation logic

* Add software profile update and version ops logic

* Add compute profile update logic

* Add logic for db parameters update and publush flow

* Add network type profile update logic

* Formatting

* Add logic for delete ops

* Linked databases code

* Minor fixes for linked databases

* Add database instance uuid in check mode

* Add backened changes for Software replication to multiple clusters

* sanity fix

* Tags crud module with backened

* Add Tags update and idempotency checks

* Basic design for db profiles params

* Minor code changes

* Backened design changes for single instance database

* 1. Backened for database registration
2. Module spec design for Db server provision and registration

* Enable static IP assignment and Virtual IP assignment for HA or single instance

* Send failover mode and backup policy as defaults in postgres payload

* Update and delete flow for database server vms

* Minor fix

* Backened changes for registration of db server VM

* Maintenance Window Module

* Add automated patching to all supported modules

* Maintenance tasks crud

* Minor fixes for database server vm registration

* Fixes for getting tag uuid

* Authorize db server vms flow

* Database clone create workflow

* Database clone delete and update flow

* Database clone update flow

* Clone database refresh and maintenance window info module

* Base design for profiles creation

* Spec changes

* Profiles spec design changes

* Logic for compute profile creation

* Network profile create for multi clusters

* Database parameter type profile creation logic

* Add software profile update and version ops logic

* Add compute profile update logic

* Add logic for db parameters update and publush flow

* Add network type profile update logic

* Formatting

* Add logic for delete ops

* Add backened changes for Software replication to multiple clusters

* Profiles redesign

* Minor fix

* Merge Day2 Ops

* Add method for getting snapshot uuid

* snapshot replication while creation to mutliple clusters

* Delete .DS_Store

* Module for snapshot replication to clusters

* sanity fix

* Minor fixes and test automation for db server vm crud and registration

* Fomatting

* fix

* Minor fixes and test automation flows for database instance

* fix

* HA and databases test automation along with minor fixes

* Test automation for tags

* Add module args for deleting db vms along with db delete

* Test automation for database clones and related backened fixes

* Minor runtime config changes

* sanity fix

* black fix

* isort fix

* Create a get spec method to point towards appropriate spec builders in clones and profiles

* black fix

* sanity fix

* sanity fix

* fix py2.7 issue

* Automation of ndb day 2 actions

* sanity fix

* prepare doc structure

* prepare doc structure

* Minor fixes in integration tests for db server vms

* Automation for maintenance window tasks

* Sla module backened fix

* Automation for maintenance windows

* ntnx_ndb_slas doc

* Fix slas module spec options

* meta runtime changes

* Add slas integration tests

* sanity & doc fix

* Fixes for db params profile

* Fix database params and software profile

* Fix publish flow of profiles

* Network profile backened fix

* network profile backened error fixes

* compute,db_params integration test

* network profile integration tests

* software profile tests

* Format response to not expose some attributes

* Enable maintenance window to get all windows if uuid is not provided

---------

Co-authored-by: alaa-bish <[email protected]>

* Clusters, vlans, tm clusters , filters (#327)

* Base design for profiles creation

* Spec changes

* Patch for scaling database storage

* create seperate module for scaling

* 1. Design spec for snapshots 2. Minor fixes to database scaling

* database restore spec design

* Minor changes

* Spec design changes for restore and scaling

* Profiles spec design changes

* Update database scaling backened as per spec changes

* Module for database restore and log catcup. Add snapshot create code

* formatting

* Add update snapshot code

* Added logic for delete of snapshots

* Logic for compute profile creation

* Network profile create for multi clusters

* Database parameter type profile creation logic

* Add software profile update and version ops logic

* Add compute profile update logic

* Add logic for db parameters update and publush flow

* Add network type profile update logic

* Formatting

* Add logic for delete ops

* Linked databases code

* Minor fixes for linked databases

* Add database instance uuid in check mode

* Add backened changes for Software replication to multiple clusters

* sanity fix

* Tags crud module with backened

* Add Tags update and idempotency checks

* Basic design for db profiles params

* Minor code changes

* Backened design changes for single instance database

* 1. Backened for database registration
2. Module spec design for Db server provision and registration

* Enable static IP assignment and Virtual IP assignment for HA or single instance

* Send failover mode and backup policy as defaults in postgres payload

* Update and delete flow for database server vms

* Minor fix

* Backened changes for registration of db server VM

* Maintenance Window Module

* Add automated patching to all supported modules

* Maintenance tasks crud

* Minor fixes for database server vm registration

* Fixes for getting tag uuid

* Authorize db server vms flow

* Database clone create workflow

* Database clone delete and update flow

* Database clone update flow

* Clone database refresh and maintenance window info module

* Base design for profiles creation

* Spec changes

* Profiles spec design changes

* Logic for compute profile creation

* Network profile create for multi clusters

* Database parameter type profile creation logic

* Add software profile update and version ops logic

* Add compute profile update logic

* Add logic for db parameters update and publush flow

* Add network type profile update logic

* Formatting

* Add logic for delete ops

* Add backened changes for Software replication to multiple clusters

* Profiles redesign

* Minor fix

* Merge Day2 Ops

* Add method for getting snapshot uuid

* snapshot replication while creation to mutliple clusters

* Delete .DS_Store

* Module for snapshot replication to clusters

* sanity fix

* Minor fixes and test automation for db server vm crud and registration

* Fomatting

* fix

* Minor fixes and test automation flows for database instance

* fix

* HA and databases test automation along with minor fixes

* Test automation for tags

* Add module args for deleting db vms along with db delete

* Test automation for database clones and related backened fixes

* Minor runtime config changes

* sanity fix

* black fix

* isort fix

* Create a get spec method to point towards appropriate spec builders in clones and profiles

* Automation of ndb day 2 actions

* clusters, vlans, tm clusters, filters

* cluster's tests changes

* Automation for multi cluster snapshots

* waiting for time machine clusters operation

* clusters and vlans fixes

* info's fixes

* database info's fixes

* fixes

* fix

* fix meta

* add ip filter

* time machine's fixes

* time machine's fixes

add ip filter

minor fixes

time machine's fixes

add ip filter

minor fixes

* fix

* time machine's fixes

* fix

* fix

* fixes

* cluster's requirements

* msg fixes

* add db server vm fliter tests

* fix vlan

* fix cluster create failure

* fix

* Fix snapshot uuid issue

* Minor comment addition

* Wait for replication to finish in tests

* Minor comment fix

* stretched_vlan_uuid fixes

* minor response changes in cluster

* fix clusters

* fix

* tm clusters fixes

* tm clusters fixes

* tm clusters fixes

* FIx errors for updating clusters in time machine

* Time machines and snapshots test fixes

* minore fixes

* minor fixes

* minor fixes

* Minor files formatting

* Minor fixes

---------

Co-authored-by: Pradeepsingh Bhati <[email protected]>
Co-authored-by: alaa-bish <[email protected]>
Co-authored-by: Gevorg-Khachatryaan <Gevorg1050.1>

* Merge DB server vms and its info module tests

* Merge slas and slas info modules test

* Minor test fixes

* black fix

* sanity fix

* prepare doc

* fix

* fix profile failures

* Minor test fixes

* snapshots_info filter tests

* merge clone and clones info tests

* profiles info fix

* Minor test fixes

* clusters filter test

* profiles info fix

* profile filters test

* sanity fix

* Minor test changes

* fix vars

* test setup for ndb tests

* fix aliases

* add no_log

* examples and doc fixes

* add cluster test

* integration test changes

* Enable/disable required tests

* Disable test setup and cleanup of PC tests

* Increase wait time for software profile tests and some minor test fixes

* black fix

* sanity fix

* prepare doc

* fix

* Minor test fixes

* merge clone and clones info tests

* Minor test fixes

* Minor test changes

* snapshots_info filter tests

* profiles info fix

* profiles info fix

* clusters filter test

* profile filters test

* sanity fix

* test setup for ndb tests

* fix vars

* integration test changes

* fix aliases

* add no_log

* add cluster test

* examples and doc fixes

* Enable/disable required tests

* Disable test setup and cleanup of PC tests

* Increase wait time for software profile tests and some minor test fixes

* Disabling some tests

* minor changes

* disable clones tests

* disable tags and slas test

* enable tags tests

* minor test fix

* Minor uncomment code

* enable few more tests

* enable all ndb tests

* Disabled passed tests

* clones test change for ubuntu runner

* Divide database tests to 3 different tests

* disabled passed tests

* disable foundation env cleanup

* fix for automated tests

* Enable all NDB tests for regression

* Minor test fix

* add db server vm check mode tests and make it stable

* sanity fix

* disabled passed testcase

* fix maintenance window issue

* Minor changes

* Doc changes

* Disable tests for verifying runners

* Enable all ndb tests

* doc fix

* doc fixes

* Doc changes and minor test fixes

* Minor test name changes

* Doc changes for new modules

* Add docs for automated patching

* doc fixes

* fix doc

* doc fix

* flake8 fix

* Doc fixes

* sanity fix

* sanity fix

* Add docs for module

* flake8 fix

* Add examples

* Add some more examples

* sanity fix

* fix subnets sanity

* remove vars from prep ndb

* sanity fix

* fix py2.7 sanity issue

* Doc fixes

* Read me changes

* Change log addtion

* add change log rst file

* Minor read me changes

* Minor change

* Minor change log changes

* doc fixes

* sanity fix

* Add ndb workflow image to examples

* Add readme in ndb examples

* Update README.md

* Minor doc changes

* Correct minor spelling in read me

---------

Co-authored-by: alaa-bish <[email protected]>
Co-authored-by: Gevorg Khachatryan <[email protected]>
Co-authored-by: Gevorg-Khachatryaan <Gevorg1050.1>

CHANGELOG.md

@@ -1,3 +1,44 @@
+## v1.8.0 (28 Feb 2022)
+
+**Features**
+
+**Nutanix Database Service (Formerly Era)**
+
+  - Ansible module for clusters info
+  - Ansible module for clusters
+  - Ansible module for vlans
+  - Ansible module for vlans info
+  - Ansible module for stretched vlans
+  - Ansible module for profiles
+  - Ansible module for profiles info
+  - Ansible module for slas
+  - Ansible module for slas info
+  - Ansible module for tags
+  - Ansible module for database instances
+  - Ansible module for database instance registration
+  - Ansible module for database instances info
+  - Ansible module for database server vms
+  - Ansible module for database server vms info
+  - Ansible module for database server vm registration
+  - Ansible module for time machine clusters
+  - Ansible module for time machines info
+  - Ansible module for authorization of database server vm with time machines
+  - Ansible module for database clones
+  - Ansible module for database clones info
+  - Ansible module for database clones refresh
+  - Ansible module for snapshots info
+  - Ansible module for database snapshots
+  - Ansible module for replicating database snapshots
+  - Ansible module for log catchups
+  - Ansible module for database restore
+  - Ansible module for database scale
+  - Ansible module for linked databases
+  - Ansible module for maintenance windows
+  - Ansible module for maintenance windows info
+  - Ansible module for maintenance tasks
+
+**Full Changelog:** [here](https://github.com/nutanix/nutanix.ansible/compare/v1.7.0...v1.8.0)
+
 ## v1.8.0-beta.1 (20 Oct 2022)
 
 **Features**

CHANGELOG.rst

@@ -5,20 +5,44 @@ Nutanix.Ncp Release Notes
 .. contents:: Topics
 
 
-v1.8.0-beta.1
-=============
+v1.8.0
+======
 
 New Modules
 -----------
 
+- ntnx_ndb_authorize_db_server_vms - module for authorizing db server vm
 - ntnx_ndb_clones_info - info module for database clones
+- ntnx_ndb_clusters - Create, Update and Delete NDB clusters
 - ntnx_ndb_clusters_info - info module for ndb clusters info
+- ntnx_ndb_database_clone_refresh - module for database clone refresh.
+- ntnx_ndb_database_clones - module for create, update and delete of ndb database clones
+- ntnx_ndb_database_log_catchup - module for performing log catchups action
+- ntnx_ndb_database_restore - module for restoring database instance
+- ntnx_ndb_database_scale - module for scaling database instance
+- ntnx_ndb_database_snapshots - module for creating, updating and deleting database snapshots
 - ntnx_ndb_databases - Module for create, update and delete of single instance database. Currently, postgres type database is officially supported.
 - ntnx_ndb_databases_info - info module for ndb database instances
+- ntnx_ndb_db_server_vms - module for create, delete and update of database server vms
 - ntnx_ndb_db_servers_info - info module for ndb db server vms info
+- ntnx_ndb_linked_databases - module to manage linked databases of a database instance
+- ntnx_ndb_maintenance_tasks - module to add and remove maintenance related tasks
+- ntnx_ndb_maintenance_window - module to create, update and delete mainetance window
+- ntnx_ndb_maintenance_windows_info - module for fetching maintenance windows info
+- ntnx_ndb_profiles - module for create, update and delete of profiles
 - ntnx_ndb_profiles_info - info module for ndb profiles
+- ntnx_ndb_register_database - module for database instance registration
+- ntnx_ndb_register_db_server_vm - module for registration of database server vm
+- ntnx_ndb_replicate_database_snapshots - module for replicating database snapshots across clusters of time machine
+- ntnx_ndb_slas - moudle for creating, updating and deleting slas
 - ntnx_ndb_slas_info - info module for ndb slas
+- ntnx_ndb_snapshots_info - info module for ndb snapshots info
+- ntnx_ndb_stretched_vlans - Module for create, update and delete of stretched vlan.
+- ntnx_ndb_tags - module for create, update and delete of tags
+- ntnx_ndb_time_machine_clusters - Module for create, update and delete for data access management in time machines.
 - ntnx_ndb_time_machines_info - info module for ndb time machines
+- ntnx_ndb_vlans - Module for create, update and delete of ndb vlan.
+- ntnx_ndb_vlans_info - info module for ndb vlans
 
 v1.7.0
 ======

CODE_OF_CONDUCT.md

@@ -54,9 +54,7 @@ further defined and clarified by project maintainers.
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at [email protected]. All
-complaints will be reviewed and investigated and will result in a response that
+All complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.
 Further details of specific enforcement policies may be posted separately.

README.md

@@ -61,12 +61,12 @@ Karbon based examples : https://github.com/nutanix/nutanix.ansible/tree/main/exa
 ## Nutanix Database Service (ERA)
 > For the 1.8.0-beta.1 release of the ansible plugin, it will have N-1 compatibility with the Nutanix Database Service (ERA). This release was tested against era versions v2.4.1 and v2.4.0
 
-NDB based examples : https://github.com/nutanix/nutanix.ansible/tree/main/examples/ndb
+> For the 1.8.0 release of the ansible plugin, it will have N-1 compatibility with the Nutanix Database Service (ERA). This release was tested against era versions v2.5.0 and v2.5.1
 
-Nutanix Ansible support for Nutanix Database Service is currently at beta stage.
+NDB based examples : https://github.com/nutanix/nutanix.ansible/tree/main/examples/ndb
 
 ### Notes:
-1. Currently for ntnx_ndb_databases, creation of only postgres type database instance is tested and offically supported. 
+1. Currently NDB based modules are supported and tested against postgres based databases.
 
 # Installing the collection
 **Prerequisite**
@@ -152,14 +152,6 @@ ansible-playbook examples/iaas/iaas.yml
 | ntnx_karbon_clusters_info | Get clusters info. |
 | ntnx_karbon_registries | Create, Delete a karbon private registry entry |
 | ntnx_karbon_registries_info | Get karbon private registry registry info. |
-| ntnx_ndb_databases | Create, Update and Delete single instance database. |
-| ntnx_ndb_databases_info | Get database info. |
-| ntnx_ndb_db_servers_info | Get db servers vm info. |
-| ntnx_ndb_clusters_info | Get clusters info. |
-| ntnx_ndb_slas_info | Get slas info |
-| ntnx_ndb_profiles_info | Get profiles info. |
-| ntnx_ndb_time_machines_info | Get time machines info. |
-| ntnx_ndb_clones_info | Get database clones info. |
 | ntnx_pbrs | Create or delete a PBR. |
 | ntnx_pbrs_info | List existing PBRs. |
 | ntnx_permissions_info | List permissions info |
@@ -203,6 +195,38 @@ ansible-playbook examples/iaas/iaas.yml
 | ntnx_foundation_central_api_keys_info | List all the api keys created in Foundation Central. |
 | ntnx_foundation_central_imaged_clusters_info | List all the clusters created using Foundation Central. |
 | ntnx_foundation_central_imaged_nodes_info | List all the nodes registered with Foundation Central. |
+| ntnx_ndb_databases_info | Get ndb database instance info |
+| ntnx_ndb_clones_info | Get ndb database clones info. |
+| ntnx_ndb_time_machines_info | Get ndb time machines info. |
+| ntnx_ndb_profiles_info | Get ndb profiles info.  |
+| ntnx_ndb_db_servers_info | Get ndb database server vms info.  |
+| ntnx_ndb_databases | Create, update and delete database instances. |
+| ntnx_ndb_register_database | Register database instance. |
+| ntnx_ndb_db_server_vms | Create, update and delete database server vms. |
+| ntnx_ndb_clusters_info | Get clusters info. |
+| ntnx_ndb_clusters | Create, update and delete clusters in NDB |
+| ntnx_ndb_snapshots_info | Get snapshots info |
+| ntnx_ndb_vlans | Create, update and delete vlans |
+| ntnx_ndb_vlans_info | Get vlans info in NDB |
+| ntnx_ndb_stretched_vlans | Get stretched vlans inf in NDB |
+| ntnx_ndb_time_machine_clusters | Manage clusters in NDB time machines |
+| ntnx_ndb_tags | Create, update and delete tags |
+| ntnx_ndb_database_clones | Create, update and delete database clones |
+| ntnx_ndb_database_snapshots | Create, update and delete database snapshots |
+| ntnx_ndb_database_clone_refresh | Perform database clone refresh |
+| ntnx_ndb_authorize_db_server_vms | authorize database server vms with time machines |
+| ntnx_ndb_profiles | create, update and delete all kind of profiles |
+| ntnx_ndb_database_log_catchup | perform log catchup |
+| ntnx_ndb_database_restore | perform database restore |
+| ntnx_ndb_database_scale | perform database scaling |
+| ntnx_ndb_linked_databases | Add and remove linked databases of database instance |
+| ntnx_ndb_replicate_database_snapshots | replicate snapshots accross clusters in time machines |
+| ntnx_ndb_register_db_server_vm | register database server vm |
+| ntnx_ndb_maintenance_tasks | Add and remove maintenance tasks in window |
+| ntnx_ndb_maintenance_window | Create, update and delete maintenance window |
+| ntnx_ndb_maintenance_windows_info | Get maintenance window info |
+| ntnx_ndb_slas | Create, update and delete sla |
+| ntnx_ndb_slas_info | Get slas info |
 
 ## Inventory Plugins
 

changelogs/changelog.yaml

@@ -282,6 +282,83 @@ releases:
       - nutanix.ncp.ntnx_prism_vm_inventory - [Imprv] add functionality constructed
         to module inventory [\#235](https://github.com/nutanix/nutanix.ansible/issues/235)
     release_date: '2022-09-30'
+  1.8.0:
+    modules:
+    - description: module for authorizing db server vm
+      name: ntnx_ndb_authorize_db_server_vms
+      namespace: ''
+    - description: Create, Update and Delete NDB clusters
+      name: ntnx_ndb_clusters
+      namespace: ''
+    - description: module for database clone refresh.
+      name: ntnx_ndb_database_clone_refresh
+      namespace: ''
+    - description: module for create, update and delete of ndb database clones
+      name: ntnx_ndb_database_clones
+      namespace: ''
+    - description: module for performing log catchups action
+      name: ntnx_ndb_database_log_catchup
+      namespace: ''
+    - description: module for restoring database instance
+      name: ntnx_ndb_database_restore
+      namespace: ''
+    - description: module for scaling database instance
+      name: ntnx_ndb_database_scale
+      namespace: ''
+    - description: module for creating, updating and deleting database snapshots
+      name: ntnx_ndb_database_snapshots
+      namespace: ''
+    - description: module for create, delete and update of database server vms
+      name: ntnx_ndb_db_server_vms
+      namespace: ''
+    - description: module to manage linked databases of a database instance
+      name: ntnx_ndb_linked_databases
+      namespace: ''
+    - description: module to add and remove maintenance related tasks
+      name: ntnx_ndb_maintenance_tasks
+      namespace: ''
+    - description: module to create, update and delete mainetance window
+      name: ntnx_ndb_maintenance_window
+      namespace: ''
+    - description: module for fetching maintenance windows info
+      name: ntnx_ndb_maintenance_windows_info
+      namespace: ''
+    - description: module for create, update and delete of profiles
+      name: ntnx_ndb_profiles
+      namespace: ''
+    - description: module for database instance registration
+      name: ntnx_ndb_register_database
+      namespace: ''
+    - description: module for registration of database server vm
+      name: ntnx_ndb_register_db_server_vm
+      namespace: ''
+    - description: module for replicating database snapshots across clusters of time
+        machine
+      name: ntnx_ndb_replicate_database_snapshots
+      namespace: ''
+    - description: moudle for creating, updating and deleting slas
+      name: ntnx_ndb_slas
+      namespace: ''
+    - description: info module for ndb snapshots info
+      name: ntnx_ndb_snapshots_info
+      namespace: ''
+    - description: Module for create, update and delete of stretched vlan.
+      name: ntnx_ndb_stretched_vlans
+      namespace: ''
+    - description: module for create, update and delete of tags
+      name: ntnx_ndb_tags
+      namespace: ''
+    - description: Module for create, update and delete for data access management
+        in time machines.
+      name: ntnx_ndb_time_machine_clusters
+      namespace: ''
+    - description: Module for create, update and delete of ndb vlan.
+      name: ntnx_ndb_vlans
+      namespace: ''
+    - description: info module for ndb vlans
+      name: ntnx_ndb_vlans_info
+      namespace: ''
+    release_date: '2023-02-28'
   1.8.0-beta.1:
     modules:
     - description: info module for database clones

examples/ndb/README.md

@@ -0,0 +1,107 @@
+# Nutanix Database Service
+Nutanix ansibe collection nutanix.ncp from v1.8.0 will contain modules for supporting Nutanix Database Service (NDB) features.
+
+These modules are based on workflow :
+
+![NDB workflow](ndb_workflow.png)
+
+Note: Access Control update and enabling multi-cluster in NDB is not yet supported by nutanix ansible provider.
+
+## Usage
+Below we will discuss usage of various NDB modules.
+
+First, we need to configure NDB setup details in the playbook. This can be done either by using module_defaults or in each individual tasks.
+
+```yaml
+---
+- name: NDB operations
+  hosts: localhost
+  gather_facts: false
+  collections:
+    - nutanix.ncp
+  module_defaults:
+    group/nutanix.ncp.ntnx:
+      nutanix_host: <ndb_setup_ip>
+      nutanix_username: <ndb_setup_username>
+      nutanix_password: <ndb_setup_password>
+      validate_certs: true
+  tasks:
+    - name: create tags
+      ntnx_ndb_tags:
+        nutanix_host: <ndb_setup_ip>
+        nutanix_username: <ndb_setup_username>
+        nutanix_password: <ndb_setup_password>
+        validate_certs: true
+```
+
+Initially on NDB setup, we add cluster, vlans or stretched vlans.
+
+For example, playbook task to register AHV cluster in NDB setup is :
+
+```yaml
+  - name: NDB cluster registration
+    ntnx_ndb_clusters:
+        name: "<name>"
+        desc: "<description>"
+        name_prefix: "<prefix_for_agent_vm>"
+        cluster_ip: "<cluster's_ip_address>"
+        cluster_credentials:
+            username: "<username>"
+            password: "<password>"
+        agent_network:
+            dns_servers:
+                - "<dns_ip1>"
+                - "<dns_ip2>"
+            ntp_servers:
+                - "<ntp_server_address1>"
+                - "<ntp_server_address1>"
+                - "<ntp_server_address1>"
+                - "<ntp_server_address1>"
+        vlan_access:
+            prism_vlan:
+                vlan_name: "<vlan_name_for_agent_vm>"
+                vlan_type: "<vlan_type>"
+                static_ip: "<ip_address_for_agent_vm>"
+                gateway: "<vlan_gateway>"
+                subnet_mask: "<subnet_mask>"
+        storage_container: "<storage_container_name>"
+    register: output
+```
+
+Examples for adding vlans and stretched vlans can be found in module documentation or examples/ndb/ in our GitHub repository.
+
+Currently, we only support postgres type databases.
+
+Example playbook task to deploy single instance postgres type database in NDB is :
+
+```yaml
+  - name: Create single instance postgres database
+    ntnx_ndb_databases:
+        name: POSTGRES_DATABASE_ANSIBLE
+        db_params_profile:
+            name: DEFAULT_POSTGRES_PARAMS
+        db_vm:
+            create_new_server:
+                name: postgres_server_ansible
+                password: temp_password
+                cluster: 
+                    name: TempCluster
+                software_profile:
+                    name: POSTGRES_10.4_OOB
+                network_profile:
+                    name: DEFAULT_OOB_POSTGRESQL_NETWORK
+                compute_profile:
+                    name: DEFAULT_OOB_SMALL_COMPUTE
+                pub_ssh_key: "<publickey-for-vm-access>"
+
+        postgres:
+            listener_port: "5432"
+            db_name: test_ansible
+            db_password: db_password
+            db_size: 200
+
+        time_machine:
+            name: POSTGRES_DATABASE_ANSIBLE_TM
+            sla:
+                name: "None"
+```