kodemonster/colorball-app repository overview

Quick start (default color red):

docker run -p 80:80 kodemonster/colorball-app:stable

It is always recommended to pull the stable release. The latest release may be associated with a version that are still in experimental mode. To know which specific version are associated to stable/latest release please refer to release notes section below.

⁠Environment Variable

⁠COLOR_CODE

Change the ball color selection by passing COLOR_CODE environment variable. Available options are:

• red (default)
• blue
• green
• purple
• yellow
• orange
• brown
• black
• white

Example starting with blue colored ball:

docker run -p 80:80 -e COLOR_CODE='blue' kodemonster/colorball-app:stable

⁠COLOR_SERVER1 COLOR_SERVER2 COLOR_SERVER1

Accept IP address to turn Ball GW mode to the current deployed container that calls other Ball services.

Example to run in Ball GW mode with 3 ball microservices running in backend on 3 different IP:

docker run -p 80:80 -e COLOR_SERVER1='10.1.120.201' -e COLOR_SERVER2='10.1.120.202' -e COLOR_SERVER3='10.1.120.203' kodemonster/colorball-app:stable

⁠Release note

⁠v3

v3.3 stable latest

• Added more testing variation page. Find it out in /more-balls page
• now stable release has been moved up to v3.3
  
  

v3.2

• Added load balancing and failure handling on the rest of microservices page
  
  

v3.1

• Introduce load balancing and failure handling on default microservices page so even if Ball GW mode is not configured, the microservices page would still load local ball image and no error image is displayed.
  
  

v3.0

• Introduce microservices mode with COLOR_SERVER1, COLOR_SERVER2 and COLOR_SERVER3 env variable to turn on Ball GW mode where IP address can be defined for 3 additional server deployed with different color ball
• Example usage docker run -p 80:80 -e COLOR_SERVER1='10.1.120.201' -e COLOR_SERVER2='10.1.120.202' -e COLOR_SERVER3='10.1.120.203' kodemonster/colorball-app:v3.0

⁠v2

v2.1

• Minor fix on visual
  
  

v2.0

• Introduce alternate page to have more balls for higher loading time
• New feature
  • Support 760 balls in /2048x1280 page that best fit for 2048x1280 screen resolution
  • Support 2664 balls in /3840x2160 page that best fit for 3840x2160 screen resolution

⁠v1

v1.1

• Fix balls image file
  
  

v1.0

• Initial release. Original image reverse engineered from Michael Cheo (mcheo) greenbullet⁠ and bluebullet⁠
• New feature
  • Support 300 balls in default page /
  • Support COLOR_CODE environment variable to manipulate ball color
  • Support input error handling to default to red ball if COLOR_CODE environment variable are misconfigured