forked from TrueCloudLab/frostfs-s3-gw
Nikita Zinkevich
afaf12b482
Signed-off-by: Nikita Zinkevich <n.zinkevich@yadro.com> Signed-off-by: Alex Vanin <a.vanin@yadro.com>
47 lines
2.5 KiB
Markdown
47 lines
2.5 KiB
Markdown
# FrostFS S3 Playback
|
|
|
|
Playback is a tool to reproduce queries to `frostfs-s3-gw` in dev environment. Network logs could be
|
|
gathered from `s3-gw` via HTTP Logger which could be enabled on build with `loghttp` build tag
|
|
and `http_logging.enabled` option set to `true` in `s3-gw` configuration.
|
|
|
|
## Commands
|
|
|
|
`run` - reads log file and reproduces send requests from it to specified endpoint
|
|
|
|
#### Example
|
|
```bash
|
|
frostfs-s3-playback --config <config_path> run [--endpoint=<endpoint>] [--log=<log_path>]
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Playback accepts configuration file path in yaml with corresponding options:
|
|
```yaml
|
|
endpoint: http://localhost:8084
|
|
log: ./request.log
|
|
env: .env
|
|
credentials:
|
|
access_key: CAtUxDSSFtuVyVCjHTMhwx3eP3YSPo5ffwbPcnKfcdrD06WwUSn72T5EBNe3jcgjL54rmxFM6u3nUAoNBps8qJ1PD
|
|
secret_key: 560027d81c277de7378f71cbf12a32e4f7f541de724be59bcfdbfdc925425f30
|
|
http_timeout: 60s
|
|
skip_verify_tls: true
|
|
```
|
|
Configuration path is passed via required `--config` flag.
|
|
If corresponding flag is set, it overrides parameter from config.
|
|
|
|
### Configuration parameters
|
|
|
|
#### Global params
|
|
| # | Config parameter name | Flag name | Type | Default value | Description |
|
|
|---|-----------------------|-----------------|----------|---------------|--------------------------------------------------------|
|
|
| 1 | - | config | string | - | config file path (e.g. `./config/playback.yaml`) |
|
|
| 2 | http_timeout | http-timeout | duration | 60s | http request timeout |
|
|
| 3 | skip_verify_tls | skip-verify-tls | bool | false | skips tls certificate verification for https endpoints |
|
|
| 4 | credentials.accessKey | - | string | - | AWS access key id |
|
|
| 5 | credentials.secretKey | - | string | - | AWS secret key |
|
|
|
|
#### `run` command parameters
|
|
| # | Config parameter name | Flag name | Type | Default value | Description |
|
|
|---|-----------------------|-----------|--------|---------------|--------------------------------------------------------|
|
|
| 1 | endpoint | endpoint | string | - | s3-gw endpoint URL |
|
|
| 2 | log | log | string | ./request.log | path to log file, could be either absolute or relative |
|