Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/psi-4ward/haproxy

Docker images for haproxy
https://github.com/psi-4ward/haproxy

Last synced: 22 days ago
JSON representation

Docker images for haproxy

Host: GitHub
URL: https://github.com/psi-4ward/haproxy
Owner: psi-4ward
License: mit
Created: 2015-04-02T07:54:11.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2015-04-06T10:49:30.000Z (over 9 years ago)
Last Synced: 2024-12-09T08:46:49.620Z (25 days ago)
Language: Shell
Size: 121 KB
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Haproxy

These are docker images for Haproxy running on an
[Alpine Linux container](https://registry.hub.docker.com/u/webhippie/alpine/)

## Usage

```
docker run -p 80:80 -p 443:443 -p 9000:9000 -d --name haproxy webhippie/haproxy:latest start

# Execute this for further available commands
docker exec -ti haproxy manage help
```

## Versions

* [latest](https://github.com/dockhippie/haproxy/tree/master)
available as ```webhippie/haproxy:latest``` at
[Docker Hub](https://registry.hub.docker.com/u/webhippie/haproxy/)

## Available management commands

```bash
Usage: manage []

Some useful manage commands are:
bash Start a shell on container
check Check config file
commands List all available sub commands
pid Return the process id
prepare Prepare environment
reload Reload the main process
running Check if main process is running
start Start the main process
stop Stop the main process
```

## Available environment variables

```bash
ENV DISCOVERY_TYPE etcd
ENV DISCOVERY_HOST http://127.0.0.1
ENV DISCOVERY_PORT 4001
ENV DISCOVERY_INTERVAL 30
ENV DISCOVERY_PREFIX /services/haproxy
ENV DISCOVERY_OPTS # Optional, any allowed confd param
ENV DISCOVERY_CLIENT_KEY # Optional, as string or filename
ENV DISCOVERY_CLIENT_CERT # Optional, as string or filename
ENV DISCOVERY_CLIENT_CA # Optional, as string or filename

ENV HAPROXY_USERNAME webhippie
ENV HAPROXY_PASSWORD webhippie
ENV HAPROXY_CERT # Optional, as string or filename
```

### Configure with etcd

If you export ```DISCOVERY_TYPE``` with the value ```etcd``` you can use etcd
for configuration:

```
etcdctl set /app/exampleapp 'example.com'
etcdctl set /upstream/exampleapp/server1 '127.0.0.1:3000'
etcdctl set /upstream/exampleapp/server2 '127.0.0.1:4000'
```

### Configure with consul

If you export ```DISCOVERY_TYPE``` with the value ```consul``` you can use
consul for configuration:

```
curl -X PUT -d 'example.com' http://localhost:8500/v1/kv/app/exampleapp
curl -X PUT -d '127.0.0.1:3000' http://localhost:8500/v1/kv/upstream/exampleapp/server1
curl -X PUT -d '127.0.0.1:4000' http://localhost:8500/v1/kv/upstream/exampleapp/server2
```

### Configure with environment

If you export ```DISCOVERY_TYPE``` with the value ```env``` you can use
environment for configuration:

```
export APP_EXAMPLEAPP=example.com
export UPSTREAM_EXAMPLEAPP_SERVER1=127.0.0.1:3000
export UPSTREAM_EXAMPLEAPP_SERVER2=127.0.0.1:4000
```

## Contributing

Fork -> Patch -> Push -> Pull Request

## Authors

* [Thomas Boerger](https://github.com/tboerger)

## License

MIT