/imagelayers

Docker Image Visualization and Badges

Primary LanguageGoApache License 2.0Apache-2.0

ImageLayers API

ImageLayers.io is a project maintained by Microscaling Systems since September 2016. The project was created and developed by the team at CenturyLink Labs. This utility provides a browser-based visualization of user-specified Docker Images and their layers. This visualization provides key information on the composition of a Docker Image and any commonalities between them. ImageLayers.io allows Docker users to easily discover best practices for image construction, and aid in determining which images are most appropriate for their specific use cases. Similar to docker images --tree, the ImageLayers project aims to make visualizing your image cache easier, so that you may identify images that take up excessive space and create smarter base images for your Docker projects.

##Installation

The ImageLayers API is a golang application and uses godep.

$ go get github.com/microscaling/imagelayers
$ go get github.com/tools/godep
$ cd $GOPATH/src/github.com/microscaling/imagelayers
$ godep restore
$ go test ./... #should all pass
$ go run main.go #or build and run

##Build Docker image

# Compile the Go binary for Linux with static linking for Alpine
$ GOOS=linux CGO_ENABLED=0 go build -a -installsuffix cgo -o imagelayers

# Build the Docker image using args for the labels
$ docker build --tag microscaling/imagelayers-api:$(cat VERSION) \
               --build-arg BUILD_DATE=`date -u +"%Y-%m-%dT%H:%M:%SZ"` \
               --build-arg VCS_REF=`git rev-parse --short HEAD` \
               --build-arg VERSION=`cat VERSION` .

##imagelayers-graph UI Project ImageLayers provides services to search and analyze mulitple images within the docker registry. Imagelayers Graph is an example interface using these services.

##ImageLayers In Action You can see the hosted version of ImageLayers at imagelayers.io.