About

Go-getdockerimage is a utility tool to download images from docker hub and export them. Exporting images is useful, if you have a server without access to docker hub.

No magic involved. This tool is just a convenient wrapper for regular docker cli or podman.

Use case

• Export image on a machine with access to docker hub
• Copy image to your server
• Load image with docker load --input MyImage

Requirements

Docker is installed on your machine.

Quickstart

Checkout the project and run make (given that go build chain is installed). Hint: You can simply click on the Gitpod link above and compile it online without setting up a tool chain.

make all

Installation

Simply grep the latest available binary from the release page and put it somewhere in your path.

If go is installed and $GOPATH/bin is in your path, you can download and install the tool directly by using go install.

Download tool:

# get latest version
go install github.com/EricNeid/go-getdockerimage/cmd/getdockerimage@latest
# or get specific version
go install github.com/EricNeid/go-getdockerimage/cmd/[email protected]

Usage

Download image:

getdockerimage.exe foo/image:2.0.0
=> foo_image_2.0.0.img

Download image from different registry:

getdockerimage.exe myregistry:1234/foo/image:2.0.0
=> foo_image_2.0.0.img

Download image(s) from dockerfile or docker-compose.yml

getdockerimage.exe ./my-docker-project/Dockerfile
=> foo_image_2.0.0.img

Download all required images for project, by checking dockerfile and docker-compose.yml:

getdockerimage.exe ./my-docker-project
=> foo_image_2.0.0.img
=> bar_image_2.0.0.img

Store images to folder:

getdockerimage.exe -dir=out foo/image:2.0.0
=> out/foo_image_2.0.0.img

Question or comments

Please feel free to open a new issue: https://github.com/EricNeid/go-getdockerimage/issues