Skip to main content
Container Registry armazena imagens e artefatos OCI na sua conta e região. Envie e baixe com Docker, Podman ou outro cliente OCI. Use a API REST para gerenciar repositórios, políticas, criptografia e regras de cache. São Paulo usa cr.sa-saopaulo-1.basaltic.cloud para Docker e clientes OCI. As referências incluem o identificador da conta: cr.sa-saopaulo-1.basaltic.cloud/my-account/api:v1. A API de gerenciamento usa registry.sa-saopaulo-1.basaltic.sh. Use a uri retornada pelo repositório em vez de montá-la manualmente.

Repositórios, imagens e tags

Um repositório tem nome imutável, proteção opcional contra exclusão e tags mutáveis ou imutáveis. O digest identifica os bytes exatos do manifesto. Uma tag aponta para um manifesto e pode mudar, salvo quando a imutabilidade impede. Manifestos multiplataforma, assinaturas e outros artefatos OCI seguem o mesmo modelo. Excluir uma tag remove esse apontador. Excluir um digest remove o manifesto e todas as tags associadas. Camadas são deduplicadas entre repositórios da mesma conta; excluir uma imagem não libera imediatamente todos os bytes. A limpeza remove camadas sem referências.

Autenticação

A API REST em /v1 usa um bearer token da plataforma e X-Account-Id, conforme Autenticação. Clientes de contêiner usam /v2 e uma credencial temporária separada obtida em POST /v1/authorization-token. Essa credencial não acessa a API de gerenciamento. IAM e políticas de recurso determinam o acesso por repositório.

Criar um repositório

Choose a name, tag settings, and deletion protection.

Enviar e baixar imagens

Authenticate a container client and deploy by digest.

Políticas de ciclo de vida

Preview cleanup rules before installing them.

Criptografia

Choose platform encryption or a customer-managed KMS key.

Cache de imagens

Cache upstream images under an account-owned prefix.

Permissões

Separate image consumers, publishers, and administrators.