regclient/regctl

regctl

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

重要链接

• 项目网站：regclient.org
• 安装选项：regclient.org/install/
• CLI参考文档：regclient.org/cli/regctl/
• 源代码：https://github.com/regclient/regclient
• 发布版本：https://github.com/regclient/regclient/releases
• 贡献指南：https://github.com/regclient/regclient/blob/main/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版本值基于https://github.com/regclient/regclient/tags%E3%80%82%E8%BF%99%E4%BA%9B%E7%89%88%E6%9C%AC%E4%B9%9F%E4%BC%9A%E6%A0%87%E8%AE%B0%E4%B8%BB%E8%A6%81%E5%92%8C%E6%AC%A1%E8%A6%81%E7%89%88%E6%9C%AC%EF%BC%8C%E4%BE%8B%E5%A6%82%EF%BC%8C%60v0.7.1%60%E7%89%88%E6%9C%AC%E4%BC%9A%E5%90%8C%E6%97%B6%E6%A0%87%E8%AE%B0%60v0.7%60%E5%92%8C%60v0%60%E3%80%82

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 "$@"