Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/artefactual-labs/docker-gearmand
Docker image of gearmand based on Alpine Linux.
https://github.com/artefactual-labs/docker-gearmand
backend containers docker docker-image gearman gearmand jobs queue
Last synced: 2 months ago
JSON representation
Docker image of gearmand based on Alpine Linux.
- Host: GitHub
- URL: https://github.com/artefactual-labs/docker-gearmand
- Owner: artefactual-labs
- License: apache-2.0
- Created: 2017-03-29T19:23:43.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-04-30T03:35:46.000Z (9 months ago)
- Last Synced: 2024-04-30T23:55:45.746Z (9 months ago)
- Topics: backend, containers, docker, docker-image, gearman, gearmand, jobs, queue
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/artefactual/gearmand/
- Size: 26.4 KB
- Stars: 17
- Watchers: 8
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# gearmand
[](https://github.com/artefactual-labs/docker-gearmand)
`artefactual/gearmand` packages recent versions of gearmand using Alpine Linux as the base image.
## Supported tags and respective `Dockerfile` links
- [`1.1.15-alpine` (*Dockerfile*)](1.1.15/Dockerfile)
- [`1.1.16-alpine` (*Dockerfile*)](1.1.16/Dockerfile)
- [`1.1.17-alpine` (*Dockerfile*)](1.1.17/Dockerfile)
- [`1.1.18-alpine` (*Dockerfile*)](1.1.18/Dockerfile)
- [`1.1.19.1-alpine` (*Dockerfile*)](1.1.19.1/Dockerfile)
- [`1.1.20.1-alpine` (*Dockerfile*)](1.1.20.1/Dockerfile)
- [`1.1.21.2-alpine`, `latest` (*Dockerfile*)](1.1.21.2/Dockerfile)
See also the [official releases](https://github.com/gearman/gearmand/releases) page.
## Supported gearmand backends
- `builtin` (default)
- `libmemcached`
- `mysql` (using `mariadb-dev`)
- `redis`
## Usage
Print help:
```bash
docker run --rm -i artefactual/gearmand:latest --help
```
Use `redis` backend and set verbose level to `DEBUG`.
```bash
docker run --rm -i artefactual/gearmand:latest --queue-type=redis --redis-server=192.168.1.1 --redis-port=6379 --verbose=DEBUG
```
## Environment variables
This image includes an entry point that translates environment strings into [configuration attributes](http://gearman.info/gearmand.html). The following is a list of the strings currently supported:
| Name | Description | Default |
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| VERBOSE | Logging level | INFO |
| GEARMAND_PORT | Listen port | 4730 |
| QUEUE_TYPE | Persistent queue type to use | builtin |
| THREADS | Number of I/O threads to use | 4 |
| BACKLOG | Number of backlog connections for listen | 32 |
| FILE_DESCRIPTORS | Number of file descriptors to allow for the process | Default is max allowed for user |
| JOB_RETRIES | Number of attempts to run the job before the job server removes it. Default is no limit. | 0 |
| ROUND_ROBIN | Assign work in round-robin order per worker connection | 0 |
| WORKER_WAKEUP | Number of workers to wakeup for each job received | 0 |
| KEEPALIVE | Enable keepalive on sockets | 0 |
| KEEPALIVE_IDLE | The duration between two keepalive transmissions in idle condition | 30 |
| KEEPALIVE_INTERVAL | The duration between two successive keepalive retransmissions, if acknowledgement to the previous keepalive transmission is not received | 10 |
| KEEPALIVE_COUNT | The number of retransmissions to be carried out before declaring that remote end is not available | 5 |
| MYSQL_HOST | MySQL server host | localhost |
| MYSQL_PORT | MySQL server port | 3306 |
| MYSQL_USER | MySQL server user | root |
| MYSQL_PASSWORD | MySQL password | |
| MYSQL_PASSWORD_FILE | Path to file with MySQL password (Docker secrets) | |
| MYSQL_DB | Database to use by Gearman | Gearmand |
| MYSQL_TABLE | Table to use by Gearman | gearman_queue |
You can also inject your version of config file to `/etc/gearmand.conf` as needed.
## Credits
See the [list of contributors](https://github.com/artefactual-labs/docker-gearmand/graphs/contributors).
Thanks to @Mararok for the new entry point bringing support for environment variables and secrets.