Todos os produtos
Search

Este produto

    Container Registry:Push and pull custom OCI artifacts

    Central de documentação

    Container Registry:Push and pull custom OCI artifacts

    Última atualização: Jul 03, 2026

    O Container Registry Enterprise Edition armazena e distribui artefatos personalizados da Open Container Initiative (OCI) junto com imagens de contêiner e gráficos Helm. Este guia demonstra como enviar um arquivo local como artefato OCI personalizado para uma instância do Container Registry Enterprise Edition e recuperá-lo com o cliente ORAS (OCI Registry As Storage).

    Pré-requisitos

    Antes de começar, verifique se você tem:

    Enviar um artefato OCI personalizado

    Etapa 1: Defina variáveis de ambiente

    Defina os detalhes do registro como variáveis de ambiente. Como todos os comandos subsequentes referenciam essas variáveis, atualize-as apenas uma vez.

    REGISTRY=<instance-name>-registry.cn-<region>.cr.aliyuncs.com
NAMESPACE=<namespace>
REPO=<image-repository>
TAG=<artifact-version>
IMAGE=$REGISTRY/$NAMESPACE/$REPO:$TAG

    Substitua os espaços reservados pelos valores reais:

    Espaço reservado

    Descrição

    Exemplo

    <instance-name>

    Nome da instância Enterprise Edition

    my-registry

    <region>

    Região onde a instância está implantada

    hangzhou

    <namespace>

    Namespace na instância

    my-namespace

    <image-repository>

    Nome do repositório de imagens

    my-artifacts

    <artifact-version>

    Tag de versão do artefato

    v1.0

    Etapa 2: Fazer login na instância

    oras login --username=<username> $REGISTRY

    Insira a senha de login quando solicitado. Um login bem-sucedido exibe:

    login succeeded

    Etapa 3: Crie um artefato local

    Crie um arquivo de exemplo para usar como artefato:

    echo "hello world" > artifact.txt

    Etapa 4: Enviar o artefato

    Envie o arquivo para a instância usando a variável $IMAGE definida anteriormente:

    oras push $IMAGE \
  --manifest-config /dev/null:application/vnd.customized.artifact.config \
  ./artifact.txt

    A flag --manifest-config define o tipo de mídia do artefato como application/vnd.customized.artifact.config. Isso distingue o artefato personalizado de uma imagem de contêiner padrão, que usa application/vnd.oci.image.config.v1+json. O argumento ./artifact.txt especifica o arquivo local para upload.

    Um envio bem-sucedido gera uma saída semelhante a:

    Uploading a948904f2f0f artifact.txt
Uploaded  a948904f2f0f artifact.txt
Pushed [registry] <instance-name>-registry.cn-<region>.cr.aliyuncs.com/<namespace>/<image-repository>:<artifact-version>
Digest: sha256:...

    Recuperar um artefato OCI personalizado

    Etapa 1: Defina variáveis de ambiente

    Em uma nova sessão de shell, defina as variáveis de ambiente novamente:

    REGISTRY=<instance-name>-registry.cn-<region>.cr.aliyuncs.com
NAMESPACE=<namespace>
REPO=<image-repository>
TAG=<artifact-version>
IMAGE=$REGISTRY/$NAMESPACE/$REPO:$TAG

    Etapa 2: Fazer login na instância

    oras login --username=<username> $REGISTRY

    Etapa 3: Recuperar o artefato

    Exclua a cópia local primeiro para confirme que a recuperação obtém o arquivo do registro:

    rm -f artifact.txt
oras pull $IMAGE

    Etapa 4: Verifique o artefato

    cat artifact.txt

    Se a recuperação for bem-sucedida, a saída será:

    hello world

    Próximos passos