def setUp(self, get_client_type_mock):
self.job_id = "8ba9d676-4108-4474-9dca-8bbac1da9b19"
self.region_name = AWS_REGION
self.batch_waiters = AwsBatchWaitersHook(region_name=self.region_name)
assert self.batch_waiters.aws_conn_id == 'aws_default'
assert self.batch_waiters.region_name == self.region_name
# init the mock client
self.client_mock = self.batch_waiters.client
get_client_type_mock.assert_called_once_with("batch", region_name=self.region_name)
# don't pause in these unit tests
self.mock_delay = mock.Mock(return_value=None)
self.batch_waiters.delay = self.mock_delay
self.mock_exponential_delay = mock.Mock(return_value=0)
self.batch_waiters.exponential_delay = self.mock_exponential_delay
class TestAwsBatchWaiters(unittest.TestCase):
@mock.patch.dict("os.environ", AWS_DEFAULT_REGION=AWS_REGION)
@mock.patch.dict("os.environ", AWS_ACCESS_KEY_ID=AWS_ACCESS_KEY_ID)
@mock.patch.dict("os.environ", AWS_SECRET_ACCESS_KEY=AWS_SECRET_ACCESS_KEY)
@mock.patch(
"airflow.providers.amazon.aws.hooks.batch_client.AwsBaseHook.get_client_type"
)
def setUp(self, get_client_type_mock):
self.job_id = "8ba9d676-4108-4474-9dca-8bbac1da9b19"
self.region_name = AWS_REGION
self.batch_waiters = AwsBatchWaitersHook(region_name=self.region_name)
assert self.batch_waiters.aws_conn_id == 'aws_default'
assert self.batch_waiters.region_name == self.region_name
# init the mock client
self.client_mock = self.batch_waiters.client
get_client_type_mock.assert_called_once_with(
"batch", region_name=self.region_name)
# don't pause in these unit tests
self.mock_delay = mock.Mock(return_value=None)
self.batch_waiters.delay = self.mock_delay
self.mock_exponential_delay = mock.Mock(return_value=0)
self.batch_waiters.exponential_delay = self.mock_exponential_delay
def test_default_config(self):
# the default config is used when no custom config is provided
config = self.batch_waiters.default_config
assert config == self.batch_waiters.waiter_config
assert isinstance(config, dict)
assert config["version"] == 2
assert isinstance(config["waiters"], dict)
waiters = list(sorted(config["waiters"].keys()))
assert waiters == ["JobComplete", "JobExists", "JobRunning"]
def test_list_waiters(self):
# the default config is used when no custom config is provided
config = self.batch_waiters.waiter_config
assert isinstance(config["waiters"], dict)
waiters = list(sorted(config["waiters"].keys()))
assert waiters == ["JobComplete", "JobExists", "JobRunning"]
assert waiters == self.batch_waiters.list_waiters()
def test_waiter_model(self):
model = self.batch_waiters.waiter_model
assert isinstance(model, botocore.waiter.WaiterModel)
# test some of the default config
assert model.version == 2
waiters = sorted(model.waiter_names)
assert waiters == ["JobComplete", "JobExists", "JobRunning"]
# test errors when requesting a waiter with the wrong name
with pytest.raises(ValueError) as ctx:
model.get_waiter("JobExist")
assert "Waiter does not exist: JobExist" in str(ctx.value)
# test some default waiter properties
waiter = model.get_waiter("JobExists")
assert isinstance(waiter, botocore.waiter.SingleWaiterConfig)
assert waiter.max_attempts == 100
waiter.max_attempts = 200
assert waiter.max_attempts == 200
assert waiter.delay == 2
waiter.delay = 10
assert waiter.delay == 10
assert waiter.operation == "DescribeJobs"
def test_wait_for_job(self):
import sys
# mock delay for speedy test
mock_jitter = mock.Mock(return_value=0)
self.batch_waiters.add_jitter = mock_jitter
with mock.patch.object(self.batch_waiters, "get_waiter") as get_waiter:
self.batch_waiters.wait_for_job(self.job_id)
assert get_waiter.call_args_list == [
mock.call("JobExists"),
mock.call("JobRunning"),
mock.call("JobComplete"),
]
mock_waiter = get_waiter.return_value
mock_waiter.wait.assert_called_with(jobs=[self.job_id])
assert mock_waiter.wait.call_count == 3
mock_config = mock_waiter.config
assert mock_config.delay == 0
assert mock_config.max_attempts == sys.maxsize
def test_wait_for_job_raises_for_client_error(self):
# mock delay for speedy test
mock_jitter = mock.Mock(return_value=0)
self.batch_waiters.add_jitter = mock_jitter
with mock.patch.object(self.batch_waiters, "get_waiter") as get_waiter:
mock_waiter = get_waiter.return_value
mock_waiter.wait.side_effect = botocore.exceptions.ClientError(
error_response={"Error": {
"Code": "TooManyRequestsException"
}},
operation_name="get job description",
)
with pytest.raises(AirflowException):
self.batch_waiters.wait_for_job(self.job_id)
assert get_waiter.call_args_list == [mock.call("JobExists")]
mock_waiter.wait.assert_called_with(jobs=[self.job_id])
assert mock_waiter.wait.call_count == 1
def test_wait_for_job_raises_for_waiter_error(self):
# mock delay for speedy test
mock_jitter = mock.Mock(return_value=0)
self.batch_waiters.add_jitter = mock_jitter
with mock.patch.object(self.batch_waiters, "get_waiter") as get_waiter:
mock_waiter = get_waiter.return_value
mock_waiter.wait.side_effect = botocore.exceptions.WaiterError(
name="JobExists", reason="unit test error", last_response={})
with pytest.raises(AirflowException):
self.batch_waiters.wait_for_job(self.job_id)
assert get_waiter.call_args_list == [mock.call("JobExists")]
mock_waiter.wait.assert_called_with(jobs=[self.job_id])
assert mock_waiter.wait.call_count == 1
def test_aws_batch_job_waiting(aws_clients, aws_region, job_queue_name,
job_definition_name):
"""
Submit batch jobs and wait for various job status indicators or errors.
These batch job waiter tests can be slow and might need to be marked
for conditional skips if they take too long, although it seems to
run in about 30 sec to a minute.
.. note::
These tests have no control over how moto transitions the batch job status.
.. seealso::
- https://github.com/boto/botocore/blob/develop/botocore/waiter.py
- https://github.com/spulec/moto/blob/master/moto/batch/models.py#L360
- https://github.com/spulec/moto/blob/master/tests/test_batch/test_batch.py
"""
aws_resources = batch_infrastructure(aws_clients, aws_region,
job_queue_name, job_definition_name)
batch_waiters = AwsBatchWaitersHook(region_name=aws_resources.aws_region)
job_exists_waiter = batch_waiters.get_waiter("JobExists")
assert job_exists_waiter
assert isinstance(job_exists_waiter, botocore.waiter.Waiter)
assert job_exists_waiter.__class__.__name__ == "Batch.Waiter.JobExists"
job_running_waiter = batch_waiters.get_waiter("JobRunning")
assert job_running_waiter
assert isinstance(job_running_waiter, botocore.waiter.Waiter)
assert job_running_waiter.__class__.__name__ == "Batch.Waiter.JobRunning"
job_complete_waiter = batch_waiters.get_waiter("JobComplete")
assert job_complete_waiter
assert isinstance(job_complete_waiter, botocore.waiter.Waiter)
assert job_complete_waiter.__class__.__name__ == "Batch.Waiter.JobComplete"
# test waiting on a jobId that does not exist (this throws immediately)
with pytest.raises(botocore.exceptions.WaiterError) as ctx:
job_exists_waiter.config.delay = 0.2
job_exists_waiter.config.max_attempts = 2
job_exists_waiter.wait(jobs=["missing-job"])
assert isinstance(ctx.value, botocore.exceptions.WaiterError)
assert "Waiter JobExists failed" in str(ctx.value)
# Submit a job and wait for various job status indicators;
# moto transitions the batch job status automatically.
job_name = "test-job"
job_cmd = [
'/bin/sh -c "for a in `seq 1 2`; do echo Hello World; sleep 0.25; done"'
]
job_response = aws_clients.batch.submit_job(
jobName=job_name,
jobQueue=aws_resources.job_queue_arn,
jobDefinition=aws_resources.job_definition_arn,
containerOverrides={"command": job_cmd},
)
job_id = job_response["jobId"]
job_description = aws_clients.batch.describe_jobs(jobs=[job_id])
job_status = [
job for job in job_description["jobs"] if job["jobId"] == job_id
][0]["status"]
assert job_status == "PENDING"
# this should not raise a WaiterError and note there is no 'state' maintained in
# the waiter that can be checked after calling wait() and it has no return value;
# see https://github.com/boto/botocore/blob/develop/botocore/waiter.py#L287
job_exists_waiter.config.delay = 0.2
job_exists_waiter.config.max_attempts = 20
job_exists_waiter.wait(jobs=[job_id])
# test waiting for job completion with too few attempts (possibly before job is running)
job_complete_waiter.config.delay = 0.1
job_complete_waiter.config.max_attempts = 1
with pytest.raises(botocore.exceptions.WaiterError) as ctx:
job_complete_waiter.wait(jobs=[job_id])
assert isinstance(ctx.value, botocore.exceptions.WaiterError)
assert "Waiter JobComplete failed: Max attempts exceeded" in str(ctx.value)
# wait for job to be running (or complete)
job_running_waiter.config.delay = 0.25 # sec delays between status checks
job_running_waiter.config.max_attempts = 50
job_running_waiter.wait(jobs=[job_id])
# wait for job completion
job_complete_waiter.config.delay = 0.25
job_complete_waiter.config.max_attempts = 50
job_complete_waiter.wait(jobs=[job_id])
job_description = aws_clients.batch.describe_jobs(jobs=[job_id])
job_status = [
job for job in job_description["jobs"] if job["jobId"] == job_id
][0]["status"]
assert job_status == "SUCCEEDED"
def test_aws_batch_waiters(aws_region):
assert inspect.isclass(AwsBatchWaitersHook)
batch_waiters = AwsBatchWaitersHook(region_name=aws_region)
assert isinstance(batch_waiters, AwsBatchWaitersHook)
