{"id":19704774,"url":"https://github.com/datastax/fallout","last_synced_at":"2026-03-02T11:01:29.806Z","repository":{"id":43415278,"uuid":"251662339","full_name":"datastax/fallout","owner":"datastax","description":"Distributed System Testing as a Service","archived":false,"fork":false,"pushed_at":"2025-03-19T20:20:39.000Z","size":19249,"stargazers_count":51,"open_issues_count":3,"forks_count":12,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-06-10T22:20:12.488Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datastax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-03-31T16:23:37.000Z","updated_at":"2025-03-19T20:20:43.000Z","dependencies_parsed_at":"2025-05-12T00:37:48.685Z","dependency_job_id":null,"html_url":"https://github.com/datastax/fallout","commit_stats":null,"previous_names":[],"tags_count":74,"template":false,"template_full_name":null,"purl":"pkg:github/datastax/fallout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Ffallout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Ffallout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Ffallout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Ffallout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datastax","download_url":"https://codeload.github.com/datastax/fallout/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datastax%2Ffallout/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29999216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T09:59:02.300Z","status":"ssl_error","status_checked_at":"2026-03-02T09:59:02.001Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-11-11T21:24:25.448Z","updated_at":"2026-03-02T11:01:29.382Z","avatar_url":"https://github.com/datastax.png","language":"Java","funding_links":[],"categories":["分布式开发"],"sub_categories":[],"readme":"# Fallout\n\nFallout is a tool for running local or large scale remote based distributed correctness, verification and performance tests. Fallout is run in production at DataStax facilitating mission critical testing of Apache Cassandra\u0026#x2122;, Apache Pulsar\u0026#x2122;, and many other products.\n\nThis repository contains the core framework and components of fallout: you can use it to run performance tests on Google Kubernetes Engine.  At DataStax, we have an internal version that builds on this code and integrates with our internal infrastructure.\n\nBelow are some resources covering Fallout's architecture and design (best consumed in order, shortest to longest):\n- [Overview Video](https://www.youtube.com/watch?v=eSz8ypKQWp8) - Covers Fallout's history, architecture, CI usage, \u0026 learnings. This video is a summary of;\n- [Fallout: Distributed Systems Testing as a Service](https://arxiv.org/abs/2110.05543) - Paper submitted to 2021 BenchCouncil International Symposium on Benchmarking, Measuring and Optimizing (Bench'21).\n- [Recorded Workshop](https://www.youtube.com/watch?v=45iTmTBjU0M) - Covers the project's intent, architecture, and simple examples.\n\n## Getting Started\n\nThe easiest way to get started is to use the [published docker image](https://hub.docker.com/r/datastax/fallout) (which bundles all the support tools with Fallout), and the `fallout exec` command which runs a single test definition:\n\n```\n$ docker run datastax/fallout:latest fallout exec --help\nusage: java -jar fallout-0.1.0-SNAPSHOT-all.jar\n       exec [--params TEMPLATE-PARAMS-YAML-FILE]\n       [--use-unique-output-dir] [--config FILE] [-h] test-yaml-file\n       creds-yaml-file output-dir [template-params [template-params ...]]\n\nRun a single testrun in a standalone fallout process and exit\n\npositional arguments:\n  test-yaml-file         Test definition YAML file\n  creds-yaml-file        Credentials YAML file\n  output-dir             Where to write  testrun  artifacts;  it's an error\n                         if the directory isn't empty\n  template-params        Template params  for  test-yaml-file  in  the form\n                         param=value\n\nnamed arguments:\n  --params TEMPLATE-PARAMS-YAML-FILE\n                         Template parameters YAML file\n  --use-unique-output-dir\n                         Write     testrun     artifacts     to     output-\n                         dir/TEST_NAME/TESTRUN_ID instead of  directly into\n                         output-dir (default: false)\n  --config FILE          Application configuration file\n  -h, --help             show this help message and exit\n```\n\nFor an example, see the Pulsar tests at https://github.com/datastax/pulsar-fallout.\n\n## Running a Server\n\nFallout can be run as a multi-user service (that's how we deploy it at DataStax).  Before describing how to do this, one important caveat: **please do not run Fallout as a service on the public internet**.  In its current form, it is not secure.\n\nYou can use `docker compose` to run [`docker-compose.yml`](docker/docker-compose.yml).  When starting for the first time you'll want to create a default admin user; you can do this by setting the `FALLOUT_ADMIN_CREDS` environment variable to `\u003cUSERNAME\u003e:\u003cEMAIL\u003e:\u003cPASSWORD\u003e` on the very first start-up:\n\n```\nFALLOUT_ADMIN_CREDS=admin:admin@fallout.example.com:admin \\\n  docker compose --file fallout-oss/docker/docker-compose.yml up\n```\n\n...and connect to http://localhost:8080.\n\nThe `docker-compose.yml` defines two volumes to persist the Fallout artifacts and cassandra data, so the next time you start, the data will still be there; also you won't need the `FALLOUT_ADMIN_CREDS`:\n\n```\ndocker compose --file fallout-oss/docker/docker-compose.yml up\n```\n\n### Single-user Mode\n\nIf you set the environment variable `FALLOUT_AUTH_MODE` to `SINGLE_USER`, then fallout will automatically log you in as the user defined in `FALLOUT_ADMIN_CREDS` above.  In this case, you have to specify both environment variables every time you start:\n\n```\nFALLOUT_AUTH_MODE=SINGLE_USER \\\nFALLOUT_ADMIN_CREDS=admin:admin@fallout.example.com:admin \\\n  docker compose --file fallout-oss/docker/docker-compose.yml up\n```\n\n\n## The Future\n\nWe intend to move more functionality into this, the core repository, as time goes on.  There will be better documentation, and more examples.\n\n## Building, Contributing and Issues\n\nSee [BUILDING.md](BUILDING.md) for how to build and run the project.\n\nContributions are welcome, please see [CONTRIBUTING](CONTRIBUTING.md) for guidance.\n\nIf you encounter any bugs, please file a GitHub issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatastax%2Ffallout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatastax%2Ffallout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatastax%2Ffallout/lists"}