fail_az

This function simulates the lost of an AZ in an AWS Region for EC2. For network failure type, it uses a blackhole network ACL with deny all traffic. For instance failure type, it stops normal instances with force; stops persistent spot instances; cancels spot requests and terminates one-time spot instances. Ensure your subnets are tagged if failure_type = “network” and ensure your instances are tagged if failure_type = “instance”. Instances that are not in pending or running state will still be captured and stopped.

Usage

JSON

{
  "name": "fail_az",
  "type": "action",
  "provider": {
    "type": "python",
    "module": "azchaosaws.ec2.actions",
    "func": "fail_az",
    "arguments": {
      "az": "",
      "dry_run": true
    }
  }
}

YAML

name: fail_az
provider:
  arguments:
    az: ""
    dry_run: true
  func: fail_az
  module: azchaosaws.ec2.actions
  type: python
type: action

Arguments

Required:

• dry_run (bool): The boolean flag to simulate a dry run or not. Setting to True will only run read-only operations and not make changes to resources. (Accepted values: True | False)

At least one of:

• az (str): An availability zone
• filters (List[Dict[str, Any]]): A list of key/value pair to identify subnets by. Provide availability-zone filter if az is not specified.

Optional:

• failure_type (str): The failure type to simulate. (Accepted values: “network” | “instance”) (Default: “network”)
• state_path (str): Path to generate the state data (Default: fail_az.ec2.json). This file is used for recover_az (rollback).

Return structure

{
  "AvailabilityZone": str,
  "DryRun": bool,
  "Subnets":
    [
      {
        "SubnetId": str,
        "VpcId": str,
        "Before": {
          "NetworkAclId": str,
          "NetworkAclAssociationId": str
        },
        "After": {
          "NetworkAclId": str,
          "NetworkAclAssociationId": str
        }
      },
      ...
    ],
  "Instances":
    [
      {
        "InstanceId": str,
        "Before": {
          "State": 'pending'|'running'
        }
        "After": {
          "State": 'stopping'|'stopped'
        }
      },
      ...
    ]
}

Signature

def fail_az(
    az: str = None,
    dry_run: bool = None,
    failure_type: str = "network",
    filters: List[Dict[str, Any]] = None,
    state_path: str = "fail_az.{}.json".format(__package__.split(".", 1)[1]),
    configuration: Configuration = None,
) -> Dict[str, Any]:
    pass