https://github.com/stone/siege-docker
Unofficial Siege http(s) benchmarking utility container image based on debian-slim
https://github.com/stone/siege-docker
autobuild benchmarking docker-image http tooling
Last synced: 6 months ago
JSON representation
Unofficial Siege http(s) benchmarking utility container image based on debian-slim
- Host: GitHub
- URL: https://github.com/stone/siege-docker
- Owner: stone
- Created: 2024-12-04T14:48:04.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-13T13:46:35.000Z (9 months ago)
- Last Synced: 2025-02-10T09:43:01.722Z (8 months ago)
- Topics: autobuild, benchmarking, docker-image, http, tooling
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/ttyse/siege
- Size: 44.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Siege Docker Image
This repository provides a Dockerfile to build a containerized version of
[Siege](https://www.joedog.org/siege-manual/), a powerful HTTP load testing and
benchmarking tool.
Built upon a debian slim image, autobuilt and pushed once a week.
## Table of Contents
- [Getting Started](#getting-started)
- [Build the Image Locally](#build-the-image-locally)
- [Specify a Siege Version](#specify-a-siege-version)
- [Using the Docker Image](#using-the-docker-image)
- [Refer to Siege Documentation](#refer-to-siege-documentation)
---
## Getting Started
To use this Docker image, ensure you have Docker installed on your system. The
image can be used directly from a container registry (e.g., DockerHub) or built
locally using the provided Dockerfile.
## Build the Image Locally
If you want to build the Docker image locally, clone this repository and use the
following steps:
1. Clone the repository:
```bash
git clone https://github.com/stone/siege-docker.git
cd siege-docker
```
2. Build the image using Docker:
```bash
docker build -t siege:latest .
```
3. (Optional) Specify a Siege version during the build:
```bash
docker build --build-arg SIEGE_VERSION= -t siege: .
```
Replace `` with the specific version of Siege you want to use (e.g., `4.1.7`).
You find releases here: https://download.joedog.org/siege/
## Specify a Siege Version
By default, the image is built with the version specified in the Dockerfile. To
use a specific version:
1. During build, pass the desired version using the `--build-arg` option:
```bash
docker build --build-arg SIEGE_VERSION=4.1.7 -t siege:4.1.7 .
```
2. If pulling from a dockerhub remote registry, check the available tags to see specific versions.
## Using the Docker Image
Run the Siege container using the following command:
```bash
docker run --rm ttyse/siege:latest --help
```
To test a URL, pass it as an argument to the container:
```bash
docker run --rm ttyse/siege:latest https://example.com
```
You can also bind local configuration files or volumes if needed:
```bash
docker run --rm -v $(pwd)/config:/root/.siege ttyse/siege:latest https://example.url
```
For more advanced usage and options, refer to the [Siege Manual](https://www.joedog.org/siege-manual/).
## Refer to Siege Documentation
For detailed information on how to configure and use Siege, refer to its
official documentation:
[https://www.joedog.org/siege-manual/](https://www.joedog.org/siege-manual/).