文档

推送和拉取自定义OCI制品

更新时间:

容器镜像服务企业版支持管理以ORAS(OCI Registry As Storage)客户端制作的符合OCI规范的自定义制品,您可以安全的管理以及高效的分发符合OCI规范的自定义制品。

前提条件

  • 已在本地安装ORAS客户端。具体操作,请参见安装ORAS

  • 已配置专有网络或公网的访问控制,用于连接到企业版实例,本文以配置公网访问控制为例。具体操作,请参见配置公网的访问控制

  • 已获取登录企业版实例的密码。

    若您忘记或遗失密码,您可以通过配置访问凭证的方式重置密码。具体操作,请参见配置访问凭证

背景信息

容器镜像服务企业版支持托管OCI制品,包括镜像、Helm Chart和自定义的OCI制品。关于镜像和Helm Chart的详细介绍,请参见推送和拉取镜像推送和拉取Helm Chart

推送自定义OCI制品至企业版实例

  1. 执行以下命令,登录企业版实例。

    oras login --username=<镜像仓库登录名> <企业版实例名称>-registry.cn-<企业版实例所在的地域>.cr.aliyuncs.com

    在返回结果中输入登录密码,然后显示login succeeded,表示登录成功。

  2. 执行以下命令,使用本地数据制作OCI制品。

    echo "hello world" > artifact.txt
  3. 执行以下命令,推送OCI制品至企业版实例。

    oras push mlf-registry.cn-hangzhou.cr.aliyuncs.com/<命名空间的名称>/<镜像仓库的名称>:<OCI制品版本> --manifest-config /dev/null:application/vnd.customized.artifact.config ./artifact.txt
    • manifest-config /dev/null:application/vnd.customized.artifact.config:指定制品的类型名称为application/vnd.customized.artifact.config

    • manifest-config /dev/null:application/vnd.customized.artifact.config ./artifact.txt:指定本地数据为artifact.txt

从企业版实例中拉取自定义OCI制品

  1. 执行以下命令,登录企业版实例。

    oras login --username=<镜像仓库登录名> <企业版实例名称>-registry.cn-<企业版实例所在的地域>.cr.aliyuncs.com

    在返回结果中输入登录密码,然后显示login succeeded,表示登录成功。

  2. 执行以下命令,从企业版实例中拉取OCI制品。

    oras pull <企业版实例名称>-registry.cn-<企业版实例所在的地域>.cr.aliyuncs.com/<命名空间的名称>/<镜像仓库的名称>:<OCI制品版本>
  3. 执行以下命令,确认OCI制品已存储至本地。

    cat <OCI制品版本>

    在返回结果中可以看到文件内容,说明本地已包含OCI制品。