regctl 命令

常用示例

说明

regctl is a CLI tool for interacting with OCI-compliant container registries without requiring a container runtime or privileged access. It provides efficient image operations by working directly with registry APIs. The tool excels at copying images between registries, transferring only layers that don't exist at the destination. This makes it efficient for mirroring, promoting images between environments, or synchronizing across air-gapped systems. Regctl supports multi-platform images, OCI artifacts, and can work with OCI Layout directories as local registry equivalents. It automatically imports credentials from Docker CLI configuration. Common workflows include inspecting remote images, copying between registries, managing tags, checking rate limits, and exporting/importing images for offline transfer.

参数

image inspect _ref_

Display image configuration and metadata

image copy _src_ _dest_

Copy image between registries (efficient layer reuse)

image digest _ref_

Get image digest

image export _ref_ _file_

Export image to tar file (OCI or Docker format)

image import _ref_ _file_

Import image from tar file

tag ls _repository_

List tags in a repository

tag rm _ref_

Delete a tag from registry

repo ls _registry_

List repositories in a registry

manifest get _ref_

Get raw manifest content

manifest put _ref_

Upload manifest to registry

blob get _ref_

Download blob content

registry login _registry_

Authenticate with a registry

registry ratelimit _registry_

Check rate limit status for a registry

--platform _os/arch_

Filter by platform (e.g., linux/amd64, linux/arm64)

--format _template_

Output format (Go template)

-v, --verbosity _level_

Set logging verbosity