Docker puller

Installation

Download the executable for your platform from the releases.

Build using cargo build --release, copy the executable from target/release/docker-puller to anywhere you want to use this.

Usage

docker-puller cli for local cli usage:

Usage: docker-puller cli [OPTIONS] <SERVICE_NAME>

Arguments:
  <SERVICE_NAME>  

Options:
  -p, --path <PATH>  
  -h, --help         Print help

docker-puller server to start HTTP server:

Provide the environment variable SECRET with the secret token that clients should provide.

Usage: docker-puller server [OPTIONS]

Options:
  -p, --port <PORT>  
  -h, --help         Print help

Clients can make a get request to the server with the following paramters: ?service=<SERVICE_NAME>&path=<PATH>&token=<TOKEN>, where path is optional.

GitHub Actions

For an example on how to use this in a GitHub Actions flow, see this example.

Systemd

You can also use the docker-puller.service file. Make sure to uncomment the Environment= line and to set the SECRET.

If you are using private registries that you need to be signed in for, change the User= line to the correct user. Otherwise, you can comment it out.

Place it in /etc/systemd/system/docker-puller.service and run sudo systemctl enable --now docker-puller.