操作场景
前提条件
操作步骤
使用控制台创建

docker login 命令登录实例时,即使用该域名。
【版权声明】
©2013-2026 腾讯云版权所有
本⽂档著作权归腾讯云单独所有,未经腾讯云事先书⾯许可,任何主体不得以任何形式复制、修改、抄袭、传播全部或部分本⽂档内容。
【商标声明】
及其他腾讯云服务相关的商标均为腾讯集团下的相关公司主体所有。另外,本⽂档涉及的第三⽅主体的商标,依法由权利⼈所有。
【服务声明】
本⽂档意在向客户介绍腾讯云全部或部分产品、服务的当时的整体概况,部分产品、服务的内容可能有所调整。您所购买的腾讯云产品、服务的种类、服务标准等应由您与腾讯云之间的商业合同约定,除⾮双⽅另有约定,否则,腾讯云对本⽂档内容不做任何明⽰或默⽰的承诺或保证。
最近更新时间:2025-12-22 17:33:08

docker login 命令登录实例时,即使用该域名。最近更新时间:2025-12-22 17:33:08
docker login 命令并输入用户名及密码,该用户名及密码仅用于该实例的登录及认证鉴权,不可用于其他场景。本文档介绍如何在企业版实例中管理与腾讯云账号关联的用户级账号。

最近更新时间:2025-12-22 17:33:08
docker login 命令并输入用户名及密码,该用户名及密码仅用于该实例的登录及认证鉴权,不可用于其他场景。本文档介绍如何在企业版实例中管理自定义的服务级账号,用于 CI/CD 等自动化场景。


最近更新时间:2025-12-22 17:33:08

192.168.0.0/24,不建议直接输入 0.0.0.0/0 以放开全部公网访问。最近更新时间:2025-12-22 17:33:09



echo '172.16.1.95 techo-demo.tencentcloudcr.com' >> /etc/hosts
172.21.17.69 及 demo.tencentcloudcr.com 请替换为您实际使用的内网解析 IP 及 TCR 实例域名。最近更新时间:2025-12-22 17:33:08
最近更新时间:2025-12-22 17:33:09
API 名称及描述 | 资源类型 | 资源六段式示例 |
CreateInstance创建实例 | instance | qcs::tcr:$region:$account:instance/$instanceid |
DescribeInstanceStatus查询实例状态 | instance | qcs::tcr:$region:$account:instance/*qcs::tcr:$region:$account:instance/$instanceid |
DescribeInstances查询实例信息 | instance | qcs::tcr:$region:$account:instance/*qcs::tcr:$region:$account:instance/$instanceid |
CreateInstanceToken创建实例访问凭证 | instance | qcs::tcr:$region:$account:instance/$instanceid |
DeleteInstanceToken删除长期访问凭证 | instance | qcs::tcr:$region:$account:instance/$instanceid |
ModifyInstanceToken更新实例长期访问凭证 | instance | qcs::tcr:$region:$account:instance/$instanceid |
DescribeInstanceToken查询长期访问凭证信息 | instance | qcs::tcr:$region:$account:instance/$instanceid |
API 名称及描述 | 资源类型 | 资源六段式示例 |
CreateNamespace创建命名空间 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName |
DeleteNamespace删除命名空间 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName |
ModifyNamespace更新命名空间信息 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName |
DescribeNamespaces查询命名空间信息 | repository | qcs::tcr:$region:$account:repository/$instanceId/*qcs::tcr:$region:$account:repository/$instanceId/$namespaceName |
API 名称及描述 | 资源类型 | 资源六段式示例 |
CreateRepository创建镜像仓库 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName/$repositoryName |
DeleteRepository删除镜像仓库 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName/$repositoryName |
ModifyRepository更新镜像仓库信息 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName/$repositoryName |
DescribeImages查询容器镜像信息 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName/$repositoryName/* |
DescribeImages查询镜像仓库信息 | repository | qcs::tcr:$region:$account:repository/$instanceId/$namespaceName/*qcs::tcr:$region:$account:repository/$instanceId/$namespaceName/$repositoryName |
最近更新时间:2025-12-22 17:33:09
资源类型 | 授权策略中的资源描述方法 |
企业版实例相关 | qcs::tcr:$region:$account:instance/* |
企业版仓库相关 | qcs::tcr:$region:$account:repository/* |
个人版仓库相关 | qcs::tcr:$region:$account:repo/* |
$region:描述地域信息,例如 ap-guangzhou 代表广州地域,若值为空则表示所有地域。具体地域列表及缩写请参见 地域和可用区。$account:描述资源拥有者的主账号信息,表示为 uin/${uin},例如 uin/12345678,若值为空则表示创建策略的 CAM 用户所属的主账号。tcr-xxxxxxxx/team-01/repo-demo/*。您可在 镜像仓库 中获取资源路径。tcr-xxxxxxxx。您可在 实例列表 中获取实例 ID。{"version": "2.0","statement": [{"action": ["tcr:DescribeRepositories","tcr:PullRepository","tcr:DescribeNamespaces"],"resource": ["qcs::tcr:::repository/tcr-xxxxxxxx/team-01/repo-demo/*"],"effect": "allow"},{"action": ["tcr:DescribeInstance*"],"resource": ["qcs::tcr:::instance/tcr-xxxxxxxx"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:*"],"resource": "*","effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:Describe*","tcr:PullRepository*"],"resource": "*","effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:*"],"resource": ["qcs::tcr:::instance/*","qcs::tcr:::repository/*"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:Describe*","tcr:PullRepository*"],"resource": ["qcs::tcr:::instance/*","qcs::tcr:::repository/*"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:*"],"resource": ["qcs::tcr:::instance/tcr-xxxxxxxx","qcs::tcr:::repository/tcr-xxxxxxxx/*"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:*"],"resource": ["qcs::tcr:::repository/tcr-xxxxxxxx/team-01","qcs::tcr:::repository/tcr-xxxxxxxx/team-01/*"],"effect": "allow"},{"action": ["tcr:DescribeInstance*"],"resource": ["qcs::tcr:::instance/tcr-xxxxxxxx"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:Describe*","tcr:PullRepository"],"resource": ["qcs::tcr:::instance/tcr-xxxxxxxx","qcs::tcr:::repository/tcr-xxxxxxxx/team-01","qcs::tcr:::repository/tcr-xxxxxxxx/team-01/repo-demo","qcs::tcr:::repository/tcr-xxxxxxxx/team-01/repo-demo/*"],"effect": "allow"}]}
最近更新时间:2025-12-22 17:33:09


最近更新时间:2025-12-22 17:33:09

.、_、-,且不能以分隔符开头、结尾或连续。建议使用组织团队、产品项目等进行命名,或使用个人姓名用作个人测试空间。单个实例内命名空间名称不可重复。


最近更新时间:2025-12-22 17:33:09

.、_、-、/),且不能以分隔符开头、结尾或连续。名称支持多级路径,例如 team-01/front/nginx,可根据业务需要灵活设置。






最近更新时间:2025-12-22 17:33:09




最近更新时间:2025-12-22 17:33:09

-、.、 _)三种符号,且需以字母或数字开头。project,其下有多层级子仓库,如 project/subrepo1/subrepo2 。若要在目标实例中同步此子仓库,应在目标实例的“命名空间”字段中留空。



最近更新时间:2025-12-22 17:33:09

yum install -y fuse 安装 fuse 应用。kubectl label node xxx cloud.tencent.com/apparate=true
cloud.tencent.com/apparate=true。helm repo add tcr-helm-public https://helmhub.tencentcloudcr.com/chartrepo/publichelm pull tcr-helm-public/apparate --version 1.0.0
tar -xzvf apparate-1.0.0.tgzvim apparate/values.yaml
helm package apparate/helm install apparate apparate-1.0.0.tgz
cloud.tencent.com/apparate=true。cloud.tencent.com/apparate=true,该工作负载将强制调度至支持加速镜像的节点上,实现加速启动。最近更新时间:2025-12-22 17:33:09




最近更新时间:2025-12-22 17:33:09

配置项 | 配置说明 |
所属实例 | 当前已选择实例。 |
命名空间 | 当前实例需要开启版本保护的命名空间。单个命名空间内仅支持创建一条规则。 |
不可变规则 | latest:当前命名空间下所有仓库中,除 latest 版本外,其余镜像版本均不可被覆盖。 |
| 自定义:自定义配置需要匹配的仓库和镜像版本。 仓库匹配:选择镜像仓库的过滤类型,并填写需要过滤的仓库名称。 版本匹配:选择镜像版本的过滤类型,并填写需要过滤的版本名称。 |
启用规则 | 规则默认创建时生效。 规则状态启用即代表规则生效,您可在配置中开启/关闭该规则。 |
最近更新时间:2025-12-22 17:33:09
最近更新时间:2025-12-22 17:33:09

最近更新时间:2025-12-22 17:33:09




最近更新时间:2025-12-22 17:33:09
最近更新时间:2025-12-22 17:33:09
Key:Value 的形式配置访问目标 URL 时的 Header,可用于鉴权等场景。
-、.、 _)三种符号,且需以字母数字开头。本文以 webhook-demo 为例。Authentication: xxxxxxx。



{"type": "pushImage","occur_at": 1589106605,"event_data": {"resources": [{"digest": "sha256:89a42c3ba15f09a3fbe39856bddacdf9e94cd03df7403cad4fc105xxxx268fc9","tag": "v1.10.0","resource_url": "xxx-bj.tencentcloudcr.com/public/nginx:v1.10.0"}],"repository": {"date_created": 1587119137,"name": "nginx","namespace": "public","repo_full_name": "public/nginx","repo_type": "public"}},"operator": "332133xxxx"}
* :匹配所有不包含路径分隔符(/)的任意长字符串。** :匹配所有的任意长字符串,包括路径分隔符(/)。** 必须作为一段完整的相对路径,如果使用 /path** ,其作用将等同于 /path* ,仅能匹配以path为名称前缀的一级仓库。要想匹配path下的所有仓库,应使用 /path/** ;要想匹配以path为名称前缀的所有仓库,则应使用 /path*/** 。?:匹配除 ‘/’ 以外的任意单个字符。{alt1, alt2, …}:同时匹配多个正则表达式。匹配选定命名空间内所有仓库 | ** 或者不填 |
匹配选定命名空间内以 path 为名称前缀的所有一级仓库 | /path* |
匹配选定命名空间内以 path1 和 path2 为名称前缀的所有一级仓库 | /{path1, path2}* |
匹配选定命名空间内 path1 和 path2 目录下的所有仓库 | /{path1, path2}/** |
匹配选定命名空间内以 path1 和 path2 为名称前缀的所有仓库 | /{path1, path2}*/** |
匹配选定仓库内所有 1.x 的版本Tag | 1.? |
匹配选定仓库内所有以 env1 和 env2 为名称前缀的版本 Tag | {env1, env2} |
最近更新时间:2025-12-22 17:33:09
最近更新时间:2025-12-22 17:33:09




helm version -c 命令查看已安装的客户端版本。curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh
helm repo add $instance-$namespace https://$instance.tencentcloudcr.com/chartrepo/$namespace --username $username --password $instance-token
$instance-$namespace:为 helm repo 名称,建议使用实例名称+命名空间名称组合的方式命名,以便于区分各个实例及命名空间。https://$instance.tencentcloudcr.com/chartrepo/$namespace:为 helm repo 的远端地址。$username:为 步骤2 中已获取的用户名。$instance-token:为 步骤2 中已获取的登录密码。
如添加成功将提示以下信息。"$instance-$namespace" has been added to your repositories
helm push 指令推送 helm chart 至指定 repo,同时支持上传目录及压缩包。helm plugin install https://github.com/chartmuseum/helm-push
helm create tcr-chart-demo
helm cm-push tcr-chart-demo $instance-$namespace
$instance-$namespace 为已添加的本地仓库名称。tar zcvf tcr-chart-demo-1.0.0.tgz tcr-chart-demo/
helm cm-push tcr-chart-demo-1.0.0.tgz $instance-$namespace
$instance-$namespace 为已添加的本地仓库名称。helm repo update
helm fetch <本地仓库名称>/<Chart 名称> --version <Chart 版本>
helm fetch tcr-demo-project-a/tcr-chart-demo --version 1.0.0
最近更新时间:2025-12-22 17:33:09


最近更新时间:2025-12-22 17:33:09
API 名称及描述 | 资源类型 | 资源六段式示例 |
CreateNamespacePersonal创建个人版命名空间 | repo | qcs::tcr:$region:$account:repo/$namespace |
DeleteNamespacePersonal删除个人版命名空间 | repo | qcs::tcr:$region:$account:repo/$namespace |
API 名称及描述 | 资源类型 | 资源六段式示例 |
DescribeRepositoryOwnerPersonal查询个人版所有仓库 | repo | qcs::tcr:$region:$account:repo/* |
CreateRepositoryPersonal创建个人版镜像仓库 | repo | qcs::tcr:$region:$account:repo/$namespace/$repo |
DeleteRepositoryPersonal删除个人版镜像仓库 | repo | qcs::tcr:$region:$account:repo/$namespace/$repo |
BatchDeleteRepositoryPersonal批量删除个人版镜像仓库 | repo | qcs::tcr:$region:$account:repo/$namespace/* |
DeleteImagePersonal删除个人版仓库 tag | repo | qcs::tcr:$region:$account:repo/$namespace/$repo |
BatchDeleteImagePersonal批量删除个人版仓库 tag | repo | qcs::tcr:$region:$account:repo/$namespace/$repo |
PullRepositoryPersonal拉取个人版镜像仓库内镜像 | repo | qcs::tcr:$region:$account:repo/$namespace/$repo |
PushRepositoryPersonal推送个人版镜像仓库内镜像 | repo | qcs::tcr:$region:$account:repo/$namespace/$repo |
最近更新时间:2025-12-22 17:33:10
{"version": "2.0","statement": [{"action": ["tcr:*"],"resource": ["qcs::tcr:::repo/*"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:Describe*","tcr:PullRepository*"],"resource": ["qcs::tcr:::repo/*"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:*"],"resource": ["qcs::tcr:::repo/team-01","qcs::tcr:::repo/team-01/*"],"effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:Describe*","tcr:PullRepositoryPersonal"],"resource": ["qcs::tcr:::repo/team-01","qcs::tcr:::repo/team-01/repo-demo","qcs::tcr:::repo/team-01/repo-demo/*"],"effect": "allow"}]}
最近更新时间:2025-12-22 17:33:09
API 2.0 名称 | API 3.0 名称 | 接口描述 | 最新资源(Resource)描述方式 |
CreateCCRNamespace | CreateNamespacePersonal | 创建个人版命名空间 | qcs::tcr:$region:$account:repo/$namespace |
DeleteUserNamespace | DeleteNamespacePersonal | 删除个人版命名空间 | qcs::tcr:$region:$account:repo/$namespace |
GetUserRepositoryList | DescribeRepositoryOwnerPersonal | 查询个人版所有仓库 | qcs::tcr:$region:$account:repo/* |
CreateRepository | CreateRepositoryPersonal | 创建个人版镜像仓库 | qcs::tcr:$region:$account:repo/$namespace/$repo |
DeleteRepository | DeleteRepositoryPersonal | 删除个人版镜像仓库 | qcs::tcr:$region:$account:repo/$namespace/$repo |
BatchDeleteRepository | BatchDeleteRepositoryPersonal | 批量删除个人版镜像仓库 | qcs::tcr:$region:$account:repo/$namespace/* |
DeleteTag | DeleteImagePersonal | 删除个人版仓库 tag | qcs::tcr:$region:$account:repo/$namespace/$repo |
BatchDeleteTag | BatchDeleteImagePersonal | 批量删除个人版仓库 tag | qcs::tcr:$region:$account:repo/$namespace/$repo |
pull | PullRepositoryPersonal | 拉取个人版镜像仓库内镜像 | qcs::tcr:$region:$account:repo/$namespace/$repo |
push | PushRepositoryPersonal | 推送个人版镜像仓库内镜像 | qcs::tcr:$region:$account:repo/$namespace/$repo |
ccr 作为产品前缀,API 接口名称为2.0版本。例如,创建命名空间为 ccr:CreateCCRNamespace。ccr 作为产品名称,仅有 repo 资源类型。例如,描述命名空间 namespace-a 下的镜像仓库 repo-b,则为 qcs::ccr:::repo/namespace-a/repo-b。其中,$region,$account 若置空,则默认为全部地域,账号默认为创建策略的 CAM 用户所属的主账号。
具体授权方案请参考:TKE 镜像仓库资源级权限设置。tcr 作为产品前缀,API 接口名称为3.0版本。例如,创建个人版命名空间为 tcr:CreateNamespacePersonal。tcr 作为产品名称,具有 instance、repository 和repo 三种资源类型。其中,repo 为个人版专属的资源类型。例如,描述个人版命名空间 namespace-a 下的镜像仓库 repo-b,则为 qcs::tcr:$region:$account:repo/namespace-a/repo-b。其中,$region,$account 若置空,则默认为全部地域,账号默认为创建策略的 CAM 用户所属的主账号。
具体授权方案请参考:个人版接入 CAM 的 API 列表 及 个人版授权方案示例。{"version": "2.0","statement": [{"action": ["ccr:pull"],"resource": "qcs::ccr:::repo/namespace-a/repo-b","effect": "allow"}]}
{"version": "2.0","statement": [{"action": ["tcr:PullRepositoryPersonal"],"resource": "qcs::tcr:::repo/namespace-a/repo-b","effect": "allow"}]}
最近更新时间:2025-12-22 17:33:10


最近更新时间:2025-12-22 17:33:10
