{"id":18188913,"url":"https://github.com/mlafeldt/docker-simianarmy","last_synced_at":"2025-07-24T06:04:24.424Z","repository":{"id":138076502,"uuid":"55961661","full_name":"mlafeldt/docker-simianarmy","owner":"mlafeldt","description":"Docker image of Netflix's Simian Army","archived":false,"fork":false,"pushed_at":"2021-04-02T19:52:18.000Z","size":116,"stargazers_count":75,"open_issues_count":1,"forks_count":19,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T04:36:03.570Z","etag":null,"topics":["chaos-engineering","chaos-monkey","chaos-testing","docker"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/mlafeldt/simianarmy/","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlafeldt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-04-11T10:05:20.000Z","updated_at":"2025-02-14T01:53:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"181f613b-4229-4a21-8cc7-7df3e5fd1df6","html_url":"https://github.com/mlafeldt/docker-simianarmy","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/mlafeldt/docker-simianarmy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlafeldt%2Fdocker-simianarmy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlafeldt%2Fdocker-simianarmy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlafeldt%2Fdocker-simianarmy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlafeldt%2Fdocker-simianarmy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlafeldt","download_url":"https://codeload.github.com/mlafeldt/docker-simianarmy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlafeldt%2Fdocker-simianarmy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266801388,"owners_count":23986371,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chaos-engineering","chaos-monkey","chaos-testing","docker"],"created_at":"2024-11-03T03:05:10.527Z","updated_at":"2025-07-24T06:04:24.383Z","avatar_url":"https://github.com/mlafeldt.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Simian Army - Docker Edition\n\n[![](https://images.microbadger.com/badges/image/mlafeldt/simianarmy.svg)](https://microbadger.com/images/mlafeldt/simianarmy)\n[![](https://img.shields.io/docker/pulls/mlafeldt/simianarmy.svg?maxAge=604800)](https://hub.docker.com/r/mlafeldt/simianarmy/)\n\nThis project provides a highly configurable Docker image of the [Simian Army](https://github.com/Netflix/SimianArmy) as a sound basis for [automating chaos experiments](https://medium.com/production-ready/chaos-monkey-for-fun-and-profit-87e2f343db31).\n\n\u003e The Simian Army is a suite of tools for keeping your cloud operating in top form. Chaos Monkey, the first member, is a resiliency tool that helps ensure that your applications can tolerate random instance failures\n\n## Quick Start\n\nAs an example, this command will start a Docker container running the Simian Army and instruct Chaos Monkey to consider all auto scaling groups (ASGs) in the given AWS account for termination:\n\n```bash\ndocker run -d \\\n    -e SIMIANARMY_CLIENT_AWS_ACCOUNTKEY=$AWS_ACCESS_KEY_ID \\\n    -e SIMIANARMY_CLIENT_AWS_SECRETKEY=$AWS_SECRET_ACCESS_KEY \\\n    -e SIMIANARMY_CLIENT_AWS_REGION=$AWS_REGION \\\n    -e SIMIANARMY_CALENDAR_ISMONKEYTIME=true \\\n    -e SIMIANARMY_CHAOS_ASG_ENABLED=true \\\n    mlafeldt/simianarmy\n```\n\nThis example is safe to run as Chaos Monkey will operate in dry-run mode by default. It's a good way for getting a feeling of the application without taking a risk.\n\nThe second example is more realistic. This time, Chaos Monkey will randomly terminate instances of the auto scaling groups tagged with a specific key-value pair:\n\n```bash\ndocker run -d \\\n    -e SIMIANARMY_CLIENT_AWS_ACCOUNTKEY=$AWS_ACCESS_KEY_ID \\\n    -e SIMIANARMY_CLIENT_AWS_SECRETKEY=$AWS_SECRET_ACCESS_KEY \\\n    -e SIMIANARMY_CLIENT_AWS_REGION=$AWS_REGION \\\n    -e SIMIANARMY_CALENDAR_ISMONKEYTIME=true \\\n    -e SIMIANARMY_CHAOS_ASG_ENABLED=true \\\n    -e SIMIANARMY_CHAOS_ASGTAG_KEY=chaos_monkey \\\n    -e SIMIANARMY_CHAOS_ASGTAG_VALUE=true \\\n    -e SIMIANARMY_CHAOS_LEASHED=false \\\n    mlafeldt/simianarmy\n```\n\nNote that this command will actually *unleash* the monkey. But don't worry: you still need to tag your ASGs accordingly for any instances to be killed.\n\nThere are many more configuration settings you can pass to the Docker image, including ones to control frequency, probability, and type of terminations. Also, you can (and should) configure Chaos Monkey to send email notifications about terminations. I encourage you to read the following documentation to learn more.\n\n## Documentation\n\n* [Usage](https://github.com/mlafeldt/docker-simianarmy/blob/master/docs/usage.md)\n* [Configuration](https://github.com/mlafeldt/docker-simianarmy/blob/master/docs/configuration.md)\n* [Configuration Properties](https://github.com/mlafeldt/docker-simianarmy/blob/master/docs/configuration-properties.md)\n* [Notifications](https://github.com/mlafeldt/docker-simianarmy/blob/master/docs/notifications.md)\n* [REST API](https://github.com/mlafeldt/docker-simianarmy/blob/master/docs/api.md)\n\n## Author\n\nThis project is being developed by [Mathias Lafeldt](https://twitter.com/mlafeldt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlafeldt%2Fdocker-simianarmy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlafeldt%2Fdocker-simianarmy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlafeldt%2Fdocker-simianarmy/lists"}