[manual backport stable-5] rds - add the engine_mode parameter (#941)

changelogs/fragments/rds_cluster_engine_mode.yaml

@@ -0,0 +1,3 @@
+---
+minor_changes:
+- "rds_cluster - New the engine_mode parameter (https://github.com/ansible-collections/amazon.aws/pull/941)."

plugins/modules/rds_cluster.py

@@ -219,6 +219,19 @@
           - mysql
           - postgres
         type: str
+    engine_mode:
+        description:
+          - The DB engine mode of the DB cluster. The combinaison of I(engine) and I(engine_mode) may not be supported.
+          - "See AWS documentation for details:
+            L(Amazon RDS Documentation,https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)."
+        choices:
+          - provisioned
+          - serverless
+          - parallelquery
+          - global
+          - multimaster
+        type: str
+        version_added: 5.1.0
     engine_version:
         description:
           - The version number of the database engine to use.
@@ -432,6 +445,23 @@
     username: "{{ username }}"
     cluster_id: "cluster-{{ resource_prefix }}-restored"
     snapshot_identifier: "cluster-{{ resource_prefix }}-snapshot"
+
+- name: Create an Aurora PostgreSQL cluster and attach an intance
+  amazon.aws.rds_cluster:
+    state: present
+    engine: aurora-postgresql
+    engine_mode: provisioned
+    cluster_id: '{{ cluster_id }}'
+    username: '{{ username }}'
+    password: '{{ password }}'
+
+- name: Attach a new instance to the cluster
+  amazon.aws.rds_instance:
+    id: '{{ instance_id }}'
+    cluster_id: '{{ cluster_id }}'
+    engine: aurora-postgresql
+    state: present
+    db_instance_class: 'db.t3.medium'
 '''
 
 RETURN = r'''
@@ -989,9 +1019,9 @@ def main():
         copy_tags_to_snapshot=dict(type='bool'),
         domain=dict(),
         domain_iam_role_name=dict(),
-        enable_global_write_forwarding=dict(type="bool"),
+        enable_global_write_forwarding=dict(type='bool'),
         db_cluster_instance_class=dict(type="str"),
-        enable_iam_database_authentication=dict(type="bool"),
+        enable_iam_database_authentication=dict(type='bool'),
         engine=dict(choices=["aurora", "aurora-mysql", "aurora-postgresql", "mysql", "postgres"]),
         engine_mode=dict(choices=["provisioned", "serverless", "parallelquery", "global", "multimaster"]),
         engine_version=dict(),

tests/integration/targets/rds_cluster/roles/rds_cluster/defaults/main.yml

@@ -4,7 +4,7 @@
 cluster_id: ansible-test-{{ inventory_hostname | replace('_','-') }}{{ tiny_prefix}}
 username: testrdsusername
 password: test-rds_password
-engine: aurora-mysql
+engine: aurora
 port: 3306
 tags_create:
   Name: ansible-test-cluster-{{ tiny_prefix }}

tests/integration/targets/rds_cluster/roles/rds_cluster/tasks/test_create.yml

@@ -62,15 +62,15 @@
       - "'engine' in _result_create_db_cluster"
       - _result_create_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_db_cluster"
-      - _result_create_db_cluster.engine_mode == "provisioned"
+      - _result_create_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_db_cluster"
       - "'master_username' in _result_create_db_cluster"
       - _result_create_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_create_db_cluster"
       - _result_create_db_cluster.port == {{ port }}
       - "'status' in _result_create_db_cluster"
       - _result_create_db_cluster.status == 'available'
-      - _result_create_db_cluster.storage_encrypted == false
+      - _result_create_db_cluster.storage_encrypted == true
       - "'tags' in _result_create_db_cluster"
       - _result_create_db_cluster.tags | length == 2
       - _result_create_db_cluster.tags["Created_By"] == "{{ tags_create["Created_By"]}}"

tests/integration/targets/rds_cluster/roles/rds_cluster/tasks/test_create_sgs.yml

@@ -71,15 +71,15 @@
       - "'engine' in _result_create_db_cluster"
       - _result_create_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_db_cluster"
-      - _result_create_db_cluster.engine_mode == "provisioned"
+      - _result_create_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_db_cluster"
       - "'master_username' in _result_create_db_cluster"
       - _result_create_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_create_db_cluster"
       - _result_create_db_cluster.port == {{ port }}
       - "'status' in _result_create_db_cluster"
       - _result_create_db_cluster.status == 'available'
-      - _result_create_db_cluster.storage_encrypted == false
+      - _result_create_db_cluster.storage_encrypted == true
       - "'tags' in _result_create_db_cluster"
       - "'vpc_security_groups' in _result_create_db_cluster"
       - _result_create_db_cluster.vpc_security_groups | selectattr('status', 'in',
@@ -126,15 +126,15 @@
       - "'engine' in _result_create_db_cluster"
       - _result_create_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_db_cluster"
-      - _result_create_db_cluster.engine_mode == "provisioned"
+      - _result_create_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_db_cluster"
       - "'master_username' in _result_create_db_cluster"
       - _result_create_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_create_db_cluster"
       - _result_create_db_cluster.port == {{ port }}
       - "'status' in _result_create_db_cluster"
       - _result_create_db_cluster.status == 'available'
-      - _result_create_db_cluster.storage_encrypted == false
+      - _result_create_db_cluster.storage_encrypted == true
       - "'tags' in _result_create_db_cluster"
       - "'vpc_security_groups' in _result_create_db_cluster"
       - _result_create_db_cluster.vpc_security_groups | selectattr('status', 'in',

tests/integration/targets/rds_cluster/roles/rds_cluster/tasks/test_modify.yml

@@ -3,7 +3,7 @@
     rds_cluster:
       id: '{{ cluster_id }}'
       state: absent
-      engine: '{{ engine}}'
+      engine: '{{ engine }}'
       username: '{{ username }}'
       password: '{{ password }}'
       skip_final_snapshot: true
@@ -14,11 +14,15 @@
       - not _result_delete_db_cluster.changed
     ignore_errors: yes
 
-  - name: Create a DB cluster
+  # Follow up to Aurora Serverless V2 release, we use an aurora-mysql to
+  # avoid the following error when we try to adjust the port:
+  # You currently can't modify EndpointPort with Aurora Serverless.
+  - name: Create an Aurora-MySQL DB cluster
     rds_cluster:
       id: '{{ cluster_id }}'
       state: present
-      engine: '{{ engine }}'
+      engine: aurora-mysql
+      engine_mode: provisioned
       username: '{{ username }}'
       password: '{{ password }}'
     register: _result_create_source_db_cluster
@@ -37,7 +41,7 @@
       - "'db_cluster_resource_id' in _result_create_source_db_cluster"
       - "'endpoint' in _result_create_source_db_cluster"
       - "'engine' in _result_create_source_db_cluster"
-      - _result_create_source_db_cluster.engine == "{{ engine }}"
+      - _result_create_source_db_cluster.engine == "aurora-mysql"
       - "'engine_mode' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.engine_mode == "provisioned"
       - "'engine_version' in _result_create_source_db_cluster"
@@ -72,7 +76,7 @@
       - "'db_cluster_resource_id' in _result_modify_password"
       - "'endpoint' in _result_modify_password"
       - "'engine' in _result_modify_password"
-      - _result_modify_password.engine == "{{ engine }}"
+      - _result_modify_password.engine == "aurora-mysql"
       - "'engine_mode' in _result_modify_password"
       - _result_modify_password.engine_mode == "provisioned"
       - "'engine_version' in _result_modify_password"
@@ -105,7 +109,7 @@
       - "'db_cluster_resource_id' in _result_modify_port"
       - "'endpoint' in _result_modify_port"
       - "'engine' in _result_modify_port"
-      - _result_modify_port.engine == "{{ engine }}"
+      - _result_modify_port.engine == "aurora-mysql"
       - "'engine_mode' in _result_modify_port"
       - _result_modify_port.engine_mode == "provisioned"
       - "'engine_version' in _result_modify_port"
@@ -140,7 +144,7 @@
       - "'db_cluster_resource_id' in _result_modify_id"
       - "'endpoint' in _result_modify_id"
       - "'engine' in _result_modify_id"
-      - _result_modify_id.engine == "{{ engine }}"
+      - _result_modify_id.engine == "aurora-mysql"
       - "'engine_mode' in _result_modify_id"
       - _result_modify_id.engine_mode == "provisioned"
       - "'engine_version' in _result_modify_id"
@@ -199,7 +203,7 @@
       - "'db_cluster_resource_id' in _result_modify_db_parameter_group_name"
       - "'endpoint' in _result_modify_db_parameter_group_name"
       - "'engine' in _result_modify_db_parameter_group_name"
-      - _result_modify_db_parameter_group_name.engine == "{{ engine }}"
+      - _result_modify_db_parameter_group_name.engine == "aurora-mysql"
       - "'engine_mode' in _result_modify_db_parameter_group_name"
       - _result_modify_db_parameter_group_name.engine_mode == "provisioned"
       - "'engine_version' in _result_modify_db_parameter_group_name"

tests/integration/targets/rds_cluster/roles/rds_cluster/tasks/test_promote.yml

@@ -47,7 +47,7 @@
       - "'engine' in _result_create_src_db_cluster"
       - _result_create_src_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_src_db_cluster"
-      - _result_create_src_db_cluster.engine_mode == "provisioned"
+      - _result_create_src_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_src_db_cluster"
       - "'master_username' in _result_create_src_db_cluster"
       - _result_create_src_db_cluster.master_username == "{{ username }}"
@@ -103,7 +103,7 @@
       - "'engine' in _result_create_replica_db_cluster"
       - _result_create_replica_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_replica_db_cluster"
-      - _result_create_replica_db_cluster.engine_mode == "provisioned"
+      - _result_create_replica_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_replica_db_cluster"
       - "'master_username' in _result_create_replica_db_cluster"
       - _result_create_replica_db_cluster.master_username == "{{ username }}"

tests/integration/targets/rds_cluster/roles/rds_cluster/tasks/test_restore.yml

@@ -41,15 +41,15 @@
       - "'engine' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_source_db_cluster"
-      - _result_create_source_db_cluster.engine_mode == "provisioned"
+      - _result_create_source_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_source_db_cluster"
       - "'master_username' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.port == {{ port }}
       - "'status' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.status == 'available'
-      - _result_create_source_db_cluster.storage_encrypted == false
+      - _result_create_source_db_cluster.storage_encrypted == true
       - "'tags' in _result_create_source_db_cluster"
       - "'vpc_security_groups' in _result_create_source_db_cluster"
 
@@ -83,7 +83,7 @@
       - "'engine' in _result_restored_db_cluster"
       - _result_restored_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_restored_db_cluster"
-      - _result_restored_db_cluster.engine_mode == "provisioned"
+      - _result_restored_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_restored_db_cluster"
       - "'master_username' in _result_restored_db_cluster"
       - _result_restored_db_cluster.master_username == "{{ username }}"
@@ -152,7 +152,7 @@
       - "'engine' in _result_restored_db_cluster"
       - _result_restored_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_restored_db_cluster"
-      - _result_restored_db_cluster.engine_mode == "provisioned"
+      - _result_restored_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_restored_db_cluster"
       - "'master_username' in _result_restored_db_cluster"
       - _result_restored_db_cluster.master_username == "{{ username }}"

tests/integration/targets/rds_cluster/roles/rds_cluster/tasks/test_tag.yml

@@ -39,15 +39,15 @@
       - "'engine' in _result_create_db_cluster"
       - _result_create_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_db_cluster"
-      - _result_create_db_cluster.engine_mode == "provisioned"
+      - _result_create_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_db_cluster"
       - "'master_username' in _result_create_db_cluster"
       - _result_create_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_create_db_cluster"
       - _result_create_db_cluster.port == {{ port }}
       - "'status' in _result_create_db_cluster"
       - _result_create_db_cluster.status == 'available'
-      - _result_create_db_cluster.storage_encrypted == false
+      - _result_create_db_cluster.storage_encrypted == true
       - "'tags' in _result_create_db_cluster"
       - _result_create_db_cluster.tags | length == 2
       - _result_create_db_cluster.tags["Created_By"] == "{{ tags_create["Created_By"]
@@ -81,15 +81,15 @@
       - "'engine' in _result_tag_db_cluster"
       - _result_tag_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_tag_db_cluster"
-      - _result_tag_db_cluster.engine_mode == "provisioned"
+      - _result_tag_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_tag_db_cluster"
       - "'master_username' in _result_tag_db_cluster"
       - _result_tag_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_tag_db_cluster"
       - _result_tag_db_cluster.port == {{ port }}
       - "'status' in _result_tag_db_cluster"
       - _result_tag_db_cluster.status == 'available'
-      - _result_tag_db_cluster.storage_encrypted == false
+      - _result_tag_db_cluster.storage_encrypted == true
       - "'tags' in _result_tag_db_cluster"
       - _result_tag_db_cluster.tags | length == 2
       - _result_tag_db_cluster.tags["Created_By"] == "{{ tags_create["Created_By"]
@@ -120,15 +120,15 @@
       - "'engine' in _result_tag_db_cluster"
       - _result_tag_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_tag_db_cluster"
-      - _result_tag_db_cluster.engine_mode == "provisioned"
+      - _result_tag_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_tag_db_cluster"
       - "'master_username' in _result_tag_db_cluster"
       - _result_tag_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_tag_db_cluster"
       - _result_tag_db_cluster.port == {{ port }}
       - "'status' in _result_tag_db_cluster"
       - _result_tag_db_cluster.status == 'available'
-      - _result_tag_db_cluster.storage_encrypted == false
+      - _result_tag_db_cluster.storage_encrypted == true
       - "'tags' in _result_tag_db_cluster"
       - _result_tag_db_cluster.tags | length == 2
       - _result_tag_db_cluster.tags["Name"] == "{{ tags_patch['Name'] }}"
@@ -175,15 +175,15 @@
       - "'engine' in _result_tag_db_cluster"
       - _result_tag_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_tag_db_cluster"
-      - _result_tag_db_cluster.engine_mode == "provisioned"
+      - _result_tag_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_tag_db_cluster"
       - "'master_username' in _result_tag_db_cluster"
       - _result_tag_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_tag_db_cluster"
       - _result_tag_db_cluster.port == {{ port }}
       - "'status' in _result_tag_db_cluster"
       - _result_tag_db_cluster.status == 'available'
-      - _result_tag_db_cluster.storage_encrypted == false
+      - _result_tag_db_cluster.storage_encrypted == true
       - "'tags' in _result_tag_db_cluster"
       - _result_tag_db_cluster.tags | length == 1
       - _result_tag_db_cluster.tags["Created_By"] == "Ansible_rds_cluster_integration_test"
@@ -230,15 +230,15 @@
       - "'engine' in _result_tag_db_cluster"
       - _result_tag_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_tag_db_cluster"
-      - _result_tag_db_cluster.engine_mode == "provisioned"
+      - _result_tag_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_tag_db_cluster"
       - "'master_username' in _result_tag_db_cluster"
       - _result_tag_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_tag_db_cluster"
       - _result_tag_db_cluster.port == {{ port }}
       - "'status' in _result_tag_db_cluster"
       - _result_tag_db_cluster.status == 'available'
-      - _result_tag_db_cluster.storage_encrypted == false
+      - _result_tag_db_cluster.storage_encrypted == true
       - "'tags' in _result_tag_db_cluster"
       - _result_tag_db_cluster.tags | length == 2
       - _result_tag_db_cluster.tags["Created_By"] == "{{ tags_create["Created_By"]}}"
@@ -269,15 +269,15 @@
       - "'engine' in _result_tag_db_cluster"
       - _result_tag_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_tag_db_cluster"
-      - _result_tag_db_cluster.engine_mode == "provisioned"
+      - _result_tag_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_tag_db_cluster"
       - "'master_username' in _result_tag_db_cluster"
       - _result_tag_db_cluster.master_username == "{{ username }}"
       - "'port' in _result_tag_db_cluster"
       - _result_tag_db_cluster.port == {{ port }}
       - "'status' in _result_tag_db_cluster"
       - _result_tag_db_cluster.status == 'available'
-      - _result_tag_db_cluster.storage_encrypted == false
+      - _result_tag_db_cluster.storage_encrypted == true
       - "'tags' in _result_tag_db_cluster"
       - _result_tag_db_cluster.tags | length == 0
       - "'vpc_security_groups' in _result_tag_db_cluster"

tests/integration/targets/rds_cluster_snapshot/defaults/main.yml

@@ -6,7 +6,7 @@ _resource_prefix: 'ansible-test-{{ tiny_prefix }}'
 cluster_id: '{{ _resource_prefix }}-rds-cluster'
 username: 'testrdsusername'
 password: "{{ lookup('password', 'dev/null length=12 chars=ascii_letters,digits') }}"
-engine: 'aurora-mysql'
+engine: 'aurora'
 port: 3306
 
 # Create snapshot

tests/integration/targets/rds_cluster_snapshot/tasks/main.yml

@@ -35,7 +35,7 @@
       - "'engine' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_source_db_cluster"
-      - _result_create_source_db_cluster.engine_mode == "provisioned"
+      - _result_create_source_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_source_db_cluster"
       - "'master_username' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.master_username == "{{ username }}"
@@ -149,7 +149,7 @@
       - "'engine' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.engine == "{{ engine }}"
       - "'engine_mode' in _result_create_source_db_cluster"
-      - _result_create_source_db_cluster.engine_mode == "provisioned"
+      - _result_create_source_db_cluster.engine_mode == "serverless"
       - "'engine_version' in _result_create_source_db_cluster"
       - "'master_username' in _result_create_source_db_cluster"
       - _result_create_source_db_cluster.master_username == "{{ username }}"

tests/integration/targets/rds_instance_aurora/aliases

@@ -1,5 +1,3 @@
-# See: https://github.com/ansible-collections/amazon.aws/pull/1192
-disabled
 cloud/aws
 time=30m
 rds_instance