Orchestrator Tester

Simple, lightweight (only ~7MiB image) and easy to use service for testing Container Orchestrators (Kubernetes - k8s, Docker Swarm) and Load Balancers. Written in GO (Golang), based on Alpine.

Features

• Load balancer test (instance_id)
• List all environment variables
• Works with all HTTP METHOD
• Works with all HTTP STATUS CODE (f.e.: 500 error -> /500 | default: 200)
• * Route match
• IP info (real_ip)
• List K8S specific environment variables like service ports, hosts, etc..

Todo

• Docker Swarm environment variables support
• Docker Secret Support
• Dotenv Support
• Example k8s service, deployment
• Example docker swarm service

How to use

Example: Docker

  docker run \
    --rm \
    -it \
    -p 9090:9090 \
    --env TEST=12 \
    kazmerdome/orchestrator-tester:latest

• open http://localhost:9090

Example: Docker compose

version: '3.4'

services:
  orchestrator-tester:
    image: kazmerdome/orchestrator-tester:latest
    environment:
      - TEST=12
    ports:
      - "9090:9090"

• open http://localhost:9090

Example: Docker Swarm (with traefik)

version: '3.4'

services:
  orchestrator-tester:
    image: kazmerdome/orchestrator-tester:latest
    networks:
      - ${YOUR_NETWORK_NAME}
    environment:
      - TEST=12
    deploy:
      replicas: 4
      restart_policy:
        condition: on-failure
      labels:
      traefik.port: 9090
        traefik.frontend.rule: "Host: ${YOUR_DOMAIN};"

• open <YOUR_DOMAIN>

Example: Kubernetes (with nginx ingress)

Coming Soon

Example: Binary Build

• Check Production Mode of Development Section
• Open http://localhost:9090

Develpoment

Development Mode

step1 - build local environment with docker-compose and makefile

  make start

step2 - start the server (inside docker)

  make run

step3 - restart the server

  CTRL + C
  make run

Production Mode

step1 - binary build

  make build

step2 - run

  ./build/orchestrator-tester