Skip to content

Latest commit

 

History

History
79 lines (46 loc) · 1.62 KB

README.md

File metadata and controls

79 lines (46 loc) · 1.62 KB
Raw

hello

  • A simple http server, written in go.
  • Requests can be sent using GET, POST, PUT, et. al.
  • Requests can be sent to ANY URL.
  • This service will always return the json string: { "hello": "world" }

Why?

  • There are MANY very similar services available to be run from docker containers.
  • When I was pulling one of them, I was stunned how large the container was and that only a few urls were supported.
  • This little hello container is not meant to impress, but to be small, quick to pull, easy to use, and serve well when a test web service is needed.

HTTP Service Port

  • The default port is 8765
  • The http service port can be overwritten by setting the HTTP_PORT environment variable
HTTP_PORT=8765

Build

Application

  • Ensure golang is installed
  • Run build.sh
  • build.sh will produce binaries in the target directory which can be run on multiple platforms.
./build.sh
Building darwin-amd64
Building linux-amd64
Building windows-amd64

tree target
target
├── hello-darwin-amd64
├── hello-linux-amd64
└── hello-windows-amd64.exe

Docker Image

  • Ensure docker is installed
  • The build_docker.sh script will build the docker image.
  • Build the docker image after building the application.
  • To push to the Docker Registry, set the PUSH_TO_REGISTRY environment variable to true.
PUSH_TO_REGISTRY=true ./build_docker.sh

Using the Docker Container

docker pull devokun/hello

docker run -d --name hello -p 3000:3000 -e "HTTP_PORT=3000" devokun/hello

curl http://0.0.0.0:3000/