24.01.2025

Conexão ao armazenamento compatível com o S3 por meio da API do Amazon S3 no Ubuntu com o Python pré-instalado

Este artigo oferece um guia detalhado sobre como se conectar a um armazenamento compatível com S3 usando a API Amazon S3 em um sistema Ubuntu. Você aprenderá como instalar as ferramentas necessárias, configurar um script Python para interação contínua com o armazenamento e executar operações essenciais, como recuperar uma lista de buckets, fazer upload e download de arquivos. Cada etapa é explicada de forma clara, facilitando para iniciantes configurarem e testarem a conexão com confiança, mesmo sem experiência prévia.

Instalando o Python e o pip

Comece atualizando seu sistema e instalando o Python 3 junto com o pip:

sudo apt update
sudo apt install python3 python3-pip
python3 -m pip install --upgrade pip

Instalando a Biblioteca boto3

Em seguida, instale a biblioteca boto3, que facilita o trabalho com armazenamento compatível com S3:

pip3 install boto3

Criando o Script Python

Crie um novo arquivo (por exemplo, s3_client.py usando seu editor de texto preferido:

import boto3
from botocore.client import Config

# Substitua os espaços reservados pelas suas credenciais
access_key = 'SUA_CHAVE_DE_ACESSO'
secret_key = 'SUA_CHAVE_SECRETA'
endpoint_url = 'https://seu.endpoint.url'

# Inicializando o cliente S3
s3_client = boto3.client(
's3',
aws_access_key_id=access_key,
aws_secret_access_key=secret_key,
endpoint_url=endpoint_url,
config=Config(signature_version='s3')
)

# Exemplo: Listar buckets
try:
response = s3_client.list_buckets()
print("Buckets:")
for bucket in response['Buckets']:
print(f" - {bucket['Name']}")
except Exception as e:
print(f"Erro: {e}")

Salve as alterações e saia do editor (use Ctrl + X, depois Y e Enter).

Executando o Script

Execute o script com o seguinte comando:

python3 s3_client.py

Se configurado corretamente, você verá uma lista de buckets no seu armazenamento.

Operações Adicionais de Armazenamento

Criando um Arquivo de Teste

Para testar os uploads e downloads de arquivos, crie um arquivo de teste:

echo "Conteúdo de exemplo do arquivo" > local_file.txt

Fazendo Upload de um Arquivo

Adicione a seguinte linha ao seu script para fazer o upload do arquivo:

s3_client.upload_file('local_file.txt', 'bucket_name', 'remote_file.txt')

Onde:

Fazendo Download de um Arquivo

Da mesma forma, adicione esta linha para fazer o download do arquivo:

s3_client.download_file('bucket_name', 'remote_file.txt', 'local_file.txt')

Onde:

Resolução de Problemas de Dependências

Se você encontrar erros, verifique se todas as dependências estão atualizadas. Por exemplo, você pode atualizar o botocore manualmente:
pip3 install --upgrade botocore[/code]

Notas

Este guia garante um processo de configuração tranquilo, permitindo que os usuários se conectem e interajam eficientemente com o armazenamento compatível com S3.

Explore Mais Recursos sobre Python

Para quem deseja expandir seus conhecimentos, nossa base de conhecimento oferece uma variedade de materiais focados em Python. Se você está começando agora ou buscando enfrentar desafios mais avançados, encontrará tudo o que precisa. Oferecemos tutoriais para iniciantes, dicas para otimizar seu código e artigos detalhados sobre tópicos como integração de banco de dados, desenvolvimento de APIs, utilização de frameworks como Django e Flask, e construção de aplicativos com bibliotecas de aprendizado de máquina. Esses recursos são projetados para ajudá-lo a construir uma base sólida em Python e aplicá-lo de forma eficaz para resolver problemas complexos do mundo real.