README
¶
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 magick involved. This tool is just a convenient wrapper for regular docker cli.
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:
go install github.com/EricNeid/go-getdockerimage/cmd/getdockerimage@latest
Usage
Download image:
getdockerimage.exe 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
Transfer images to server via ssh:
getdockerimage.exe -ssh=ssh://user:pass@111.222.333.444 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
Documentation
¶
Overview ¶
Package gogetdockerimage contains functions to download and save docker images.
Index ¶
- func DownloadImage(imageName string) error
- func GetImagesFromDockerCompose(dockerfilePath string) ([]string, error)
- func GetImagesFromDockerfile(dockerfilePath string) ([]string, error)
- func GetOutputName(image string) (string, error)
- func RemoveDir(dir string) error
- func SSHCopyFile(user, pass, addr, srcPath, dstPath string) error
- func SaveImage(imageName, outDir, outName string) error
- type RemoteDestination
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DownloadImage ¶
DownloadImage download docker image by name.
func GetImagesFromDockerCompose ¶
GetImagesFromDockerCompose returns all images found in given docker-compose file. It search for occurrences of "image: <imageName>" or "image: "<imageName>"" Search is performed case insensitive.
func GetImagesFromDockerfile ¶
GetImagesFromDockerfile returns all images found in given Dockerfile. It search for occurrences of "FROM imageName" or "FROM imageName AS alias" Search is performed case insensitive. Declaration of scratch is ignored.
func GetOutputName ¶
GetOutputName returns name of generated file from image name foo -> foo.docker.img foo/bar -> foo_bar.docker.img foo/bar:42 -> foo_bar_42.docker.img
func SSHCopyFile ¶
SSHCopyFile copies a file from srcPath to dstPath on the provided host. Host url can include port (ie. "10.20.300.400:22")
Types ¶
type RemoteDestination ¶
RemoteDestination represents a destination on a remote host. It contains user name, remote address (containing port number) and folder on remote host.
func ParseDestination ¶
func ParseDestination(urlString string) (*RemoteDestination, error)
ParseDestination parses the given url and returns new RemoteDestination. Url is expected to be in the format: ssh://user@10.20.300.400:22.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
getdockerimage
command
SPDX-FileCopyrightText: 2021 Eric Neidhardt SPDX-License-Identifier: MIT
|
SPDX-FileCopyrightText: 2021 Eric Neidhardt SPDX-License-Identifier: MIT |
|
internal
|
|
|
verify
Package verify provides utility functions for tests.
|
Package verify provides utility functions for tests. |