> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Container Registry

> Armazene imagens privadas e artefatos OCI, controle o acesso e automatize a limpeza.

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.

<span id="repositories-images-and-tags" />

## 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.

<span id="authentication" />

## Autenticação

A API REST em `/v1` usa um bearer token da plataforma e `X-Account-Id`, conforme [Autenticação](/pt/authentication). 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.

<CardGroup cols={2}>
  <Card title="Criar um repositório" href="/pt/registry/create-repository">Choose a name, tag settings, and deletion protection.</Card>
  <Card title="Enviar e baixar imagens" href="/pt/registry/images">Authenticate a container client and deploy by digest.</Card>
  <Card title="Políticas de ciclo de vida" href="/pt/registry/lifecycle">Preview cleanup rules before installing them.</Card>
  <Card title="Criptografia" href="/pt/registry/encryption">Choose platform encryption or a customer-managed KMS key.</Card>
  <Card title="Cache de imagens" href="/pt/registry/pull-through-cache">Cache upstream images under an account-owned prefix.</Card>
  <Card title="Permissões" href="/pt/registry/permissions">Separate image consumers, publishers, and administrators.</Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.