Pular para o conteúdo principal

Object Storage: usar com ferramentas S3

O Object Store segue o padrão do Amazon S3. Qualquer ferramenta compatível com S3 funciona: basta apontá-la para o endereço do seu Object Store e usar suas chaves. Para criar o Object Store no portal, veja Object Storage.

Antes de começar: pegue suas credenciais​

No portal, abra Object Store, escolha o seu e clique em Credenciais. Nesta página, os valores aparecem assim:

Na páginaO que é
SUA_ACCESS_KEYAccess Key
SUA_SECRET_KEYSecret Key
ENDPOINTEndereço do Object Store, começando com https://

Se o endereço (endpoint) não aparecer em Credenciais, peça ao suporte.

AWS CLI​

Instale pela página oficial da AWS. Depois, crie ou edite dois arquivos na pasta .aws do seu usuário (no Windows, C:\Users\SEU_USUARIO\.aws\).

~/.aws/credentials:

[audaks]
aws_access_key_id = SUA_ACCESS_KEY
aws_secret_access_key = SUA_SECRET_KEY

~/.aws/config:

[profile audaks]
region = us-east-1
endpoint_url = ENDPOINT
request_checksum_calculation = when_required
response_checksum_validation = when_required

As duas últimas linhas evitam erros de checksum que versões recentes da AWS CLI podem causar em serviços compatíveis com S3.

Comandos do dia a dia:

# Criar um bucket
aws s3 mb s3://meu-bucket --profile audaks

# Listar buckets e arquivos
aws s3 ls --profile audaks
aws s3 ls s3://meu-bucket --profile audaks

# Enviar um arquivo e sincronizar uma pasta
aws s3 cp relatorio.pdf s3://meu-bucket/ --profile audaks
aws s3 sync ./backups s3://meu-bucket/backups --profile audaks

# Gerar um link temporário (1 hora) para baixar um arquivo
aws s3 presign s3://meu-bucket/relatorio.pdf --expires-in 3600 --profile audaks

# Apagar um arquivo
aws s3 rm s3://meu-bucket/relatorio.pdf --profile audaks

O nome do bucket deve ter de 3 a 63 caracteres, só com letras minúsculas, números e hífen.

rclone​

No arquivo de configuração do rclone (rclone config file mostra onde fica), acrescente:

[audaks]
type = s3
provider = Other
access_key_id = SUA_ACCESS_KEY
secret_access_key = SUA_SECRET_KEY
endpoint = ENDPOINT
rclone lsd audaks:
rclone mkdir audaks:meu-bucket
rclone copy ./pasta audaks:meu-bucket/pasta --progress
Cuidado com o rclone sync

O rclone sync deixa o destino igual à origem: ele apaga no bucket o que não existir na pasta local. Na dúvida, use rclone copy.

Python (boto3)​

import boto3
from botocore.config import Config

s3 = boto3.client(
"s3",
endpoint_url="ENDPOINT",
aws_access_key_id="SUA_ACCESS_KEY",
aws_secret_access_key="SUA_SECRET_KEY",
region_name="us-east-1",
config=Config(request_checksum_calculation="when_required", response_checksum_validation="when_required"),
)

s3.upload_file("relatorio.pdf", "meu-bucket", "relatorio.pdf")
for objeto in s3.list_objects_v2(Bucket="meu-bucket").get("Contents", []):
print(objeto["Key"], objeto["Size"])

Programas com janela​

O Cyberduck (Windows e macOS) e o WinSCP (Windows) também funcionam: escolha o protocolo Amazon S3, informe o endereço do endpoint (sem https://) e as chaves.

Segurança das chaves​

  • A Secret Key é uma senha: nunca a coloque em código que vai para um repositório. Prefira variáveis de ambiente ou os arquivos de configuração acima.
  • Se a chave vazar, fale com o suporte para trocá-la.

Problemas comuns​

ErroCausa provávelSolução
InvalidAccessKeyId ou SignatureDoesNotMatchChave copiada errada ou com espaçosCopie de novo as chaves em Credenciais
Could not connect to the endpoint URLEndpoint erradoConfira o endereço, com https://
Erro de checksum ao enviar arquivosAWS CLI ou boto3 recentesInclua as duas linhas when_required
BucketAlreadyExistsNome de bucket já usadoEscolha outro nome