Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idealista/goreplay-role
Ansible role to install GoReplay tool
https://github.com/idealista/goreplay-role
ansible debian gor goreplay
Last synced: about 2 months ago
JSON representation
Ansible role to install GoReplay tool
- Host: GitHub
- URL: https://github.com/idealista/goreplay-role
- Owner: idealista
- License: apache-2.0
- Created: 2016-12-15T13:44:24.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-08-07T04:26:52.000Z (over 1 year ago)
- Last Synced: 2024-10-20T03:29:16.367Z (3 months ago)
- Topics: ansible, debian, gor, goreplay
- Language: YAML
- Homepage:
- Size: 119 KB
- Stars: 11
- Watchers: 27
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://travis-ci.org/idealista/goreplay-role)
[](https://galaxy.ansible.com/idealista/goreplay-role)
# GoReplay Ansible role
This ansible role installs and configure GoReplay. Supports debian stretch and buster.
- [Getting Started](#getting-started)
- [Prerequisities](#prerequisities)
- [Installing](#installing)
- [Usage](#usage)
- [Testing](#testing)
- [Built With](#built-with)
- [Versioning](#versioning)
- [Authors](#authors)
- [License](#license)
- [Contributing](#contributing)
- [Acknowledgments](#acknowledgments)
## Getting Started
These instructions will get you a copy of the role for your ansible playbook. Once launched, it will install the [GoReplay](https://goreplay.org/) utility as a service in your Debian system.
### Prerequisities
Ansible 5.2.X version installed.
Inventory destination should be a Debian environment.
For testing purposes, [Molecule](https://molecule.readthedocs.io/) with [Vagrant](https://www.vagrantup.com/) as driver (with [landrush](https://github.com/vagrant-landrush/landrush) plugin) and [VirtualBox](https://www.virtualbox.org/) as provider.
### Installing
Create or add to your roles dependency file (e.g requirements.yml):
```
- src: idealista.goreplay_role
version: 2.0.0
name: goreplay
```
Install the role with ansible-galaxy command:
```
ansible-galaxy install -p roles -r requirements.yml -f
```
## Usage
To enable GoReplay and replicate traffic on another host override the following variables
```
goreplay_input: '"--input-raw :80"'
goreplay_output: '"--output-http http://test01:80"'
```
To save it to a file
```
goreplay_input: '"--input-raw :80"'
goreplay_output: "--output-file={{ goreplay_output_dir }}/requests.gor"
```
!Stop GoReplay to retrieve the file, otherwise you could lost last requests https://github.com/buger/gor/wiki/Saving-and-Replaying-from-file#buffered-file-output
```
goreplay_service_state: stopped
```
Or stop the service manually
```
ssh user@host
sudo service goreplay stop
```
Or start the service with a low flush interval
```
goreplay_input: '"--input-raw :80"'
goreplay_output: "--output-file={{ goreplay_output_dir }}/requests.gor"
goreplay_options:
- output-file-flush-interval 0m1s
```
## Testing
```
molecule test
```
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/gor-role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
## Authors
* **Idealista** - *Work with* - [idealista](https://github.com/idealista)
See also the list of [contributors](https://github.com/idealista/gor-role/contributors) who participated in this project.
## License
This project is licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license - see the [LICENSE](LICENSE) file for details.
## Contributing
Please read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
## Acknowledgments
* Leonid Bugaev, @buger, https://leonsbox.com - for such an excellent tool ;)