regctl

regctl是一个用于访问OCI兼容容器仓库的命令行工具。

重要链接

• 项目网站：regclient.org
• 安装选项：regclient.org/install/
• CLI参考文档：regclient.org/cli/regctl/
• 源代码：github.com/regclient/regclient
• 发布版本：github.com/regclient/regclient/releases
• 贡献指南：github.com/regclient/regclient - contributing.md

可用标签

• regclient/regctl:latest：基于scratch的最新发布版本。
• regclient/regctl:alpine：基于alpine的最新发布版本。
• regclient/regctl:edge：基于scratch的main分支最新提交版本。
• regclient/regctl:edge-alpine：基于alpine的main分支最新提交版本。
• regclient/regctl:$ver：基于scratch的特定发布版本（semver详情见下文）。
• regclient/regctl:$ver-alpine：基于alpine的特定发布版本（semver详情见下文）。

基于scratch的镜像不包含shell或任何凭证助手。基于alpine的镜像基于发布时最新固定的alpine镜像，并包含AWS和Google Cloud的凭证助手。

$ver的semver版本值基于GitHub标签。这些版本也会标记主要和次要版本，例如，v0.7.1版本会同时标记v0.7和v0。

Docker快速入门

shell
docker container run -it --rm --net host \
  -v regctl-conf:/home/appuser/.regctl/ \
  regclient/regctl:latest --help

在Linux和Mac环境下，以下是一个示例shell脚本，用于在容器中运行regctl，并配置为以当前用户身份访问内容，同时使用docker凭证和证书：

shell
#!/bin/sh
opts=""
case "$*" in
  "registry login"*) opts="-t";;
esac
docker container run $opts -i --rm --net host \
  -u "$(id -u):$(id -g)" -e HOME -v $HOME:$HOME \
  -v /etc/docker/certs.d:/etc/docker/certs.d:ro \
  ghcr.io/regclient/regctl:latest "$@"