Gantry

Move container images to and from IPFS.

A container crane (also container handling gantry crane or ship-to-shore crane) is a type of large dockside gantry crane found at container terminals for loading and unloading intermodal containers from container ships.

Also...

A tall framework supporting a space rocket prior to launching.

The Open Container Initiative currently maintains specifications for images and runtimes which have been implemented by the containers organization - specifically libraries such as this and tools such as Buildah and Podman. Gantry adapts some of these interfaces to further leverage IPFS as a storage backend to host all layers that comprise an image, located at the Content Identifier (CID) of it's manifest. This allows anyone with knowledge of the manifest to pull the whole image from anywhere in the world.

Getting Started

Requirements:

• go-ipfs
• buildah

Download any image to your local store:

buildah from alpine

The only way to publish an image is to run a local IPFS node. You can then push the image to your local repo, and clear the local image store:

image=$(gantry push -o alpine)
buildah rmi --all

Finally, re-download the image from IPFS and check it exists:

gantry pull -o $image -t alpine
buildah images

Troubleshooting

You may need to enable user namespace cloning in the kernel:

sysctl -w kernel.unprivileged_userns_clone=1