Convert RDS Event and Snapshot Sample DAGs to System Tests (AIP-47)

docs/apache-airflow-providers-amazon/operators/rds.rst

@@ -41,7 +41,7 @@ To create a snapshot of an Amazon RDS database instance or cluster you can use
 :class:`~airflow.providers.amazon.aws.operators.rds.RDSCreateDBSnapshotOperator`.
 The source database instance must be in the ``available`` or ``storage-optimization`` state.
 
-.. exampleinclude:: /../../airflow/providers/amazon/aws/example_dags/example_rds_snapshot.py
+.. exampleinclude:: /../../tests/system/providers/amazon/aws/example_rds_snapshot.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_rds_create_db_snapshot]
@@ -56,7 +56,7 @@ To copy a snapshot of an Amazon RDS database instance or cluster you can use
 :class:`~airflow.providers.amazon.aws.operators.rds.RDSCopyDBSnapshotOperator`.
 The source database snapshot must be in the ``available`` state.
 
-.. exampleinclude:: /../../airflow/providers/amazon/aws/example_dags/example_rds_snapshot.py
+.. exampleinclude:: /../../tests/system/providers/amazon/aws/example_rds_snapshot.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_rds_copy_snapshot]
@@ -71,7 +71,7 @@ To delete a snapshot of an Amazon RDS database instance or cluster you can use
 :class:`~airflow.providers.amazon.aws.operators.rds.RDSDeleteDBSnapshotOperator`.
 The database snapshot must be in the ``available`` state to be deleted.
 
-.. exampleinclude:: /../../airflow/providers/amazon/aws/example_dags/example_rds_snapshot.py
+.. exampleinclude:: /../../tests/system/providers/amazon/aws/example_rds_snapshot.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_rds_delete_snapshot]
@@ -118,7 +118,7 @@ This action requires an Amazon SNS topic Amazon Resource Name (ARN).
 Amazon RDS event notification is only available for not encrypted SNS topics.
 If you specify an encrypted SNS topic, event notifications are not sent for the topic.
 
-.. exampleinclude:: /../../airflow/providers/amazon/aws/example_dags/example_rds_event.py
+.. exampleinclude:: /../../tests/system/providers/amazon/aws/example_rds_event.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_rds_create_event_subscription]
@@ -132,7 +132,7 @@ Unsubscribe to an Amazon RDS event notification
 To delete an Amazon RDS event subscription you can use
 :class:`~airflow.providers.amazon.aws.operators.rds.RDSDeleteEventSubscriptionOperator`.
 
-.. exampleinclude:: /../../airflow/providers/amazon/aws/example_dags/example_rds_event.py
+.. exampleinclude:: /../../tests/system/providers/amazon/aws/example_rds_event.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_rds_delete_event_subscription]
@@ -178,7 +178,7 @@ To wait for an Amazon RDS snapshot with specific statuses you can use
 :class:`~airflow.providers.amazon.aws.sensors.rds.RdsSnapshotExistenceSensor`.
 By default, the sensor waits for the existence of a snapshot with status ``available``.
 
-.. exampleinclude:: /../../airflow/providers/amazon/aws/example_dags/example_rds_snapshot.py
+.. exampleinclude:: /../../tests/system/providers/amazon/aws/example_rds_snapshot.py
     :language: python
     :dedent: 4
     :start-after: [START howto_sensor_rds_snapshot_existence]

tests/system/providers/amazon/aws/example_rds_event.py

@@ -0,0 +1,134 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import datetime
+
+import boto3
+
+from airflow import DAG
+from airflow.decorators import task
+from airflow.models.baseoperator import chain
+from airflow.providers.amazon.aws.hooks.rds import RdsHook
+from airflow.providers.amazon.aws.operators.rds import (
+    RdsCreateEventSubscriptionOperator,
+    RdsDeleteEventSubscriptionOperator,
+)
+from airflow.utils.trigger_rule import TriggerRule
+from tests.system.providers.amazon.aws.utils import ENV_ID_KEY, SystemTestContextBuilder
+
+DAG_ID = 'example_rds_event'
+
+sys_test_context_task = SystemTestContextBuilder().build()
+
+
+@task
+def create_sns_topic(env_id) -> str:
+    return boto3.client('sns').create_topic(Name=f'{env_id}-topic')['TopicArn']
+
+
+@task
+def create_rds_instance(db_name, instance_name) -> None:
+    rds_client = RdsHook().get_conn()
+    rds_client.create_db_instance(
+        DBName=db_name,
+        DBInstanceIdentifier=instance_name,
+        AllocatedStorage=20,
+        DBInstanceClass='db.t3.micro',
+        Engine='postgres',
+        MasterUsername='username',
+        # NEVER store your production password in plaintext in a DAG like this.
+        # Use Airflow Secrets or a secret manager for this in production.
+        MasterUserPassword='rds_password',
+    )
+
+    rds_client.get_waiter('db_instance_available').wait(DBInstanceIdentifier=instance_name)
+
+
+@task(trigger_rule=TriggerRule.ALL_DONE)
+def delete_db_instance(instance_name) -> None:
+    rds_client = RdsHook().get_conn()
+    rds_client.delete_db_instance(
+        DBInstanceIdentifier=instance_name,
+        SkipFinalSnapshot=True,
+    )
+
+    rds_client.get_waiter('db_instance_deleted').wait(DBInstanceIdentifier=instance_name)
+
+
+@task(trigger_rule=TriggerRule.ALL_DONE)
+def delete_sns_topic(topic_arn) -> None:
+    boto3.client('sns').delete_topic(TopicArn=topic_arn)
+
+
+with DAG(
+    dag_id=DAG_ID,
+    schedule_interval='@once',
+    start_date=datetime(2021, 1, 1),
+    tags=['example'],
+    catchup=False,
+) as dag:
+    test_context = sys_test_context_task()
+
+    rds_db_name = f'{test_context[ENV_ID_KEY]}_db'
+    rds_instance_name = f'{test_context[ENV_ID_KEY]}-instance'
+    rds_subscription_name = f'{test_context[ENV_ID_KEY]}-subscription'
+
+    sns_topic = create_sns_topic(test_context[ENV_ID_KEY])
+
+    # [START howto_operator_rds_create_event_subscription]
+    create_subscription = RdsCreateEventSubscriptionOperator(
+        task_id='create_subscription',
+        subscription_name=rds_subscription_name,
+        sns_topic_arn=sns_topic,
+        source_type='db-instance',
+        source_ids=[rds_instance_name],
+        event_categories=['availability'],
+    )
+    # [END howto_operator_rds_create_event_subscription]
+
+    # [START howto_operator_rds_delete_event_subscription]
+    delete_subscription = RdsDeleteEventSubscriptionOperator(
+        task_id='delete_subscription',
+        subscription_name=rds_subscription_name,
+    )
+    # [END howto_operator_rds_delete_event_subscription]
+
+    chain(
+        # TEST SETUP
+        test_context,
+        sns_topic,
+        create_rds_instance(rds_db_name, rds_instance_name),
+        # TEST BODY
+        create_subscription,
+        delete_subscription,
+        # TEST TEARDOWN
+        delete_db_instance(rds_instance_name),
+        delete_sns_topic(sns_topic),
+    )
+
+    from tests.system.utils.watcher import watcher
+
+    # This test needs watcher in order to properly mark success/failure
+    # when "tearDown" task with trigger rule is part of the DAG
+    list(dag.tasks) >> watcher()
+
+
+from tests.system.utils import get_test_run  # noqa: E402
+
+# Needed to run the example DAG with pytest (see: tests/system/README.md#run_via_pytest)
+test_run = get_test_run(dag)