Repository files navigation

This package consists of two commands.

• DockerImageSaveServer is a server that pulls, saves, compresses and serves via http docker images. Docker has to be installed in the computer this service is deployed.
• DockerImageSave is the terminal application that talks withDockerImageSaveServer and downloads the zip compressed docker images.

Cuba is actively blocked by Docker and this makes difficult to obtain docker images since there is no direct access to the registry, also Cuba's internet access is restricted and slow in most cases, so a way to download these images that can be resumed is needed by thousands of developers.

Docker image is being deployed with the CI asguamulo/dockerimagesave

Download it for your distribution from the releases page on GitHub (https://github.com/jadolg/DockerImageSave/releases).Not there? Create an issue and I'll start shipping specially for you ;-)

or

snap install docker-image-save

The client comes with help included. Please use it ;-)

Usage of ./DockerImageSave-linux-amd64:  -i string        Image to download  -no-animations        Hide animations and decorations  -no-download        Do all the work but downloading the image  -s string        URL of the Docker Image Download Server (default "https://dockerimagesave.akiel.dev/")  -search string        A search query

If you are using it from a script I recommend to use the-no-animations flag to make it less noisy.Also if planning to use curl for downloading you might want to use the-no-download flag.

You are able and encouraged to deploy your own server. The best way to use it is of course the docker version.Just rundocker run -p 6060:6060 -v /var/run/docker.sock:/var/run/docker.sock:rw -d guamulo/dockerimagesave:latest.There are no "official" builds of the server as a binary.

Want to write yor own client? Here is what you need to know.

This API call will pull the image to your server. It is exactly the same as doingdocker pull image on the server.

• path:/pull/{id}
• method: GET
• curl:curl https://dockerimagesave.akiel.dev/pull/alpine:latest
• response:{"id":"alpine:latest","status":"Downloaded"}

Wait for the status to beDownloaded so you can save the image for downloading.It does not matter how many times you call this endpoint with the same image it won't re-download it.

This API call will save and compress an already pulled image making it ready for download.

• path:/save/{id}
• method: GET
• curl:curl https://dockerimagesave.akiel.dev/save/alpine:latest
• response:{"id":"alpine:latest","url":"download/alpine:latest.tar.zip","size":2214576,"status":"Ready"}

Wait for the status to beReady so you can download.

Finally you can download the image doing with the url provided after saving it.

• Path:/download/{url}
• Method: GET
• curl:url https://dockerimagesave.akiel.dev/download/alpine:latest.tar.zip -o alpine:latest.tar.zip

• Unzip the downloaded fileunzip alpine\:latest.tar.zip
• Load it into Dockerdocker load -i alpine\:latest.tarNow you should be able to see it on the images list ondocker images | grep alpine