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

# Enviar e baixar imagens

> Crie um repositório e use sua URI com um cliente OCI.

[Crie um repositório](/pt/registry/create-repository) na conta e região selecionadas e use a `uri` retornada para enviar e baixar imagens.

<span id="log-in" />

## Fazer login

Troque o token da plataforma por uma credencial do Registry. Mantenha a senha fora dos argumentos de shell e dos logs; use a entrada padrão do cliente.

```bash theme={null}
set -o pipefail
curl --fail-with-body --silent --show-error --request POST \
  https://registry.sa-saopaulo-1.basaltic.sh/v1/authorization-token \
  --header "Authorization: Bearer $TOKEN" \
  --header "X-Account-Id: $ACCOUNT" \
  | jq -er '.authorization_data.password' \
  | docker login --username basaltic --password-stdin \
      cr.sa-saopaulo-1.basaltic.cloud
```

A resposta inclui `expires_at`. Renove a credencial quando vencer. O cliente obtém tokens separados por repositório durante push e pull. Eles duram cinco minutos; revogações de política se aplicam na avaliação do próximo token.

<span id="push-a-release" />

## Enviar uma versão

Defina `IMAGE_URI` com a URI retornada e envie sua imagem local:

```bash theme={null}
docker tag my-app:v1 "$IMAGE_URI:v1"
docker push "$IMAGE_URI:v1"
docker pull "$IMAGE_URI:v1"
```

Para deployments reproduzíveis, use `IMAGE_URI@sha256:...` com o digest retornado pelo push. Tags facilitam a descoberta; o digest identifica o manifesto exato. O `manifest` interpretado na resposta REST serve para inspeção. Obtenha o manifesto original pelo cliente OCI para verificar o digest.

<span id="inspect-and-remove" />

## Inspecionar e remover

Liste imagens em `/v1/repositories/{repository_id}/images` e tags em `/v1/repositories/{repository_id}/tags`. A lista de imagens aceita `tag_status` e `tag_prefix`; a paginação de tags usa o nome de uma tag como cursor.

A exclusão em lote aceita entradas explícitas por digest ou tag. Verifique cada resultado: uma falha não impede as demais entradas. Excluir um repositório com imagens exige `force=true`, que não ignora a proteção contra exclusão. Desative a proteção explicitamente antes de excluir.


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