Principal Object Storage S3

Object Storage S3

Instruções de como utilizar sua API S3
Henrique Siquera Luan Félix
By Henrique Siquera and 1 other
8 artigos

Definindo um bucket como público

Por padrão, todos os buckets criados são definidos como "Privado" por questões de segurança dos arquivos inseridos, porém, você também pode escolher entre deixa-lô público para internet, acessando seus arquivos atráves da CDN global da CloudFlare Definindo seu bucket como público Para iniciar esse tutorial, é necessário ter seu primeiro bucket criado Em seguida, clicamos em "Object Browser" e selecionamos o bucket já criado Em seguida, vá até as configurações do Bucket Procure pela opção "Access Policy" Em seguida, clique na caneta, selecione "Public" e salve Acessando o arquivo publicamente Após alterar a configuração relacionada no bucket, é hora de enviar os arquivos para que eles fiquem acessíveis na internet Clicamos em "Object Browser" e selecionamos o bucket já criado Com o arquivo desejado dentro do bucket, vamos montar a URL para que ele seja acessível No meu caso, enviei um arquivo chamado wallpaper.jpg e deixei ele dentro do bucket marcado como Public Para descobrir a URL de download, é necessário saber o endereço da sua interface web, a que estou usando nesse tutorial é https://object-001.lura.host Isso siginfica que minha URL de conexão a API de download pública será https://api-object-001.lura.host Se sua URL de acesso é: https://object-001.lura.host Seu link de download público é: https://api-object-001.lura.host ** Agora, para montar a URL completa, é necessário adicionar /bucket/(NOME DO ARQUIVO) a URL** Exemplo para baixar o arquivo wallpaper.jpg dentro do bucket s3-1-14066-tutorial Link final: https://api-object-001.lura.host/s3-1-14066-tutorial/wallpaper.jpg

Henrique Siquera By Henrique Siquera
Última atualização em Nov 26, 2024

Enviando arquivos para o bucket (via CLI)

O serviço de Object Storage da LuraHosting usa API nativa da Amazon AWS S3, isso significa que tudo que envolva integração e cite AWS S3, nosso serviço pode atender a mesma demanda Para iniciar esse tutorial, será necessário baixar o instalador do AWS CLI - Instalador para Windows -> clique aqui - Instalador para MacOS -> clique aqui Usando o AWS CLI no Windows Faça o download do AWS CLI clicando no link acima, baixe e instale Em seguida, abra o cmd do windows e digite aws --version Se a resposta for semelhante a minha, tudo certo, basta continuar o tutorial Em seguida, digite: aws configure --profile (NOME DO PERFIL DESEJADO) No meu caso, ficou: aws configure --profile lurahosting-s3 E preencha as informações solicitadas AVISO: Para gerar suas credenciais de acesso a API siga esse tutorial clicando aqui Em "Default region name [None]:" é de extrema importância que seja us-east-1, que se trata o padrão utilizado para o Minio Em seguida, será necessário configurar o endpoint do AWS CLI diretamente nos arquivos do seu computador, navegue até o .aws Ele será instalado sempre na raiz do usuário padrão do sistema, no meu caso, em /LuraHosting Isso significa que o arquivo ficará em C:\Users\LuraHosting.aws Abra o arquivo "config" com o editor de notas da sua preferência e adicione a linha referente ao servidor que seu pacote está atribuido No meu caso, o endereço da interface web da minha hospedagem é https://object-001.lura.host, isso significa que minha API Endpoint será https://api-object-001.lura.host Em seguida, salve o arquivo, volte ao cmd do windows e faça um teste listando os buckets existentes aws --profile lurahosting-s3 s3 ls s3:// Se sua resposta for semelhante a minha e listar os buckets criados, a conexão foi realizada com sucesso, caso retorne um erro, verifique se seu endpoint_url, key ID e secret key ID estão corretos Para realizar o teste final, vamos enviar um arquivo .iso de teste via CLI aws --profile lurahosting-s3 s3 cp "C:\Users\LuraHosting\Desktop\tutorial lura.iso" s3://s3-1-14066-tutorial/ O arquivo tutorial lura.iso localizado na minha área de trabalho está sendo enviado para o bucket s3-1-14066-tutorial Aguarde finalizar e pronto, o arquivo ficará visível no seu gerenciador web em poucos segundos Usando o AWS CLI no Linux (Ubuntu) Abra o terminal e execute o seguinte comando para instalar a AWS CLI: sudo apt-get update sudo apt-get install awscli -y Se estiver usando uma distribuição diferente, use o gerenciador de pacotes correspondente. Após a instalação, verifique se foi instalado corretamente: aws --version Configuração básica da AWS CLI: Abra o terminal ou prompt de comando e execute: aws configure --profile (NOME DO PERFIL DESEJADO) No meu caso, ficou: aws configure --profile lurahosting-s3 E preencha as informações solicitadas AVISO: Para gerar suas credenciais de acesso a API siga esse tutorial clicando aqui Em "Default region name [None]:" é de extrema importância que seja us-east-1, que se trata o padrão utilizado para o Minio Em seguida, será necessário configurar o endpoint do AWS CLI diretamente nos arquivos do seu computador, navegue até o .aws Ele será instalado sempre na raiz do usuário padrão do sistema, no meu caso, em ~/.aws/credentials Use: nano ~/.aws/config E adicione o endpoint_url No meu caso, o endereço da interface web da minha hospedagem é https://object-001.lura.host, isso significa que minha API Endpoint será https://api-object-001.lura.host Pronto, você pode listar seu bucket usando aws --profile lurahosting-s3 s3 ls ou enviando um arquivo com aws --profile lurahosting-s3 s3 cp /caminho/para/seuarquivo.iso s3://nome-do-bucket/ Exemplo: aws --profile lurahosting-s3 s3 cp /home/lura.iso s3://s3-1-14066-tutorial/ O arquivo lura.iso localizado na minha área de trabalho está sendo enviado para o bucket s3-1-14066-tutorial

Henrique Siquera By Henrique Siquera
Última atualização em Nov 26, 2024