Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/keinos/imhost
Example of Docker Compose's "--scale" with Nginx's round-robin.
https://github.com/keinos/imhost
docker docker-compose-template dockerfile host-name round-robin
Last synced: about 1 month ago
JSON representation
Example of Docker Compose's "--scale" with Nginx's round-robin.
- Host: GitHub
- URL: https://github.com/keinos/imhost
- Owner: KEINOS
- License: unlicense
- Created: 2024-03-23T01:42:08.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-03-28T14:21:34.000Z (10 months ago)
- Last Synced: 2024-10-05T19:22:24.510Z (4 months ago)
- Topics: docker, docker-compose-template, dockerfile, host-name, round-robin
- Language: Go
- Homepage:
- Size: 18.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# ImHost
[ImHost](./imhost) is a **web server that simply responds the "host name" of the server** at port 80.
Its main purpose is for testing and demonstration of **load balancing** and **scaling** of Docker containers.
> We provide a [Dockerfile](./Dockerfile) for convenience. See the "[Docker Compose with scale and round-robin](#docker-compose-with-scale-and-round-robin)" section for the **full example using "--scale" option and Nginx as a load balancer** as well.
## Usage
### Docker
```shellsession
$ # Build the image
$ docker build -t imhost https://github.com/KEINOS/imhost.git
**snip**
$ # Run the container (expose the port 80 to 8080)
$ docker run --rm -p 8080:80 imhost
**snip**
$ # Check the hostname
$ curl -sS http://localhost:8080/
Hello from host: f9536b7afae0
```
### Docker Compose with scale and round-robin
Here is an example of `docker-compose.yml` that can:
1. Scale-up `imhost` containers using `--scale` option.
2. Load balancing using `nginx`.
```shellsession
$ # Run the containers and scale the imhost to 5 instances
docker compose up --scale imhost=5 --detach
**snip**
$ # Check the host names.
$ # Note that the host names are different each time because of
$ # the round-robin.
$ curl -sS http://localhost:8080
Hello from host: 2c80ea38d91a
$ curl -sS http://localhost:8080
Hello from host: 5fec68e38b9b
$ curl -sS http://localhost:8080
Hello from host: 353184aa84c0
```
```yaml
version: '3'
services:
imhost:
build:
context: https://github.com/KEINOS/imhost.git
expose:
- "80"
restart: unless-stopped
loadbalancer:
image: nginx:latest
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
ports:
- "8080:80"
depends_on:
- imhost
restart: unless-stopped
```
```nginx
user nginx;
worker_processes auto;
events {
worker_connections 1024;
}
http {
server {
listen 80;
location / {
proxy_pass http://imhost:80/;
}
}
}
```
- For the full example, see the [example](./_example) directory.
## Source code
[](https://pkg.go.dev/github.com/KEINOS/imhost)
- [/imhost/main.go](./imhost/main.go)
### Status
[](https://github.com/KEINOS/imhost/actions/workflows/unit-test.yml)
[](https://github.com/KEINOS/imhost/actions/workflows/golang-ci.yml)
[](https://github.com/KEINOS/imhost/actions/workflows/docker-test.yml)
[](https://github.com/KEINOS/imhost/actions/workflows/github-code-scanning/codeql)
[](https://codecov.io/gh/KEINOS/imhost)
[](https://goreportcard.com/report/github.com/KEINOS/imhost)