Docker Image Pusher

Docker Image Pusher is a command-line tool written in Rust that allows users to push Docker image tar packages directly to a Docker registry. This tool is designed to handle large images efficiently, including those larger than 10GB, by utilizing chunked uploads.

中文文档

Features

Chunked Uploads: Supports uploading large Docker images in chunks, ensuring stability and reliability during the upload process.
Docker Registry API Interaction: Directly interacts with the Docker registry API for seamless image uploads.
Authentication Support: Handles authentication with the Docker registry, including token retrieval and session management.
Progress Tracking: Provides real-time feedback on upload progress to the user.

Installation

To install Docker Image Pusher, you can either download the pre-built binary or build it from source.

Pre-built Binary

Download the latest release from the Releases page.

Build from Source

To build the project from source, ensure you have Rust and Cargo installed, then run the following commands:

git clone https://github.com/yorelog/docker-image-pusher.git
cd docker-image-pusher
cargo build --release

Usage

To push a Docker image tar package to a registry, use the following command:

./target/release/docker-image-pusher \
  --address http://your-registry-address:5000 \
  --username your-username \
  --password your-password \
  --project your-project \
  --file /path/to/your-image.tar

Command-Line Arguments

Argument	Description
`--address`	The address of the target Docker registry.
`--username`	The username for authentication (optional).
`--password`	The password for authentication (optional).
`--project`	The target project name in the registry (optional).
`--file`	The path to the local Docker image tar package (required).
`--skipTls`	Whether to skip TLS verification (optional).
`--chunkSize`	The size of each chunk for uploads (in bytes, required for chunked uploads).

Contributing

Contributions are welcome! Please open an issue or submit a pull request on the GitHub repository.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

docker-image-pusher 0.1.0