ashb commented on a change in pull request #8701: URL: https://github.com/apache/airflow/pull/8701#discussion_r488034299
########## File path: airflow/providers/amazon/aws/hooks/elasticache_replication_group.py ########## @@ -0,0 +1,276 @@ +# +# 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 time import sleep + +from airflow.exceptions import AirflowException +from airflow.providers.amazon.aws.hooks.base_aws import AwsBaseHook + + +class ElastiCacheReplicationGroupHook(AwsBaseHook): + """ + Interact with AWS ElastiCache + + :param max_retries: Max retries for checking availability of and deleting replication group + :type max_retries: int + :param exponential_back_off_factor: Factor for deciding next sleep time + :type exponential_back_off_factor: float + :param initial_poke_interval: Initial sleep time in seconds + :type initial_poke_interval: float + """ + + TERMINAL_STATES = frozenset({"available", "create-failed", "deleting"}) + + def __init__( + self, max_retries=10, exponential_back_off_factor=1, initial_poke_interval=60, *args, **kwargs + ): + self.max_retries = max_retries + self.exponential_back_off_factor = exponential_back_off_factor + self.initial_poke_interval = initial_poke_interval + + super().__init__(client_type='elasticache', *args, **kwargs) + + def create_replication_group(self, config): + """ + Call ElastiCache API for creating a replication group + + :param config: Configuration for creating the replication group + :type config: dict + :return: Response from ElastiCache create replication group API + :rtype: dict + """ + return self.conn.create_replication_group(**config) + + def delete_replication_group(self, replication_group_id): + """ + Call ElastiCache API for deleting a replication group + + :param replication_group_id: ID of replication group to delete + :type replication_group_id: str + :return: Response from ElastiCache delete replication group API + :rtype: dict + """ + return self.conn.delete_replication_group(ReplicationGroupId=replication_group_id) + + def describe_replication_group(self, replication_group_id): + """ + Call ElastiCache API for describing a replication group + + :param replication_group_id: ID of replication group to describe + :type replication_group_id: str + :return: Response from ElastiCache describe replication group API + :rtype: dict + """ + return self.conn.describe_replication_groups(ReplicationGroupId=replication_group_id) + + def get_replication_group_status(self, replication_group_id): + """ + Get current status of replication group + + :param replication_group_id: ID of replication group to check for status + :type replication_group_id: str + :return: Current status of replication group + :rtype: str + """ + return self.describe_replication_group(replication_group_id)['ReplicationGroups'][0]['Status'] + + def is_replication_group_available(self, replication_group_id): + """ + Helper for checking if replication group is available or not + + :param replication_group_id: ID of replication group to check for availability + :type replication_group_id: str + :return: True if available else False + :rtype: bool + """ + return self.get_replication_group_status(replication_group_id) == 'available' + + def wait_for_availability( + self, + replication_group_id, + initial_sleep_time=None, + exponential_back_off_factor=None, + max_retries=None + ): + """ + Check if replication group is available or not by performing a describe over it + + :param max_retries: Max retries for checking availability of replication group + :type max_retries: int + :param exponential_back_off_factor: Factor for deciding next sleep time + :type exponential_back_off_factor: float + :param initial_sleep_time: Initial sleep time in seconds + :type initial_sleep_time: float + :param replication_group_id: ID of replication group to check for availability + :type replication_group_id: str Review comment: Can you have doc order match function signature order. And mention that back_off and sleep_time default to class level values if not passed. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected]
