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ágina | O que é |
|---|---|
SUA_ACCESS_KEY | Access Key |
SUA_SECRET_KEY | Secret Key |
ENDPOINT | Endereç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
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
| Erro | Causa provável | Solução |
|---|---|---|
InvalidAccessKeyId ou SignatureDoesNotMatch | Chave copiada errada ou com espaços | Copie de novo as chaves em Credenciais |
Could not connect to the endpoint URL | Endpoint errado | Confira o endereço, com https:// |
| Erro de checksum ao enviar arquivos | AWS CLI ou boto3 recentes | Inclua as duas linhas when_required |
BucketAlreadyExists | Nome de bucket já usado | Escolha outro nome |