Distroless Golang IP Geolocator

The corresponding article for this repo can be found here.

This application serves to showcase small Docker images via a simple API that has one route. A GET request to the / route will make an API call to in order to get the user's IP address, ISP, and location data, including the user's latitude and longitude to the millionth decimal place. All this data will be returned.

If you want to download the code and try it out yourself, you will need to sign up for a free API key from:

https://geo.ipify.org/

Software Required

• docker
• docker-compose
• make

How to Run

Clone the repo

git clone git@github.com:starlightromero/distroless-go-ip.git

cd into the directory

cd distroless-go-ip

Rename .env.sample to .env

mv .env.sample .env

Edit the .env file to contain your API Key

vim .env

Run the application!

Makefile Commands

build-alpine-single: Build Geolocator app with an Alpine base image using a single stage build

start-alpine-single: Start Geolocator app with an Alpine base image using a single stage build

stop-alpine-single: Stop Geolocator app with an Alpine base image using a single stage build

build-alpine: Build Geolocator app with an Alpine base image using a multi-stage build

start-alpine: Start Geolocator app with an Alpine base image using a multi-stage build

stop-alpine: Stop Geolocator app with an Alpine base image using a multi-stage build

build-buster-single: Build Geolocator app with an Buster base image using a single stage build

start-buster-single: Start Geolocator app with an Buster base image using a single stage build

stop-buster-single: Stop Geolocator app with an Buster base image using a single stage build

build-buster: Build Geolocator app with an Buster base image using a multi-stage build

start-buster: Start Geolocator app with an Buster base image using a multi-stage build

stop-buster: Stop Geolocator app with an Buster base image using a multi-stage build

build-distroless: Build Geolocator app with an Distroless base image using a multi-stage build

start-distroless: Start Geolocator app with an Distroless base image using a multi-stage build

stop-distroless: Stop Geolocator app with an Distroless base image using a multi-stage build

build-scratch: Build Geolocator app with an Scratch base image using a multi-stage build

start-scratch: Start Geolocator app with an Scratch base image using a multi-stage build

stop-scratch: Stop Geolocator app with an Scratch base image using a multi-stage build

build-all: Build all images

Image Sizes

REPOSITORY                TAG           IMAGE ID       CREATED              SIZE
geo-buster-single         latest        71c5d3d96bf6   2 minutes ago        982MB
geo-buster                latest        f0059892702e   2 minutes ago        871MB
geo-alpine-single         latest        26c1187165e9   2 minutes ago        422MB
geo-alpine                latest        2c6ab726e92e   3 minutes ago        311MB
geo-distroless            latest        6127f8ad916c   3 minutes ago        10.4MB
geo-scratch               latest        530ed9f53331   4 minutes ago        8.83MB