microscaling / imagelayers-graph Goto Github PK

A visualization tool to inspect and optimize Docker images used in your projects.

License: Apache License 2.0

CSS 20.24% HTML 9.85% Shell 0.14% JavaScript 69.78%

imagelayers-graph's Introduction

imagelayers-graph

ImageLayers.io is a project maintained by Microscaling Systems since September 2016. The project was 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.

Usage

You can access the hosted version of ImageLayers at imagelayers.io. For local development, the imagelayers-graph project requires services provided by the ImageLayers API. You can inspect images by simply providing a name, with which imagelayers will query and pull from the Docker Hub. The ImageLayers API must be available in order for imagelayers-graph to function.

Building & Development

ImageLayers uses Grunt. To install Grunt, you must first have npm installed on your machine. Install Grunt with npm install -g grunt-cli. Next, install dependencies using Bower with bower install.

The last step is to install Compass. ImageLayers recommends using the latest version of Ruby. gem install compass

Next, make sure the imagelayers API is running. Run grunt for building the UI and grunt serve for preview. The ImageLayers UI will automatically open in a browser window.

Building the Docker image

Use grunt to build the Angular app into the dist directory which is added to the Docker image. The build args are used to label the image.

$ grunt

$ docker build --tag microscaling/imagelayers-web:$(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` .

Deploying in Kubernetes

Please see deployment/README.md

Testing

Running grunt test will run the unit tests with karma.

imagelayers-graph's People

Stargazers

Watchers

imagelayers-graph's Issues

Expand FROM to the right

This is a feature request.

It would be nice to see the FROM directives, for a given docker package, expanded to the right. So say i search on node:latest. I understand that all the FROM are automatically expanded downwards, but when doing this i don't see the structure of the packages. I'd like to see each package. One reason for this is because some packages will be security reviewed and certified for use. So from there and below, i don't need to review any further.

Maybe leave the FROM and create an action to expand it as needed by the user.

License

What's the license on this?

I don't understand why my image won't load on your site.

https://imagelayers.io/?images=malice%2Ffileinfo:latest

The badge is not updated on Github after Docker image update

For some reason the badge is not updated for new Docker image. I see only "question mark" icon and link to image takes me to some github cached location. Original image URL, provided by ImageLayers works just fine. It's a GitHub image cache issue, but you need to update header you return to GitHub to make him "purge" it's cache or not to cache at all.
Here is my project's README.md

ImageLayers cannot find tags for public image

Hi,

I added this public repository yesterday:

https://hub.docker.com/r/pavel/howdy/

However, ImageLayers cannot find image tags.

Steps:

Navigate to https://imagelayers.io/
Click on "Search for images on the Docker Hub".
Enter "pavel/howdy".

Outcome:

Request URL:https://imagelayers.io/registry/images/pavel/howdy/tags
Request Method:GET
Status Code:500 Internal Server Error
Remote Address:64.211.224.18:443

GET https://registry-1.docker.io/v1/repositories/pavel/howdy/tags returned 404

It seems like you are trying to use deprecated API.

Running Grunt

There is no .jshintrc file in the repository causing the default grunt task to fail. Looks like it was accidentally added it to the .gitignore

Link to centurylinkcloud.com doesn't work

The link to https://www.centurylinkcloud.com/ doesn't go anywhere. If you drop the https it redirects to https://www.ctl.io/

Web interface refuses scrolling

Reproduction steps:

Visit https://imagelayers.io/?images=phusion%2Fbaseimage:latest with a browser window size that is small enough such that the page does not fit in the window, and requires a scrollbar.
Scroll down.

Expected results:
Scrolling works normally.

Actual results:
The page "jumps back", refusing to scroll down.

I am on Chrome 43, OS X.

https://badge.imagelayers.io/erlang:latest.svg (this one still works fine)
https://badge.imagelayers.io/elixir:latest.svg (This site can’t be reached)

for anyone knows alternative badge service, please let me know